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





# Python SDK: Launch Requests From Your IDE
Source: https://docs.brightdata.com/api-reference/SDK

Quickly integrate the Python SDK to send web unlocking and data extraction requests directly from your IDE with minimal setup.

### Install the package

Open the terminal and run:

```python
pip install brightdata-sdk
```

Ensure `pip` is installed on your machine (for macOS first open a virtual env)

**In your code file**, import the package:

```python
from brightdata import bdclient
```

<Tip>
  In your IDE, hover over the `brightdata` package or **any of its functions** to view available methods, parameters, and usage examples.
</Tip>

<img src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Hover-Over1.jpg?maxW=1572&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=122df1043ab601b11fa1ec6d0abc452e" alt="Hover Over1 Jp" width="1572" height="319" data-path="images/Hover-Over1.jpg" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Hover-Over1.jpg?w=280&maxW=1572&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=8c86cb734b0b1e1d1cd2a1b97c15b2f4 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Hover-Over1.jpg?w=560&maxW=1572&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=06e0d9a934fac0bb3b810b1a390211ec 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Hover-Over1.jpg?w=840&maxW=1572&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=a90de63951e1287dde44df5b46b7df57 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Hover-Over1.jpg?w=1100&maxW=1572&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=60f94e1633884c2e7f9f7e10a62f859c 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Hover-Over1.jpg?w=1650&maxW=1572&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=b0000f285f93a5c41788e93c869fb72a 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Hover-Over1.jpg?w=2500&maxW=1572&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=467847252a72e9a3e791ce3591cdcba2 2500w" data-optimize="true" data-opv="2" />

### Start making requests

Try these examples to use Bright Data's SDK functions from your IDE

<CodeGroup>
  ```python search(...)
  from brightdata import bdclient

  client = bdclient(api_token="your-api-token") # Can also be taken from .env file

  results = client.search(query=["pizza"])
  # Try adding parameters like: search_engine="bing"/"yandex", country="gb"

  print (results)

  # save this code as Search.py in the same folder,
  # then run it by pasting "python Search.py" in your terminal.
  ```

  ```python scrape(...)
  from brightdata import bdclient

  client = bdclient(api_token="your-api-token") # can also be taken from .env file

  URL = ["https://docs.brightdata.com/api-reference/SDK"] # Add more to scrape multiple websites concurrently 

  results = client.scrape(url=URL)
  # Hover over the function to discover additional parameters

  bd.download_content(results, filename="scrape_results.json")

  # save this code as Scrape.py in the same folder,
  # then run it by pasting "python Scrape.py" in your terminal.
  ```
</CodeGroup>

<Check>
  When working with multiple queries or URLs, requests are handled concurrently for optimal performance.
</Check>

### Use LinkedIn Scrapers to get structured response

Search LinkedIn to get all the relevant data for your search, response is structured data

<CodeGroup>
  ```python search_linkedin(...) expandable
  # Add the following function after package import and setting the client
  # Search LinkedIn profiles by name
  first_names = ["James", "Idan"]
  last_names = ["Smith", "Vilenski"]
  result = client.search_linkedin.profiles(first_names, last_names)

  # Search jobs by URL
  job_urls = [
      "https://www.linkedin.com/jobs/search?keywords=Software&location=Tel%20Aviv-Yafo",
      "https://www.linkedin.com/jobs/reddit-inc.-jobs-worldwide?f_C=150573"
  ]
  result = client.search_linkedin.jobs(url=job_urls)

  # Search jobs by keyword and location
  result = client.search_linkedin.jobs(
      location="Paris", 
      keyword="product manager",
      country="FR",
      time_range="Past month",
      job_type="Full-time"
  )

  # Search posts by profile URL with date range
  result = client.search_linkedin.posts(
      profile_url="https://www.linkedin.com/in/bettywliu",
      start_date="2018-04-25T00:00:00.000Z",
      end_date="2021-05-25T00:00:00.000Z"
  )
  # Search posts by company URL
  result = client.search_linkedin.posts(
      company_url="https://www.linkedin.com/company/bright-data"
  )

  # Returns snapshot ID that can be used to download the content later using download_snapshot function
  ```

  ```python scrape_linkedin(...)
  # Add the following function after package import and setting the client

  # LinkedIn Profile URLs
  profile_url = "https://www.linkedin.com/in/elad-moshe-05a90413/"

  # LinkedIn Company URLs
  company_urls = [
      "https://il.linkedin.com/company/ibm",
      "https://www.linkedin.com/company/bright-data",
      "https://www.linkedin.com/company/stalkit"
  ]

  # LinkedIn Job URLs
  job_urls = [
      "https://www.linkedin.com/jobs/view/remote-typist-%E2%80%93-data-entry-specialist-work-from-home-at-cwa-group-4181034038?trk=public_jobs_topcard-title",
      "https://www.linkedin.com/jobs/view/arrt-r-at-shared-imaging-llc-4180989163?trk=public_jobs_topcard-title"
  ]

  # LinkedIn Post URLs
  post_urls = [
      "https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN?trk=public_profile",
      "https://www.linkedin.com/pulse/getting-value-out-sunburst-guillaume-de-b%C3%A9naz%C3%A9?trk=public_profile_article_view"
  ]

  # The scrape function
  results = client.scrape_linkedin.posts(post_urls) # can also be changed to async

  print(results)
  ```
</CodeGroup>

### Use ChatGPT  to collect any number of responses

```python expandable
# Add the following function after package import and setting the client
result = client.search_chatGPT(
    prompt="what day is it today?"
    # prompt=["What are the top 3 programming languages in 2024?", "Best hotels in New York", "Explain quantum computing"],
    # additional_prompt=["Can you explain why?", "Are you sure?", ""]  
)

client.download_content(result) # In case of timeout error, your snapshot_id is presented and you will downloaded it using download_snapshot()
```

### Parameters

<AccordionGroup>
  <Accordion title="Client" description="Add Client parameters" icon="circle-info">
    ```python
    client = bdclient(
      api_token="your_token",
      auto_create_zones=False,  # Else it creates Zone automatically
      web_unlocker_zone="custom_zone",
      serp_zone="custom_serp_zone"
    )
    ```
  </Accordion>

  <Accordion title="Search" description="Add advanced search parameters" icon="magnifying-glass-chart">
    Search the web using the SERP API

    ```python
    - `query`: Search query string or list of queries
    - `search_engine`: "google", "bing", or "yandex"
    - `zone`: Zone identifier (auto-configured if None)
    - `format`: "json" or "raw"
    - `method`: HTTP method
    - `country`: Two-letter country code
    - `data_format`: "markdown", "screenshot", etc.
    - `async_request`: Enable async processing
    - `max_workers`: Max parallel workers (default: 10)
    - `timeout`: Request timeout in seconds (default: 30)    
    ```
  </Accordion>

  <Accordion title="Scrape" description="Add advanced Scrape parameters" icon="spider">
    Scrape a single URL or list of URLs using the Web Unlocker API.

    ```python
    - `url`: Single URL string or list of URLs
    - `zone`: Zone identifier (auto-configured if None)
    - `format`: "json" or "raw"
    - `method`: HTTP method
    - `country`: Two-letter country code
    - `data_format`: "markdown", "screenshot", etc.
    - `async_request`: Enable async processing
    - `max_workers`: Max parallel workers (default: 10)
    - `timeout`: Request timeout in seconds (default: 30)
    ```
  </Accordion>
</AccordionGroup>

### Error handling

<AccordionGroup>
  <Accordion title="Logging" description="Enable advence logging" icon="ballot">
    Enable `VERBOSE` in the Client for advenced logging (see Client parameters)
    Use the `list_zones()` func 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 that your API key have **admin permissions**
  </Accordion>
</AccordionGroup>

### Resources

<CardGroup cols="3">
  <Card title="GitHub" icon="github" iconType="light" color="#NaNNaNNaN" href="https://github.com/brightdata/bright-data-sdk-python/tree/main" cta>
    Visit the Bright Data SDK GitHub repository
  </Card>
</CardGroup>


# Add Static IP(s)
Source: https://docs.brightdata.com/api-reference/account-management-api/Add_Static_Datacenter_ISP_IPs

POST /zone/ips
Add Static IPs for Datacenter and ISP

<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/unlocker/api_token)
</Tip>


# Add a Zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Add_a_Zone

POST /zone
Add a new zone

<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/unlocker/api_token)
</Tip>


# Change Account Status
Source: https://docs.brightdata.com/api-reference/account-management-api/Change_account_status

PUT /status

<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/unlocker/api_token)
</Tip>


# Get Available Countries
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_Available_Countries

GET /countrieslist
List all available countries per zone type 

<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/unlocker/api_token)
</Tip>


# Zone Statistics
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_Zone_Static_Datacenter_ISP_IPs

GET /zone/ips
Get Zone Static (Datacenter/ISP) IPs

<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/unlocker/api_token)
</Tip>

```json Response when "ip_per_country=true"
{
    "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

GET /zone
Get Zone status

<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/unlocker/api_token)
</Tip>


# Zone Password
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_Zone_passwords

GET /zone/passwords
Get Zone passwords

<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/unlocker/api_token)
</Tip>


# Zone Permission
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_Zone_permissions

GET /zone/permissions
Get Zone permissions

<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/unlocker/api_token)
</Tip>


# Zone status
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_Zone_status

GET /zone/status
Get Zone status

<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/unlocker/api_token)
</Tip>


# Account status
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_account_status

GET /status
Get account status

<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/unlocker/api_token)
</Tip>


# Active Zones
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_active_Zones

GET /zone/get_active_zones
Return all active zones

<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/unlocker/api_token)
</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

GET /zone/route_vips
Get all available residential dedicated IPs per Zone

<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/unlocker/api_token)
</Tip>

<Warning>Only works with residential dedicated zone</Warning>


# Amount of available Datacenter and ISP IPs
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_amount_of_available_Datacenter_and_ISP_IPs

GET /zone/count_available_ips

<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/unlocker/api_token)
</Tip>

<Accordion title="Plan Examples">
  * Available IPs for current Zone plan:

  ```sh
  curl "https://api.brightdata.com/count_available_ips?zone=ZONE" -H "Authorization: Bearer API_KEY"
  ```

  * Abstract plan, dedicated IPs:

  ```sh dedicated IPs
  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
  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
  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
  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
  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
  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

GET /cities
Get a list of cities from a Country

<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/unlocker/api_token)
</Tip>


# Get current service status
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_current_service_status

GET /network_status/{NETWORK_TYPE}

<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/unlocker/api_token)
</Tip>


# List all available country's cities (static network)
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_list_of_available_cities_of_static_network_per_country

GET /zone/static/cities
Get list of available cities of static network per country

<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/unlocker/api_token)
</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

GET /zone/ips/unavailable
Get live status of Static (Datacenter/ISP) Zone and IPs with connectivity problem

<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/unlocker/api_token)
</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

GET /zone/recent_ips

<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/unlocker/api_token)
</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

GET /zone/route_ips
Get the available Data center/ISP IPs per Zone

<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/unlocker/api_token)
</Tip>


# Bandwidth stats for a zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_the_bandwidth_stats_for_a_Zone

GET /zone/bw
Get the bandwidth stats for a Zone

<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/unlocker/api_token)
</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

GET /customer/bw
Get the bandwidth stats for all your Zones

<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/unlocker/api_token)
</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

GET /zone/cost
Get the total cost and bandwidth stats for a Zone

<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/unlocker/api_token)
</Tip>


# Total Balance
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_total_balance_through_API

GET /customer/balance
Get total balance through API

<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/unlocker/api_token)
</Tip>


# Migrate Static IPs between zones
Source: https://docs.brightdata.com/api-reference/account-management-api/Migrate_Static_Datacenter_ISP_IPs_between_zones

POST /zone/ips/migrate
Migrate Static IPs between zones (Datacenter/ISP)

<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/unlocker/api_token)
</Tip>


# Refresh Static IPs (Datacenter/ISP)
Source: https://docs.brightdata.com/api-reference/account-management-api/Refresh_Static_Datacenter_ISP_IPs

POST /zone/ips/refresh

<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/unlocker/api_token)
</Tip>

```json Sample Response for Static IPs
{
    "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

POST /zone/ips/refresh

<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/unlocker/api_token)
</Tip>

<Warning>
  Each dedicated residential IP refreshed costs \$0.02/refresh/IP
</Warning>


# Remove Static IPs (Datacenter/ISP)
Source: https://docs.brightdata.com/api-reference/account-management-api/Remove_Static_Datacenter_ISP_IPs

DELETE /zone/ips

<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/unlocker/api_token)
</Tip>


# Remove a Zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Remove_Zone

DELETE /zone

<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/unlocker/api_token)
</Tip>


# Remove dedicated residential IPs
Source: https://docs.brightdata.com/api-reference/account-management-api/Remove_dedicated_residential_IPs

DELETE /zone/vips

<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/unlocker/api_token)
</Tip>


# Switch Automatic Failover
Source: https://docs.brightdata.com/api-reference/account-management-api/Switch_100_uptime_ON_OFF_in_a_Static_zone

POST /zone/switch_100uptime
Switch automatic failover (100% uptime) ON/OFF in a Static zone

<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/unlocker/api_token)
</Tip>


# Turn on/off Zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Turn_on_off_Zone

POST /zone/change_disable

<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/unlocker/api_token)
</Tip>


# Allowlist IP(s)
Source: https://docs.brightdata.com/api-reference/account-management-api/allowlist-ip

POST /zone/whitelist
Add IP to zone's allowlist

<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/unlocker/api_token)
</Tip>


# Allowlist/Denylist Domain(s)
Source: https://docs.brightdata.com/api-reference/account-management-api/allowlist-or-denylist-domains

POST /zone/domain_perm
Add domain to Zone allowlist or denylist

<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/unlocker/api_token)
</Tip>


# Denylist IP(s)
Source: https://docs.brightdata.com/api-reference/account-management-api/denylist-ip

POST /zone/blacklist
Add IP to zone's denylist

<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/unlocker/api_token)
</Tip>


# Get Proxies Pending Replacement
Source: https://docs.brightdata.com/api-reference/account-management-api/get-proxies-pending-replacement

GET /zone/proxies_pending_replacement
Get list of all proxies in the provided zone, which are pending replacement



# Remove domain from Zone allowlist/denylist
Source: https://docs.brightdata.com/api-reference/account-management-api/remove-domain-from-zone-allowlist-or-denylist

DELETE /zone/domain_perm

<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/unlocker/api_token)
</Tip>


# Remove IP from Zone allowlist
Source: https://docs.brightdata.com/api-reference/account-management-api/remove-ip-from-zone-allowlist

DELETE /zone/whitelist

<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/unlocker/api_token)
</Tip>


# Remove IP from Zone denylist
Source: https://docs.brightdata.com/api-reference/account-management-api/remove-ip-from-zone-denylist

DELETE /zone/blacklist

<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/unlocker/api_token)
</Tip>


# List of allowlisted IPs for a zone
Source: https://docs.brightdata.com/api-reference/account-management-api/zone-ip-allowlist

GET /zone/whitelist
Get a list of allowlisted IPs for a specific Zone

<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/unlocker/api_token)
</Tip>


# List of denylisted IPs for a zone
Source: https://docs.brightdata.com/api-reference/account-management-api/zone-ip-denylist

GET /zone/blacklist
Get a list of denylisted IPs for a specific Zone

<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/unlocker/api_token)
</Tip>


# Authentication
Source: https://docs.brightdata.com/api-reference/authentication

Learn how to authenticate with Bright Data using API Access or Native Access methods.

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
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
'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 your **admin account**. Only admins can generate API keys.
    </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 zone/product configurations but restricts Billing access.
* **Limit:** Permits management of zone passwords and IP allowlists/denylists.
* **User:** Enables API usage on the zone/product 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 product zones can I access with proxy protocol?

Proxy protocol access is supported by:

* All proxy networks (Datacenter, ISP, residential & mobile)
* Web Unlocker
* Scraping browser

### How do I autheticate with native proxy username and password?

Here’s an example of a Native Access request:

```sh Sample Request
curl "https://www.example.com" \
  -i --proxy brd.superproxy.io:33335 \
  --proxy-user brd-customer-[ACCOUNT_ID]-zone-[ZONE_NAME]:[ZONE_PASSWORD]
```

The key part of this request is the `--proxy-user` parameter which holds the authentication credentials:

```sh proxy-user
brd-customer-[ACCOUNT_ID]-zone-[ZONE_NAME]:[ZONE_PASSWORD]
```

This parameter is made up of three elements combined into a single string:

1. `ACCOUNT_ID` - your unique customer identifier.
2. `ZONE_NAME` - the name of the zone you created.
3. `ZONE_PASSWORD` - the password associated with your zone.

Together, they form the complete proxy-user value.

### Username/password format

* All the parameters are case sensitive.
* There must be a consecutive string without spaces.
* `-` (dash/minus sign) separates between the username substrings, and `:` (colon) between the username string and 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 src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/authentication/account_id.png?maxW=2754&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=6b8b5f1e6abd6bdca54ff1929967c902" alt="Account ID " width="2754" height="678" data-path="images/api-reference/authentication/account_id.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/authentication/account_id.png?w=280&maxW=2754&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=dc04c7a174317b82ebab3f95cbbb88d2 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/authentication/account_id.png?w=560&maxW=2754&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=c32a4d84d42eb4c89cf946f3ef42f4e7 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/authentication/account_id.png?w=840&maxW=2754&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=2367ba0c3c5f40d1979b3fdce4050ab6 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/authentication/account_id.png?w=1100&maxW=2754&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=be70a1ec275ab866eeffc40053a4cf0f 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/authentication/account_id.png?w=1650&maxW=2754&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=378346182b62682c2a31f3464e0d4796 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/authentication/account_id.png?w=2500&maxW=2754&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=caa712e5aa007b29226189a39b3a7918 2500w" data-optimize="true" data-opv="2" />
</Frame>

<Note>
  Your Account ID is always a text string that begins with `hl_###`.
</Note>

#### Zone name

Zone is a bright data collection of configuration, for specific service. Read more about what is a zone [here](https://docs.brightdata.com/api-reference/terminology#what-is-a-zone). The zone name is set \*\*once \*\*by you when zone is created, and it cannot be changed later.

You can review all of your zone names by visiting [My zones](https://brightdata.com/cp/zones).

#### Zone password

Each **zone** is assigned a unique password that is required for authenticating both API and Native Access requests.

To view or update your zone password, follow these steps:

<Steps>
  <Step title={<>Open <a href="https://brightdata.com/cp/zones">My zones</a> in your dashboard.</>} />

  <Step title="Go to the Configuration tab." />

  <Step title="Scroll down to the Security Settings section and expand it." />

  <Step title="Copy your current password, or generate a new one if needed." />
</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**                                                           | - [Unlocker API](https://docs.brightdata.com/scraping-automation/web-unlocker)<br />- [SERP](https://docs.brightdata.com/scraping-automation/serp-api)<br />- [Browsers](https://docs.brightdata.com/scraping-automation/scraping-browser)<br />- [Scrapers](https://docs.brightdata.com/datasets/scrapers/overview)<br />- [Functions](https://docs.brightdata.com/datasets/functions/introduction)<br />- [Marketplace](https://docs.brightdata.com/datasets/marketplace) | [Proxies](https://docs.brightdata.com/proxy-networks)                                                                                                       |
| [**SSL certificate**](https://docs.brightdata.com/general/account/ssl-certificate) | Not required                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Required to access without KYC the residential network & unlocker. More info [here.](https://docs.brightdata.com/proxy-networks/residential/network-access) |
| **Connection via**                                                                 | API endpoint                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Proxy endpoint                                                                                                                                              |
| **Authentication**                                                                 | [API key](https://docs.brightdata.com/general/account/api-token)                                                                                                                                                                                                                                                                                                                                                                                                            | `username:password`                                                                                                                                         |
| **Output options**                                                                 | HTML or JSON                                                                                                                                                                                                                                                                                                                                                                                                                                                                | HTML                                                                                                                                                        |


# Deliver Snapshot
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/deliver-snapshot

dca-api POST /datasets/snapshots/{id}/deliver
Deliver the dataset snapshot



# Snapshot Content
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/download-the-file-by-snapshot_id

dca-api GET /datasets/snapshots/{id}/download
Get dataset snapshot content



# Filter Dataset (BETA)
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/filter-dataset

dca-api POST /datasets/filter
Create a dataset snapshot based on a provided filter

<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/unlocker/api_token)
</Tip>

## General Description

* A call to this endpoint starts the async job of filtering the dataset and creating a snapshot with filtered data in your account.
* The maximum amount of time for the job to finish is 5 minutes. If the job doesn't finish in this timeframe it will be cancelled.
* Creating the dataset snapshot is subject to charges based on the snapshot size and record price.
* The maximum depth of nesting the filter groups is 3.

## Modes of Use

### 1. JSON Mode (No File Uploads)

Use this when you are not uploading any files.

* All parameters (`dataset_id`, `records_limit`, and `filter`) are sent in the JSON request body.
* `Content-Type` must be `application/json`.
* No query parameters are used.

```bash Example
curl --request POST \
  --url https://api.brightdata.com/datasets/filter \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "dataset_id": "gd_l1viktl72bvl7bjuj0",
    "records_limit": 100,
    "filter": {
      "name": "name",
      "operator": "=",
      "value": "John"
    }
  }'
```

***

### 2. Multipart/Form-Data Mode (File Uploads)

Use this when uploading CSV or JSON files containing filter values.

* `dataset_id` and `records_limit` must be sent as **query parameters** in the URL.
* The `filter` and any uploaded files are included in the **form-data body**.
* `Content-Type` must be `multipart/form-data`.

```bash Example
curl --request POST \
  --url "https://api.brightdata.com/datasets/filter?dataset_id=gd_l1vijqt9jfj7olije&records_limit=100" \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'filter={"operator":"and","filters":[{"name":"industries:value","operator":"includes","value":"industries.csv"}]}' \
  --form 'files[]=@/path/to/industries.csv'
```

***

## Filter Syntax

### Operators

The following table shows operators that can be used in the field filter.

| Operator             | Field Types  | Description                                                                                                                                                                                                                                                                                                         |
| -------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| =                    | 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          | Tests if field value is equal to any of the values provided in filter's value                                                                                                                                                                                                                                       |
| not\_in              | Any          | Tests if field value is not equal to all of the values provided in filter's value                                                                                                                                                                                                                                   |
| includes             | Array, Text  | Tests if the field value contains the filter value. If the filter value is a single string, it matches records where the field value contains that string. If the filter value is an array of strings, it matches records where the field value contains a least one string from the array.                         |
| not\_includes        | Array, Text  | Tests if the field value does not contain the filter value. If the filter value is a single string, it matches records where the field value does not contain that string. If the filter value is an array of strings, it matches records where the field value does not contain any of the strings from the array. |
| array\_includes      | Array        | Tests if filter value is in field value (exact match)                                                                                                                                                                                                                                                               |
| not\_array\_includes | Array        | Tests if filter value is not in field value (exact match)                                                                                                                                                                                                                                                           |
| is\_null             | Any          | Tests if the field value is equal to NULL. Operator does not accept any value.                                                                                                                                                                                                                                      |
| is\_not\_null        | Any          | Tests if the field value is not equal to NULL. Operator does not accept any value.                                                                                                                                                                                                                                  |

### Combining Multiple Filters

Multiple field filters can be combined into the filter group using 2 logical operators: 'and', 'or'.
API supports filters with a maximum nesting depth of 3.
Example of filter group:

```json
{
    // operator can be one of ["and", "or"]
    "operator": "and",
    // an array of field filters
    "filters": [
        {
            "name": "reviews_count",
            "opeartor": ">",
            "value": "200"
        },
        {
            "name": "rating",
            "operator": ">",
            "value": "4.5"
        }
    ]
}
```


# Filter Dataset (JSON or File Uploads)
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/filter-dataset-with-csv-json-files

filter-csv-json POST /datasets/filter
Create a dataset snapshot based on a provided 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/unlocker/api_token).
</Tip>

## General Description

* This endpoint filters a dataset and creates a snapshot of the filtered data in your account.
* The job runs asynchronously and can take up to 5 minutes to complete. If it exceeds this time, it will be cancelled.
* Charges apply based on the size of the snapshot and per-record pricing.
* Filters can have up to 3 levels of nested filter groups.
* You can upload CSV or JSON files for efficient filtering when handling large sets of values.

***

## File Format Requirements

<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
    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
    [
      {"industries:value": "Accounting"},
      {"industries:value": "Ad Network"},
      {"industries:value": "Advertising"}
    ]
    ```
  </Tab>
</Tabs>

***

## Filter Syntax with File References

When using file uploads, reference the filename in the filter's `value` field.

```json Example
{
  "operator": "and",
  "filters": [
    {
      "name": "industries:value",
      "operator": "includes",
      "value": "industries.csv"
    }
  ]
}
```

### **Supported Operators for File References**

| Operator             | Field Types | Description                                    |
| :------------------- | :---------- | :--------------------------------------------- |
| `in`                 | Any         | Field value equals any value in file           |
| `not_in`             | Any         | Field value does not equal any value in file   |
| `includes`           | Array, Text | Field value contains any value in file         |
| `not_includes`       | Array, Text | Field value does not contain any value in file |
| `array_includes`     | Array       | Any value in file exists in field value        |
| `not_array_includes` | Array       | No values in file exist in field value         |

***

## Example: Filtering with Multiple Files

```bash
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\"}]}" \
  "api.brightdata.com/datasets/filter?dataset_id=gd_l1vijqt9jfj7olije"
```

## Troubleshooting

| 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 Documentation

* [Get Dataset List](/api-reference/marketplace-dataset-api/get-dataset-list)
* [Get Dataset Metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata)
* [Dataset Download API](/datasets/custom-datasets/custom-dataset-api)


# Dataset list
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-dataset-list

dca-api GET /datasets/list
List all Dataset IDs of all Scraper APIs, you can use this API endpoint to retrieve a list of available datasets.

<a href="https://www.postman.com/bright-data-api/bright-data-api/request/1o6iob0/dataset-list" target="_blank">
  <img height="32" width="128" noZoom src="https://run.pstmn.io/button.svg" />
</a>


# Get Dataset Metadata
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-dataset-metadata

dca-api GET /datasets/{dataset_id}/metadata

<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/unlocker/api_token).
</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**

```
GET http://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
{
    "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**

```
GET http://api.brightdata.com/datasets/gd_l1vijqt9jfj7olije/metadata
```

#### **Response**

```json
{
    "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](./get-dataset-list.md)
* [Dataset Filtering API](./filter-dataset.md)
* [Dataset Download API](./download-dataset.md)


# Get Snapshot Metadata
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-snapshot-meta

dca-api GET /datasets/snapshots/{id}
Get dataset snapshot metadata



# Get Snapshot Parts
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-snapshot-parts

dca-api GET /datasets/snapshots/{id}/parts
Get dataset snapshot delivery parts. All query parameters used here need to match those used when downloading the snapshot to get accurate parts



# Troubleshooting
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/troubleshooting

This section covers errors encountered when interacting directly with Bright Data's Unlocker API, SERP API, Web Scraper API, Marketplace Dataset API, and Web Scraper IDE.

## Proxy networks troubleshooting

Error codes and description for proxy networks can be found [here](https://docs.brightdata.com/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. Our team 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`       | Web Scraper IDE API, Marketplace Dataset API                                            | The specified request ID or other request details were not found in our system. | 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 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 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 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. |

***

### Appendix

**Sources:**

* [http://cvs.brightdata.com/cvs/zon/pkg/www/dca/pub/util.js?rev=1.197](http://cvs.brightdata.com/cvs/zon/pkg/www/dca/pub/util.js?rev=1.197)
* pkg/www/dca/dataset\_ext\_api.js

> Some error codes (e.g., 400, 404) may have multiple causes, as outlined above.\
> Error messages are designed to provide clear feedback to users about the issue and how to resolve it.\
> For errors with dynamic content (e.g., balance or job limits), placeholders like `${max_parallel_jobs}` or `${init_types}` are replaced with actual values at runtime.


# Bright Data API Postman collection
Source: https://docs.brightdata.com/api-reference/postman-collection

Quickly test and explore Bright Data's APIs using our Postman collection. View, run, and fork API requests without setting up your own backend environment.

<div id="brd-docs-postman-collection-try-cta-1">
  <Card title="Postman collection" icon="user-astronaut" iconType="regular" href="https://www.postman.com/bright-data-api/bright-data-api/collection/2f4u0m8/bright-data-api-collection" cta="Try Bright Data APIs in few seconds" />
</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](/general/account/api-token)
2. **Update Postman collection environment variable**: Set your `BRIGHT_DATA_API_KEY` in the Postman collection environment variables under Production environment.
   <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/postman-collection-environment-varaible.jpg?maxW=4056&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=7615406ec356f39756b872862bbcdd8e" alt="postman-collection-environment-varaible.jpg" width="4056" height="2732" data-path="images/postman-collection-environment-varaible.jpg" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/postman-collection-environment-varaible.jpg?w=280&maxW=4056&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=a11a04c66ec969c7e11b9b44247af9fe 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/postman-collection-environment-varaible.jpg?w=560&maxW=4056&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=193f6dba4908fabde4254e9d84d22ea9 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/postman-collection-environment-varaible.jpg?w=840&maxW=4056&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=46f2d593e0da81f29d64966e720ea61f 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/postman-collection-environment-varaible.jpg?w=1100&maxW=4056&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=00fdb01a0722a0b25dcd51f74d43d7b0 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/postman-collection-environment-varaible.jpg?w=1650&maxW=4056&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=1f71c368b28662f7157be46b54713186 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/postman-collection-environment-varaible.jpg?w=2500&maxW=4056&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=88b1aa54343d0200cb02e5d96d14580b 2500w" data-optimize="true" data-opv="2" />
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>


# Add a User
Source: https://docs.brightdata.com/api-reference/proxy-manager/add_a_user



**API endpoint:** `POST` `/api/lpm_user`

## `POST` body

<ParamField body="email" type="string" required>
  User email address to add
</ParamField>

{/* TODO: Missing Sample Response */}

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/lpm_user" -H "Content-Type: application/json" -d '{"email":"test@example.com"}'
  ```

  ```js NodeJS
  #!/usr/bin/env node
  require('request-promise')({
      method: 'POST',
      url: 'http://127.0.0.1:22999/api/lpm_user',
      json: {'email':'test@example.com'}

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python
  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

  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



**API endpoint:** `PUT` `/api/wip`

<ParamField header="Authorization" type="string" required>
  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 body="ip" type="string" required>
  IP to allowlist. e.g, `ip="1.2.1.2"`
</ParamField>

<RequestExample>
  ```sh Shell
  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
  #!/usr/bin/env node

  require('request-promise')({
    method: 'PUT',
    url: 'http://127.0.0.1:22999/api/wip',
    json: {'ip':'1.2.1.2'},
    headers: {'Authorization': 'API key'},
  }).then(function(data){ console.log(data);},

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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
  Successful response
  ```

  ```json 400
  Bad request. No IP was passed
  ```

  ```json 403
  Forbidden. No authentication provided
  ```

  ```json 422
  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



API endpoint: `POST` `/api/banip`

## `POST` body

<ParamField body="ip" type="string" required>
  IP to ban. e.g. `1.2.1.2`
</ParamField>

<ParamField body="domain" type="string">
  Ban the IP for sending requests to the specified domain
</ParamField>

<ParamField body="ms" type="integer">
  Ban the IP for specified milliseconds
</ParamField>

<RequestExample>
  ```sh Shell
  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
  #!/usr/bin/env node

  require('request-promise')({

  method: 'POST',

  url: 'http://127.0.0.1:22999/api/banip',

  json: {'ip':'1.2.1.2','domain':'example.com','ms':60000}

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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/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
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  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_



**API endpoint:** `POST` `/api/proxies/{PORT}/banip`

## Path Parameter

<ParamField body="PORT" type="string" required>
  Existing proxy port number
</ParamField>

## `POST` body

<ParamField body="ip" type="string" required>
  IP to ban. e.g. `1.2.1.2`
</ParamField>

<ParamField body="domain" type="string">
  Ban the IP for sending requests to the specified domain
</ParamField>

<ParamField body="ms" type="integer">
  Ban the IP for specified milliseconds
</ParamField>

<RequestExample>
  ```sh Shell
  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
  #!/usr/bin/env node

  require('request-promise')({
    method: 'POST',
    url: 'http://127.0.0.1:22999/api/proxies/{PORT}/banip',
    json: {'ip':'1.2.1.2','domain':'example.com','ms':60000}
  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');
  import requests


  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_



**API endpoint:** `POST` `/api/proxies/{PORT}/banips`

## Path Parameter

<ParamField body="PORT" type="string" required>
  Existing proxy port number
</ParamField>

## `POST` body

<ParamField body="ips" type="array" required>
  IPs to ban. e.g. \["10.0.0.1","20.0.0.1"]
</ParamField>

<ParamField body="domain" type="string">
  Ban the IP for sending requests to the specified domain
</ParamField>

<ParamField body="ms" type="integer">
  Ban the IP for specified milliseconds
</ParamField>

<RequestExample>
  ```sh Shell
  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
  #!/usr/bin/env node
  require('request-promise')({
      method: 'POST',
      url: 'http://127.0.0.1:22999/api/proxies/{PORT}/banips',
      json: {'ips':['10.0.0.1','20.0.0.1'],'domain':'example.com','ms':60000}
  }).then(function(data){ console.log(data);},

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  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



**API endpoint:** `POST` `/api/proxies`

## `POST` body

<ParamField body="proxy" type="User Object">
  <Expandable title="properties">
    <ParamField body="port" type="integer">
      Port for the HTTP proxy
    </ParamField>

    <ParamField body="proxy_type" type="string">
      Set to `persist` to save proxy into the configuration file.
    </ParamField>

    <ParamField body="multiply" type="integer">
      Multiply the port definition given number of times
    </ParamField>

    <ParamField body="multiply_users" type="boolean" />

    <ParamField body="users" type="array">
      List of `user`s `[string]`. This option has to be used along with `multiply_users`
    </ParamField>

    <ParamField body="ssl" type="boolean">
      Enable SSL analyzing
    </ParamField>

    <ParamField body="tls_lib" type="string">
      Choose the SSL library

      | value      | description      |
      | ---------- | ---------------- |
      | `open_ssl` | Open SSL Library |
      | `flex_tls` | Flex TLS Library |
    </ParamField>

    <ParamField body="iface" type="string">
      Interface or IP to listen on
    </ParamField>

    <ParamField body="customer" type="string">
      Customer name
    </ParamField>

    <ParamField body="zone" type="string">
      Zone name
    </ParamField>

    <ParamField body="password" type="string">
      Zone password
    </ParamField>

    <ParamField body="proxy" type="string">
      Hostname or IP of super proxy
    </ParamField>

    <ParamField body="proxy_port" type="integer">
      Super proxy port
    </ParamField>

    <ParamField body="proxy_connection_type" type="string">
      Determines what kind of connection will be used between Proxy Manager and Super Proxy

      |         |   |
      | ------- | - |
      | `http`  |   |
      | `https` |   |
      | `socks` |   |
    </ParamField>

    <ParamField body="proxy_retry" type="integer">
      Automatically retry on super proxy failure
    </ParamField>

    <ParamField body="insecure" type="boolean">
      Enable SSL connection/analyzing to insecure hosts
    </ParamField>

    <ParamField body="country" type="string">
      Country
    </ParamField>

    <ParamField body="state" type="string">
      State
    </ParamField>

    <ParamField body="city" type="string">
      City
    </ParamField>

    <ParamField body="asn" type="string">
      ASN
    </ParamField>

    <ParamField body="ip" type="string">
      Data Center IP
    </ParamField>

    <ParamField body="vip" type="integer">
      gIP
    </ParamField>

    <ParamField body="ext_proxies" type="array">
      A list of proxies from external vendors. Format: \[username:password@]ip\[:port]

      * proxy\[string]
    </ParamField>

    <ParamField body="ext_proxy_username" type="string">
      Default username for external vendor ips
    </ParamField>

    <ParamField body="ext_proxy_password" type="string">
      Default password for external vendor ips
    </ParamField>

    <ParamField body="ext_proxy_port" type="integer">
      Default port for external vendor ips
    </ParamField>

    <ParamField body="dns" type="string">
      DNS resolving

      |          |   |
      | -------- | - |
      | `local`  |   |
      | `remote` |   |
    </ParamField>

    <ParamField body="reverse_lookup_dns" type="boolean">
      Process reverse lookup via DNS
    </ParamField>

    <ParamField body="reverse_lookup_file" type="string">
      Process reverse lookup via file
    </ParamField>

    <ParamField body="reverse_lookup_values" type="array">
      Process reverse lookup via value
    </ParamField>

    <ParamField body="session" type="string">
      Session for all proxy requests
    </ParamField>

    <ParamField body="sticky_ip" type="boolean">
      Use session per requesting host to maintain IP per host
    </ParamField>

    <ParamField body="pool_size" type="integer" />

    <ParamField body="rotate_session" type="boolean">
      Session pool size
    </ParamField>

    <ParamField body="throttle" type="integer">
      Throttle requests above given number
    </ParamField>

    <ParamField body="rules" type="array">
      Proxy request rules
    </ParamField>

    <ParamField body="route_err" type="string">
      Block or allow requests to be automatically sent through super proxy on error
    </ParamField>

    <ParamField body="smtp" type="array" />

    <ParamField body="override_headers" type="string" />

    <ParamField body="os" type="string">
      Operating System of the Peer IP
    </ParamField>

    <ParamField body="headers" type="array">
      Request headers
    </ParamField>

    * name\[string]
    * value\[string]

    <ParamField body="debug" type="string">
      Request debug info

      |        |   |
      | ------ | - |
      | `full` |   |
      | `none` |   |
    </ParamField>

    <ParamField body="lpm_auth" type="string">
      x-lpm-authorization header
    </ParamField>

    <ParamField body="const" type="boolean" />

    <ParamField body="socket_inactivity_timeout" type="integer" />

    <ParamField body="multiply_ips" type="boolean" />

    <ParamField body="multiply_vips" type="boolean" />

    <ParamField body="max_ban_retries" type="integer" />

    <ParamField body="preset" type="string" />

    <ParamField body="ua" type="boolean">
      Unblocker Mobile UA
    </ParamField>

    <ParamField body="timezone" type="string">
      Timezone ID to be used by the browser
    </ParamField>

    <ParamField body="resolution" type="string">
      Browser screen size
    </ParamField>

    <ParamField body="webrtc" type="string">
      WebRTC plugin behavior in the browser
    </ParamField>

    <ParamField body="bw_limit" 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 body="create_users" type="boolean">
  {/* TODO: Add description */}
</ParamField>

<ResponseExample>
  ```JSON Sample Response
  {
  	"port":24000,
  	"zone":"zone_name",
  	"proxy_type":"persist",
  	"customer":"customer_id",
  	"password":"password",
  	"whitelist_ips":[]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  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
  #!/usr/bin/env node

  require('request-promise')({
  method: 'POST',
  method: 'POST',

  	method: 'POST',

  	url: 'http://127.0.0.1:22999/api/proxies',
  	json: {'proxy':{'port':24000,'zone': 'ZONE','proxy_type':'persist','customer':'CUSTOMER','password':'password','whitelist_ips':[]}}
  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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



**API endpoint:** `DELETE` `/api/proxies/{PORT}`

## Path Parameter

<ParamField body="PORT" type="string" required>
  Existing proxy port number
</ParamField>

<RequestExample>
  ```sh Shell
  curl -X DELETE "http://127.0.0.1:22999/api/proxies/{PORT}"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  method: 'DELETE',

  url: 'http://127.0.0.1:22999/api/proxies/{PORT}'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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



**API endpoint:** `POST /api/proxies/delete`

## `POST` body

<ParamField body="ports" type="array" required>
  Array of ports
</ParamField>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/proxies/delete" -H "Content-Type: application/json" -d '{"ports":[24000,24001]}'
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  method: 'POST',

  url: 'http://127.0.0.1:22999/api/proxies/delete',

  json: {'ports':[24000,24001]}

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  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



**API endpoint:** `POST` `/api/enable_ssl`

<RequestExample>
  ```sh
  curl -X POST "http://127.0.0.1:22999/api/enable_ssl"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({
      method: 'POST',
      url: 'http://127.0.0.1:22999/api/enable_ssl'
  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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 API key for Token based Authentication

**API endpoint:** `GET` `/api/gen_token`

<ResponseExample>
  ```json Sample Response
  {
      "token": "RZD9vaQQaL6En7"
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/gen_token"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/gen_token'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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



**API endpoint:** `GET` `/api/lpm_users`

<ResponseExample>
  ```JSON Sample Response
  [
      {
          "email": "test@example.com",
          "password":"password"
      }
  ]
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/lpm_users"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/lpm_users'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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



**API endpoint:** `GET` `/api/allocated_vips`

## Query Parameter

<ParamField query="zone" type="string">
  Residential/Mobile exclusive zone name
</ParamField>

<ResponseExample>
  ```json Sample Response
  {
      "ips": [
          "gIP_1",
          "gIP_2"
      ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/allocated_vips?zone=ZONE"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/allocated_vips?zone=ZONE'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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



**API endpoint:** `GET` `/api/allocated_ips`

## Query Parameter

<ParamField query="zone" type="string">
  Static (Datacenter/ISP) zone name
</ParamField>

<ResponseExample>
  ```JSON Sample Response
  {
      "ips": [
          "10.0.0.1",
          "20.0.0.1"
      ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/allocated_ips?zone=ZONE"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/allocated_ips?zone=ZONE'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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



**API endpoint:** `GET` `/api/banlist/{PORT}`

<ParamField query="full" 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
  {
      "ips": [
          "10.20.30.40",
          "50.60.70.80|example.com"
      ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/banlist/{PORT}?full=true"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/banlist/{PORT}?full=true'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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



**API endpoint:** `GET` `/api/node_version`

<ResponseExample>
  ```JSON Sample Response
  {
      "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>

{/* TODO: Missing Code Examples */}


# Get effective configuration for all running proxies
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_effective_configuration_for_all_running_proxies



**API endpoint:** `GET` `/api/proxies_running`

<ResponseExample>
  ```JSON Sample Response
  [
      {
          "port": 24000,
          "zone": "ZONE",
          "proxy_type": "persist",
          "customer": "CUSTOMER",
          "password": "password",
          "whitelist_ips":[]
      }
  ]
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/proxies_running"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/proxies_running'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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



**API endpoint:** `GET` `/api/zones`

<ResponseExample>
  ```JSON Sample Response
  {
      "name": "ZONE",
      "perm": "country ip route_all route_dedicated",
      "plan": {},
      "password":"password"
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/zones"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/zones'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python


  import requests


  r = requests.get('http://127.0.0.1:22999/api/zones')

  print(r.content)
  ```
</RequestExample>


# Get explicit configuration of specified Proxies
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_explicit_configuration_of_all_or_specified_proxies



**API endpoint:** `GET` `/api/proxies/{PORT}`

<ParamField path="PORT" type="string">
  PORT parameter is optional. You can skip it to fetch all the proxies\*
</ParamField>

<ResponseExample>
  ```JSON Sample Response
  [
      {"port": 24000,
      "zone": "ZONE",
      "proxy_type": "persist",
      "customer": "CUSTOMER",
      "password": "password",
      "whitelist_ips": []
      },
      {
          "port": 33335,
          "zone": "ZONE",
          "listen_port": 33335,
          "customer": "CUSTOMER",
          "password":"password"
      }
  ]
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/proxies/{PORT}"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/proxies/{PORT}'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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



**API endpoint:** `GET` `/api/settings`

<ResponseExample>
  ```JSON Sample Response
  {
      "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://lumtest.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
  curl "http://127.0.0.1:22999/api/settings"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/settings'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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



API endpoint: `GET` `/api/logs`

<ParamField query="limit" type="integar">
  Number of logs to get from tail
</ParamField>

<ParamField query="skip" type="integar">
  Number of logs to get from tail
</ParamField>

<ParamField query="limit" type="integar">
  Maximum number of requests to be fetched
</ParamField>

<ParamField query="search" type="string">
  regex search query for the URL
</ParamField>

<ParamField query="port_from" type="string">
  lower bound for port number
</ParamField>

<ParamField query="port_to" type="string">
  upper bound for port number
</ParamField>

<ParamField query="status_code" type="string">
  filter requests by status code
</ParamField>

<ParamField query="sort" type="string">
  parameter to be sorted by
</ParamField>

<ParamField query="sort_desc" type="boolean">
  is descending sorting direction
</ParamField>

{/* TODO: Missing Sample Response */}

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/logs"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({
      url: 'http://127.0.0.1:22999/api/logs'
  }).then(function(data){ console.log(data);},

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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



**API endpoint:** `GET` `/api/version`

<ResponseExample>
  ```json Sample Response
  {
    "version":"1.280.385",
    "argv":""
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/version"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/version'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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# 
  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
  #!/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



**API endpoint:** `GET` `/api/proxy_status/{PORT}`

<ParamField path="PORT" type="string">
  Existing proxy port number
</ParamField>

<ResponseExample>
  ```JSON Sample Response
  {
      "status":"ok",
      "status_details":[]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/proxy_status/{PORT}"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/proxy_status/{PORT}'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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



**API endpoint:** `GET /api/recent_stats`

<ResponseExample>
  ```JSON Sample Response
  {
      "ports": {},
      "status_code": [],
      "hostname": [],
      "protocol": [],
      "total": 0,
      "success": 0,
      "ssl_enable":true}
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/recent_stats"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/recent_stats'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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



**API endpoint:** `GET` `/api/general_logs`

<ParamField query="limit" type="integer">
  Number of logs to get from tail
</ParamField>

{/* TODO: Missing Sample Response */}

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/general_logs?limit=5"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/general_logs?limit=5'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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



**API endpoint:** `GET` `/api/last_version`

<ResponseExample>
  ```json Sample Response
  {
    "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
  curl "http://127.0.0.1:22999/api/last_version"
  ```

  ```js NodeJS
  #!/usr/bin/env node  
    
  require('request-promise')({  
    
  url: 'http://127.0.0.1:22999/api/last_version'  
    
  }).then(function(data){ console.log(data); },  
    
  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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



**API endpoint:** `POST` `/api/refresh_ips`

## `POST` body

<ParamField body="zone" type="string" required>
  Zone name
</ParamField>

<ParamField body="ips" type="array">
  Static IPs. e.g. `ips=["ip1","ip2"]`
</ParamField>

<ParamField body="vips" type="array">
  gIPs. e.g. `vips=["gip1","gip2"] [array]`
</ParamField>

<ResponseExample>
  ```json Sample Response
  {
    "ips": [
  	{
  	  "ip":"10.0.0.1",
  	  "maxmind":"us"
  	},
  	{
  	  "ip":"20.0.0.1",
  	  "maxmind":"us"
  	}
    ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  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
  #!/usr/bin/env node

  require('request-promise')({
  method: 'POST',
  url: 'http://127.0.0.1:22999/api/refresh_ips',
  json: {'zone':'ZONE','ips':['10.0.0.1']}
  }).then(function(data){ console.log(data); },
  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python

  import requests

  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



**API endpoint:** `GET` `/api/refresh_sessions/{PORT}`

## Path Parameter

<ParamField path="PORT" type="string" required>
  Existing proxy port number
</ParamField>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/refresh_sessions/{PORT}"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/refresh_sessions/{PORT}'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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



**API endpoint:** `POST` `/api/restart`

<RequestExample>
  ```sh Shell
  curl -X POST "http://127.0.0.1:22999/api/restart"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  method: 'POST',

  url: 'http://127.0.0.1:22999/api/restart'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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



**API endpoint:** `POST` `/api/shutdown`

<RequestExample>
  ```sh Shell
  curl -X POST "http://127.0.0.1:22999/api/shutdown"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  method: 'POST',

  url: 'http://127.0.0.1:22999/api/shutdown'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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



**API endpoint:** `PUT` `/api/add_whitelist_ip`

<ParamField header="Authorization" type="string" required>
  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 body="ip" type="string" required>
  IP to allowlist e.g. `ip="1.2.1.2"`
</ParamField>

<RequestExample>
  ```sh Shell
  curl -X PUT "http://127.0.0.1:22999/api/whitelist_ip" -H "Authorization: API key" -H "Content-Type: application/json" -d '{"ip":"1.2.1.2"}'
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({
    method: 'PUT',
    url: 'http://127.0.0.1:22999/api/add_whitelist_ip',
    json: {'ip':'1.2.1.2'},
    headers: {'Authorization': 'API key'},
  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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)

  )

  print(r.content)
  ```
</RequestExample>


# Unban an IP
Source: https://docs.brightdata.com/api-reference/proxy-manager/unban_an_ip



**API endpoint:** `POST` `/api/proxies/{PORT}/unbanip`

## Path Parameter

<ParamField path="PORT" type="string" required>
  Existing proxy port number
</ParamField>

## `POST` body

<ParamField body="ip" type="string" required>
  IP to unban. e.g. `ip="1.2.1.2"`
</ParamField>

<ParamField body="domain" type="string">
  Unban the IP for sending requests to the specified domain.
</ParamField>

<RequestExample>
  ```sh Shell
  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
  #!/usr/bin/env node

  require('request-promise')({
      method: 'POST',
      url: 'http://127.0.0.1:22999/api/proxies/{PORT}/unbanip',
      json: {
          'ip': '1.2.1.2',
          'domain': 'example.com'
      }
  }).then(function(data){ console.log(data);},
  function(err){ console.error(err);});
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

   

  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



**API endpoint:** `POST` `/api/proxies/{PORT}/unbanips`

## Path Parameter

<ParamField path="PORT" type="string" required>
  Existing proxy port number
</ParamField>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/proxies/{PORT}/unbanips"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({
      method: 'POST',
      url: 'http://127.0.0.1:22999/api/proxies/{PORT}/unbanips'
  }).then(function(data){ console.log(data);},

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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



**API endpoint:** `PUT` `/api/proxies/{PORT}`

## Path Parameter

<ParamField path="PORT" type="string" required>
  Existing proxy port number
</ParamField>

## `PUT` body

<ParamField body="proxy" type="User Object">
  <Expandable title="properties">
    <ParamField body="port" type="integer">
      Port for the HTTP proxy
    </ParamField>

    <ParamField body="proxy_type" type="string">
      Set to `persist` to save proxy into the configuration file.
    </ParamField>

    <ParamField body="multiply" type="integer">
      Multiply the port definition given number of times
    </ParamField>

    <ParamField body="multiply_users" type="boolean" />

    <ParamField body="users" type="array">
      List of `user`s `[string]`. This option has to be used along with `multiply_users`
    </ParamField>

    <ParamField body="ssl" type="boolean">
      Enable SSL analyzing
    </ParamField>

    <ParamField body="tls_lib" type="string">
      Choose the SSL library

      | value      | description      |
      | ---------- | ---------------- |
      | `open_ssl` | Open SSL Library |
      | `flex_tls` | Flex TLS Library |
    </ParamField>

    <ParamField body="iface" type="string">
      Interface or IP to listen on
    </ParamField>

    <ParamField body="customer" type="string">
      Customer name
    </ParamField>

    <ParamField body="zone" type="string">
      Zone name
    </ParamField>

    <ParamField body="password" type="string">
      Zone password
    </ParamField>

    <ParamField body="proxy" type="string">
      Hostname or IP of super proxy
    </ParamField>

    <ParamField body="proxy_port" type="integer">
      Super proxy port
    </ParamField>

    <ParamField body="proxy_connection_type" type="string">
      Determines what kind of connection will be used between Proxy Manager and Super Proxy

      |         |   |
      | ------- | - |
      | `http`  |   |
      | `https` |   |
      | `socks` |   |
    </ParamField>

    <ParamField body="proxy_retry" type="integer">
      Automatically retry on super proxy failure
    </ParamField>

    <ParamField body="insecure" type="boolean">
      Enable SSL connection/analyzing to insecure hosts
    </ParamField>

    <ParamField body="country" type="string">
      Country
    </ParamField>

    <ParamField body="state" type="string">
      State
    </ParamField>

    <ParamField body="city" type="string">
      City
    </ParamField>

    <ParamField body="asn" type="string">
      ASN
    </ParamField>

    <ParamField body="ip" type="string">
      Data Center IP
    </ParamField>

    <ParamField body="vip" type="integer">
      gIP
    </ParamField>

    <ParamField body="ext_proxies" type="array">
      A list of proxies from external vendors. Format: \[username:password@]ip\[:port]

      * proxy\[string]
    </ParamField>

    <ParamField body="ext_proxy_username" type="string">
      Default username for external vendor ips
    </ParamField>

    <ParamField body="ext_proxy_password" type="string">
      Default password for external vendor ips
    </ParamField>

    <ParamField body="ext_proxy_port" type="integer">
      Default port for external vendor ips
    </ParamField>

    <ParamField body="dns" type="string">
      DNS resolving

      |          |   |
      | -------- | - |
      | `local`  |   |
      | `remote` |   |
    </ParamField>

    <ParamField body="reverse_lookup_dns" type="boolean">
      Process reverse lookup via DNS
    </ParamField>

    <ParamField body="reverse_lookup_file" type="string">
      Process reverse lookup via file
    </ParamField>

    <ParamField body="reverse_lookup_values" type="array">
      Process reverse lookup via value
    </ParamField>

    <ParamField body="session" type="string">
      Session for all proxy requests
    </ParamField>

    <ParamField body="sticky_ip" type="boolean">
      Use session per requesting host to maintain IP per host
    </ParamField>

    <ParamField body="pool_size" type="integer" />

    <ParamField body="rotate_session" type="boolean">
      Session pool size
    </ParamField>

    <ParamField body="throttle" type="integer">
      Throttle requests above given number
    </ParamField>

    <ParamField body="rules" type="array">
      Proxy request rules
    </ParamField>

    <ParamField body="route_err" type="string">
      Block or allow requests to be automatically sent through super proxy on error
    </ParamField>

    <ParamField body="smtp" type="array" />

    <ParamField body="override_headers" type="string" />

    <ParamField body="os" type="string">
      Operating System of the Peer IP
    </ParamField>

    <ParamField body="headers" type="array">
      Request headers
    </ParamField>

    * name\[string]
    * value\[string]

    <ParamField body="debug" type="string">
      Request debug info

      |        |   |
      | ------ | - |
      | `full` |   |
      | `none` |   |
    </ParamField>

    <ParamField body="lpm_auth" type="string">
      x-lpm-authorization header
    </ParamField>

    <ParamField body="const" type="boolean" />

    <ParamField body="socket_inactivity_timeout" type="integer" />

    <ParamField body="multiply_ips" type="boolean" />

    <ParamField body="multiply_vips" type="boolean" />

    <ParamField body="max_ban_retries" type="integer" />

    <ParamField body="preset" type="string" />

    <ParamField body="ua" type="boolean">
      Unblocker Mobile UA
    </ParamField>

    <ParamField body="timezone" type="string">
      Timezone ID to be used by the browser
    </ParamField>

    <ParamField body="resolution" type="string">
      Browser screen size
    </ParamField>

    <ParamField body="webrtc" type="string">
      WebRTC plugin behavior in the browser
    </ParamField>

    <ParamField body="bw_limit" 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
  {
      "port":24000,
      "zone":"ZONE",
      "proxy_type":"persist",
      "customer":"CUSTOMER",
      "password":"password",
      "whitelist_ips":[]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  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
  #!/usr/bin/env node

  require('request-promise')({

  method: 'PUT',

  url: 'http://127.0.0.1:22999/api/proxies/{PORT}',

         json: {'proxy':{'port':24000,'zone': 'ZONE','proxy_type':'persist','customer':'CUSTOMER','password':'password','whitelist_ips':[]}}

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python

  import requests


  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



**API Endpoint:** `PUT` `/api/settings`

## `PUT` Body:

<ParamField body="zone" type="string">
  Default zone
</ParamField>

<ParamField body="www_whitelist_ips" type="array">
  Allowlist ip list for granting access to browser admin UI
</ParamField>

<ParamField body="whitelist_ips" type="array">
  Default for all proxies allowlist ip list for granting access to them
</ParamField>

<ParamField body="logs" type="integer">
  Number of request logs to store
</ParamField>

<ParamField body="request_stats" type="boolean">
  Enable requests statistics
</ParamField>

<ResponseExample>
  ```JSON Sample Response
  {
      "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://lumtest.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
  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
  #!/usr/bin/env node

  require('request-promise')({

  method: 'PUT',

  url: 'http://127.0.0.1:22999/api/settings',

         json: {'zone': 'ZONE','www_whitelist_ips':'[]','whitelist_ips':'[]','logs':1000,'request_stats':true}

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

   

  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



**API endpoint:** `POST` `/api/upgrade`

<RequestExample>
  ```sh Shell
  curl -X POST "http://127.0.0.1:22999/api/upgrade"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  method: 'POST',

  url: 'http://127.0.0.1:22999/api/upgrade'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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



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
  curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-c_tag-<C_TAG_VALUE>:<zone_password>
  ```

  ```js Output headers
  x-brd-c_tag: <C_TAG_VALUE>
  ```
</CodeGroup>


# Carrier-specific Proxy peer IP (Mobile only)
Source: https://docs.brightdata.com/api-reference/proxy/carrier_specific_proxy_peer_ip_mobile_only_



* You can choose to use a specific carrier from this list: a1, \[aircel]\(<code>%20</code>), airtel, att, celcom, chinamobile, claro, comcast, cox, digi, dt, docomo, dtac, etisalat, idea, kyivstar, meo, megafon, mtn, mtnza, mts, optus, orange, qwest, reliance\_jio, robi, sprint, telefonica, telstra, tmobile, tigo, tim, verizon, vimpelcom, vodacomza, vodafone, vivo, zain, vivabo, telenormyanmar, kcelljsc, swisscom, singtel, asiacell, windit, cellc, ooredoo, drei, umobile, cableone, proximus, tele2, mobitel, o2, bouygues, free, sfr, digicel
* Example for carrier Deutsche Telekom:

<CodeGroup>
  ```sh Carrier: Deutsche Telekom
  brd-customer-<customer_id>-zone-<zone_name>-carrier-dt
  ```

  ```sh Carrier: Sprint
  brd-customer-<customer_id>-zone-<zone_name>-carrier-sprint
  ```
</CodeGroup>


# Configuring DNS Resolution
Source: https://docs.brightdata.com/api-reference/proxy/configuring_dns_resolution



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)
  curl "https://example.com" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-dns-local:<zone_password>
  ```

  ```sh DNS (Remote)
  curl "https://example.com" --proxy brd.superproxy.io:33335 --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>


# Geolocation Targeting
Source: https://docs.brightdata.com/api-reference/proxy/geolocation-targeting

Geolocation targeting allows you to target specific locations based on `Country`, `City`, `State`, `ASN`, or `ZIP code`

## 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
curl "https://example.com" --proxy brd.superproxy.io:33335 --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 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
curl "https://example.com" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us-city-sanfrancisco:<zone_password>
```

## State Targeting

<Note> Residential proxies only </Note>

For relevant counties (e.g., USA and Australia), you can target a state within a country by adding to the `username-country-country_code-state-state_code`. Use only two-letter state codes in lowercase.

<CodeGroup>
  ```sh Country: USA
  curl "https://example.com" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us-state-ny:<zone_password> 
  ```

  ```sh Country: Australia
  curl "https://example.com" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-au-state-wa:<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
curl "https://example.com" --proxy brd.superproxy.io:33335 --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
curl "https://example.com" --proxy brd.superproxy.io:33335 --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



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
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
curl "http://target.site" --proxy brd.superproxy.io:33335 --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



Bright Data allows targeting the following **Operating Systems**:

<CodeGroup>
  ```sh Windows
  curl "https://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-windows:<password>
  ```

  ```sh macOS
  curl "https://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-osx:<password>
  ```

  ```sh Android
  curl "https://target.site" --proxy brd.superproxy.io:33335 --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



| 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
  curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-route_err-pass_dyn:<zone_password>
  ```

  ```sh block
  curl "http://target.site" --proxy brd.superproxy.io:33335 --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 does proxy IP rotation work, and how can you configure or control it. 

## 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
curl "http://target.site" --proxy brd.superproxy.io:33335 --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
curl "http://target.site" --proxy brd.superproxy.io:33335 --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, is 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
curl "http://target.site" --proxy brd.superproxy.io:33335 --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](https://docs.brightdata.com/api-reference/proxy/c-tag)


# Select a specific gIP
Source: https://docs.brightdata.com/api-reference/proxy/select_a_specific_gip



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
curl "http://target.site" --proxy brd.superproxy.io:33335 --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



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
curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-1.1.1.1.1:<zone_password>
```


# null
Source: https://docs.brightdata.com/api-reference/proxy/select_super_proxy_in_specific_country



{/*tags:nosophie*/}

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
curl "https://example.com" --proxy servercountry-gb.brd.superproxy.io:33335 --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



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
curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-direct:<zone_password>
```


# 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
Bright Data Web Scraper API enables you to trigger a collection for automated web data extraction.

Related guide: [Crawl API Introduction](/scraping-automation/crawl-api/overview)


# Trigger collection
Source: https://docs.brightdata.com/api-reference/rest-api/scraper/trigger-collection

api-reference/rest-api/scraper/scraper-rest-api.json post /datasets/v3/trigger
Bright Data Web Scraper API enables you to trigger a collection for automated web data extraction.

Related guide: [Web Scraper API Introduction](/scraping-automation/web-scraper-api/introduction)

<a href="https://www.postman.com/bright-data-api/bright-data-api/request/1z189u8/trigger-chatgpt-search-scraping" target="_blank">
  <img height="32" width="128" noZoom src="https://run.pstmn.io/button.svg" />
</a>


# Scrape SERP
Source: https://docs.brightdata.com/api-reference/rest-api/serp/scrape-serp

serp-rest-api POST /request
Extract search engine results using Bright Data SERP API. Extract structured data from major search engines including Google, Bing, Yandex, DuckDuckGo, and more.  Get organic results, paid ads, local listings, shopping results, and other SERP features.

Related guide: [SERP API Introduction](/scraping-automation/scraping-automation/serp-api/introduction)

<a href="https://www.postman.com/bright-data-api/bright-data-api/request/kpq952m/google-search" target="_blank">
  <img height="32" width="128" noZoom src="https://run.pstmn.io/button.svg" />
</a>

<Card title="Bright Data Python SDK" icon="python" href="https://docs.brightdata.com/api-reference/SDK" cta="Get Started">
  For an easy start using our tools check out our new Python SDK.
</Card>


# Unlock website
Source: https://docs.brightdata.com/api-reference/rest-api/unlocker/unlock-website

unlocker-rest-api POST /request
Bright Data Unlocker API enables you to bypass anti-bot measures, manages proxies, and solves CAPTCHAs automatically for easier web data collection.

Related guide: [Unlocker API Introduction](/scraping-automation/web-unlocker/introduction)

<a href="https://www.postman.com/bright-data-api/bright-data-api/request/f0g939o/unlock-website" target="_blank">
  <img height="32" width="128" noZoom src="https://run.pstmn.io/button.svg" />
</a>

<Card title="Bright Data Python SDK" icon="python" href="https://docs.brightdata.com/api-reference/SDK" cta="Get Started">
  For an easy start using our tools check out our new Python SDK.
</Card>


# All Classification Data
Source: https://docs.brightdata.com/api-reference/scraping-shield-api/all-classification-data

scraping-shield-rest-api GET /shield/class
Get all classification data



# Domains by Classification
Source: https://docs.brightdata.com/api-reference/scraping-shield-api/domains-by-classification-data

scraping-shield-rest-api GET /shield/domains_by_class
Returns usage data per domain for the chosen classification



# Samples by Classification
Source: https://docs.brightdata.com/api-reference/scraping-shield-api/samples-by-classification-data

scraping-shield-rest-api GET /shield/samples
Returns sample requests data for the chosen classification



# Zone by Classification
Source: https://docs.brightdata.com/api-reference/scraping-shield-api/zones-by-classification-data

scraping-shield-rest-api GET /shield/zones_by_class
Returns usage data per zone for the chosen classification



# Terminology
Source: https://docs.brightdata.com/api-reference/terminology



## 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 Unlocker API. Access your zones [here](https://brightdata.com/cp/zones).

<img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/bright-data-zones.png?maxW=4400&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=425a4e6d3b61917b62560e872ad97833" alt="bright-data-zones.png" width="4400" height="3176" data-path="images/bright-data-zones.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/bright-data-zones.png?w=280&maxW=4400&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=88d8de8c2ab00d3c6ac44ae8b788c637 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/bright-data-zones.png?w=560&maxW=4400&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=052462505bfdd1a113ec1e65277387ca 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/bright-data-zones.png?w=840&maxW=4400&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=ad706422d621b904137b513ea8b74b71 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/bright-data-zones.png?w=1100&maxW=4400&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=538230c1eb310069d9fb60aef12835c0 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/bright-data-zones.png?w=1650&maxW=4400&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=d4b93b1c67064e760838c145bec978fb 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/bright-data-zones.png?w=2500&maxW=4400&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=292a7de32c4b91a544e47bbb09ead220 2500w" data-optimize="true" data-opv="2" />

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


# Send your first Request
Source: https://docs.brightdata.com/api-reference/unlocker/sending_first_request



Here's an example of the most simple Unlocker API request using cURL that returns a JSON:

```sh
curl "https://geo.brdtest.com/welcome.txt" --proxy brd.superproxy.io:33335 --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 tip="Port 33335 replacing port 22225 deprecated on Sep 2026, click to read more">[`33335`](https://docs.brightdata.com/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 just a placeholder that goes to our server for testing purposes.               |

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>


# null
Source: https://docs.brightdata.com/api-reference/web-scraper-api/delivery-apis/deliver-snapshot

dca-api POST /datasets/v3/deliver/{snapshot_id}
Deliver the snapshot content to the specified storage



# null
Source: https://docs.brightdata.com/api-reference/web-scraper-api/delivery-apis/download-snapshot

dca-api GET /datasets/v3/snapshot/{snapshot_id}
Download the snapshot content

<Note>
  If needed, the result can be divided into several parts:

  1. Download the first part by specifying a `batch_size` and `part=1`

  2. Check how many part were created using <a href="/scraping-automation/web-data-apis/web-scraper-api/management-apis#calculate-the-number-of-parts-for-delivery" target="_blank">this endpoint</a>

  3. Download the rest of the parts by changing the `part` parameter. (`batch_size`, `format` and `compress` must stay the same for each call)
</Note>


# null
Source: https://docs.brightdata.com/api-reference/web-scraper-api/management-apis/cancel-snapshot

post /datasets/v3/snapshot/{snapshot_id}/cancel
Cancel the running collection



# null
Source: https://docs.brightdata.com/api-reference/web-scraper-api/management-apis/get-snapshot-delivery-parts

get /datasets/v3/snapshot/{snapshot_id}/parts
When requesting a delivery in batches (see available delivery APIs) use this endpoint to check how many parts were created. format, compress and batch_size should exactly match what was sent to the delivery/download API calls.



# null
Source: https://docs.brightdata.com/api-reference/web-scraper-api/management-apis/get-snapshot-input

get /datasets/v3/snapshot/{snapshot_id}/input
Get the inputs that were used to trigger the collection



# null
Source: https://docs.brightdata.com/api-reference/web-scraper-api/management-apis/get-snapshots

get /datasets/v3/snapshots
Get a list of triggered collections, the list contains only snapshots created for a specific dataset



# null
Source: https://docs.brightdata.com/api-reference/web-scraper-api/management-apis/monitor-delivery

get /datasets/v3/delivery/{delivery_id}
The call returns the delivery status



# null
Source: https://docs.brightdata.com/api-reference/web-scraper-api/management-apis/monitor-progress

get /datasets/v3/progress/{snapshot_id}
Get the status of a specific collection



# Snapshot Data
Source: https://docs.brightdata.com/api-reference/web-scraper-api/management-apis/snapshot-data

get /datasets/v3/log{snapshot_id}
Retrieve the logs for a specific dataset snapshot



# Facebook API Scrapers
Source: https://docs.brightdata.com/api-reference/web-scraper-api/social-media-apis/facebook



## Overview

The Facebook API Suite offers multiple types of APIs, each designed for specific data collection needs from Facebook. Below is an overview of how these APIs connect and interact, based on the available features:

<CardGroup cols="1">
  <Card title="Posts API" icon="images" href="/api-reference/web-scraper-api/social-media-apis/facebook#posts-api">
    This API allows users to collect multiple posts based on a single input URL (such as a Facebook page, group, or profile URL).

    <br />

    *   **Discovery functionality**:

    *   Requires the direct URL of the Facebook page, group, or profile.

    <br />

    *   **Interesting Columns**:

    *   `post_url`, `content`, `hashtags`, `likes`
  </Card>

  <Card title="Comments API" icon="comments" href="/api-reference/web-scraper-api/social-media-apis/facebook#comments-api">
    This API allows users to collect multiple comments from a post using its URL.

    <br />

    *   **Discovery functionality**:

    *   `N/A`

    <br />

    *   **Interesting Columns**:

    *   `commenter_url`, `comment_text`, `num_likes`, `num_replies`
  </Card>
</CardGroup>

<Note>There is no discovery capability across Facebook datasets since the data is locked behind login requirements.</Note>

The suite of APIs is designed to offer flexibility for targeted data collection, where users can input specific URLs to gather detailed post and comment data, either in bulk or with precise filtering options.

## Posts API

Posts API allows users to collect detailed post data from Facebook profiles, groups, and pages. The API provides comprehensive data points about posts, including post details, page/profile details, and attachments and media.

### Collect by Profile URL

This API enables users to collect detailed data from Facebook posts by providing a profile URL.

**Input Parameters**

<ParamField path="URL" type="string" required="true">
  The Facebook profile URL.
</ParamField>

<ParamField path="num_of_posts" type="number">
  The number of recent posts to collect. If omitted, there is no limit.
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  Array of post IDs to exclude from the results.
</ParamField>

<ParamField path="start_date" type="string">
  Start date for filtering posts in MM-DD-YYYY format (should be earlier than end\_date).
</ParamField>

<ParamField path="end_date" 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**:
  `post_id`, `content`, `hashtags`, `date_posted`, `num_comments`, `num_likes`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lkaxegm826bjpoo9m5?id=all\&tab=overview).

* **Page/Profile Details**:
  `page_name`, `page_category`, `page_followers`, `profile_handle`.

  > We provide a limited set of data points about the profile.

* **Attachments and Media**:
  `attachments` and `post_image` (link only, not the file itself), `video_view_count`.

### Collect by Group URL

This API enables users to collect detailed posts from Facebook groups by providing a group URL.

**Input Parameters**

<ParamField path="URL" type="string" required="true">
  The Facebook group URL.
</ParamField>

<ParamField path="num_of_posts" type="number">
  The number of posts to collect. If omitted, there is no limit.
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  Array of post IDs to exclude from the results.
</ParamField>

<ParamField path="start_date" type="string">
  Start date for filtering posts in MM-DD-YYYY format (should be earlier than end\_date).
</ParamField>

<ParamField path="end_date" 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**:
  `post_id`, `user_url`, `user_username`, `content`, `date_posted`, `hashtags`, `num_comments`, `num_shares`, `num_likes_type`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lz11l67o2cb3r0lkj3?id=all\&tab=overview).

* **Group Details**:
  `group_name`, `group_id`, `group_url`, `group_intro`, `group_category`,  and more.

* **User Details**:
  `user_is_verified`, `profile_handle` and more.

* **Attachments and External Links**:
  `Attachments` (link only, not the file itself), `original_post_url`, `other_posts_url`, `post_external_link` and more.

### Collect by Post URL

This API enables users to collect detailed data from specific Facebook posts using post URLs.

**Input Parameters**

<ParamField path="URL" type="string" required="true">
  The Facebook profile URL.
</ParamField>

**Output Structure**
Includes comprehensive data points:

* **Post Details**:
  `post_id`, `content`, `hashtags`, `date_posted`, `num_comments`, `num_likes`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lyclm1571iy3mv57zw?id=all\&tab=overview).

* **Page/Profile Details**:
  `page_name`, `page_category`, `page_followers`, `profile_handle`.

  > We provide a limited set of data points about the profile.

* **Attachments and Media**:
  `attachments` and `post_image` (link only, not the file itself), `video_view_count`.

## Comments API

Comments API allows users to collect detailed comment data from Facebook posts. The API provides comprehensive data points about comments, including comment details, user details, post metadata, and attachments and media.

### Collect by Post URL

This API enables users to collect detailed comment data from Facebook posts by providing a post URL.

**Input Parameters**

<ParamField path="URL" type="string" required="true">
  The Facebook post URL.
</ParamField>

<ParamField path="num_of_comments" type="number">
  The number of comments to collect. If omitted, there is no limit.
</ParamField>

<ParamField path="comments_to_not_include" type="array">
  Array of comment IDs to exclude.
</ParamField>

<ParamField path="start_date" type="string">
  Start date for filtering comments in MM-DD-YYYY format (should be earlier than end\_date).
</ParamField>

<ParamField path="end_date" type="string">
  End date for filtering comments in MM-DD-YYYY format (should be later than start\_date).
</ParamField>

**Output Structure**
Includes comprehensive data points:

* **Comment Details**:
  `comment_id`, `comment_text`, `num_likes`, replies, `num_replies`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lkay758p1eanlolqw8?id=all\&tab=overview).

* **User Details**:
  `user_name`, `user_id`, `user_url`

  > We provide a limited set of data points about the profile.

* **Post Metadata**:
  `post_id`, `post_url`.

* **Attachments and Media**:
  `attached_files` (link only, not the file itself) , `video_length`.

## Reels API

Reels API allows users to collect detailed data about Facebook reels from public profiles. The API provides comprehensive data points about reels, including post details, page/profile details, and attachments and media.

### Collect by Profile URL

This API allows users to collect detailed data about Facebook reels from public profiles by providing the profile URL.

**Input Parameters**

<ParamField path="URL" type="string" required="true">
  The Facebook profile URL.
</ParamField>

<ParamField path="num_of_posts" type="number">
  Number of reels to collect (default: up to 1600).
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  Array of reel IDs to exclude.
</ParamField>

<ParamField path="start_date" type="string">
  Start of the date range for filtering reels.
</ParamField>

<ParamField path="end_date" type="string">
  End of the date range for filtering reels.
</ParamField>

**Output Structure**
Includes comprehensive data points:

* **Reel Details**:
  `post_id`, `content`, `hashtags`, `date_posted`, `num_comments`, `num_likes`, `audio` (soundtrack details), `video_view_count` and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lyclm3ey2q6rww027t?id=all\&tab=overview).

* **Page/Profile Details**:
  `page_name`, `page_category`, `page_followers`, `profile_handle`.

  > We provide a limited set of data points about the profile.

* **Attachments and Media**:
  `external_link` (link only, not the file itself)


# Instagram API Scrapers
Source: https://docs.brightdata.com/api-reference/web-scraper-api/social-media-apis/instagram



## Overview

The Instagram API Suite offers multiple types of APIs, each designed for specific data collection needs from Instagram. Below is an overview of how these APIs connect and interact, based on the available features:

<CardGroup cols="1">
  <Card title="Profiles API" icon="user" href="/api-reference/web-scraper-api/social-media-apis/instagram#profiles-api">
    This API allows users to collect profile details based on a single input: profile URL.

    <br />

    *   **Discovery functionality**:

    *   `N/A`

    <br />

    *   **Interesting Columns**:

    *   `followers`, `post_count`, `post_hashtags`, `profile_name`.
  </Card>

  <Card title="Posts API" icon="images" href="/api-reference/web-scraper-api/social-media-apis/instagram#posts-api">
    This API allows users to collect multiple posts based on a single input URL (such as an Instagram reels URL, search URL or profile URL).

    <br />

    *   **Discovery functionality**:

      *   - Direct URL of the Instagram reel

      *   - Direct URL of the search

      *   - Direct URL of the profile

    <br />

    *   **Interesting Columns**:

    *   `url`, `followers`, `hashtags`, `engagement_score_view`.
  </Card>

  <Card title="Comments API" icon="comments" href="/api-reference/web-scraper-api/social-media-apis/instagram#comments-api">
    This API allows users to collect multiple comments from a post using its URL.

    <br />

    *   **Discovery functionality**:

    *   `N/A`

    <br />

    *   **Interesting Columns**:

    *   `comment_user`, `comment`, `likes_number`, `replies_number`.
  </Card>
</CardGroup>

The suite of APIs is designed to offer flexibility for targeted data collection, where users can input specific URLs to gather detailed post and comment data, either in bulk or with precise filtering options.

## Profiles API

### Collect by URL

This API allows users to collect detailed data about an Instagram profile by providing the profile URL. It provides a comprehensive overview of an Instagram profile, including business and engagement information, posts, and user details.

**Input Parameters**

<ParamField path="URL" type="string" required="true">
  The Instagram profile URL.
</ParamField>

**Output Structure**
Includes comprehensive data points:

* **Page/Profile Details**:
  `account`, `id`, `followers`, `posts_count`, `is_business_account`, `is_professional_account`, `is_verified`, `avg_engagement`, `profile_name`, `profile_url`, `profile_image_link`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_l1vikfch901nx3by4?id=all\&tab=overview).

## Posts API

### Collect by URL

This API enables users to collect detailed data from Instagram posts by providing a post URL.

**Input Parameters**

<ParamField path="URL" type="string" required="true">
  The Instagram post URL.
</ParamField>

**Output Structure**
Includes comprehensive data points:

* **Post Details**:
  `post_id`, `description`, `hashtags`, `date_posted`, `num_comments`, `likes`, `content_type`, `video_view_count`, `video_play_count`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lk5ns7kz21pck8jpis?id=all\&tab=overview).

* **Page/Profile Details**:
  `user_posted`, `followers`, `posts_count`, `profile_image_link`, `is_verified`, `profile_url`.

  > We provide a limited set of data points about the profile.

* **Attachments and Media**:
  `photos`, `videos`, `thumbnail`, `display_url` (link only, not the file itself), audio.

### Discover by URL

This API allows users to discover recent Instagram posts from a public profile by providing the profile URL and specifying additional parameters.

**Input Parameters**

<ParamField path="URL" type="string" required="true">
  The Instagram profile URL.
</ParamField>

<ParamField path="num_of_posts" type="number">
  The number of recent posts to collect. If omitted, there is no limit.
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  Array of post IDs to exclude from the results.
</ParamField>

<ParamField path="start_date" type="string">
  Start date for filtering posts in MM-DD-YYYY format (should be earlier than end\_date).
</ParamField>

<ParamField path="end_date" type="string">
  End date for filtering posts in MM-DD-YYYY format (should be later than start\_date).
</ParamField>

<ParamField path="post_type" type="string">
  Specify the type of posts to collect (e.g., post, reel).
</ParamField>

**Output Structure**
Includes comprehensive data points:

* Post Details:
  `post_id`, `description`, `hashtags`, `date_posted`, `num_comments`, `likes`, `video_view_count`, `video_play_count`,and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lk5ns7kz21pck8jpis/url?id=all\&tab=overview).

* Page/Profile Details:
  `user_posted`, `followers`, `posts_count`, `profile_image_link`, `is_verified`, `profile_url`, `is_paid_partnership`, `partnership_details`, `user_posted_id`

* Attachments and Media:
  `photos`, `videos`, `thumbnail`, `audio`, `display_url`, `content_type`, `product_type`, `coauthor_producers`, `tagged_users`.

This API is designed to allow for filtering, exclusion of specific posts, and collecting posts by type (regular post or reel) within a defined time frame. It provides detailed post and profile information, making it ideal for data collection and analytics.

## Comments API

### Collect by URL

This API allows users to collect the latest comments from a specific Instagram post by providing the post URL.

<Note>
  This API retrieves the most recent 10 comments along with associated metadata.
</Note>

**Input Parameters**

<ParamField path="URL" type="string" required="true">
  The Instagram post URL.
</ParamField>

**Output Structure**
Includes comprehensive data points:

* **Comment Details**:
  `comment_id`, `comment_user`, `comment_user_url`, `comment_date`, `comment`, `likes_number`, `replies_number`, `replies`, `hashtag_comment`, `tagged_users_in_comment`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_ltppn085pokosxh13?id=all\&tab=overview).

* **User Details**:
  `user_name`, `user_id`, `user_url`

  > We provide a limited set of data points about the profile.

* **Post Metadata**:
  `post_url`, `post_user`, `post_id`.

## Reels API

### Collect by URL

This API allows users to collect detailed data about Instagram reels from public profiles by providing the reel URL.

**Input Parameters**

<ParamField path="URL" type="string" required="true">
  The Instagram reel URL.
</ParamField>

**Output Structure**
Includes comprehensive data points:

* **Reel Details**:
  `post_id`, `description`, `hashtags`, `date_posted`, `tagged_users`, `num_comments`, `likes`, `views`, `video_play_count`, `length`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lyclm20il4r5helnj?id=all\&tab=overview).

* **Page/Profile Details**:
  `user_posted`, `followers`, `posts_count`, `profile_image_link`, `is_verified`, `profile_url`.

  > We provide a limited set of data points about the profile.

* **Attachments and Media**:
  `video_url`, `thumbnail`, `audio_url`.

### Discover by URL

This API allows users to discover Instagram Reels videos from a profile URL or direct search URL.

**Input Parameters**

<ParamField path="URL" type="string" required="true">
  The Instagram profile or direct search URL.
</ParamField>

<ParamField path="num_of_posts" type="number">
  The number of recent reels to collect. If omitted, there is no limit.
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  Array of post IDs to exclude from the results.
</ParamField>

<ParamField path="start_date" type="string">
  Start date for filtering reels in MM-DD-YYYY format.
</ParamField>

<ParamField path="end_date" type="string">
  End date for filtering reels in MM-DD-YYYY format (should be later than `start_date`).
</ParamField>

**Output Structure**
Includes comprehensive data points:

* **Reel Details**:
  `post_id`, `description`, `hashtags`, `date_posted`, `num_comments`, `likes`, `views`, `video_play_count`, `top_comments`, `length`, `video_url`, `audio_url`, `content_id`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lyclm20il4r5helnj/url?id=all\&tab=overview).

* **Profile Details**:
  `user_posted`, `followers`, `posts_count`, `following`.

* **Attachments and Media**:
  `video_url`, `thumbnail`, `audio_url` (link only, not the file itself).

This API provides detailed information about Instagram Reels, with filtering options by date range, exclusion of specific posts, and a limit on the number of reels collected.


# LinkedIn API Scrapers
Source: https://docs.brightdata.com/api-reference/web-scraper-api/social-media-apis/linkedin



## Overview

[The LinkedIn API](https://brightdata.com/products/web-scraper/linkedin) Suite offers multiple types of APIs, each designed for specific data collection needs from LinkedIn. Below is an overview of how these APIs connect and interact, based on the available features:

<CardGroup cols="1">
  <Card title="Profiles API" icon="user" href="/api-reference/web-scraper-api/social-media-apis/linkedin#profiles-api">
    The [LinkedIn Profiles API](https://brightdata.com/products/web-scraper/linkedin/profiles) allows users to collect profile details based on a single input: profile URL.

    <br />

    *   **Discovery functionality**:

    *   Discover LinkedIn profiles by names

    <br />

    *   **Interesting Columns**:

    *   `name`, `country_code`, `current_company`, `about`.
  </Card>

  <Card title="Posts API" icon="images" href="/api-reference/web-scraper-api/social-media-apis/linkedin#posts-api">
    The [LinkedIn Posts API](https://brightdata.com/products/web-scraper/linkedin/post) allows users to collect multiple posts based on a single input URL.

    <br />

    *   **Discovery functionality**:

      *   - Direct URL of the LinkedIn profile

      *   - Direct URL user’s articles

      *   - Direct URL of the company

    <br />

    *   **Interesting Columns**:

    *   `url`, `title`, `hashtags`, `num_likes`.
  </Card>

  <Card title="Job Listings Information API" icon="briefcase" href="/api-reference/web-scraper-api/social-media-apis/linkedin#job-listings-information-api">
    The [LinkedIn Jobs API](https://brightdata.com/products/web-scraper/linkedin/jobs) allows users to collect job details based on a single input URL.

    <br />

    *   **Discovery functionality**:

      *   - Direct URL of the search

      *   - Discover by keywords

    <br />

    *   **Interesting Columns**:

    *   `job_title`, `company_name`, `job_location`, `job_seniority_level`.
  </Card>

  <Card title="Companies Information API" icon="building" href="/api-reference/web-scraper-api/social-media-apis/linkedin#companies-information-api">
    The [LinkedIn Companies API](https://brightdata.com/products/web-scraper/linkedin/company) allows users to collect company information by using its URL.

    <br />

    *   **Discovery functionality**: N/A

    <br />

    *   **Interesting Columns**:

    *   `name`, `country_code`, `followers`, `employees_in_linkedin`.
  </Card>
</CardGroup>

The suite of APIs is designed to offer flexibility for targeted data collection, where users can input specific URLs to gather detailed post, profile, job, and company data, either in bulk or with precise filtering options.

## Profiles API

### Collect by URL

This API allows users to collect detailed information about a LinkedIn profile by providing the profile URL.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  The LinkedIn profile URL.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Profile Details**:
  `linkedin_id`, `name`, `country_code`, `city`, `position`, `current_company`, `current_company_name`, `current_company_company_id`, `about`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_l1viktl72bvl7bjuj0?id=all\&tab=overview).

* **Professional Information**:
  `experience`, `education`, `educations_details`, `certifications`, `languages`, `recommendations_count`, `recommendations`, `volunteer_experience`, `courses`, `publications`, `patents`, `projects`, `organizations`, and `honors_and_awards`.

* **Social Activity**:
  `posts`, `activity`, `followers`, `connections`, `people_also_viewed`.

* **Media and Identification**:
  `avatar`, `banner_image`, `url`, `input_url`, `linkedin_num_id`, `id`, `timestamp`.

This API provides a rich set of data points for analyzing LinkedIn profiles, including professional experience, education, recommendations, and social activity, as well as media and unique identification details.

### Discover by Name

This API allows users to discover LinkedIn profiles based on a given first and last name.

**Input Parameters**:

<ParamField path="first_name" type="string" required="true">
  The first name of the individual.
</ParamField>

<ParamField path="last_name" type="string" required="true">
  The last name of the individual.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Profile Details**:
  `linkedin_id`, `name`, `country_code`, `city`, `position`, `current_company`, `current_company_name`, `current_company_company_id`, `about`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_l1viktl72bvl7bjuj0/name?id=all\&tab=overview).

* **Professional Information**:
  `experience`, `education`, `educations_details`, `certifications`, `languages`, `recommendations_count`, `recommendations`, `volunteer_experience`, `courses`, `publications`, `patents`, `projects`, `organizations`, and `honors_and_awards`.

* **Social Activity**:
  `posts`, `activity`, `followers`, `connections`, `people_also_viewed`.

* **Media and Identification**:
  `avatar`, `banner_image`, `url`, `input_url`, `linkedin_num_id`, `id`, `timestamp`.

This API provides an efficient way to retrieve LinkedIn profile details based on a person's name, delivering rich professional and social insights along with associated media assets.

## Posts API

### Collect by URL

This API enables users to collect detailed data from Instagram posts by providing a post URL.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  The LinkedIn post URL.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:
  `id`, `title`, `headline`, `post_text`, `post_text_html`, `date_posted`, `hashtags`, `embedded_links`, `images`, `videos`, `post_type`, `account_type`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lyy3tktm25m4avu764?id=all\&tab=overview).

* **Engagement Metrics**:
  `num_likes`, `num_comments`, `top_visible_comments`.

* **User Details**:
  `user_id`, `use_url`, `user_followers`, `user_posts`, `user_articles`.

* **Related Content**:
  `more_articles_by_user`, `more_relevant_posts`.

This API provides detailed information about a LinkedIn post, including text, media attachments, engagement metrics, and additional user-related and related content for comprehensive post analysis.

### Discover by URL

This API allows users to discover articles authored by a LinkedIn user by providing their profile URL and optionally limiting the number of results.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  The LinkedIn profile URL.
</ParamField>

<ParamField path="limit" type="number">
  The maximum number of articles to retrieve. If omitted, all available articles will be collected.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Article Details**:
  `id`, `title`, `headline`, `post_text`, `post_text_html`, `date_posted`, `hashtags`, `embedded_links`, `images`, `videos`, `post_type`, `account_type`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lyy3tktm25m4avu764/url?id=all\&tab=overview).

* **Engagement Metrics**:
  `num_likes`, `num_comments`, `top_visible_comments`.

* **User Details**:
  `user_id`, `use_url`, `user_followers`, `user_posts`, `user_articles`.

* **Related Content**:
  `more_articles_by_user`, `more_relevant_posts`.

This API delivers detailed information about articles written by a LinkedIn user, including text, media, and engagement insights, along with associated user and related content data for enhanced analysis.

### Discover by Profile URL

This API allows users to discover LinkedIn posts from a profile by providing the profile URL and applying optional date filters.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  The LinkedIn profile URL.
</ParamField>

<ParamField path="start_date" type="date">
  Start date for filtering posts by their publish date (YYYY-MM-DD format). Posts published before this date will be excluded.
</ParamField>

<ParamField path="end_date" type="date">
  End date for filtering posts by their publish date (YYYY-MM-DD format). Posts published after this date will be excluded.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:
  `id`, `title`, `headline`, `post_text`, `post_text_html`, `date_posted`, `hashtags`, `embedded_links`, `images`, `videos`, `post_type`, `account_type`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lyy3tktm25m4avu764/company_url?id=all\&tab=overview).

* **Engagement Metrics**:
  `num_likes`, `num_comments`, `top_visible_comments`.

* **User Details**:
  `user_id`, `use_url`, `user_followers`, `user_posts`, `user_articles`.

* **Related Content**:
  `more_articles_by_user`, `more_relevant_posts`.

This API enables precise discovery of LinkedIn posts based on specific profiles and time ranges, providing detailed post data, engagement metrics, and associated user information for in-depth analysis.

### Discover by Company URL

This API allows users to discover recent LinkedIn posts published by a company, filtered by optional date ranges, using the company URL.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  The LinkedIn company profile URL.
</ParamField>

<ParamField path="start_date" type="date">
  Start date for filtering posts by their publish date (YYYY-MM-DD format). Only posts published on or after this date will be collected.
</ParamField>

<ParamField path="end_date" type="date">
  End date for filtering posts by their publish date (YYYY-MM-DD format). Only posts published on or before this date will be collected.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:
  `post_id`, `title`, `post_text`, `date_posted`, `hashtags`, `embedded_links`, `images`, `videos`, `post_type`, `account_type`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lyy3tktm25m4avu764/company_url?id=all\&tab=overview).

* **Engagement Metrics**:
  `num_likes`, `num_comments`, `top_visible_comments`.

* **Company Details**:
  `company_id`, `company_name`, `company_url`, `followers`.

* **Related Content**:
  `more_relevant_posts`, `additional_media_links`.

This API provides detailed insights into company posts, allowing businesses and analysts to track updates, engagement, and content trends effectively.

## Job Listings Information API

### Collect by URL

This API allows users to collect detailed information about a LinkedIn job listing by providing the job URL.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  The LinkedIn job listing URL.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Job Details**:
  `job_posting_id`, `job_title`, `job_summary`, `job_seniority_level`, `job_function`, `job_employment_type`, `job_industries`, `job_base_pay_range`, `base_salary`, `job_description_formatted`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lpfll7v5hcqtkxl6l?id=all\&tab=overview).

* **Company Details**:
  `company_name`, `company_id`, `company_url`, `company_logo`.

* **Job Metadata**:
  `job_location`, `job_posted_time`, `job_posted_date`, `job_num_applicants`, `discovery_input`, `apply_link`, `country_code`, `title_id`.

* **Job Poster Information**:
  `job_poster`.

This API provides a comprehensive overview of LinkedIn job listings, including job details, company information, applicant statistics, and metadata for enhanced job analysis and application tracking.

### Discover by Keyword

This API allows users to discover LinkedIn job postings based on keyword search, location, and other filters like job type, experience level, and more.

**Input Parameters**:

<ParamField path="location" type="string" required="true">
  The specific location where the jobs are located.
</ParamField>

<ParamField path="keyword" type="string" required="true">
  A keyword or job title for searching jobs (e.g., "Product Manager"). Use quotation marks for exact matches.
</ParamField>

<ParamField path="country" type="string">
  The country code in 2-letter format (e.g., `US`, `FR`).
</ParamField>

<ParamField path="time_range" type="string">
  The time range of the job postings (e.g., `past_week`, `past_month`).
</ParamField>

<ParamField path="job_type" type="string">
  The type of job (e.g., "full-time", "part-time").
</ParamField>

<ParamField path="experience_level" type="string">
  The required experience level for the job (e.g., "entry-level", "mid-senior").
</ParamField>

<ParamField path="remote" type="string">
  Whether the job is remote (e.g., "yes" or "no").
</ParamField>

<ParamField path="company" type="string">
  The company name to filter jobs by.
</ParamField>

<ParamField path="selective_search" type="boolean">
  When set to true, excludes job titles that do not contain the specified keywords.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Job Details**:
  `job_posting_id`, `job_title`, `job_summary`, `job_seniority_level`, `job_function`, `job_employment_type`, `job_industries`, `job_base_pay_range`, `job_description_formatted`, `base_salary`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lpfll7v5hcqtkxl6l/keyword?id=all\&tab=overview).

* **Company Details**:
  `company_name`, `company_id`, `company_url`, `company_logo`.

* **Job Metadata**:
  `job_location`, `job_posted_time`, `job_posted_date`, `job_num_applicants`, `job_poster`, `apply_link`, `country_code`, `title_id`.

* **Application Details**:
  `job_poster`, `application_availability`, `discovery_input`.

This API allows users to discover and filter jobs on LinkedIn based on specific keywords, location, job type, and other criteria, offering detailed job listings and company information for further analysis.

### Discover by URL

This API allows users to discover job listings from a direct LinkedIn job search URL, providing job details, company information, and job metadata based on the specific URL query.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  A direct LinkedIn search URL for jobs (e.g., by company or job title).
</ParamField>

<ParamField path="selective_search" type="boolean">
  When set to `true`, the search will exclude job titles that do not match the specified keywords or criteria.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Job Details**:
  `job_posting_id`, `job_title`, `job_summary`, `job_seniority_level`, `job_function`, `job_employment_type`, `job_industries`, `job_base_pay_range`, `job_description_formatted`, `base_salary`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lpfll7v5hcqtkxl6l/url?id=all\&tab=overview).

* **Company Details**:
  `company_name`, `company_id`, `company_url`, `company_logo`.

* **Job Metadata**:
  `job_location`, `job_posted_time`, `job_posted_date`, `job_num_applicants`, `job_poster`, `apply_link`, `country_code`, `title_id`.

* **Application Details**:
  `job_poster`, `application_availability`, `discovery_input`.

This API allows users to retrieve detailed job listings from a LinkedIn search URL, offering insights into job opportunities, company details, and more, enabling efficient job discovery and application tracking.

## Companies Information API

### Collect by URL

This API allows users to collect detailed information about a LinkedIn company profile by providing the company URL.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  The LinkedIn company profile URL.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Company Details**:
  `id`, `name`, `about`, `slogan`, `description`, `specialties`, `organization_type`, `company_size`, `industries`, `founded`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_l1vikfnt1wgvvqz95w?id=all\&tab=overview).

* **Business Information**:
  `country_code`, `country_codes_array`, `locations`, `formatted_locations`, `headquarters`, `stock_info`, `funding`, `investors`, `crunchbase_url`, `get_directions_url`.

* **Engagement and Network**:
  `followers`, `employees`, `employees_in_linkedin`, `alumni`, `alumni_information`, `affiliated`, `similar`.

* **Media and Metadata**:
  `logo`, `image`, `url`, `updates`, `timestamp`.

This API provides a comprehensive overview of LinkedIn company profiles, including business details, locations, alumni network, funding information, and media assets.


# Social Media Scrapers APIs Overview
Source: https://docs.brightdata.com/api-reference/web-scraper-api/social-media-apis/overview

The Social Media API Suite provides extensive tools for data collection across multiple platforms.

The Social Media API Suite is designed to simplify data collection while providing deep insights into user engagement and content reach across multiple platforms. Users can refer to the detailed guide provided to understand more about leveraging the APIs together for comprehensive results.

## Supported Platforms

The Social Media API Suite supports a wide range of social media platforms, including:

<CardGroup cols={4}>
  <Card title="Facebook" icon="facebook" href="/api-reference/web-scraper-api/social-media-apis/facebook" />

  <Card title="Instagram" icon="instagram" href="/api-reference/web-scraper-api/social-media-apis/instagram" />

  <Card title="LinkedIn" icon="linkedin" href="/api-reference/web-scraper-api/social-media-apis/linkedin" />

  <Card title="TikTok" icon="tiktok" href="/api-reference/web-scraper-api/social-media-apis/tiktok" />

  <Card title="Reddit" icon="reddit" href="/api-reference/web-scraper-api/social-media-apis/reddit" />

  <Card title="Twitter" icon="twitter" href="/api-reference/web-scraper-api/social-media-apis/twitter" />

  <Card title="Pinterest" icon="pinterest" href="/api-reference/web-scraper-api/social-media-apis/pinterest" />

  <Card title="Quora" icon="quora" href="/api-reference/web-scraper-api/social-media-apis/quora" />

  <Card title="Vimeo" icon="vimeo" href="/api-reference/web-scraper-api/social-media-apis/vimeo" />

  <Card title="YouTube" icon="youtube" href="/api-reference/web-scraper-api/social-media-apis/youtube" />
</CardGroup>

This unified suite is designed to provide insights into user profiles, posts, and interactions such as comments and likes. Below is an overview based on the sales guide for all social media APIs.

## API Types and Data Connections

* **Profiles API**: Collects data on user or channel profiles, including metrics such as followers, subscribers, and content statistics.

* **Posts API**: Provides data on individual posts or videos, detailing engagement metrics like likes, views, and hashtags.

* **Comments API**: Offers insights into user interactions with posts, such as replies and likes on comments.

Each platform, including Facebook, YouTube, Instagram, TikTok, and Pinterest, supports these APIs, enabling a consistent and comprehensive approach to social data collection.

## Key Features:

1. **Comprehensive Coverage**: The APIs cover a broad range of social platforms, from video content sites like YouTube and TikTok to social networks like Instagram and Facebook, providing versatile data collection solutions.

2. **Fresh Data**: Each API offers on-demand data collection, ensuring the data provided is always up-to-date for the user.

3. **Customizable Solutions**: The suite of APIs is flexible, enabling users to customize data collection and delivery to meet specific needs. Users can combine different APIs to gain broader insights tailored to their use cases.

4. **Ease of Integration**: Simple API calls are supported for seamless integration into existing workflows, enhancing usability and reducing the learning curve for developers.

5. **Interconnectivity**: These APIs are interconnected, meaning data from one API can be used as an input for another, allowing users to perform cross-platform analysis and derive comprehensive insights.

   > **For example**, on YouTube:
   >
   > * Use the **Profiles API** to gather data on a specific profile.
   > * Utilize the **Posts API** to fetch data on videos linked to that profile.
   > * Leverage the **Comments API** to obtain data on comments related to those posts.

This interconnected approach applies to all supported platforms, giving users the ability to conduct comprehensive analyses that span profiles, posts, and their associated interactions.


# Pinterest API Scrapers
Source: https://docs.brightdata.com/api-reference/web-scraper-api/social-media-apis/pinterest



## 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 cols={1}>
  <Card title="Profiles API" icon="user" href="/api-reference/web-scraper-api/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/web-scraper-api/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 path="URL" type="string" required="true">
  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/data_api/gd_lk0zv93c2m9qdph46z?id=all\&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 path="keyword" type="string" required="true">
  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/data_api/gd_lk0zv93c2m9qdph46z/keyword?id=all\&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 path="URL" type="string" required="true">
  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/data_api/gd_lk0sjs4d21kdr7cnlv?id=all\&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 path="URL" type="string" required="true">
  The Pinterest profile URL from which to collect posts.
</ParamField>

<ParamField path="num_of_posts" type="number">
  The number of posts to collect. If omitted, there is no limit.
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  An array of post IDs to exclude from the results.
</ParamField>

<ParamField path="start_date" type="string">
  Start date for filtering posts in `MM-DD-YYYY` format (should be earlier than `end_date`).
</ParamField>

<ParamField path="end_date" 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/data_api/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 path="keyword" type="string" required="true">
  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/data_api/gd_lk0zv93c2m9qdph46z/keyword?id=all\&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/web-scraper-api/social-media-apis/quora



## Overview

<CardGroup cols={1}>
  <Card title="Posts API" icon="images" href="/api-reference/web-scraper-api/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 path="URL" type="string" required="true">
  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/data_api/gd_lvz1rbj81afv3m6n5y?id=all\&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.


# Reddit API Scrapers
Source: https://docs.brightdata.com/api-reference/web-scraper-api/social-media-apis/reddit



## Overview

The Reddit API Suite offers multiple types of APIs, each designed for specific data collection needs from Reddit. Below is an overview of how these APIs connect and interact, based on the available features:

<CardGroup cols={1}>
  <Card title="Posts API" icon="images" href="/api-reference/web-scraper-api/social-media-apis/reddit#posts-api">
    This API allows users to collect multiple posts based on a single input URL.

    <br />

    *   **Discovery functionality**:

    *   Discover by subreddit URL.

    *   Discover by Keywords.

    <br />

    *   **Interesting Columns**:

    *   `url`, `title`, `num_comments`, `description`
  </Card>

  <Card title="Comments API" icon="comments" href="/api-reference/web-scraper-api/social-media-apis/reddit#comments-api">
    This API allows users to collect multiple comments from a post using its URL.

    <br />

    *   **Discovery functionality**:

    *   N/A

    <br />

    *   **Interesting Columns**:

    *   `url`, `comment`, `community_name`, `num_replies`
  </Card>
</CardGroup>

## Posts API

### Collect by URL

This API allows users to retrieve detailed post data from a specific Reddit post using the provided URL.

**Input Parameters**

<ParamField path="URL" type="string" required="true">
  The URL of the Reddit post to be retrieved.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:\
  `post_id`, `url`, `title`, `description`, `num_comments`, `date_posted`, `tag`, `related_posts`, `comments`, `photos`, `videos`.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lvz8ah06191smkebj4?id=all\&tab=overview).

* **User Details**:\
  `user_posted`.

* **Community Details**:\
  `community_name`, `community_url`, `community_description`, `community_members_num`, `community_rank`.

* **Engagement Metrics**:\
  `num_upvotes`.

This API enables efficient retrieval of Reddit post information, including user engagement metrics, community details, and multimedia content, supporting advanced analysis and content tracking.

### Discover by Keywords

This API allows users to discover Reddit posts by specific keywords, with options to filter by date and the number of posts to retrieve.

**Input Parameters**

<ParamField path="keyword" type="string" required="true">
  The search term to find relevant posts.
</ParamField>

<ParamField path="date" type="string" required="true">
  The date to filter posts by, ensuring results fall within the specified timeframe.
</ParamField>

<ParamField path="num_of_posts" type="number">
  The number of posts to collect. If not provided, all matching posts are retrieved.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:\
  `post_id`, `url`, `user_posted`, `title`, `description`, `num_comments`, `date_posted`, `tag`, `related_posts`, `comments`.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lvz8ah06191smkebj4/keyword?id=all\&tab=overview).

* **Community Details**:\
  `community_name`, `community_url`, `community_description`, `community_members_num`, `community_rank`.

* **Media Details**:\
  `photos`, `videos`.

This API enables users to efficiently discover and analyze Reddit posts related to specific keywords, providing valuable insights into community discussions, post popularity, and associated media content.

### Discover by subreddit URL

This API allows users to retrieve posts from a specific subreddit using the subreddit URL, with an option to sort results based on specific criteria.

**Input Parameters**

<ParamField path="URL" type="string" required="true">
  The URL of the subreddit to collect posts from.
</ParamField>

<ParamField path="sort_by" type="string">
  Determines the sorting method for the posts (e.g., `new`, `top`, `hot`).
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:\
  `post_id`, `url`, `user_posted`, `title`, `description`, `num_comments`, `date_posted`, `tag`, `related_posts`, `comments`.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lvz8ah06191smkebj4/subreddit_url?id=all).

* **Community Details**:\
  `community_name`, `community_url`, `community_description`, `community_members_num`, `community_rank`.

* **Media Details**:\
  `photos`, `videos`.

This API provides a streamlined way to explore and analyze posts within a subreddit, offering insights into post content, community dynamics, and associated media files. Perfect for monitoring subreddit activity or extracting post-level data for further analysis.

## Comments API

### Collect by URL

This API allows users to collect detailed comment data from a specific Reddit post or comment URL, with the option to filter comments based on the number of days since they were published.

**Input Parameters**

<ParamField path="URL" type="string" required="true">
  The URL of the Reddit post or comment to retrieve comments from.
</ParamField>

<ParamField path="days_back" type="number">
  Collect all comments published no later than the specified number of days.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Comment Details**:\
  `comment_id`, `user_posted`, `comment`, `date_posted`, `replies`, `num_upvotes`, `num_replies`.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lvzdpsdlw09j6t702?tab=overview).

* **Post Details**:\
  `post_url`, `post_id`, `post_language`, `post_state`, `post_type`, `images`.

* **Community Details**:\
  `community_name`, `community_url`, `community_description`, `community_members_num`, `community_rank`.

* **Post Attributes**:\
  `is_moderator`, `is_pinned`, `has_bot_in_username`, `is_locked`, `is_admin_post`, `is_archived_post`, `is_moderator_post`, `is_quarantined_post`, `is_not_safe_for_work_post`, `is_eligible_for_content_blocking_post`, `is_promoted_post`.

This API provides comprehensive insights into Reddit comments and their associated posts, enabling users to analyze engagement, user activity, and content trends effectively.


# TikTok API Scrapers
Source: https://docs.brightdata.com/api-reference/web-scraper-api/social-media-apis/tiktok



## Overview

The TikTok API Suite offers multiple types of APIs, each designed for specific data collection needs from TikTok. Below is an overview of how these APIs connect and interact, based on the available features:

<CardGroup cols="1">
  <Card title="Profile API" icon="user" href="/api-reference/web-scraper-api/social-media-apis/tiktok#profile-api">
    This API allows users to collect profile details based on a single input: profile URL.

    <br />

    *   **Discovery functionality**:

    *   Direct URL of the search

    <br />

    *   **Interesting Columns**:

    *   `nickname`, `awg_engagement_rate`, `followers`, `likes`
  </Card>

  <Card title="Posts API" icon="images" href="/api-reference/web-scraper-api/social-media-apis/tiktok#posts-api">
    This API allows users to collect multiple posts based on a single input URL.

    <br />

    *   **Discovery functionality**:

    *   - Direct URL of the TikTok profile

    *   - Discover by keywords

    *   - Direct URL of the discovery

    <br />

    *   **Interesting Columns**:

    *   `url`, `share_count`, `description`, `hashtags`
  </Card>

  <Card title="Comments API" icon="comments" href="/api-reference/web-scraper-api/social-media-apis/tiktok#comments-api">
    This API allows users to collect multiple comments from a post using its URL.

    <br />

    *   **Discovery functionality**:

    *   N/A

    <br />

    *   **Interesting Columns**:

    *   `url`, `comment_text`, `commenter_url`, `num_likes`
  </Card>
</CardGroup>

## Profile API

### Collect by URL

This API allows users to retrieve detailed TikTok profile information using the provided profile URL.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  The TikTok profile URL.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Profile Details**:\
  `account_id`, `nickname`, `biography`, `bio_link`, `predicted_lang`, `is_verified`, `followers`, `following`, `likes`, `videos_count`, `create_time`, `id`, `url`, `profile_pic_url`, `profile_pic_url_hd`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_l1villgoiiidt09ci?id=all\&tab=overview).

* **Engagement Metrics**:\
  `awg_engagement_rate`, `comment_engagement_rate`, `like_engagement_rate`, `like_count`, `digg_count`.

* **Privacy & Settings**:\
  `is_private`, `relation`, `open_favorite`, `comment_setting`, `duet_setting`, `stitch_setting`, `is_ad_virtual`, `room_id`, `is_under_age_18`.

* **Discovery & Top Videos**:\
  `region`, `top_videos`, `discovery_input`.

This API allows users to retrieve detailed TikTok profile information, including engagement metrics, privacy settings, and top videos, offering insights into user activity and profile data.

### Discover by Search URL

This API allows users to discover TikTok profiles based on a specific search URL and country, providing detailed profile information.

**Input Parameters**:

<ParamField path="search_url" type="string" required="true">
  The TikTok search URL.
</ParamField>

<ParamField path="country" type="string" required="true">
  The country from which to perform the search.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Profile Details**:\
  `account_id`, `nickname`, `biography`, `bio_link`, `predicted_lang`, `is_verified`, `followers`, `following`, `likes`, `videos_count`, `create_time`, `id`, `url`, `profile_pic_url`, `profile_pic_url_hd`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_l1villgoiiidt09ci/search_url?id=all\&tab=overview).

* **Engagement Metrics**:\
  `awg_engagement_rate`, `comment_engagement_rate`, `like_engagement_rate`, `like_count`, `digg_count`.

* **Privacy & Settings**:\
  `is_private`, `relation`, `open_favorite`, `comment_setting`, `duet_setting`, `stitch_setting`, `is_ad_virtual`, `room_id`, `is_under_age_18`.

* **Discovery & Top Videos**:\
  `region`, `top_videos`, `discovery_input`.

This API enables users to discover TikTok profiles based on search criteria, offering insights into user activity, engagement, privacy settings, and top content. It helps facilitate efficient discovery and analysis of TikTok users.

## Posts API

### Collect by URL

This API enables users to collect detailed data from TikTok posts by providing a post URL.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  The TikTok post URL.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:\
  `post_id`, `description`, `create_time`, `share_count`, `collect_count`, `comment_count`, `play_count`, `video_duration`, `hashtags`, `original_sound`, `official_item`, `original_item`, `shortcode`, `video_url`, `music`, `cdn_url`, `width`, `carousel_images`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lu702nij2f790tmv9h?id=all\&tab=overview).

* **Profile Details**:\
  `profile_id`, `profile_username`, `profile_url`, `profile_avatar`, `profile_biography`, `account_id`, `profile_followers`, `is_verified`.

* **Tagged Users and Media**:\
  `tagged_user`, `carousel_images`.

* **Additional Information:**:\
  `tt_chain_token`, `secu_id`

### Discover by Profile URL

This API allows users to retrieve posts from a TikTok profile based on a provided profile URL, with filtering options for the number of posts, date range, and post exclusions.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  The TikTok profile URL.
</ParamField>

<ParamField path="num_of_posts" type="number">
  The number of posts to collect. If not provided, there is no limit.
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  An array of post IDs to exclude from the collection.
</ParamField>

<ParamField path="start_date" type="string">
  Start date for filtering posts (format: mm-dd-yyyy). Should be lower than `end_date`.
</ParamField>

<ParamField path="end_date" type="string">
  End date for filtering posts (format: mm-dd-yyyy). Should be greater than `start_date`.
</ParamField>

<ParamField path="what_to_collect" type="string">
  Specify the type of posts to collect (e.g., "post" or "reel").
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:\
  `post_id`, `description`, `create_time`, `share_count`, `collect_count`, `comment_count`, `play_count`, `video_duration`, `hashtags`, `original_sound`, `official_item`, `original_item`, `shortcode`, `video_url`, `music`, `cdn_url`, `width`, `carousel_images`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lu702nij2f790tmv9h/profile_url?id=all\&tab=overview).

* **Profile Details**:\
  `profile_id`, `profile_username`, `profile_url`, `profile_avatar`, `profile_biography`, `account_id`, `profile_followers`, `is_verified`.

* **Tagged Users and Media**:\
  `tagged_user`, `carousel_images`.

* **Additional Information**:\
  `tt_chain_token`, `secu_id`.

This API allows users to discover and retrieve detailed information about posts from a specific TikTok profile, including post-specific metrics, profile details of the creator, and tagged users. It supports efficient content discovery and post analysis.

### Discover by Keywords

This API allows users to search for TikTok posts based on specific keywords or hashtags, offering a powerful tool for discovering relevant content across TikTok's platform.

**Input Parameters**:

<ParamField path="search_keyword" type="string" required="true">
  The keyword or hashtag to search for within TikTok posts.
</ParamField>

<ParamField path="num_of_posts" type="number">
  The number of posts to collect. If not provided, there is no limit.
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  An array of post IDs to exclude from the collection.
</ParamField>

<ParamField path="what_to_collect" type="string">
  Specify the type of posts to collect (e.g., "post" or "reel").
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:\
  `post_id`, `description`, `create_time`, `digg_count`, `share_count`, `collect_count`, `comment_count`, `play_count`, `video_duration`, `hashtags`, `original_sound`, `post_type`, `discovery_input`, `official_item`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lu702nij2f790tmv9h/keyword?id=all\&tab=overview).

* **Profile Details**:\
  `profile_id`, `profile_username`, `profile_url`, `profile_avatar`, `profile_biography`, `account_id`, `profile_followers`, `is_verified`.

* **Tagged Users and Media**:\
  `tagged_user`, `carousel_images`.

* **Additional Information**:\
  `tt_chain_token`, `secu_id`.

This API allows users to discover posts on TikTok that match specific keywords or hashtags, providing insights into post details, profile information, and media. It’s a great tool for exploring trends, content, and users on TikTok.

### Discover by Discover URL

This API allows users to collect detailed post data from a specific TikTok discover URL.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  The TikTok discover URL from which posts will be retrieved.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:\
  `post_id`, `description`, `create_time`, `digg_count`, `share_count`, `collect_count`, `comment_count`, `play_count`, `video_duration`, `hashtags`, `original_sound`, `post_type`, `discovery_input`, `official_item`, `original_item`, and more.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lu702nij2f790tmv9h/url?id=all\&tab=overview).

* **Profile Details**:\
  `profile_id`, `profile_username`, `profile_url`, `profile_avatar`, `profile_biography`, `account_id`, `profile_followers`, `is_verified`.

* **Tagged Users and Media**:\
  `tagged_user`, `carousel_images`.

* **Additional Information**:\
  `tt_chain_token`, `secu_id`.

This API provides detailed insights into TikTok posts discovered via the discover URL, allowing for easy access to trending content, user profiles, and post metadata for analysis and exploration.

## Comments API

### Collect by URL

This API allows users to collect detailed comment data from a specific TikTok post using the provided post URL.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  The TikTok post URL.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:\
  `post_url`, `post_id`, `post_date_created`.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lkf2st302ap89utw5k?id=all\&tab=overview).

* **Comment Details**:\
  `date_created`, `comment_text`, `num_likes`, `num_replies`, `comment_id`, `comment_url`.

* **Commenter Details**:\
  `commenter_user_name`, `commenter_id`, `commenter_url`.

This API provides detailed insights into TikTok post comments, including comment-specific metrics and information about the commenters, enabling effective comment analysis and interaction tracking.


# Twitter API Scrapers
Source: https://docs.brightdata.com/api-reference/web-scraper-api/social-media-apis/twitter



## Overview

The Twitter API Suite offers multiple types of APIs, each designed for specific data collection needs from Twitter. Below is an overview of how these APIs connect and interact, based on the available features:

<CardGroup cols={1}>
  <Card title="Profiles API" icon="user" href="/api-reference/web-scraper-api/social-media-apis/twitter#profiles-api">
    This API allows users to collect profile details based on a single input: profile URL.

    <br />

    *   **Discovery functionality**:

    *   N/A

    <br />

    *   **Interesting Columns**:

    *   `url`, `profile_name`, `is_verified`, `followers`.
  </Card>

  <Card title="Posts API" icon="images" href="/api-reference/web-scraper-api/social-media-apis/twitter#posts-api">
    This API allows users to collect multiple posts based on a single input URL.

    <br />

    *   **Discovery functionality**:

    *   Discover by profile URL.

    <br />

    *   **Interesting Columns**:

    *   `name`, `description`, `replies`, `likes`.
  </Card>
</CardGroup>

## Profiles API

### Profiles by URL

This API allows users to retrieve detailed Twitter profile information using the provided profile URL.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  The Twitter profile URL.
</ParamField>

<ParamField path="max_number_of_posts" type="number">
  The number of posts to collect. If omitted, there is no limit.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Profile Details**:\
  `x_id`, `url`, `id`, `profile_name`, `biography`, `is_verified`, `profile_image_link`, `external_link`, `date_joined`, `location`, `birth_date`, `posts_count`, `posts`, `suggested_profiles`, `is_business_account`, `is_government_account`, `category_name`.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lwxmeb2u1cniijd7t4?id=all\&tab=overview).

* **Engagement Metrics**:\
  `followers`, `following`, `subscriptions`.

* **Post Details**:\
  `posts`.

This API allows users to retrieve detailed Twitter profile information, including user engagement metrics, post details, and more, offering insights into user activity and profile data.

## Posts API

### Collect by URL

This API allows users to retrieve detailed post information from a specific Twitter post using the provided post URL.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  The Twitter post URL.
</ParamField>

<Note>API limitations: Up to 1000 posts per input.</Note>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:\
  `id`, `user_posted`, `name`, `description`, `date_posted`, `url`, `tagged_users`, `replies`, `reposts`, `likes`, `views`, `external_url`, `hashtags`, `quotes`, `bookmarks`, `external_image_urls`, `videos`, `quoted_post`.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lwxkxvnf1cynvib9co?id=all\&tab=overview).

* **User Profile Details**:\
  `followers`, `biography`, `posts_count`, `profile_image_link`, `following`, `is_verified`.

* **Parent Post Details**:\
  `parent_post_details`.

This API allows users to retrieve detailed information about a specific Twitter post, including user details, engagement metrics, and media content, offering insights into post interactions and user activity.

### Discover by Profile URL

This API allows users to discover and retrieve posts from a specific Twitter profile within a specified date range.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  The URL of the Twitter profile.
</ParamField>

<ParamField path="start_date" type="string">
  Start date for filtering posts in MM-DD-YYYY format.
</ParamField>

<ParamField path="end_date" type="string">
  End date for filtering posts in MM-DD-YYYY format.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:\
  `id`, `user_posted`, `name`, `description`, `date_posted`, `url`, `tagged_users`, `replies`, `reposts`, `likes`, `views`, `external_url`, `hashtags`, `quotes`, `bookmarks`, `external_image_urls`, `videos`, `quoted_post`.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lwxkxvnf1cynvib9co/profile_url?id=all\&tab=overview).

* **User Profile Details**:\
  `followers`, `biography`, `posts_count`, `profile_image_link`, `following`, `is_verified`.

* **Parent Post Details**:\
  `parent_post_details`.

This API allows users to retrieve posts from a specific Twitter profile within a defined time frame, offering detailed insights into post interactions, user data, and media content.


# Vimeo API Scrapers
Source: https://docs.brightdata.com/api-reference/web-scraper-api/social-media-apis/vimeo



## 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 cols={1}>
  <Card title="Posts API" icon="images" href="/api-reference/web-scraper-api/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 path="URL" type="string" required="true">
  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/data_api/gd_lxk88z3v1ketji4pn?id=all\&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 path="URL" type="string" required="true">
  The URL of the Vimeo post.
</ParamField>

<ParamField path="keyword" type="string" required="true">
  The keyword to search for within the video's content.
</ParamField>

<ParamField path="pages" type="number" required="true">
  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/data_api/gd_lxk88z3v1ketji4pn/url?id=all\&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 path="keyword" type="string" required="true">
  The keyword to search for in the video content.
</ParamField>

<ParamField path="license" type="string" required="true">
  The license type to filter the videos by (e.g., Creative Commons, Standard License).
</ParamField>

<ParamField path="pages" type="number" required="true">
  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/data_api/gd_lxk88z3v1ketji4pn/keyword_and_license?id=all\&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.


# YouTube API Scrapers
Source: https://docs.brightdata.com/api-reference/web-scraper-api/social-media-apis/youtube



<Note>
  If you are looking to download videos from YouTube, please contact Bright Data sales at [sales@brightdata.com](mailto:sales@brightdata.com).
</Note>

## Overview

The Youtube API Suite offers multiple types of APIs, each designed for specific data collection needs from Youtube. Below is an overview of how these APIs connect and interact, based on the available features:

<CardGroup cols={1}>
  <Card title="Profiles API" icon="user" href="/api-reference/web-scraper-api/social-media-apis/youtube#profiles-api">
    This API allows users to collect profile details based on a single input: profile URL.

    <br />

    *   **Discovery functionality**:
    *   [Discover by Keywords](/api-reference/web-scraper-api/social-media-apis/youtube#discover-profiles-by-keywords)

    <br />

    *   **Interesting Columns**:
    *   `name`, `url`, `videos_count`, `views`.
  </Card>

  <Card title="Posts API" icon="images" href="/api-reference/web-scraper-api/social-media-apis/youtube#posts-api">
    This API allows users to collect multiple posts based on a single input URL.

    <br />

    *   **Discovery functionality**:
    *   Discover by keywords.
    *   Discover by search filters.
    *   Discover by hashtag.
    *   Discover by channel URL.

    <br />

    *   **Interesting Columns**:
    *   `url`, `title`, `likes`, `views`.
  </Card>

  <Card title="Comments API" icon="comments" href="/api-reference/web-scraper-api/social-media-apis/youtube#comments-api">
    This API allows users to collect multiple comments from a post using its URL.

    <br />

    *   **Discovery functionality**:
    *   N/A

    <br />

    *   **Interesting Columns**:
    *   `comment_text`, `replies`, `likes`, `username`.
  </Card>
</CardGroup>

## Profiles API

### Collect by URL

This API allows users to retrieve detailed YouTube channel information using the provided channel URL.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  The YouTube channel URL.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Profile Details**:\
  `url`, `handle`, `name`, `description`, `created_date`, `identifier`, `id`, `handle_md5`.
* **Engagement Metrics**:\
  `subscribers`, `videos_count`, `views`.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lk538t2k2p1k3oos71?id=all\&tab=overview).
* **Media Assets**:\
  `profile_image`, `banner_img`.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lk538t2k2p1k3oos71?id=all\&tab=overview).
* **Additional Information**:\
  `details`, `links`, `discovery_input`.

This API provides insights into YouTube channel profiles, including engagement metrics, profile assets, and detailed channel information.

### Discover by Keywords

This API allows users to discover YouTube channel profiles by searching with specific keywords related to the channel or its videos.

**Input Parameters**:

<ParamField path="keyword" type="string" required="true">
  Keyword related to the channel or its videos.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Profile Details**:\
  `url`, `handle`, `name`, `description`, `created_date`, `identifier`, `id`, `handle_md5`.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lk538t2k2p1k3oos71/keyword?id=all\&tab=overview).
* **Engagement Metrics**:\
  `subscribers`, `videos_count`, `views`.
* **Media Assets**:\
  `profile_image`, `banner_img`.
* **Additional Information**:\
  `details`, `links`, `discovery_input`.

This API enables efficient discovery of YouTube channel profiles based on keywords, providing profile information, engagement metrics, and related details.

## Posts API

### Collect by URL

This API allows users to retrieve detailed video information from YouTube using the provided video URL.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  The YouTube video URL.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Video Details**:\
  `url`, `title`, `video_url`, `video_length`, `video_id`, `post_type`, `date_posted`, `description`, `music`, `transcript`, `formatted_transcript`.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lk56epmy2i5g7lzu0k?id=all\&tab=overview).
* **Engagement Metrics**:\
  `likes`, `views`, `num_comments`, `related_videos`.
* **Channel Details**:\
  `youtuber`, `youtuber_id`, `handle_name`, `channel_url`, `subscribers`, `verified`, `avatar_img_channel`, `youtuber_md5`.
* **Video Media & Quality**:\
  `preview_image`, `viewport_frames`, `current_optimal_res`, `codecs`, `color`, `quality`, `quality_label`.
* **Additional Information**:\
  `discovery_input`, `shortcode`, `is_sponsored`, `license`.

This API enables users to retrieve detailed insights about a YouTube video, including metadata, engagement metrics, and channel-specific details, supporting content analysis and tracking.

### Discover by Channel URL

This API allows users to collect videos published by a specific YouTube channel using its URL, with optional filters like the number of posts, date range, and sorting order.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  The YouTube channel URL.
</ParamField>

<ParamField path="num_of_posts" type="number">
  The number of videos to collect. If omitted, there is no limit.
</ParamField>

<ParamField path="start_date" type="string">
  Start date for filtering videos (MM-DD-YYYY).
</ParamField>

<ParamField path="end_date" type="string">
  End date for filtering videos (MM-DD-YYYY).
</ParamField>

<ParamField path="order_by" type="string">
  Sort the results (e.g., by views, date, or relevance).
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Video Details**:\
  `url`, `title`, `video_url`, `video_id`, `video_length`, `date_posted`, `description`, `post_type`.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lk56epmy2i5g7lzu0k/url?id=all\&tab=overview).
* **Channel Details**:\
  `youtuber`, `youtuber_id`, `channel_url`, `handle_name`, `avatar_img_channel`, `subscribers`, `youtuber_md5`, `verified`.
* **Engagement Metrics**:\
  `likes`, `views`, `num_comments`, `is_sponsored`.
* **Media and Technical Information**:\
  `preview_image`, `related_videos`, `music`, `shortcode`, `viewport_frames`, `current_optimal_res`, `codecs`, `color`, `quality`, `quality_label`, `license`.
* **Transcript**:\
  `transcript`, `formatted_transcript`.

This API allows efficient retrieval of YouTube videos from a specified channel with detailed video, channel, and engagement information, supporting filtering and sorting options for enhanced analysis.

### Discover by Keywords

This API allows users to search for YouTube videos using specific keywords, with optional parameters for filtering results by date range and the number of posts to retrieve.

**Input Parameters**:

<ParamField path="keyword" type="string" required="true">
  The keyword to search for videos.
</ParamField>

<ParamField path="num_of_posts" type="number">
  The number of videos to collect.
</ParamField>

<ParamField path="start_date" type="string">
  Start date for filtering videos (MM-DD-YYYY).
</ParamField>

<ParamField path="end_date" type="string">
  End date for filtering videos (MM-DD-YYYY).
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Video Details**:\
  `url`, `title`, `video_url`, `video_id`, `video_length`, `date_posted`, `description`, `post_type`.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lk56epmy2i5g7lzu0k/keyword?id=all\&tab=overview).
* **Channel Details**:\
  `youtuber`, `youtuber_id`, `channel_url`, `handle_name`, `avatar_img_channel`, `subscribers`, `youtuber_md5`, `verified`.
* **Engagement Metrics**:\
  `likes`, `views`, `num_comments`, `is_sponsored`.
* **Media and Technical Information**:\
  `preview_image`, `related_videos`, `music`, `shortcode`, `viewport_frames`, `current_optimal_res`, `codecs`, `color`, `quality`, `quality_label`, `license`.
* **Transcript**:\
  `transcript`, `formatted_transcript`.

This API enables efficient discovery of YouTube videos using keywords, supporting advanced filtering by date and result count for targeted video analysis and retrieval.

### Discover by Search Filters

This API allows users to search for YouTube videos using advanced search filters such as upload date, video type, duration, and additional features, enabling more refined and targeted video discovery.

**Input Parameters**:

<ParamField path="keyword_search" type="string" required="true">
  The keyword to search for videos.
</ParamField>

<ParamField path="upload_date" type="string">
  Filter results by upload date (e.g., today, this week, this month).
</ParamField>

<ParamField path="type" type="string">
  Specify video type (e.g., video, channel, playlist).
</ParamField>

<ParamField path="duration" type="string">
  Filter by video length (e.g., short, medium, long).
</ParamField>

<ParamField path="features" type="string">
  Specify additional video features (e.g., 4K, HD, subtitles, live).
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Video Details**:\
  `url`, `title`, `video_url`, `video_id`, `video_length`, `date_posted`, `description`, `post_type`.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lk56epmy2i5g7lzu0k/search_filters?id=all\&tab=overview).
* **Channel Details**:\
  `youtuber`, `youtuber_id`, `channel_url`, `handle_name`, `avatar_img_channel`, `subscribers`, `youtuber_md5`, `verified`.
* **Engagement Metrics**:\
  `likes`, `views`, `num_comments`, `is_sponsored`.
* **Media and Technical Information**:\
  `preview_image`, `related_videos`, `music`, `shortcode`, `viewport_frames`, `current_optimal_res`, `codecs`, `color`, `quality`, `quality_label`, `license`.
* **Transcript**:\
  `transcript`, `formatted_transcript`.

This API supports advanced search capabilities on YouTube, allowing users to filter results by multiple parameters for precise and efficient video discovery.

### Discover by Hashtag

This API allows users to search for YouTube posts by a specific hashtag, enabling users to discover videos related to trending topics or specific themes.

**Input Parameters**:

<ParamField path="hashtag" type="string" required="true">
  The hashtag to search for (e.g., #fitness, #travel).
</ParamField>

<ParamField path="num_of_posts" type="number">
  The number of posts to collect. If omitted, there is no limit.
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  An array of post IDs to exclude from the results.
</ParamField>

<ParamField path="start_date" type="string">
  Start date for filtering posts in MM-DD-YYYY format (should be earlier than end\_date).
</ParamField>

<ParamField path="end_date" 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:

* **Video Details**:\
  `url`, `title`, `video_url`, `video_id`, `video_length`, `date_posted`, `description`, `post_type`.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lk56epmy2i5g7lzu0k/hashtag?id=all\&tab=overview).
* **Channel Details**:\
  `youtuber`, `youtuber_id`, `channel_url`, `handle_name`, `avatar_img_channel`, `subscribers`, `youtuber_md5`, `verified`.
* **Engagement Metrics**:\
  `likes`, `views`, `num_comments`, `is_sponsored`.
* **Media and Technical Information**:\
  `preview_image`, `related_videos`, `music`, `shortcode`, `viewport_frames`, `current_optimal_res`, `codecs`, `color`, `quality`, `quality_label`, `license`.
* **Transcript**:\
  `transcript`, `formatted_transcript`.

This API enables efficient video discovery by searching posts related to a specific hashtag, with filtering options to refine the results.

## Comments API

### Collect by URL

This API allows users to retrieve detailed comment data from a specific YouTube video using the provided video URL.

**Input Parameters**:

<ParamField path="URL" type="string" required="true">
  The YouTube video URL.
</ParamField>

<ParamField path="load_replies" type="number">
  Number of times to load replies for comments.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Comment Details**:\
  `comment_id`, `comment_text`, `likes`, `replies`, `replies_value`, `replies_without_names`.

  > For all data points, [click here](https://brightdata.com/cp/data_api/gd_lk9q0ew71spt1mxywf?id=all\&tab=overview).
* **User Details**:\
  `username`, `user_channel`, `username_md5`.
* **Additional Information**:\
  `date`, `url`, `video_id`.

This API enables users to analyze YouTube video comments, including replies and user details, providing insights into engagement and audience interactions.


# Synchronous Requests
Source: https://docs.brightdata.com/api-reference/web-scraper-api/synchronous-requests

dca-api POST /datasets/v3/scrape
This endpoint allows users to fetch data efficiently and ensures seamless integration with their applications or workflows.

## 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
{
  "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."
}
```


# Choose a delivery type on request level
Source: https://docs.brightdata.com/api-reference/web-scraper-ide-api/Choose_a_delivery_type_on_request_level



Instead of creating duplicate scrapers for each delivery type, you can choose a delivery type per job using API.

<Frame>
    <img src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/hero-image.png?maxW=1308&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=c0b2fe035d6e7e5a7c588f6e90762340" alt="hero-image.png" width="1308" height="371" data-path="images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/hero-image.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/hero-image.png?w=280&maxW=1308&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=2e2b92998f618f879fac1211b882054f 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/hero-image.png?w=560&maxW=1308&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=f2a56e49fc9f13a26e3234e61fd5ed88 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/hero-image.png?w=840&maxW=1308&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=04df0e8b5584c3226142c059ff7bcb8b 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/hero-image.png?w=1100&maxW=1308&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=931d0c0c9ec256c46840799ee24e96a3 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/hero-image.png?w=1650&maxW=1308&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=53a11be50bffe6b9a251f3a2842eb67e 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/hero-image.png?w=2500&maxW=1308&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=0cecafda621ce9b46421f842d582ab43 2500w" data-optimize="true" data-opv="2" />
</Frame>

<Steps>
  <Step title="Update your scraper">
    Ensure that your scraper is updated to the latest version to improve success rate

    <Frame>
            <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/update-available.png?maxW=1624&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=df87a15795545a363756958702990976" alt="update-available.png" width="1624" height="354" data-path="images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/update-available.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/update-available.png?w=280&maxW=1624&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b99489472e3b7faddd90161e0e3c3d00 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/update-available.png?w=560&maxW=1624&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=12026b857faa4fd04a8aa2c1d99c7238 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/update-available.png?w=840&maxW=1624&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=1dbfe7136f77d85694c1798798986316 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/update-available.png?w=1100&maxW=1624&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=cb34a39f5c79e5908904768381d6ba9b 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/update-available.png?w=1650&maxW=1624&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=14b6173f2572d87100cf04a1f5f1b7f9 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/update-available.png?w=2500&maxW=1624&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=1cd6714dacd0ae694733cbf6f76d7222 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Set a delivery type to Batch">
    <Frame>
            <img src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/type-batch.png?maxW=1613&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=dd60e9b95d5573d7fe7a4409a4de1037" alt="type-batch.png" width="1613" height="353" data-path="images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/type-batch.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/type-batch.png?w=280&maxW=1613&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=457f6876d775594573995268a43661dc 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/type-batch.png?w=560&maxW=1613&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=873563b42435812f3a5e28f1d279fbc8 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/type-batch.png?w=840&maxW=1613&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=9dbfcd03ac80990bde022c7f47117dfc 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/type-batch.png?w=1100&maxW=1613&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=c55d8f1744ecab09d1cd7cf2522664bd 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/type-batch.png?w=1650&maxW=1613&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=c4d3954a5ee1aced17a67fa30080d7de 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/type-batch.png?w=2500&maxW=1613&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=649b5026abcf6398d1aaa20fad97d757 2500w" data-optimize="true" data-opv="2" />
            <img src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/on-completion.png?maxW=940&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=346027bcef3fdde227ba05b2c037559b" alt="on-completion.png" width="940" height="287" data-path="images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/on-completion.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/on-completion.png?w=280&maxW=940&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=9d48446843be9e86d4547238689f0114 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/on-completion.png?w=560&maxW=940&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=e225695298275c22580c6afd6b136221 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/on-completion.png?w=840&maxW=940&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=3e95408899b10f543eb6126f4c1f2b74 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/on-completion.png?w=1100&maxW=940&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=4e5dd538f482b201c6d975d589b10129 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/on-completion.png?w=1650&maxW=940&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=9af5a9e4fa834daefefa6df6850345e8 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/on-completion.png?w=2500&maxW=940&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=e420aaca6e545917f8dbafb2ecbfc894 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    Following error message will be returned from Batch API when delivery type is set to Realtime.

    ```json Error
    "error": "Cannot trigger a batch job with a real-time scraper. Use /trigger_immediate endpoint instead"
    ```
  </Step>

  <Step title="Trigger the scraper using a preferred API">
    <Tabs>
      <Tab title="Initiate a Batch job">
        `dca/trigger`

        [Trigger a scraper for batch collection method](/api-reference/web-scraper-ide-api/Trigger_a_scraper_for_batch_collection_method)

        <CodeGroup>
          ```sh Shell
          curl "https://api.brightdata.com/dca/trigger?collector=ID_COLLECTOR&queue_next=1" -H "Content-Type: application/json" -H "Authorization: Bearer API_KEY" -d '[{"url":"https://targetwebsite.com/product_id/"}]'
          ```

          ```json Sample Response
          {
              "collection_id":"j_l3daejgw1wnpjxxxxx",
              "start_eta":"2022-05-19T17:28:48.056Z"
          }
          ```
        </CodeGroup>
      </Tab>

      <Tab title="Initiate a Realtime job">
        `dca/trigger_immediate`

        [Trigger a scraper for real-time collection](/api-reference/web-scraper-ide-api/Receive_data_from_real_time_work_scraper)

        <CodeGroup>
          ```sh Shell
          curl "https://api.brightdata.com/dca/trigger_immediate?collector=ID_COLLECTOR" -H "Content-Type: application/json" -H "Authorization: Bearer API_KEY" -d '{"url":"https://targetwebsite.com/product_id/"}'
          ```

          ```json Sample Response
          {
              "response_id":"z2805t1652973963340rg6252xxxxxx"
          }
          ```
        </CodeGroup>
      </Tab>
    </Tabs>

    <Note>
      Batch responses begin with `j_****` and real-time responses begin with `z****`
    </Note>
  </Step>

  <Step title="Receive data">
    * [Receive batch data](/api-reference/web-scraper-ide-api/Receive_batch_data)
    * [Receive data from real-time work scraper](/api-reference/web-scraper-ide-api/Receive_data_from_real_time_work_scraper)
  </Step>
</Steps>


# Getting started with the API
Source: https://docs.brightdata.com/api-reference/web-scraper-ide-api/Getting_started_wtih_the_API

The Data scraper product offers a JSON API to control and inspect your data scrapers programmatically.

1. Signup (or login) to our control panel
2. Insert target URL (website to collect data from) or choose a ready-made template
3. Set up the delivery preference of scraper: Batch or Real-Time
4. Initiate by API

<Tip>
  NOT A DEVELOPER? Contact our support for easy onboarding.
</Tip>

The data scraper is divided into two crawling systems:

<Tabs>
  <Tab title="Batch">
    This is an efficient way of handling large amounts of data. Data is collected in batches over a period of time. After the data is collected, entered, and processed, the batch results are generated. You can deliver the results all at once or stream them to your system as they're collected.
  </Tab>

  <Tab title="Real-Time">
    This is an ideal way to get a fast response for one request. This is useful in environments where you have a limited amount of time to crawl a page and get the data.
  </Tab>
</Tabs>

The Data scraper API has four general workflows:

1. [Batch trigger + Push delivery](/api-reference/web-scraper-ide-api/Trigger_a_scraper_for_batch_collection_method)
2. [Batch trigger + API polling](/api-reference/web-scraper-ide-api/Receive_batch_data)
3. [Real-time trigger + Push delivery](/api-reference/web-scraper-ide-api/Trigger_a_scraper_for_real_time_collection)
4. [Real-time trigger + API polling](/api-reference/web-scraper-ide-api/Receive_data_from_real_time_work_scraper)


# Receive Batch Data
Source: https://docs.brightdata.com/api-reference/web-scraper-ide-api/Receive_batch_data

web-scraper-ide-rest-api GET /dca/dataset
Receive Batch data



# Receive data from real-time work scraper
Source: https://docs.brightdata.com/api-reference/web-scraper-ide-api/Receive_data_from_real_time_work_scraper

web-scraper-ide-rest-api GET /dca/get_result
Receive data from real-time work scraper



# Trigger a scraper for batch collection method
Source: https://docs.brightdata.com/api-reference/web-scraper-ide-api/Trigger_a_scraper_for_batch_collection_method

web-scraper-ide-rest-api POST /dca/trigger
Trigger a scraper for batch collection method



# Trigger a scraper for real-time collection
Source: https://docs.brightdata.com/api-reference/web-scraper-ide-api/Trigger_a_scraper_for_real_time_collection

web-scraper-ide-rest-api POST /dca/trigger_immediate
Trigger a scraper for real-time collection



# IDE Job data API
Source: https://docs.brightdata.com/api-reference/web-scraper-ide-api/job-data

web-scraper-ide-rest-api GET /dca/log/{job_id}
Get job data by job ID



# 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





# 添加静态 IP
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Add_Static_Datacenter_ISP_IPs

POST /zone/ips
Add Static IPs for Datacenter and ISP

<Warning> **Warning:** This API can modify your ac数量 settings, damage your operations or incur charges.</Warning>

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an ac数量](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 添加区域
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Add_a_Zone

POST /zone
Add a new zone

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>

# 添加计划示例

<Tabs>
  <Tab title="数据中心">
    ```sh 添加共享数据中心 - 按使用区域付费
    curl "https://api.brightdata.com/区域" -H "Content-Type: application/json" -H "身份验证: 持有者 API_KEY" -d "{'区域':{'名称':'区域_名称'},'计划':{'类型':'static','ips_类型':'shared','ip_alloc_preset':'shared_block'}}"
    ```
  </Tab>

  <Tab title="ISP">
    ```sh Add an ISP - Exclusive 区域
    curl "https://api.brightdata.com/区域" -H "Content-Type: application/json" -H "身份验证: 持有者 API_KEY" -d "{'区域':{'名称':'区域_名称'},'计划':{'类型':'static','ips_类型':'dedicated','pool_ip_类型':'static_res','ips':3}}"
    ```
  </Tab>

  <Tab title="住宅">
    ```sh Add a 住宅 - Exclusive with Exclusive domain 'example.com' 区域
    curl "https://api.brightdata.com/区域" -H "Content-Type: application/json" -H "身份验证: 持有者 API_KEY" -d "{'区域':{'名称':'区域_名称'},'计划':{'类型':'resident','VIP_类型':'domain','VIP':true,'VIP':3,'domain_whitelist':'example.com'}}"
    ```
  </Tab>

  <Tab title="移动设备">
    *

    ```sh Add a 移动设备 - Shared 区域
    curl "https://api.brightdata.com/区域" -H "Content-Type: application/json" -H "身份验证: 持有者 API_KEY" -d "{'区域':{'名称':'区域_名称'},'计划':{'类型':'resident','移动设备':true,'VIP_类型':'shared'}}"
    ```
  </Tab>

  <Tab title="解锁器">
    ```sh Add a Web Unlcoker Zone
    curl "https://api.brightdata.com/区域" -H "Content-Type: application/json" -H "身份验证: 持有者 API_KEY" -d "{'区域':{'名称':'区域_名称'},'计划':{'类型':'unblocker'}}"
    ```
  </Tab>

  <Tab title="SERP">
    ```sh Add a SERP Zone
    curl "https://api.brightdata.com/区域" -H "Content-Type: application/json" -H "身份验证: 持有者 API_KEY" -d "{'区域':{'名称':'区域_名称'},'计划':{'类型':'resident','serp':true}}"
    ```
  </Tab>
</Tabs>

<RequestExample>
  ```sh Shell
  curl "https://api.brightdata.com/zone" -H "Content-Type: application/json" -H "Authorization: Bearer API_KEY" -d "{'zone':{'name':'zone_name'},'plan':{'type':'static|resident','ips_type':'shared|dedicated|selective','ip_alloc_preset':'shared_block','bandwidth':'payperusage|unlimited','mobile':false,'city':false,'asn':false,'vip':false,'vips_type':'shared|vip|domain','vips':0,'domain_whitelist':'test.com fb.com','not_country':null,'vip_country':'any','exclusive_sec':0,'exclusive_type':'days','exclusive_num':0,'ips':0}}"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({
      method: 'POST',
      url: 'https://api.brightdata.com/zone',
      json: {
          'zone': {
              'name': 'zone_name'
          },
          'plan': {
              'type': 'static|resident',
              'ips_type': 'shared|dedicated|selective',
              'ip_alloc_preset': 'shared_block',
              'bandwidth': 'payperusage|unlimited',
              'mobile': false,
              'city': false,
              'asn': false,
              'vip': false,
              'vips_type': 'shared|vip|domain',
              'vips': 0,
              'domain_whitelist': 'test.com fb.com',
              'not_country': null,
              'vip_country': 'any',
              'exclusive_sec': 0,
              'exclusive_type': 'days',
              'exclusive_num': 0,
              'ips': 0
          }
      },
      headers: {
          'Authorization': 'Bearer API_KEY'
      },
  }).then(function(data) {
          console.log(data);
      },
      function(err) {
          console.error(err);
      });
  ```

  ```java Java
  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':{'name':'zone_name'},'plan':{'type':'static|resident','ips_type':'shared|dedicated|selective','ip_alloc_preset':'shared_block','bandwidth':'payperusage|unlimited','mobile':false,'city':false,'asn':false,'vip':false,'vips_type':'shared|vip|domain','vips':0,'domain_whitelist':'test.com fb.com','not_country':null,'vip_country':'any','exclusive_sec':0,'exclusive_type':'days','exclusive_num':0,'ips':0}}";
      String res = Executor.newInstance()
        .addHeader("Authorization", "Bearer API_KEY")
        .execute(Request.Post("https://api.brightdata.com/zone")
          .bodyString(body, ContentType.APPLICATION_JSON))
        .returnContent().asString();
      System.out.println(res)
    }
  }
  ```

  ```cs C#
  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("https://api.brightdata.com/zone"),
          Headers = {
            {
              "Authorization",
              "Bearer API_KEY"
            }
          },
          Content = new StringContent(JsonConvert.SerializeObject(new {
            zone = new {
                name = "zone_name"
              },
              plan = new {
                type = "static|resident", ips_type = "shared|dedicated|selective", ip_alloc_preset = "shared_block", bandwidth = "payperusage|unlimited", mobile = false, city = false, asn = false, vip = false, vips_type = "shared|vip|domain", vips = 0, domain_whitelist = "test.com fb.com", not_country = null, vip_country = "any", exclusive_sec = 0, exclusive_type = "days", exclusive_num = 0, ips = 0
              }
          }), Encoding.UTF8, "application/json"))
    };
    var response = await client.SendAsync(requestMessage);
    var responseString = await response.Content.ReadAsStringAsync();
    Console.WriteLine(responseString);
  }
  }
  ```

  ```python Python
  #!/usr/bin/env python
  import requests
    
  data = {
  	'zone':{'name': 'zone_name'},
  	'plan':{
  		'type': 'static|resident',
  		'ips_type': 'shared|dedicated|selective',
  		'ip_alloc_preset':'shared_block',
  		'bandwidth':'payperusage|unlimited',
  		'mobile':False,
  		'city':False,
  		'asn':False,
  		'vip':False,
  		'vips_type':'shared|vip|domain',
  		'vips':0,
  		'domain_whitelist':'test.com fb.com',
  		'not_country':null,
  		'vip_country':'any',
  		'exclusive_sec':0,
  		'exclusive_type':'days',
  		'exclusive_num':0,
  		'ips':0
  	}
  }
  headers = {'Authorization': 'Bearer API_KEY'}

  r = requests.post(
  	'https://api.brightdata.com/zone',
  	data=data,
  	headers=headers
  )

  print(r.content)
  ```
</RequestExample>


# 更改账户状态
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Change_account_status

PUT /status

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 获取可用国家
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_Available_Countries

GET /countrieslist
List all available countries per zone type 

<Tip>
  将您的 API 令牌粘贴到授权字段中。要获取令牌，请[创建账户](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground)，并了解如何[生成令牌](/cn/api-reference/unlocker/api_token)。
</Tip>


# 区域统计信息
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_Zone_Static_Datacenter_ISP_IPs

GET /zone/ips
Get Zone Static (Datacenter/ISP) IPs

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>

```json Response when "ip_per_country=true"
{
    "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
}
```


# 区域信息
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_Zone_info

GET /zone
Get Zone status

<Tip>
  请将 API 令牌粘贴到“授权”字段。 如需获取令牌，请创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/api-reference/unlocker/api_token)
</Tip>


# 区域密码
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_Zone_passwords

GET /zone/passwords
Get Zone passwords

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 区域权限
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_Zone_permissions

GET /zone/permissions
Get Zone permissions

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 区域状态
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_Zone_status

GET /zone/status
Get Zone status

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 账户状态
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_account_status

GET /status
Get account status

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 活动区域
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_active_Zones

GET /zone/get_active_zones
Return all active zones

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 可用的 IP/区域
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_all_available_dedicated_residential_IPs_per_Zone

GET /zone/route_vips
Get all available residential dedicated IPs per Zone

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>

<Warning>仅适用于专属固定区域</Warning>


# 数据中心和 ISP 的可用 IP 数量
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_amount_of_available_Datacenter_and_ISP_IPs

GET /zone/count_available_ips

<Tip>
  请将 API 令牌粘贴到“授权”字段。 如需获取令牌，请创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/api-reference/unlocker/api_token)
</Tip>

<Accordion title="计划示例">
  * 当前区域计划中可用的 IP:

  ```sh
  curl "https://api.brightdata.com/count_available_ips?zone=ZONE" -H "Authorization: Bearer API_KEY"
  ```

  * 抽象计划，专用 IP：

  ```sh dedicated IPs
  curl "https://api.brightdata.com/count_available_ips?plan=\{\"ips_type\":\"dedicated\"\}" -H "Authorization: Bearer API_KEY"
  ```

  * 抽象计划，共享 IP 位于美国：

  ```sh
  curl "https://api.brightdata.com/count_available_ips?plan=\{\"country\":\"us\",\"ips_type\":\"shared\"\}" -H "Authorization: Bearer API_KEY"
  ```

  * 抽象计划，专用 IP 位于美国：

  ```sh
  curl "https://api.brightdata.com/count_available_ips?plan=\{\"country\":\"us\",\"ips_type\":\"dedicated\"\}" -H "Authorization: Bearer API_KEY"
  ```

  * 抽象计划，共享 IP 位于美国丹佛：

  ```sh
  curl "https://api.brightdata.com/count_available_ips?plan=\{\"ips_type\":\"shared\",\"country_city\":\"us-denver\",\"city\":true\}" -H "Authorization: Bearer API_KEY"
  ```

  * 抽象计划，共享 IP 位于美国，仅适用于以下域名：amazon.com 和 fb.com：

  ```sh
  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"
  ```

  * 抽象计划，共享 IP 位于美国，地理位置 IP 数据库：需同时存储在 `maxmind` 和 `dbip` 中：

  ```sh
  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>


# 获取国家/地区城市
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_country_cities

GET /cities
Get a list of cities from a Country

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 获取当前服务状态
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_current_service_status

GET /network_status/{NETWORK_TYPE}

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 列出所有国家/地区的可用城市（静态网络）
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_list_of_available_cities_of_static_network_per_country

GET /zone/static/cities
Get list of available cities of static network per country

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 静态区域的实时状态
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_live_status_of_Static_Datacenter_ISP_Zone_and_IPs_with_connectivity_problem

GET /zone/ips/unavailable
Get live status of Static (Datacenter/ISP) Zone and IPs with connectivity problem

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 最近尝试使用您的区域的 IP
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_recent_IPs_attempting_to_use_your_Zone

GET /zone/recent_ips

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 可用数据中心和 ISP IP/区域
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_the_available_Data_center_ISP_IPs_per_Zone

GET /zone/route_ips
Get the available Data center/ISP IPs per Zone

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 区域的带宽统计信息
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_the_bandwidth_stats_for_a_Zone

GET /zone/bw
Get the bandwidth stats for a Zone

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 所有区域的带宽统计信息
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_the_bandwidth_stats_for_all_your_Zones

GET /customer/bw
Get the bandwidth stats for all your Zones

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>

<Note>Sample response redacted</Note>


# 区域总成本和带宽
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_the_total_cost_and_bandwidth_stats_for_a_Zone

GET /zone/cost
Get the total cost and bandwidth stats for a Zone

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 总余额
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Get_total_balance_through_API

GET /customer/balance
Get total balance through API

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 在区域间迁移静态 IP
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Migrate_Static_Datacenter_ISP_IPs_between_zones

POST /zone/ips/migrate
Migrate Static IPs between zones (Datacenter/ISP)

<Warning>
  **警告**：此 API 可能会修改账户设置、影响正常操作或产生额外费用。
</Warning>

<Tip>
  请将 API 令牌粘贴到“授权”字段。 如需获取令牌，请创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/api-reference/unlocker/api_token)
</Tip>


# 刷新静态 IP（数据中心/ISP）
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Refresh_Static_Datacenter_ISP_IPs

POST /zone/ips/refresh

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>

<Tip>
  [查看刷新数据中心 IP 的定价](/cn/general/account/billing-and-pricing/faqs#what-is-the-cost-for-refreshing-data-center-IP)
</Tip>

```json Sample Response for Static IPs
{
    "IP":[
        "1.1.1.1",
        "1.1.1.2",
        "1.1.1.3"
    ],
    "new_IP":[
        "1.1.1.1",
        "1.1.1.3"
    ]
}
```


# 刷新专用住宅 IP
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Refresh_dedicated_residential_IPs

POST /zone/ips/refresh

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>

<Warning>
  每个专用住宅 IP 刷新费用为每个 IP 每次刷新 \$0.02
</Warning>


# 移除静态 IP（数据中心/ISP）
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Remove_Static_Datacenter_ISP_IPs

DELETE /zone/ips

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 移除区域
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Remove_Zone

DELETE /zone

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 移除专用住宅 IP
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Remove_dedicated_residential_IPs

DELETE /zone/vips

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 切换 100% 正常运行时间
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Switch_100_uptime_ON_OFF_in_a_Static_zone

POST /zone/switch_100uptime
Switch automatic failover (100% uptime) ON/OFF in a Static zone

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 开启/关闭区域
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/Turn_on_off_Zone

POST /zone/change_disable

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 建立 IP 白名单
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/allowlist-ip

POST /zone/whitelist
Add IP to zone's allowlist

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 建立域名白名单/黑名单
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/allowlist-or-denylist-domains

POST /zone/domain_perm
Add domain to Zone allowlist or denylist

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 将 IP 列入黑名单
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/denylist-ip

POST /zone/blacklist
Add IP to zone's denylist

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 获取待更换代理
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/get-proxies-pending-replacement

GET /zone/proxies_pending_replacement
Get list of all proxies in the provided zone, which are pending replacement



# 从区域白名单/黑名单中移除域名
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/remove-domain-from-zone-allowlist-or-denylist

DELETE /zone/domain_perm

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 从区域白名单中移除 IP
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/remove-ip-from-zone-allowlist

DELETE /zone/whitelist

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 从区域黑名单中移除 IP
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/remove-ip-from-zone-denylist

DELETE /zone/blacklist

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# 特定区域的白名单 IP 列表
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/zone-ip-allowlist

GET /zone/whitelist
Get a list of allowlisted IPs for a specific Zone

<Tip>
  请将 API 令牌粘贴到“授权”字段。 如需获取令牌，请创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/api-reference/unlocker/api_token)
</Tip>


# 区域黑名单 IP 列表
Source: https://docs.brightdata.com/cn/api-reference/account-management-api/zone-ip-denylist

GET /zone/blacklist
Get a list of denylisted IPs for a specific Zone

<Tip>
  将您的 API 令牌粘贴到身份验证字段。要获得令牌，创建账户并了解如何生成令牌

  [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground), [generate an API key](/cn/api-reference/unlocker/api_token)
</Tip>


# API vs 本地访问
Source: https://docs.brightdata.com/cn/api-reference/api-vs-native-access

哪种方式更适合我？

Bright Data 的代理和解锁平台（Unlocker API、SERP API 和代理产品）可通过两种方式访问：

1. **API 访问** - 通过标准化的 HTTP 方法（如 GET、POST、REST API 调用）和端点与 Bright Data 平台交互，以发送请求并检索结构化数据（JSON 或 HTML）。

   适用于：与内部脚本或第三方应用程序的无缝、可扩展集成。

2. **本地访问** - 通过为每个产品定制的代理协议直接与 Bright Data 平台交互。

   适用于：需要直接代理连接（IP:端口）的网页浏览器和[第三方工具](https://docs.brightdata.com/integrations)集成。

## **请求示例**

### **API 访问**

```sh
curl https://api.brightdata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer <API_KEY>" -d "{"zone": "zone_name","url": "https://www.example.com", "format": "raw"}"
```

### **本地访问**

```sh
curl -i --proxy brd.superproxy.io:33335 --proxy-user <USERNAME>:<PASSWORD> "https://www.example.com"
```

## **API vs 本地访问对比**

| 参数         | API 访问                     | 本地访问                |
| ---------- | -------------------------- | ------------------- |
| **推荐产品**   | Unlocker API, SERP API, 代理 | 代理 - 适用于需要直接代理连接的情况 |
| **SSL 证书** | 不需要                        | 需要（数据中心和 ISP 代理除外）  |
| **账户验证**   | 通常不需要                      | 某些特定域名需要            |
| **连接方式**   | API 端点                     | 代理端点                |
| **身份验证**   | API 令牌                     | 用户名:密码              |
| **输出格式**   | HTML 或 JSON                | HTML                |

## **计费**

本地访问和 API 访问的计费 **相同**，费用基于您的 Bright Data 产品的常规定价。


# 交付快照
Source: https://docs.brightdata.com/cn/api-reference/marketplace-dataset-api/deliver-snapshot

dca-api POST /datasets/snapshots/{id}/deliver
Deliver the dataset snapshot



# 快照内容
Source: https://docs.brightdata.com/cn/api-reference/marketplace-dataset-api/download-the-file-by-snapshot_id

dca-api GET /datasets/snapshots/{id}/download
Get dataset snapshot content



# 过滤数据集
Source: https://docs.brightdata.com/cn/api-reference/marketplace-dataset-api/filter-dataset

dca-api POST /datasets/filter
Create a dataset snapshot based on a provided filter

<Tip>
  将您的 API 令牌粘贴到授权字段中。要获取令牌，[创建一个账户](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground)，并了解如何[生成令牌](/api-reference/unlocker/api_token)。
</Tip>

## 一般描述

* 调用此端点将启动异步作业，以过滤数据集并在您的账户中创建包含过滤数据的快照。

* 该作业的最大完成时间为 5 分钟。如果在此时间范围内未完成，作业将被取消。

* 创建数据集快照的费用取决于快照大小和记录单价。

* 过滤组的最大嵌套深度为 3。

## 过滤语法

### 运算符

下表显示了可用于字段过滤的运算符。

| 操作符                  | 字段类型   | 描述                                                                                |
| -------------------- | ------ | --------------------------------------------------------------------------------- |
| =                    | 任意     | 等于                                                                                |
| !=                   | 任意     | 不等于                                                                               |
| \<                   | 数字, 日期 | 小于                                                                                |
| \<=                  | 数字, 日期 | 小于或等于                                                                             |
| >                    | 数字, 日期 | 大于                                                                                |
| >=                   | 数字, 日期 | 大于或等于                                                                             |
| `in`                 | 任意     | 测试字段值是否等于筛选值中提供的任意值                                                               |
| `not_in`             | 任意     | 测试字段值是否不等于筛选值中提供的所有值                                                              |
| `includes`           | 数组, 文本 | 测试字段值是否包含筛选值。如果筛选值是一个单一字符串，则匹配字段值包含该字符串的记录。如果筛选值是一个字符串数组，则匹配字段值包含数组中的至少一个字符串的记录。  |
| `not_includes`       | 数组, 文本 | 测试字段值是否不包含筛选值。如果筛选值是一个单一字符串，则匹配字段值不包含该字符串的记录。如果筛选值是一个字符串数组，则匹配字段值不包含数组中的任何字符串的记录。 |
| `array_includes`     | 数组     | 测试筛选值是否在字段值中（精确匹配）                                                                |
| `not_array_includes` | 数组     | 测试筛选值是否不在字段值中（精确匹配）                                                               |
| `is_null`            | 任意     | 测试字段值是否等于 NULL。操作符不接受任何值。                                                         |
| `is_not_null`        | 任意     | 测试字段值是否不等于 NULL。操作符不接受任何值。                                                        |

### 组合多个筛选器

可以使用两个逻辑运算符：'and'（与），'or'（或）将多个字段筛选器组合成筛选器组。\
API 支持最多 3 层嵌套的筛选器。\
筛选器组示例：

```json
{
    // operator can be one of ["and", "or"]
    "operator": "and",
    // an array of field filters
    "filters": [
        {
            "name": "reviews_count",
            "opeartor": ">",
            "value": "200"
        },
        {
            "name": "rating",
            "operator": ">",
            "value": "4.5"
        }
    ]
}
```


# 获取快照元数据
Source: https://docs.brightdata.com/cn/api-reference/marketplace-dataset-api/get-snapshot-meta

dca-api GET /datasets/snapshots/{id}
Get dataset snapshot metadata



# 获取快照部分
Source: https://docs.brightdata.com/cn/api-reference/marketplace-dataset-api/get-snapshot-parts

dca-api GET /datasets/snapshots/{id}/parts
Get dataset snapshot delivery parts. All query parameters used here need to match those used when downloading the snapshot to get accurate parts



# 获取快照元数据
Source: https://docs.brightdata.com/cn/api-reference/marketplace-dataset-api/get-snapshots-meta

dca-api GET /datasets/snapshots
Get dataset snapshots metadata



# 添加用户
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/add_a_user



**API 端点:** `POST` `/api/lpm_user`

## `POST` 正文

<ParamField body="电子邮件" type="字符串" 必填项>
  要添加的用户电子邮件地址
</ParamField>

{/* TODO: Missing Sample Response */}

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/lpm_user" -H "Content-Type: application/json" -d '{"email":"test@example.com"}'
  ```

  ```js NodeJS
  #!/usr/bin/env node
  require('request-promise')({
      method: 'POST',
      url: 'http://127.0.0.1:22999/api/lpm_user',
      json: {'email':'test@example.com'}

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python
  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

  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>


# 建立 IP 白名单
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/allowlist-ips



**API 端点:** `PUT` `/api/wip`

<ParamField header="Authorization" type="string" required>
  API 令牌

  <Tip>
    应通过“生成令牌 API”命令生成令牌

    [Generate API Key](/cn/api-reference/proxy-manager/generate_token_for_token_based_authentication)
  </Tip>
</ParamField>

## `PUT` body

<ParamField body="ip" type="string" required>
  要列入白名单的 IP。例如，`ip="1.2.1.2"`
</ParamField>

<RequestExample>
  ```sh Shell
  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
  #!/usr/bin/env node

  require('request-promise')({
    method: 'PUT',
    url: 'http://127.0.0.1:22999/api/wip',
    json: {'ip':'1.2.1.2'},
    headers: {'Authorization': 'API key'},
  }).then(function(data){ console.log(data);},

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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
  Successful response
  ```

  ```json 400
  Bad request. No IP was passed
  ```

  ```json 403
  Forbidden. No authentication provided
  ```

  ```json 422
  Unprocessable entity. Invalid IP was passed
  ```
</ResponseExample>


# 封禁 IP（所有端口）
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/ban_an_ip_for_all_ports



**API  端点:** `POST` `/api/banip`

## `POST` body

<ParamField body="ip" type="string" required>
  所要封禁的 IP。例如 `1.2.1.2`
</ParamField>

<ParamField body="domain" type="string">
  封禁向指定域发送请求的 IP
</ParamField>

<ParamField body="ms" type="integer">
  在指定毫秒内封禁 IP
</ParamField>

<RequestExample>
  ```sh Shell
  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
  #!/usr/bin/env node

  require('request-promise')({
      method: 'POST',
      url: 'http://127.0.0.1:22999/api/banip',
      json: {'ip':'1.2.1.2','domain':'example.com','ms':60000}
  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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/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
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

  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>


# 封禁 IP
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/ban_an_ip_single_



**API 端点:** `POST` `/api/proxies/{PORT}/banip`

## 路径参数

<ParamField body="PORT" type="string" required>
  现有代理服务器端口号
</ParamField>

## `POST` 正文

<ParamField body="ip" type="string" required>
  所要封禁的 IP。例如 `1.2.1.2`
</ParamField>

<ParamField body="domain" type="string">
  封禁向指定域发送请求的 IP
</ParamField>

<ParamField body="ms" type="integer">
  在指定毫秒内封禁 IP
</ParamField>

<RequestExample>
  ```sh Shell
  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
  #!/usr/bin/env node

  require('request-promise')({
    method: 'POST',
    url: 'http://127.0.0.1:22999/api/proxies/{PORT}/banip',
    json: {'ip':'1.2.1.2','domain':'example.com','ms':60000}
  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');
  import requests


  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>


# 封禁多个 IP（阵列）
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/ban_ips_array_



**API 端点:** `POST` `/api/proxies/{PORT}/banips`

## 路径参数

<ParamField body="PORT" type="string" required>
  现有代理服务器端口号
</ParamField>

## `POST` body

<ParamField body="ips" type="array" required>
  所要封禁的 IP。例如 `["10.0.0.1", "20.0.0.1"]`
</ParamField>

<ParamField body="domain" type="string">
  封禁向指定域发送请求的 IP
</ParamField>

<ParamField body="ms" type="integer">
  在指定毫秒内封禁 IP
</ParamField>

<RequestExample>
  ```sh Shell
  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
  #!/usr/bin/env node
  require('request-promise')({
      method: 'POST',
      url: 'http://127.0.0.1:22999/api/proxies/{PORT}/banips',
      json: {'ips':['10.0.0.1','20.0.0.1'],'domain':'example.com','ms':60000}
  }).then(function(data){ console.log(data);},

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  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>


# 创建新的代理端口
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/create_a_new_proxy_port



**API 端点:** `POST` `/api/proxies`

## `POST` 正文

<ParamField body="代理" type="用户对象">
  <Expandable title="properties">
    <ParamField body="port" type="integer">
      HTTP 代理的端口
    </ParamField>

    <ParamField body="proxy_type" type="string">
      设置为 `persist` 以将代理保存到配置文件中。
    </ParamField>

    <ParamField body="multiply" type="integer">
      将端口定义乘以给定的次数
    </ParamField>

    <ParamField body="multiply_users" type="boolean" />

    <ParamField body="users" type="array">
      用户 `[string]` 的列表。此选项必须与 `multiply_users` 一起使用
    </ParamField>

    <ParamField body="ssl" type="boolean">
      启用 SSL 分析
    </ParamField>

    <ParamField body="tls_lib" type="string">
      选择 SSL 库

      | value      | description |
      | ---------- | ----------- |
      | `open_ssl` | 打开 SSL 库    |
      | `flex_tls` | Flex TLS 库  |
    </ParamField>

    <ParamField body="iface" type="string">
      所要监听的接口或 IP
    </ParamField>

    <ParamField body="customer" type="string">
      客户名称
    </ParamField>

    <ParamField body="zone" type="string">
      区域名称
    </ParamField>

    <ParamField body="password" type="string">
      区域密码
    </ParamField>

    <ParamField body="proxy" type="string">
      超级代理的主机名或 IP
    </ParamField>

    <ParamField body="proxy_port" type="integer">
      超级代理端口
    </ParamField>

    <ParamField body="proxy_connection_type" type="string">
      确定代理管理器和超级代理之间将使用哪种连接

      |         |   |
      | ------- | - |
      | `http`  |   |
      | `https` |   |
      | `socks` |   |
    </ParamField>

    <ParamField body="proxy_retry" type="integer">
      超级代理出现故障时自动重试
    </ParamField>

    <ParamField body="insecure" type="boolean">
      对不安全的主机启用 SSL 连接/分析
    </ParamField>

    <ParamField body="country" type="string">
      国家/地区
    </ParamField>

    <ParamField body="state" type="string">
      州
    </ParamField>

    <ParamField body="city" type="string">
      城市
    </ParamField>

    <ParamField body="asn" type="string">
      ASN
    </ParamField>

    <ParamField body="ip" type="string">
      数据中心 IP
    </ParamField>

    <ParamField body="vip" type="integer">
      gIP
    </ParamField>

    <ParamField body="ext_proxies" type="array">
      来自外部供应商的代理列表。 格式：`[username:password@]ip[:port]`

      * proxy\[string]
    </ParamField>

    <ParamField body="ext_proxy_username" type="string">
      外部供应商 IP 的默认用户名
    </ParamField>

    <ParamField body="ext_proxy_password" type="string">
      外部供应商 IP 的默认密码
    </ParamField>

    <ParamField body="ext_proxy_port" type="integer">
      外部供应商 IP 的默认端口
    </ParamField>

    <ParamField body="dns" type="string">
      DNS resolving

      |          |   |
      | -------- | - |
      | `local`  |   |
      | `remote` |   |
    </ParamField>

    <ParamField body="reverse_lookup_dns" type="boolean">
      通过 DNS 进行反向查询
    </ParamField>

    <ParamField body="reverse_lookup_file" type="string">
      通过文件进行反向查询
    </ParamField>

    <ParamField body="reverse_lookup_values" type="array">
      通过值进行反向查询
    </ParamField>

    <ParamField body="session" type="string">
      所有代理请求的会话
    </ParamField>

    <ParamField body="sticky_ip" type="boolean">
      使用每个请求主机的会话维护每个主机的 IP
    </ParamField>

    <ParamField body="pool_size" type="integer" />

    <ParamField body="rotate_session" type="boolean">
      会话池大小
    </ParamField>

    <ParamField body="throttle" type="integer">
      限制超过给定数量的请求
    </ParamField>

    <ParamField body="rules" type="array">
      代理请求规则
    </ParamField>

    <ParamField body="route_err" type="string">
      出错时阻止或允许通过超级代理自动发送请求
    </ParamField>

    <ParamField body="smtp" type="array" />

    <ParamField body="override_headers" type="string" />

    <ParamField body="os" type="string">
      对等 IP 的操作系统
    </ParamField>

    <ParamField body="headers" type="array">
      请求标头
    </ParamField>

    * `name[string]`
    * `value[string]`

    <ParamField body="debug" type="string">
      请求调试信息

      |        |   |
      | ------ | - |
      | `full` |   |
      | `none` |   |
    </ParamField>

    <ParamField body="lpm_auth" type="string">
      `x-lpm-authorization header`
    </ParamField>

    <ParamField body="const" type="boolean" />

    <ParamField body="socket_inactivity_timeout" type="integer" />

    <ParamField body="multiply_ips" type="boolean" />

    <ParamField body="multiply_vips" type="boolean" />

    <ParamField body="max_ban_retries" type="integer" />

    <ParamField body="preset" type="string" />

    <ParamField body="ua" type="boolean">
      解锁器移动 UA
    </ParamField>

    <ParamField body="timezone" type="string">
      浏览器使用的时区 ID
    </ParamField>

    <ParamField body="resolution" type="string">
      浏览器屏幕尺寸
    </ParamField>

    <ParamField body="webrtc" type="string">
      浏览器中的 WebRTC 插件行为
    </ParamField>

    <ParamField body="bw_limit" type="object">
      带宽限制参数

      * days \[integer]
      * bytes \[integer]
      * reenewable \[boolean] - 更新每个周期的字节限制或者使用单个周期，并在达到周期的最后一天时停止使用。 默认值为 true
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="create_users" type="boolean">
  {/* TODO: Add description */}
</ParamField>

<ResponseExample>
  ```JSON Sample Response
  {
  	"port":24000,
  	"zone":"zone_name",
  	"proxy_type":"persist",
  	"customer":"customer_id",
  	"password":"password",
  	"whitelist_ips":[]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  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
  #!/usr/bin/env node

  require('request-promise')({
  method: 'POST',
  method: 'POST',

  	method: 'POST',

  	url: 'http://127.0.0.1:22999/api/proxies',
  	json: {'proxy':{'port':24000,'zone': 'ZONE','proxy_type':'persist','customer':'CUSTOMER','password':'password','whitelist_ips':[]}}
  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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>


# 删除代理端口
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/delete_a_proxy_port



**API 端点:** `DELETE` `/api/proxies/{PORT}`

## 路径参数

<ParamField body="PORT" type="string" required>
  现有代理服务器端口编号
</ParamField>

<RequestExample>
  ```sh Shell
  curl -X DELETE "http://127.0.0.1:22999/api/proxies/{PORT}"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({
    method: 'DELETE',
    url: 'http://127.0.0.1:22999/api/proxies/{PORT}'
  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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>


# 删除代理端口（多个）
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/delete_proxy_ports



**API 端点:** `POST /api/proxies/delete`

## `POST` body

<ParamField body="ports" type="array" required>
  端口数组
</ParamField>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/proxies/delete" -H "Content-Type: application/json" -d '{"ports":[24000,24001]}'
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  method: 'POST',

  url: 'http://127.0.0.1:22999/api/proxies/delete',

  json: {'ports':[24000,24001]}

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  data = {'ports':[24000,24001]}

  r = requests.post('http://127.0.0.1:22999/api/proxies/delete', data=json.dumps(data))

  print(r.content)
  ```
</RequestExample>


# 启用 SSL 分析（所有端口）
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/enable_ssl_analyzing_on_all_proxy_ports



**API 端点:** `POST` `/api/enable_ssl`

<RequestExample>
  ```sh
  curl -X POST "http://127.0.0.1:22999/api/enable_ssl"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({
      method: 'POST',
      url: 'http://127.0.0.1:22999/api/enable_ssl'
  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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>


# 生成 API 令牌
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/generate_token_for_token_based_authentication



**API 端点:** `GET` `/api/gen_token`

<ResponseExample>
  ```json Sample Response
  {
      "token": "RZD9vaQQaL6En7"
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/gen_token"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/gen_token'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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>


# 获取所有用户
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/get_all_users



**API 端点:** `GET` `/api/lpm_users`

<ResponseExample>
  ```JSON Sample Response
  [
      {
          "email": "test@example.com",
          "password":"password"
      }
  ]
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/lpm_users"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/lpm_users'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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>


# 获取区域中分配的 gIP
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/get_allocated_gips_in_zone



**API 端点:** `GET` `/api/allocated_vips`

## 查询参数

<ParamField query="zone" type="string">
  住宅/移动专属区域名称
</ParamField>

<ResponseExample>
  ```json Sample Response
  {
      "ips": [
          "gIP_1",
          "gIP_2"
      ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/allocated_vips?zone=ZONE"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/allocated_vips?zone=ZONE'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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>


# 获取区域中分配的 IP
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/get_allocated_ips_in_zone



**API 端点:** `GET` `/api/allocated_ips`

## 查询参数

<ParamField query="zone" type="string">
  静态（数据中心/互联网服务提供商）区域名称
</ParamField>

<ResponseExample>
  ```JSON Sample Response
  {
      "ips": [
          "10.0.0.1",
          "20.0.0.1"
      ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/allocated_ips?zone=ZONE"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/allocated_ips?zone=ZONE'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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>


# 获取封禁的 IP
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/get_banned_ips



**API 端点:** `GET` `/api/banlist/{PORT}`

<ParamField query="full" type="boolean">
  `full=true` 参数是可选的，可用于提供有关封禁列表中每个条目的更多详情
</ParamField>

<ResponseExample>
  ```JSON Sample Response
  {
      "ips": [
          "10.20.30.40",
          "50.60.70.80|example.com"
      ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/banlist/{PORT}?full=true"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/banlist/{PORT}?full=true'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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>


# 获取当前 NodeJS 版本
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/get_currently_running_nodejs_version



**API 端点:** `GET` `/api/node_version`

<ResponseExample>
  ```JSON Sample Response
  {
      "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>

{/* TODO: Missing Code Examples */}


# 为所有正在运行的代理获取有效配置
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/get_effective_configuration_for_all_running_proxies



**API 端点:** `GET` `/api/proxies_running`

<ResponseExample>
  ```JSON Sample Response
  [
      {
          "port": 24000,
          "zone": "ZONE",
          "proxy_type": "persist",
          "customer": "CUSTOMER",
          "password": "password",
          "whitelist_ips":[]
      }
  ]
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/proxies_running"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/proxies_running'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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>


# 获取已启用区域的配置
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/get_enabled_zones_configuration



**API 端点:** `GET` `/api/zones`

<ResponseExample>
  ```JSON Sample Response
  {
      "name": "ZONE",
      "perm": "country ip route_all route_dedicated",
      "plan": {},
      "password":"password"
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/zones"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/zones'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python


  import requests


  r = requests.get('http://127.0.0.1:22999/api/zones')

  print(r.content)
  ```
</RequestExample>


# 获取指定代理的显式配置
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/get_explicit_configuration_of_all_or_specified_proxies



**API 端点:** `GET` `/api/proxies/{PORT}`

<ParamField path="PORT" type="string">
  端口 参数是可选的。 您可以跳过它来获取所有代理\*
</ParamField>

<ResponseExample>
  ```JSON Sample Response
  [
      {"port": 24000,
      "zone": "ZONE",
      "proxy_type": "persist",
      "customer": "CUSTOMER",
      "password": "password",
      "whitelist_ips": []
      },
      {
          "port": 33335,
          "zone": "ZONE",
          "listen_port": 33335,
          "customer": "CUSTOMER",
          "password":"password"
      }
  ]
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/proxies/{PORT}"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/proxies/{PORT}'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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>


# 获取常规设置
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/get_general_settings



**API 端点:** `GET` `/api/settings`

<ResponseExample>
  ```JSON Sample Response
  {
      "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://lumtest.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
  curl "http://127.0.0.1:22999/api/settings"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/settings'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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>


# 获取 HAR 日志
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/get_har_logs



**API 端点:** `GET` `/api/logs`

<ParamField query="limit" type="integar">
  要从尾部获取的日志数量
</ParamField>

<ParamField query="skip" type="integar">
  要从尾部获取的日志数量
</ParamField>

<ParamField query="limit" type="integar">
  要获取的最大请求数量
</ParamField>

<ParamField query="search" type="string">
  URL 的正则表达式搜索查询
</ParamField>

<ParamField query="port_from" type="string">
  端口号的下限
</ParamField>

<ParamField query="port_to" type="string">
  端口号的上限
</ParamField>

<ParamField query="status_code" type="string">
  按状态码筛选请求
</ParamField>

<ParamField query="sort" type="string">
  排序依据的参数
</ParamField>

<ParamField query="sort_desc" type="布尔值">
  是降序排序方向
</ParamField>

{/* TODO: Missing Sample Response */}

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/logs"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({
      url: 'http://127.0.0.1:22999/api/logs'
  }).then(function(data){ console.log(data);},

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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>


# 获取代理管理器版本
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/get_proxy_manager_version



**API 端点:** `GET` `/api/version`

<ResponseExample>
  ```json Sample Response
  {
    "version":"1.280.385",
    "argv":""
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/version"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/version'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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# 
  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
  #!/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>


# 获取代理端口状态
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/get_proxy_port_status



**API 端点:** `GET` `/api/proxy_status/{端口}`

<ParamField path="PORT" type="string">
  现有代理端口号
</ParamField>

<ResponseExample>
  ```JSON Sample Response
  {
      "status":"ok",
      "status_details":[]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/proxy_status/{PORT}"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/proxy_status/{PORT}'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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>


# 获取最新状态
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/get_recent_stats



**API 端点:** `GET /api/recent_stats`

<ResponseExample>
  ```JSON Sample Response
  {
      "ports": {},
      "status_code": [],
      "hostname": [],
      "protocol": [],
      "total": 0,
      "success": 0,
      "ssl_enable":true}
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/recent_stats"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/recent_stats'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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>


# 从日志文件中获取结尾部分
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/get_tail_from_the_log_file



**API 端点:** `GET` `/api/general_logs`

<ParamField query="limit" type="integer">
  要从尾部获取的日志数量
</ParamField>

{/* TODO: Missing Sample Response */}

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/general_logs?limit=5"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/general_logs?limit=5'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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>


# 获取最新的代理管理器版本
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/get_the_latest_proxy_manager_versions



**API 端点:** `GET` `/api/last_version`

<ResponseExample>
  ```json Sample Response
  {
    "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
  curl "http://127.0.0.1:22999/api/last_version"
  ```

  ```js NodeJS
  #!/usr/bin/env node  
    
  require('request-promise')({  
    
  url: 'http://127.0.0.1:22999/api/last_version'  
    
  }).then(function(data){ console.log(data); },  
    
  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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>


# 刷新区域中的 IP/gIP
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/refresh_ips_or_gips_in_zone



**API 端点:** `POST` `/api/refresh_IP`

## `POST` body

<ParamField body="zone" type="string" 必填项>
  区域名称
</ParamField>

<ParamField body="IP" type="array">
  Static IPs. e.g. `IP=["ip1","ip2"]`
</ParamField>

<ParamField body="VIP" type="array">
  gIPs. e.g. `VIP=["gip1","gip2"] [数组]`
</ParamField>

<ResponseExample>
  ```json Sample Response
  {
    "ips": [
  	{
  	  "ip":"10.0.0.1",
  	  "maxmind":"us"
  	},
  	{
  	  "ip":"20.0.0.1",
  	  "maxmind":"us"
  	}
    ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  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
  #!/usr/bin/env node

  require('request-promise')({
  method: 'POST',
  url: 'http://127.0.0.1:22999/api/refresh_ips',
  json: {'zone':'ZONE','ips':['10.0.0.1']}
  }).then(function(data){ console.log(data); },
  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python

  import requests

  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>


# 刷新代理管理器端口会话
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/refresh_proxy_manager_port_sessions



**API 端点:** `GET` `/api/refresh_sessions/{PORT}`

## 路径参数

<ParamField path="PORT" type="string" required>
  现有代理端口号
</ParamField>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/refresh_sessions/{PORT}"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  url: 'http://127.0.0.1:22999/api/refresh_sessions{PORT}'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python


  import requests



  r = requests.get('http://127.0.0.1:22999/api/refresh_sessions/{PORT}')

  print(r.content)
  ```
</RequestExample>


# 重启 Proxy Manager
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/restart_proxy_manager



**API 端点:** `POST` `/api/restart`

<RequestExample>
  ```sh Shell
  curl -X POST "http://127.0.0.1:22999/api/restart"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  method: 'POST',

  url: 'http://127.0.0.1:22999/api/restart'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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>


# 关闭 Proxy Manager
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/shutdown_proxy_manager



**API 端点:** `POST` `/api/shutdown`

<RequestExample>
  ```sh Shell
  curl -X POST "http://127.0.0.1:22999/api/shutdown"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({

  method: 'POST',

  url: 'http://127.0.0.1:22999/api/shutdown'

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python


  import requests



  r = requests.post('http://127.0.0.1:22999/api/shutdown')

  print(r.content)
  ```
</RequestExample>


# 建立访问用户界面的 IP 白名单
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/ui-allowlist-ips



**API 端点:** `PUT` `/api/add_whitelist_ip`

<ParamField header="Authorization" type="string" required>
  API 令牌

  <Tip>
    应通过“生成令牌 API”命令生成令牌

    [Generate API Key](/cn/api-reference/proxy-manager/generate_token_for_token_based_authentication)
  </Tip>
</ParamField>

## `PUT` body

<ParamField body="ip" type="string" required>
  要列入白名单的 IP，例如 `ip="1.2.1.2"`
</ParamField>

<RequestExample>
  ```sh Shell
  curl -X PUT "http://127.0.0.1:22999/api/whitelist_ip" -H "Authorization: API key" -H "Content-Type: application/json" -d '{"ip":"1.2.1.2"}'
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({
    method: 'PUT',
    url: 'http://127.0.0.1:22999/api/add_whitelist_ip',
    json: {'ip':'1.2.1.2'},
    headers: {'Authorization': 'API key'},
  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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)

  )

  print(r.content)
  ```
</RequestExample>


# 解禁 IP
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/unban_an_ip



**API 端点:** `POST` `/api/proxies/{PORT}/unbanip`

## 路径参数

<ParamField path="PORT" type="string" required>
  现有代理服务器的端口号
</ParamField>

## `POST` body

<ParamField body="ip" type="string" required>
  要解禁的 IP。例如 `ip="1.2.1.2"`
</ParamField>

<ParamField body="domain" type="string">
  解禁向指定域发送请求的 IP。
</ParamField>

<RequestExample>
  ```sh Shell
  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
  #!/usr/bin/env node

  require('request-promise')({
      method: 'POST',
      url: 'http://127.0.0.1:22999/api/proxies/{PORT}/unbanip',
      json: {
          'ip': '1.2.1.2',
          'domain': 'example.com'
      }
  }).then(function(data){ console.log(data);},
  function(err){ console.error(err);});
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

   

  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>


# 解禁 IP（多个）
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/unban_ips



**API 端点:** `POST` `/api/proxies/{PORT}/unbanips`

## 路径参数

<ParamField path="PORT" type="字符串" 必填项>
  现有代理服务器的端口号
</ParamField>

<RequestExample>
  ```sh Shell
  curl "http://127.0.0.1:22999/api/proxies/{PORT}/unbanips"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({
      method: 'POST',
      url: 'http://127.0.0.1:22999/api/proxies/{PORT}/unbanips'
  }).then(function(data){ console.log(data);},

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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>


# 更新代理端口
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/update_a_proxy_port



**API 端点:** `PUT` `/api/proxies/{PORT}`

## 路径参数

<ParamField path="PORT" type="string" required>
  现有代理服务器的端口号
</ParamField>

## `PUT` body

<ParamField body="proxy" type="User Object">
  <Expandable title="properties">
    <ParamField body="port" type="integer">
      HTTP 代理的端口
    </ParamField>

    <ParamField body="proxy_type" type="string">
      设置为 `persist` 以将代理保存至配置文件。
    </ParamField>

    <ParamField body="multiply" type="integer">
      将端口定义复用给定次数
    </ParamField>

    <ParamField body="multiply_users" type="boolean" />

    <ParamField body="users" type="array">
      user \[string] 的列表。此项必须与 `multiply_users` 一起使用
    </ParamField>

    <ParamField body="ssl" type="boolean">
      启用 SSL 分析
    </ParamField>

    <ParamField body="tls_lib" type="string">
      选择 SSL 库

      | 值          | 描述         |
      | ---------- | ---------- |
      | `open_ssl` | 打开 SSL 库   |
      | `flex_tls` | Flex TLS 库 |
    </ParamField>

    <ParamField body="iface" type="string">
      所要监听的接口或 IP
    </ParamField>

    <ParamField body="customer" type="string">
      客户名称
    </ParamField>

    <ParamField body="zone" type="string">
      区域名称
    </ParamField>

    <ParamField body="password" type="string">
      区域密码
    </ParamField>

    <ParamField body="proxy" type="string">
      超级代理的主机名或 IP
    </ParamField>

    <ParamField body="proxy_port" type="integer">
      超级代理端口
    </ParamField>

    <ParamField body="proxy_connection_type" type="string">
      确定代理管理器和超级代理之间将使用哪种连接

      |         |   |
      | ------- | - |
      | `http`  |   |
      | `https` |   |
      | `socks` |   |
    </ParamField>

    <ParamField body="proxy_retry" type="integer">
      超级代理出现故障时自动重试
    </ParamField>

    <ParamField body="insecure" type="boolean">
      对不安全的主机启用 SSL 连接/分析
    </ParamField>

    <ParamField body="country" type="string">
      国家/地区
    </ParamField>

    <ParamField body="state" type="string">
      州
    </ParamField>

    <ParamField body="city" type="string">
      城市
    </ParamField>

    <ParamField body="asn" type="string">
      ASN
    </ParamField>

    <ParamField body="ip" type="string">
      数据中心 IP
    </ParamField>

    <ParamField body="vip" type="integer">
      gIP
    </ParamField>

    <ParamField body="ext_proxies" type="array">
      来自外部供应商的代理列表。 格式：`[username:password@]ip[:port]`

      * `proxy[字符串]`
    </ParamField>

    <ParamField body="ext_proxy_username" type="string">
      外部供应商 IP 的默认用户名
    </ParamField>

    <ParamField body="ext_proxy_password" type="string">
      外部供应商 IP 的默认密码
    </ParamField>

    <ParamField body="ext_proxy_port" type="integer">
      外部供应商 IP 的默认端口
    </ParamField>

    <ParamField body="dns" type="string">
      DNS 解析

      |          |   |
      | -------- | - |
      | `local`  |   |
      | `remote` |   |
    </ParamField>

    <ParamField body="reverse_lookup_dns" type="boolean">
      通过 DNS 进行反向查询
    </ParamField>

    <ParamField body="reverse_lookup_file" type="string">
      通过文件进行反向查询
    </ParamField>

    <ParamField body="reverse_lookup_值s" type="array">
      通过值进行反向查询
    </ParamField>

    <ParamField body="session" type="string">
      所有代理请求的会话
    </ParamField>

    <ParamField body="sticky_ip" type="boolean">
      使用每个请求主机的会话维护每个主机的 IP
    </ParamField>

    <ParamField body="pool_size" type="integer" />

    <ParamField body="rotate_session" type="boolean">
      会话池大小
    </ParamField>

    <ParamField body="throttle" type="integer">
      限制超过给定数量的请求
    </ParamField>

    <ParamField body="rules" type="array">
      代理请求规则
    </ParamField>

    <ParamField body="route_err" type="string">
      出错时阻止或允许通过超级代理自动发送请求
    </ParamField>

    <ParamField body="smtp" type="array" />

    <ParamField body="override_headers" type="string" />

    <ParamField body="os" type="string">
      对等 IP 的操作系统
    </ParamField>

    <ParamField body="headers" type="array">
      请求标头
    </ParamField>

    * name\[字符串]
    * 值\[字符串]

    <ParamField body="debug" type="string">
      请求调试信息

      |        |   |
      | ------ | - |
      | `full` |   |
      | `none` |   |
    </ParamField>

    <ParamField body="lpm_auth" type="string">
      `x-lpm-authorization header`
    </ParamField>

    <ParamField body="const" type="boolean" />

    <ParamField body="socket_inactivity_timeout" type="integer" />

    <ParamField body="multiply_ips" type="boolean" />

    <ParamField body="multiply_vips" type="boolean" />

    <ParamField body="max_ban_retries" type="integer" />

    <ParamField body="preset" type="string" />

    <ParamField body="ua" type="boolean">
      解锁器移动 UA
    </ParamField>

    <ParamField body="timezone" type="string">
      浏览器使用的时区 ID
    </ParamField>

    <ParamField body="resolution" type="string">
      浏览器屏幕尺寸
    </ParamField>

    <ParamField body="webrtc" type="string">
      浏览器中的 WebRTC 插件行为
    </ParamField>

    <ParamField body="bw_limit" type="object">
      带宽限制参数

      * days \[整数]
      * bytes \[整数]
      * reenewable \[布尔值] - 更新每个周期的字节限制或者使用单个周期，并在达到周期的最后一天时停止使用。 默认值为 “true”
    </ParamField>
  </Expandable>
</ParamField>

<ResponseExample>
  ```JSON Sample Response
  {
      "port":24000,
      "zone":"ZONE",
      "proxy_type":"persist",
      "customer":"CUSTOMER",
      "password":"password",
      "whitelist_ips":[]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  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
  #!/usr/bin/env node

  require('request-promise')({

  method: 'PUT',

  url: 'http://127.0.0.1:22999/api/proxies/{PORT}',

         json: {'proxy':{'port':24000,'zone': 'ZONE','proxy_type':'persist','customer':'CUSTOMER','password':'password','whitelist_ips':[]}}

  }).then(function(data){ console.log(data); },

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python

  import requests


  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>


# 更新常规设置
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/update_general_settings



**API 端点:** `PUT` `/api/settings`

## `PUT` 正文:

<ParamField body="zone" type="string">
  默认区域
</ParamField>

<ParamField body="www_whitelist_ips" type="array">
  允许访问浏览器管理界面的白名单 IP 列表
</ParamField>

<ParamField body="whitelist_ips" type="array">
  所有代理的默认白名单 IP 列表，以允许相关 IP 访问代理
</ParamField>

<ParamField body="logs" type="integer">
  待存储的请求日志数量
</ParamField>

<ParamField body="request_stats" type="boolean">
  启用请求统计
</ParamField>

<ResponseExample>
  ```JSON Sample Response
  {
      "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://lumtest.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
  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
  #!/usr/bin/env node

  require('request-promise')({
    method: 'PUT',
    url: 'http://127.0.0.1:22999/api/settings',
    json: {
      'zone': 'ZONE',
      'www_whitelist_ips':'[]',
      'whitelist_ips':'[]',
      'logs':1000,
      'request_stats':true
    }
  }).then(function(data){ console.log(data); },
  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/usr/bin/env python

  print(
    'If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests'
  )

  import requests

   
  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>


# 升级代理管理器
Source: https://docs.brightdata.com/cn/api-reference/proxy-manager/upgrade_proxy_manager



**API 端点:** `POST` `/api/upgrade`

<RequestExample>
  ```sh Shell
  curl -X POST "http://127.0.0.1:22999/api/upgrade"
  ```

  ```js NodeJS
  #!/usr/bin/env node

  require('request-promise')({
    method: 'POST',
    url: 'http://127.0.0.1:22999/api/upgrade'
  }).then(function(data){ console.log(data);},

  function(err){ console.error(err); });
  ```

  ```java Java
  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#
  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
  #!/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>


# 请求和响应 C-Tag
Source: https://docs.brightdata.com/cn/api-reference/proxy/c-tag



处理大量请求时，跟踪单个响应可能会很困难。C-Tag 是一种简单但功能强大的解决方案，可提升请求跟踪效率。

使用 C-Tag，用户可以在请求中添加唯一的 `c_tag` 标志。作为回应，企业会在标头中回传相同的标签。 这种无缝交换可确保每个响应都与相应的请求绑定，从而消除混乱并简化数据管理。

在请求中添加任何 C-Tag 文本，可在响应标头中获得相同的字符串：

<CodeGroup>
  ```sh Sample Request
  curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-c_tag-<C_TAG_VALUE>:<zone_password>
  ```

  ```js Output headers
  x-brd-c_tag: <C_TAG_VALUE>
  ```
</CodeGroup>


# 运营商专属代理对等 IP（仅限移动设备）
Source: https://docs.brightdata.com/cn/api-reference/proxy/carrier_specific_proxy_peer_ip_mobile_only_



* 您可以选择使用此列表中的特定运营商：a1、\[aircel] (%20)、airtel、att、celcom、chinamobile、claro、cox、digi、dt、docomo、dac、etisalat、idea、kyivstar、meo、mtnza、mts、optus、orange、qwest，reliance\_jio、robi、sprint、telefonica、telstra、time、vimpelcom、vimpelcom、vidacomza、vidafone、vivo、vivo、zain、vivabo、telenormyanmar、kcelljsc、swisscom、singtel、asiacell、windit、cellc、ooredoo、drei、umobile、callleon、proximus、2、mobitel、o2、bouygues、free、sfr、digicel
* 运营商德国电信示例：

<CodeGroup>
  ```sh Carrier: Deutsche Telekom
  brd-customer-<customer_id>-zone-<zone_name>-carrier-dt
  ```

  ```sh Carrier: Sprint
  brd-customer-<customer_id>-zone-<zone_name>-carrier-sprint
  ```
</CodeGroup>


# 配置 DNS 解析
Source: https://docs.brightdata.com/cn/api-reference/proxy/configuring_dns_resolution



可以指示 Bright Data 代理网络使用远程或本地 DNS 解析。

如果您的目标有两个以上的 IP（取决于进行 DNS 查询的位置），并且想要定向目标站点的特定 IP，这就会很有用。

对 Bright Data 的所有请求都以与超级代理 (brd.superproxy.io) 的连接开始。然后，超级代理将请求发送到不同国家的本地服务器，如果需要，这些服务器可以将请求发送给固定代理（“对等方”）。

使用本地DNS 解析时，域名由 Bright Data 超级代理网络服务器解析和缓存，经过解析的 IP 用于代理在实际国家/地区的真实请求。

当使用远程发出请求时，它们最初由超级代理 (brd.superproxy.io) 接收。超级代理在本地进行初步的 DNS 解析，只是为了检查域是否有效。 如果域有效，则请求将发送到距离代理所在国家/地区最近的 Bright Data 服务器。

* 如果 Bright Data 服务器与代理位于同一个国家/地区，则在服务器上执行 DNS，经过解析的 IP 用于实际请求。 此 DNS 解析通常比代理的 DNS 解析更快。
* 如果 Bright Data 服务器位于不同的国家/地区，则在实际代理上执行 DNS。

<CodeGroup>
  ```sh DNS (Local)
  curl "https://example.com" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-dns-local:<zone_password>
  ```

  ```sh DNS (Remote)
  curl "https://example.com" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-dns-remote:<zone_password>
  ```
</CodeGroup>

<Note>
  使用远程 DNS 解析时，由于本地 DNS 解析延迟，您可能会发现一些性能下降。
</Note>


# 地理位置定位
Source: https://docs.brightdata.com/cn/api-reference/proxy/geolocation-targeting

地理位置定位允许您根据“国家/地区”、“城市”、“州”、“ASN”或“邮政编码”来定位具体的位置

## 国家/地区定位

您可以通过在用户名中添加国家/地区代码来定位特定国家/地区，例如 `username-country-country_code`。仅使用两个小写字母的国家/地区代码。

```sh Shell
curl "https://example.com" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us:<zone_password>
```

### EU Specific Targeting

<Note> 网络解锁器 only </Note>

网络解锁器 allows 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.

## 城市定位

<Note> Residential proxies only. For DC & ISP networks you need to configure your zone and select the cities you would like to have proxies in. Using this parameter without pre-selection in DC & ISP is not permitted </Note>

您可以通过在用户名中添加城市名称来定位某个国家/地区的特定城市，例如 `username-country-country_code-city-city_code`。city\_code 必须是小写且不含空格，例如 `-city-sanfrancisco`

```sh Shell
curl "https://example.com" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us-city-sanfrancisco:<zone_password>
```

## 州定位

<Note> Residential proxies only </Note>

对于相关郡县（例如美国和澳大利亚），您可以通过添加 `username-country-country_code-state-state_code` 来定位一个国家/地区的某个州。仅使用两个小写字母的州代码。

<CodeGroup>
  ```sh Country: USA
  curl "https://example.com" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us-state-ny:<zone_password> 
  ```

  ```sh Country: Australia
  curl "https://example.com" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-au-state-wa:<zone_password>
  ```
</CodeGroup>

## ASN 定位

<Note> Residential proxies only </Note>

您可以从 ASN 列表中定位特定的 ASN: [http://bgp.potaroo.net/cidr/autnums.html](http://bgp.potaroo.net/cidr/autnums.html) 选择 ASN 国家/地区的方法如下：-asn-ASN\_NUMBER

```sh Shell
curl "https://example.com" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-asn-56386:<zone_password>
```

## 邮政编码定位

<Note> Residential proxies only </Note>

您可以通过特定区域的邮政编码来定位代理对等方。 以下是定位来自美国孟菲斯且邮政编码为12345的 IP 的示例：

```sh Shell
curl "https://example.com" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-city-memphis-zip-12345:<zone_password>
```


# 获取每个区域可用的专用 IP
Source: https://docs.brightdata.com/cn/api-reference/proxy/get_dedicated_ips_per_zone



**API 端点**: `GET` `/api/zone/route_vips`

**获取每个区域的所有可用专用 IP**

用于获取专用住宅或移动代理区域内 [gIP](/cn/proxy-networks/residential/configure-your-proxy#ip-groups-gips) 列表的 API 端点是：
`GET /api/zone/route_vips`

<CodeGroup>
  ```sh Shell
   curl -X GET "https://api.brightdata.com/zone/route_vips?zone=<zone_name>" -H "Authorization: Bearer <API_KEY>"
  ```

  ```js NodeJS
  var request = require('request');
  var options = {
    'method': 'GET',
    'url': 'https://api.brightdata.com/zone/route_vips?zone=<zone_name>',
    'headers': {
      'Authorization': 'Bearer <API_KEY>'
    }
  };
  request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
  });
  ```

  ```java Java
  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/route_vips?zone=<zone_name>"))      
        .returnContent().asString();
      System.out.println(res);
    }}
  ```

  ```cs C#
  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/route_vips?zone=ZONE"),
        Headers = {
          {"Authorization", "Bearer API_KEY"}
        }
      };
      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();
      Console.WriteLine(responseString);
    }
  }
  ```

  ```python Python
  import requests
  url = "https://api.brightdata.com/zone/route_vips?zone=<zone_name>"
  payload={}
  headers = {
    'Authorization': 'Bearer <API_KEY>'
  }
  response = requests.request("GET", url, headers=headers, data=payload)
  print(response.text)
  ```
</CodeGroup>

```json Sample Response
[
  "186XXXXXXXXXXX01",
  "186XXXXXXXXXXX00"
]
```


# 确保会话期间始终使用相同的节点
Source: https://docs.brightdata.com/cn/api-reference/proxy/keep_same_peer_in_session



您可以通过 API 指定，即使当前会话使用的节点离线，也不重新分配新的节点。 如果强制启用此请求参数，当会话使用的节点离线时，您的请求将收到 502 错误代码，同时返回以下错误消息：

```sh 错误消息
502 Proxy Error: server_error Failed to establish connection with peer
```

对于由真实电脑和移动设备组成的住宅和移动网络代理区域，此工作流程非常有用。

要使用此功能，只需在会话名称后添加 -`const`，例如 `-session-mystring12345-const`

```sh Shell
curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-session-mystring12345-const:<zone_password>
```


# 操作系统定位
Source: https://docs.brightdata.com/cn/api-reference/proxy/os_targeting



Bright Data允许针对以下操作系统进行抓取:

<CodeGroup>
  ```sh Windows
  curl "https://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-windows:<password>
  ```

  ```sh macOS
  curl "https://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-osx:<password>
  ```

  ```sh Android
  curl "https://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-android:<password>
  ```
</CodeGroup>


# 代理 REST API 测试平台
Source: https://docs.brightdata.com/cn/api-reference/proxy/proxy_api_post_playground

proxy-rest-api POST /request
使用 REST API 访问代理网络

<Note> 查看如何创建 API 令牌的说明：[API 令牌创建](/cn/general/account/api-token)</Note>


# 请求错误处理
Source: https://docs.brightdata.com/cn/api-reference/proxy/request_error_handling



| 值          | 描述                                     |
| ---------- | -------------------------------------- |
| `pass_dyn` | 如果请求无法通过代理对等节点传递，系统将自动通过超级代理传递请求。      |
| `block`    | 如果请求无法通过代理对等节点传递，则阻塞该请求，并且不通过超级代理进行发送。 |

<CodeGroup>
  ```sh pass_dyn
  curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-route_err-pass_dyn:<zone_password>
  ```

  ```sh block
  curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-route_err-block:<zone_password>
  ```
</CodeGroup>


# IP Rotation in shared proxies pool
Source: https://docs.brightdata.com/cn/api-reference/proxy/rotate_ips

How does proxy IP rotation works, and how can you configure or control it. 

## 代理 IP rotation by default

By default, Bright Data assigns a random proxy from the available proxies in the zone, considering your configuration.&#x20;

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.&#x20;

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.&#x20;

## Forcing rotation with `session` parameter

In order to force electing a different proxy, use the `-session` parameter with different value for every request. This will assure consequent requests will have different IPs.&#x20;

## 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 identified you create and control. Each request, carrying the same `-session` value will be forwarded to the **same proxy IP**.&#x20;

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.&#x20;

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.&#x20;

```sh Shell
curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-session-mystring12345:<zone_password>
```

## Losing session context&#x20;

The following describes scenarios where session context can be lost, and consequent requests will be executed by **different** proxies.&#x20;

### Session Idle Time&#x20;

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.&#x20;

### 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&#x20;

2. EMEA: Europe, Middle East and Africa&#x20;

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.&#x20;

### 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.&#x20;

### Error on lost session

By default, is 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`&#x20;

```sh Shell
curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-session-mystring12345-const:<zone_password>
```


# 选择特定的 gIP
Source: https://docs.brightdata.com/cn/api-reference/proxy/select_a_specific_gip



该选项仅适用于分配了多个 IP 的住宅区域或移动区域。要将分配给您的区域的特定 `gIP` 作为目标，请使用 `-gip-gip_name` 请求参数。

```sh
curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-gip-us_7922_fl_hollywood_0:<zone_password>
```


# 选择特定的 IP
Source: https://docs.brightdata.com/cn/api-reference/proxy/select_a_specific_ip



该选项仅适用于分配了多个 IP 的区域。 要将分配给您的区域的特定 IP 作为目标，请使用 `-ip-ip_address` 请求参数。

```sh Shell
curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-1.1.1.1.1:<zone_password>
```


# 在特定国家/地区选择超级代理
Source: https://docs.brightdata.com/cn/api-reference/proxy/select_super_proxy_in_specific_country



{/*tags:nosophie*/}

重要提示：本文仅适用于选择超级代理，而很少需要对超级代理执行相关操作。要选择特定的标准代理（例如，住宅代理、数据中心代理或 ISP 代理），请执行以下操作：

* 在共享代理区域，您可以在代理用户名中添加 `-country` 标记（以及 `-city` 标记），如下所示：`username-country-country_code-city-city_code`。国家/地区代码是标准的 2 个字符代码。 `city_code` 必须是小写且没有空格，例如 `-city-sanfrancisco`。

* 在专用代理区域，您可以按照以下步骤在区域配置页面中选择国家/地区和城市：
  1. 添加一个新代理区域，并将 IP 类型设置为“专用”。
  2. 选择您要在此区域中定位的域名。
  3. 选择要分配给该区域的专用代理数量。
  4. 选择您要定位的国家/地区。
  5. 可选项——选择您想要的国家/地区后，在城市分辨率中点击您想要定位的每个国家/地区旁边的“添加城市”。
  6. 为每个国家/地区添加所选城市并保存区域。
  7. 您的新专用代理区域将在您选择的国家/地区和城市之间平均分配您要求的 grproxies 数量。

如果您确实需要我们的负载均衡器在特定国家/地区提供超级代理：

选择超级代理国家/地区的方法如下：`servercountry-{country}.brd.superproxy.io`。

```sh Shell
curl "https://example.com" --proxy servercountry-gb.brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
```


# 直接从超级代理发送请求
Source: https://docs.brightdata.com/cn/api-reference/proxy/send_requests_directly_from_super_proxy



您可以选择直接从超级代理而不是对等 IP 执行请求。 在这种情况下，通过在请求授权字符串中添加 -direct，请求的 IP 将是超级代理的 IP。

```sh Shell
curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-direct:<zone_password>
```


# Unlocker API & SERP REST API 游乐场
Source: https://docs.brightdata.com/cn/api-reference/rest-api/proxy-rest-api-playground

unlocker-rest-api POST /request



# 所有分类数据
Source: https://docs.brightdata.com/cn/api-reference/scraping-shield-api/all-classification-data



## 查询参数

<ParamField query="from" type="string">
  请求数据的起始时间范围

  示例: `from=2018-07-01T00:00:00`
</ParamField>

<ParamField query="to" type="string">
  请求数据的结束时间范围

  示例: `to=2018-07-02T00:00:00`
</ParamField>

<ParamField query="cn" type="string">
  请求来源所在的国家

  示例: `cn=uk`
</ParamField>

<ParamField query="peer_cn" type="string">
  对等 IP 所在的国家

  示例: `peer_cn=us`
</ParamField>

<ParamField query="类别" type="string">
  仅返回特定的分类

  示例: `categories=ads`
</ParamField>

<RequestExample>
  ```sh Request
  curl "https://api.brightdata.com/shield/class" -H "Authorization: <API key>"
  ```
</RequestExample>

<ResponseExample>
  ```json Response
  [
      {
          "class":"Shopping",
          "req":1139485,
          "bw":61138544246
      }, ... 
  ]
  ```
</ResponseExample>


# 按分类数据划分的域
Source: https://docs.brightdata.com/cn/api-reference/scraping-shield-api/domains-by-classification-data

返回所选分类的每个域的使用数据

## 查询参数

<ParamField query="from" type="字符串">
  请求数据的起始时间范围

  示例: `from=2018-07-01T00:00:00`
</ParamField>

<ParamField query="to" type="字符串">
  请求数据的结束时间范围

  示例: `to=2018-07-02T00:00:00`
</ParamField>

<ParamField query="cn" type="字符串">
  请求来源所在的国家/地区

  示例: `cn=uk`
</ParamField>

<ParamField query="peer_cn" type="字符串">
  对等 IP 所在的国家/地区

  示例: `peer_cn=us`
</ParamField>

<ParamField query="categories" type="字符串">
  仅返回特定的分类

  示例: `categories=ads`
</ParamField>

<ParamField query="order_by" type="字符串">
  按 bw/requests 排序结果

  * `order_by=bw`
  * `order_by=req`
</ParamField>

<ParamField query="order" type="字符串">
  按大小升序/降序排列结果

  * `order=asc`
  * `order=desc`
</ParamField>

<RequestExample>
  ```sh Request
  curl "https://api.brightdata.com/shield/domains_by_class?category=Ads" -H "Authorization: <API key>" 
  ```
</RequestExample>

<ResponseExample>
  ```json Response
  [
      {
          "domain":"static.addtoany.com",
          "req":16370,
          "bw":200590537
      }, ... 
  ]
  ```
</ResponseExample>


# 按分类数据排列的示例
Source: https://docs.brightdata.com/cn/api-reference/scraping-shield-api/samples-by-classification-data

返回所选分类的示例请求数据

## 查询参数

<ParamField query="from" type="string">
  请求数据的起始时间范围

  示例: `from=2018-07-01T00:00:00`
</ParamField>

<ParamField query="to" type="string">
  请求数据的结束时间范围

  示例: `to=2018-07-02T00:00:00`
</ParamField>

<ParamField query="cn" type="string">
  请求来源所在的国家/地区

  示例: `cn=uk`
</ParamField>

<ParamField query="peer_cn" type="string">
  对等 IP 所在的国家/地区

  示例: `peer_cn=us`
</ParamField>

<ParamField query="类别" type="string">
  仅返回特定的分类

  示例: `categories=ads`
</ParamField>

<ParamField query="host" type="string">
  仅返回特定的域名

  示例: `host=example.com`
</ParamField>

<RequestExample>
  ```sh Request
  curl "https://api.brightdata.com/shield/samples?category=Ads" -H "Authorization: <API key>" 
  ```
</RequestExample>

<ResponseExample>
  ```json Response
  [
      {
          "timestamp":"2024-02-07T11:35:45.197Z",
          "ip":"13.229.30.41",
          "zone":"zone_name",
          "bw":82345,
          "time":62594
      }, ... 
  ]
  ```
</ResponseExample>


# 按分类汇总的区域数据
Source: https://docs.brightdata.com/cn/api-reference/scraping-shield-api/zones-by-classification-data

根据所选分类，返回每个区域的用量数据

## 查询参数

<ParamField query="from" type="字符串">
  请求数据的起始时间范围

  示例: `from=2018-07-01T00:00:00`
</ParamField>

<ParamField query="to" type="字符串">
  请求数据的结束时间范围

  示例: `to=2018-07-02T00:00:00`
</ParamField>

<ParamField query="cn" type="字符串">
  请求来源所在的国家/地区

  示例: `cn=uk`
</ParamField>

<ParamField query="peer_cn" type="字符串">
  对等 IP 所在的国家/地区

  示例: `peer_cn=us`
</ParamField>

<ParamField query="categories" type="字符串">
  仅返回特定分类的数据

  示例: `categories=ads`
</ParamField>

<ParamField query="order_by" type="字符串">
  按 bw/requests 排序查询结果

  * `order_by=bw`
  * `order_by=req`
</ParamField>

<ParamField query="order" type="字符串">
  按大小升序/降序排列结果

  * `order=asc`
  * `order=desc`
</ParamField>

<RequestExample>
  ```sh Request
  curl "https://api.brightdata.com/shield/zones_by_class?category=Ads" -H "Authorization: <API key>"
  ```
</RequestExample>

<ResponseExample>
  ```json Response
  [
      {
          "zone":"v__dca",
          "req":5959860,
          "bw":390784389795
      }, ... 
  ]
  ```
</ResponseExample>


# 发送您的第一个请求
Source: https://docs.brightdata.com/cn/api-reference/unlocker/sending_first_request



下面是一个使用 cURL 的最简单 Unlocker API 请求示例，该请求会返回一个 JSON:

```sh
curl "https://geo.brdtest.com/welcome.txt" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
```

您可以在代理区域的“访问参数”选项卡中找到您的 API 凭据，包括用户名（Customer\_ID）、区域名称和密码。

|                                                                                                                                                                                                   |                                         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
| `brd.superproxy.io`                                                                                                                                                                               | 我们的负载均衡器地址，它将为您的请求找到最快的超级代理             |
| <Tooltip tip="Port 33335 replacing port 22225 deprecated on Sep 2026, click to read more">[`33335`](https://docs.brightdata.com/cn/general/faqs#which-port-shall-i-use-22225-or-33335) </Tooltip> | 我们的超级代理的基础设施端口，用于接收您的请求                 |
| `-user brd-customer-<customer_id>-zone-<zone_name>`                                                                                                                                               | 用户名验证。 它以最基本的形式定义了您的用户名以及您将在请求中使用哪个区域。  |
| `<zone_password>`                                                                                                                                                                                 | 区域密码。 所有区域都有用于身份验证的密码                   |
| [https://geo.brdtest.com/welcome.txt](https://geo.brdtest.com/welcome.txt)                                                                                                                        | 替换为您的目标域名。 这只是一个用于测试的服务器占位符。            |

有关所有 API 用例、集成和偏好的深入互动展示，请参阅我们的 API 示例页面:
[https://brightdata.com/cp/zones/proxy\_examples](https://brightdata.com/cp/zones/proxy_examples)

<Tip>
  您需要注册（免费）并登录 Bright Data 控制面板，才能访问此 API 工具。如果您添加了支付方式，您甚至会收到 5 美元的积分，以便开始使用！
</Tip>


# 交付快照
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/delivery-apis/deliver-snapshot

dca-api POST /datasets/v3/deliver/{snapshot_id}
Deliver the snapshot content to the specified storage



# 下载快照
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/delivery-apis/download-snapshot

dca-api GET /datasets/v3/snapshot/{snapshot_id}
Download the snapshot content

<Note>
  如果需要，结果可以分成多个部分：

  1. 通过指定 `batch_size` 和 `part=1` 来下载第一部分。

  2. 使用 [此端点](/scraping-automation/web-data-apis/web-scraper-api/management-apis#calculate-the-number-of-parts-for-delivery) 检查已创建的部分数量。

  3. 通过更改 `part` 参数下载剩余部分。（`batch_size`、`format` 和 `compress` 在每次调用时必须保持不变）
</Note>


# 取消快照
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/management-apis/cancel-snapshot

post /datasets/v3/snapshot/{snapshot_id}/cancel
Cancel the running collection



# 获取快照交付部分
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/management-apis/get-snapshot-delivery-parts

get /datasets/v3/snapshot/{snapshot_id}/parts
When requesting a delivery in batches (see available delivery APIs) use this endpoint to check how many parts were created. format, compress and batch_size should exactly match what was sent to the delivery/download API calls.



# 获取快照输入
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/management-apis/get-snapshot-input

get /datasets/v3/snapshot/{snapshot_id}/input
Get the inputs that were used to trigger the collection



# 获取快照
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/management-apis/get-snapshots

get /datasets/v3/snapshots
Get a list of triggered collections, the list contains only snapshots created for a specific dataset



# 监控交付
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/management-apis/monitor-delivery

get /datasets/v3/delivery/{delivery_id}
The call returns the delivery status



# 监控进度
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/management-apis/monitor-progress

get /datasets/v3/progress/{snapshot_id}
Get the status of a specific collection



# Facebook API爬取工具
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/social-media-apis/facebook



## 概览

Facebook API套件提供多种类型的API，每种API都针对Facebook数据收集的特定需求进行了优化。以下是这些API的概述，包括它们如何连接和交互的方式：

<CardGroup cols="1">
  <Card title="帖子API" icon="images" href="/cn/api-reference/web-scraper-api/social-media-apis/facebook#帖子api">
    此API允许用户根据单个输入URL（例如Facebook页面、群组或个人资料URL）收集多个帖子。

    <br />

    *   **发现功能**：

    *   需要Facebook页面、群组或个人资料的直接URL。

    <br />

    *   **重要字段**：

    *   `post_url`、`content`、`hashtags`、`likes`
  </Card>

  <Card title="评论API" icon="comments" href="/cn/api-reference/web-scraper-api/social-media-apis/facebook#评论-api">
    此API允许用户使用帖子URL收集多个评论。

    <br />

    *   **发现功能**：

    *   `N/A`

    <br />

    *   **重要字段**：

    *   `commenter_url`、`comment_text`、`num_likes`、`num_replies`
  </Card>
</CardGroup>

<Note>由于Facebook数据需要登录，因此无法跨数据集进行发现。</Note>

该API套件旨在为用户提供灵活性，使他们能够输入特定URL，以批量或精确筛选的方式收集详细的帖子和评论数据。

## 帖子API

帖子API允许用户从Facebook个人资料、群组和页面收集详细的帖子数据。API提供有关帖子、页面/个人资料详情以及附件和媒体的全面数据点。

### 通过个人资料URL收集

此API允许用户通过提供个人资料URL收集Facebook帖子数据。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Facebook个人资料URL。
</ParamField>

<ParamField path="num_of_posts" type="number">
  要收集的最近帖子数量。如果省略，则没有限制。
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  需要从结果中排除的帖子ID数组。
</ParamField>

<ParamField path="start_date" type="string">
  以MM-DD-YYYY格式指定的起始日期（应早于end\_date）。
</ParamField>

<ParamField path="end_date" type="string">
  以MM-DD-YYYY格式指定的结束日期（应晚于start\_date）。
</ParamField>

**输出结构**
包括全面的数据点：

* **帖子详情**：
  `post_id`、`content`、`hashtags`、`date_posted`、`num_comments`、`num_likes`等。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lkaxegm826bjpoo9m5?id=all\&tab=overview)。

* **页面/个人资料详情**：
  `page_name`、`page_category`、`page_followers`、`profile_handle`。

  > 我们仅提供有关个人资料的有限数据点。

* **附件和媒体**：
  `attachments` 和 `post_image`（仅链接，不提供文件本身）、`video_view_count`。

### 通过群组URL收集

此API允许用户通过提供群组URL收集详细的Facebook帖子。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Facebook群组URL。
</ParamField>

<ParamField path="num_of_posts" type="number">
  要收集的帖子数量。如果省略，则没有限制。
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  需要从结果中排除的帖子ID数组。
</ParamField>

<ParamField path="start_date" type="string">
  以MM-DD-YYYY格式指定的起始日期（应早于end\_date）。
</ParamField>

<ParamField path="end_date" type="string">
  以MM-DD-YYYY格式指定的结束日期（应晚于start\_date）。
</ParamField>

**输出结构**
包括全面的数据点：

* **帖子详情**：
  `post_id`、`user_url`、`user_username`、`content`、`date_posted`、`hashtags`、`num_comments`、`num_shares`、`num_likes_type`等。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lz11l67o2cb3r0lkj3?id=all\&tab=overview)。

* **群组详情**：
  `group_name`、`group_id`、`group_url`、`group_intro`、`group_category`等。

* **用户详情**：
  `user_is_verified`、`profile_handle`等。

* **附件和外部链接**：
  `attachments`（仅链接，不提供文件本身）、`original_post_url`、`other_posts_url`、`post_external_link`等。

### 通过帖子URL收集

此API允许用户使用帖子URL收集详细的Facebook帖子数据。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Facebook帖子URL。
</ParamField>

**输出结构**
包括全面的数据点：

* **帖子详情**：
  `post_id`、`content`、`hashtags`、`date_posted`、`num_comments`、`num_likes`等。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lyclm1571iy3mv57zw?id=all\&tab=overview)。

* **页面/个人资料详情**：
  `page_name`、`page_category`、`page_followers`、`profile_handle`。

  > 我们仅提供有关个人资料的有限数据点。

* **附件和媒体**：
  `attachments` 和 `post_image`（仅链接，不提供文件本身）、`video_view_count`。

## 评论 API

评论 API 允许用户从 Facebook 帖子中收集详细的评论数据。该 API 提供关于评论的全面数据点，包括评论详情、用户信息、帖子元数据、附件和媒体。

### 通过帖子 URL 采集

该 API 允许用户通过提供帖子 URL，从 Facebook 帖子中收集详细的评论数据。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Facebook 帖子 URL。
</ParamField>

<ParamField path="num_of_comments" type="number">
  要采集的评论数量。如果省略，则没有限制。
</ParamField>

<ParamField path="comments_to_not_include" type="array">
  要排除的评论 ID 数组。
</ParamField>

<ParamField path="start_date" type="string">
  用于筛选评论的起始日期，格式为 MM-DD-YYYY（应早于 end\_date）。
</ParamField>

<ParamField path="end_date" type="string">
  用于筛选评论的结束日期，格式为 MM-DD-YYYY（应晚于 start\_date）。
</ParamField>

**输出结构**

包含全面的数据点：

* **评论详情**：
  `comment_id`、`comment_text`、`num_likes`、回复、`num_replies` 等。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lkay758p1eanlolqw8?id=all\&tab=overview)。

* **用户信息**：
  `user_name`、`user_id`、`user_url`

  > 我们仅提供有限的用户信息数据点。

* **帖子元数据**：
  `post_id`、`post_url`。

* **附件和媒体**：
  `attached_files`（仅链接，不包含文件本身）、`video_length`。

## Reels API

Reels API 允许用户从公共 Facebook 个人资料中收集详细的 Reels 数据。该 API 提供关于 Reels 的全面数据点，包括帖子详情、页面/个人资料信息、附件和媒体。

### 通过个人资料 URL 采集

该 API 允许用户通过提供个人资料 URL，从公共 Facebook 个人资料中收集详细的 Reels 数据。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Facebook 个人资料 URL。
</ParamField>

<ParamField path="num_of_posts" type="number">
  要采集的 Reels 数量（默认最多 1600）。
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  要排除的 Reels ID 数组。
</ParamField>

<ParamField path="start_date" type="string">
  用于筛选 Reels 的起始日期。
</ParamField>

<ParamField path="end_date" type="string">
  用于筛选 Reels 的结束日期。
</ParamField>

**输出结构**

包含全面的数据点：

* **Reels 详情**：
  `post_id`、`content`、`hashtags`、`date_posted`、`num_comments`、`num_likes`、`audio`（音轨详情）、`video_view_count` 等。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lyclm3ey2q6rww027t?id=all\&tab=overview)。

* **页面/个人资料信息**：
  `page_name`、`page_category`、`page_followers`、`profile_handle`。

  > 我们仅提供有限的个人资料信息数据点。

* **附件和媒体**：
  `external_link`（仅链接，不包含文件本身）。


# Instagram API 抓取工具
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/social-media-apis/instagram



## 概述

Instagram API 套件提供多种类型的 API，每种 API 都针对特定的 Instagram 数据采集需求设计。以下是这些 API 的连接和交互概览，基于可用功能：

<CardGroup cols="1">
  <Card title="Profiles API" icon="user" href="/cn/api-reference/web-scraper-api/social-media-apis/instagram#profiles-api">
    此 API 允许用户基于单一输入（个人资料 URL）收集个人资料详细信息。

    <br />

    *   **发现功能**：

    *   `N/A`

    <br />

    *   **关键字段**：

    *   `followers`、`post_count`、`post_hashtags`、`profile_name`。
  </Card>

  <Card title="Posts API" icon="images" href="/cn/api-reference/web-scraper-api/social-media-apis/instagram#posts-api">
    此 API 允许用户基于单一输入 URL（如 Instagram Reels URL、搜索 URL 或个人资料 URL）收集多个帖子。

    <br />

    *   **发现功能**：

      *   - Instagram Reels 直接 URL

      *   - 搜索结果的直接 URL

      *   - 个人资料的直接 URL

    <br />

    *   **关键字段**：

    *   `url`、`followers`、`hashtags`、`engagement_score_view`。
  </Card>

  <Card title="Comments API" icon="comments" href="/cn/api-reference/web-scraper-api/social-media-apis/instagram#comments-api">
    此 API 允许用户使用帖子 URL 收集多个评论。

    <br />

    *   **发现功能**：

    *   `N/A`

    <br />

    *   **关键字段**：

    *   `comment_user`、`comment`、`likes_number`、`replies_number`。
  </Card>
</CardGroup>

该 API 套件旨在提供灵活的数据采集能力，用户可以输入特定的 URL 以批量或精准筛选的方式获取详细的帖子和评论数据。

## Profiles API

### 通过 URL 采集

此 API 允许用户通过提供 Instagram 个人资料 URL 来收集详细的 Instagram 个人资料数据。它提供了 Instagram 个人资料的全面概览，包括商业和互动信息、帖子以及用户详细信息。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Instagram 个人资料 URL。
</ParamField>

**输出结构**\
包含全面的数据点：

* **页面/个人资料详情**：\
  `account`、`id`、`followers`、`posts_count`、`is_business_account`、`is_professional_account`、`is_verified`、`avg_engagement`、`profile_name`、`profile_url`、`profile_image_link` 等。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_l1vikfch901nx3by4?id=all\&tab=overview)。

***

## Posts API

### 通过 URL 采集

此 API 允许用户通过提供帖子 URL 来收集 Instagram 帖子的详细数据。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Instagram 帖子 URL。
</ParamField>

**输出结构**\
包含全面的数据点：

* **帖子详情**：\
  `post_id`、`description`、`hashtags`、`date_posted`、`num_comments`、`likes`、`content_type`、`video_view_count`、`video_play_count` 等。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lk5ns7kz21pck8jpis?id=all\&tab=overview)。

* **页面/个人资料详情**：\
  `user_posted`、`followers`、`posts_count`、`profile_image_link`、`is_verified`、`profile_url`。

  > 仅提供有限的个人资料数据点。

* **附件和媒体**：\
  `photos`、`videos`、`thumbnail`、`display_url`（仅链接，非文件）、`audio`。

***

### 通过 URL 发现

此 API 允许用户通过提供 Instagram 个人资料 URL 并指定额外参数，发现该公共个人资料的最新帖子。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Instagram 个人资料 URL。
</ParamField>

<ParamField path="num_of_posts" type="number">
  要采集的最新帖子数量。如果省略，则没有限制。
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  要从结果中排除的帖子 ID 数组。
</ParamField>

<ParamField path="start_date" type="string">
  过滤帖子时的起始日期，格式为 MM-DD-YYYY（应早于 `end_date`）。
</ParamField>

<ParamField path="end_date" type="string">
  过滤帖子时的结束日期，格式为 MM-DD-YYYY（应晚于 `start_date`）。
</ParamField>

<ParamField path="post_type" type="string">
  指定要采集的帖子类型（如 `post`、`reel`）。
</ParamField>

**输出结构**\
包含全面的数据点：

* **帖子详情**：\
  `post_id`、`description`、`hashtags`、`date_posted`、`num_comments`、`likes`、`video_view_count`、`video_play_count` 等。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lk5ns7kz21pck8jpis/url?id=all\&tab=overview)。

* **页面/个人资料详情**：\
  `user_posted`、`followers`、`posts_count`、`profile_image_link`、`is_verified`、`profile_url`、`is_paid_partnership`、`partnership_details`、`user_posted_id`。

* **附件和媒体**：\
  `photos`、`videos`、`thumbnail`、`audio`、`display_url`、`content_type`、`product_type`、`coauthor_producers`、`tagged_users`。

此 API 允许进行过滤、排除特定帖子，并按类型（普通帖子或短视频）在指定时间范围内采集帖子。它提供详细的帖子和个人资料信息，适用于数据采集和分析。

## 评论 API

### 通过 URL 采集

此 API 允许用户通过提供 Instagram 帖子 URL 来收集特定帖子的最新评论。

<Note>
  此 API 仅获取最近 10 条评论及相关元数据。
</Note>

**输入参数**

<ParamField path="URL" type="string" required="true">
  Instagram 帖子 URL。
</ParamField>

**输出结构**\
包含全面的数据点：

* **评论详情**：\
  `comment_id`、`comment_user`、`comment_user_url`、`comment_date`、`comment`、`likes_number`、`replies_number`、`replies`、`hashtag_comment`、`tagged_users_in_comment` 等。

  > 所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_ltppn085pokosxh13?id=all\&tab=overview)。

* **用户详情**：\
  `user_name`、`user_id`、`user_url`

  > 我们仅提供有限的用户资料数据点。

* **帖子元数据**：\
  `post_url`、`post_user`、`post_id`。

## Reels API（短视频 API）

### 通过 URL 采集

此 API 允许用户通过提供 Reels 短视频的 URL，从公开的 Instagram 个人资料中收集详细数据。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Instagram Reels 短视频 URL。
</ParamField>

**输出结构**\
包含全面的数据点：

* **短视频详情**：\
  `post_id`、`description`、`hashtags`、`date_posted`、`tagged_users`、`num_comments`、`likes`、`views`、`video_play_count`、`length` 等。

  > 所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lyclm20il4r5helnj?id=all\&tab=overview)。

* **页面/个人资料详情**：\
  `user_posted`、`followers`、`posts_count`、`profile_image_link`、`is_verified`、`profile_url`。

  > 我们仅提供有限的个人资料数据点。

* **附件和媒体**：\
  `video_url`、`thumbnail`、`audio_url`。

### 通过 URL 发现

此 API 允许用户通过个人资料 URL 或直接搜索 URL 发现 Instagram Reels 短视频。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Instagram 个人资料 URL 或直接搜索 URL。
</ParamField>

<ParamField path="num_of_posts" type="number">
  需要收集的最新短视频数量。如果省略，则没有限制。
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  要排除的短视频 ID 数组。
</ParamField>

<ParamField path="start_date" type="string">
  过滤短视频的起始日期，格式为 MM-DD-YYYY。
</ParamField>

<ParamField path="end_date" type="string">
  过滤短视频的结束日期，格式为 MM-DD-YYYY（应晚于 `start_date`）。
</ParamField>

**输出结构**\
包含全面的数据点：

* **短视频详情**：\
  `post_id`、`description`、`hashtags`、`date_posted`、`num_comments`、`likes`、`views`、`video_play_count`、`top_comments`、`length`、`video_url`、`audio_url`、`content_id` 等。

  > 所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lyclm20il4r5helnj/url?id=all\&tab=overview)。

* **个人资料详情**：\
  `user_posted`、`followers`、`posts_count`、`following`。

* **附件和媒体**：\
  `video_url`、`thumbnail`、`audio_url`（仅提供链接，不包含文件本身）。

此 API 提供有关 Instagram Reels 的详细信息，并支持按日期范围过滤、排除特定帖子以及限制收集的短视频数量。


# LinkedIn API Scrapers
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/social-media-apis/linkedin



## 概览

LinkedIn API 套件提供多种类型的 API，每种 API 旨在满足 LinkedIn 数据采集的特定需求。以下是这些 API 之间的连接和交互概述，基于可用功能：

<CardGroup cols="1">
  <Card title="个人资料 API" icon="user" href="/cn/api-reference/web-scraper-api/social-media-apis/linkedin#profiles-api">
    该 API 允许用户根据一个输入：个人资料 URL 采集个人资料详情。

    <br />

    *   **发现功能**：

    *   根据姓名发现 LinkedIn 个人资料

    <br />

    *   **重要列、列名**：

    *   `name`，`country_code`，`current_company`，`about`。
  </Card>

  <Card title="文章 API" icon="images" href="/cn/api-reference/web-scraper-api/social-media-apis/linkedin#posts-api">
    该 API 允许用户根据一个输入 URL 采集多篇文章。

    <br />

    *   **发现功能**：

      *   - 直接 LinkedIn 个人资料 URL

      *   - 直接用户文章 URL

      *   - 直接公司 URL

    <br />

    *   **重要列、列名**：

    *   `url`，`title`，`hashtags`，`num_likes`。
  </Card>

  <Card title="职位信息 API" icon="briefcase" href="/cn/api-reference/web-scraper-api/social-media-apis/linkedin#job-listings-information-api">
    该 API 允许用户根据一个输入 URL 采集职位信息。

    <br />

    *   **发现功能**：

      *   - 直接搜索 URL

      *   - 根据关键词发现

    <br />

    *   **重要列、列名**：

    *   `job_title`，`company_name`，`job_location`，`job_seniority_level`。
  </Card>

  <Card title="公司信息 API" icon="building" href="/cn/api-reference/web-scraper-api/social-media-apis/linkedin#companies-information-api">
    该 API 允许用户通过公司 URL 采集公司信息。

    <br />

    *   **发现功能**：N/A

    <br />

    *   **重要列、列名**：

    *   `name`，`country_code`，`followers`，`employees_in_linkedin`。
  </Card>
</CardGroup>

该 API 套件设计为提供灵活性，以满足定向数据采集需求。用户可以输入特定 URL 以获取详细的文章、个人资料、职位和公司数据，支持批量操作或精准筛选。

## 个人资料 API

### 通过 URL 采集

此 API 允许用户通过提供 LinkedIn 个人资料 URL 来收集详细信息。

**输入参数**:

<ParamField path="URL" type="string" required="true">
  LinkedIn 个人资料 URL。
</ParamField>

**输出结构**:\
包括全面的数据点：

* **个人资料详情**：\
  `linkedin_id`、`name`、`country_code`、`city`、`position`、`current_company`、`current_company_name`、`current_company_company_id`、`about` 等。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_l1viktl72bvl7bjuj0?id=all\&tab=overview)。

* **职业信息**：\
  `experience`、`education`、`educations_details`、`certifications`、`languages`、`recommendations_count`、`recommendations`、`volunteer_experience`、`courses`、`publications`、`patents`、`projects`、`organizations` 和 `honors_and_awards`。

* **社交活动**：\
  `posts`、`activity`、`followers`、`connections`、`people_also_viewed`。

* **媒体与身份识别**：\
  `avatar`、`banner_image`、`url`、`input_url`、`linkedin_num_id`、`id`、`timestamp`。

此 API 提供丰富的数据点，可用于分析 LinkedIn 个人资料，包括职业经历、教育背景、推荐信息、社交活动，以及媒体和唯一身份标识信息。

### 通过姓名发现

此 API 允许用户根据提供的姓和名查找 LinkedIn 个人资料。

**输入参数**:

<ParamField path="first_name" type="string" required="true">
  个人的名字。
</ParamField>

<ParamField path="last_name" type="string" required="true">
  个人的姓氏。
</ParamField>

**输出结构**:\
包括全面的数据点：

* **个人资料详情**：\
  `linkedin_id`、`name`、`country_code`、`city`、`position`、`current_company`、`current_company_name`、`current_company_company_id`、`about` 等。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_l1viktl72bvl7bjuj0/name?id=all\&tab=overview)。

* **职业信息**：\
  `experience`、`education`、`educations_details`、`certifications`、`languages`、`recommendations_count`、`recommendations`、`volunteer_experience`、`courses`、`publications`、`patents`、`projects`、`organizations` 和 `honors_and_awards`。

* **社交活动**：\
  `posts`、`activity`、`followers`、`connections`、`people_also_viewed`。

* **媒体与身份识别**：\
  `avatar`、`banner_image`、`url`、`input_url`、`linkedin_num_id`、`id`、`timestamp`。

此 API 可根据姓名高效检索 LinkedIn 个人资料，提供丰富的职业和社交信息，并附带相关的媒体资源。

## 文章 API

### 通过 URL 收集

此 API 允许用户通过提供帖子 URL 来收集 Instagram 帖子的详细数据。

**输入参数**:

<ParamField path="URL" type="string" required="true">
  LinkedIn 帖子的 URL。
</ParamField>

**输出结构**:\
包含全面的数据点：

* **帖子详情**：\
  `id`、`title`、`headline`、`post_text`、`post_text_html`、`date_posted`、`hashtags`、`embedded_links`、`images`、`videos`、`post_type`、`account_type` 等。

  > 查看所有数据点，请 [点击这里](https://brightdata.com/cp/data_api/gd_lyy3tktm25m4avu764?id=all\&tab=overview)。

* **互动指标**：\
  `num_likes`、`num_comments`、`top_visible_comments`。

* **用户详情**：\
  `user_id`、`use_url`、`user_followers`、`user_posts`、`user_articles`。

* **相关内容**：\
  `more_articles_by_user`、`more_relevant_posts`。

此 API 提供 LinkedIn 帖子的详细信息，包括文本、媒体附件、互动指标，以及额外的用户和相关内容数据，以便进行全面的帖子分析。

### 通过 URL 发现

此 API 允许用户通过提供 LinkedIn 个人资料 URL 并可选择限制结果数量，来发现该用户撰写的文章。

**输入参数**:

<ParamField path="URL" type="string" required="true">
  LinkedIn 个人资料 URL。
</ParamField>

<ParamField path="limit" type="number">
  要检索的文章最大数量。如果省略，将收集所有可用的文章。
</ParamField>

**输出结构**:\
包含全面的数据点：

* **文章详情**：\
  `id`、`title`、`headline`、`post_text`、`post_text_html`、`date_posted`、`hashtags`、`embedded_links`、`images`、`videos`、`post_type`、`account_type` 等。

  > 查看所有数据点，请 [点击这里](https://brightdata.com/cp/data_api/gd_lyy3tktm25m4avu764/url?id=all\&tab=overview)。

* **互动指标**：\
  `num_likes`、`num_comments`、`top_visible_comments`。

* **用户详情**：\
  `user_id`、`use_url`、`user_followers`、`user_posts`、`user_articles`。

* **相关内容**：\
  `more_articles_by_user`、`more_relevant_posts`。

此 API 可获取 LinkedIn 用户撰写的文章的详细信息，包括文本、媒体、互动数据，以及相关的用户和内容数据，以便进行深入分析。

### 通过个人资料 URL 发现

此 API 允许用户通过提供个人资料 URL 并应用可选的日期筛选器，来发现 LinkedIn 帖子。

**输入参数**:

<ParamField path="URL" type="string" required="true">
  LinkedIn 个人资料 URL。
</ParamField>

<ParamField path="start_date" type="date">
  按发布时间筛选帖子的起始日期（YYYY-MM-DD 格式）。发布时间早于此日期的帖子将被排除。
</ParamField>

<ParamField path="end_date" type="date">
  按发布时间筛选帖子的结束日期（YYYY-MM-DD 格式）。发布时间晚于此日期的帖子将被排除。
</ParamField>

**输出结构**:\
包含全面的数据点：

* **帖子详情**：\
  `id`、`title`、`headline`、`post_text`、`post_text_html`、`date_posted`、`hashtags`、`embedded_links`、`images`、`videos`、`post_type`、`account_type` 等。

  > 查看所有数据点，请 [点击这里](https://brightdata.com/cp/data_api/gd_lyy3tktm25m4avu764/company_url?id=all\&tab=overview)。

* **互动指标**：\
  `num_likes`、`num_comments`、`top_visible_comments`。

* **用户详情**：\
  `user_id`、`use_url`、`user_followers`、`user_posts`、`user_articles`。

* **相关内容**：\
  `more_articles_by_user`、`more_relevant_posts`。

此 API 允许基于特定个人资料和时间范围精准发现 LinkedIn 帖子，提供详细的帖子数据、互动指标以及相关用户信息，以便进行深入分析。

### 通过公司 URL 发现

此 API 允许用户使用公司 URL 发现公司发布的最新 LinkedIn 帖子，并通过可选的日期范围进行筛选。

**输入参数**:

<ParamField path="URL" type="string" required="true">
  LinkedIn 公司资料 URL。
</ParamField>

<ParamField path="start_date" type="date">
  按发布时间筛选帖子的起始日期（YYYY-MM-DD 格式）。仅收集该日期或之后发布的帖子。
</ParamField>

<ParamField path="end_date" type="date">
  按发布时间筛选帖子的结束日期（YYYY-MM-DD 格式）。仅收集该日期或之前发布的帖子。
</ParamField>

**输出结构**:\
包含全面的数据点：

* **帖子详情**：\
  `post_id`、`title`、`post_text`、`date_posted`、`hashtags`、`embedded_links`、`images`、`videos`、`post_type`、`account_type` 等。

  > 查看所有数据点，请 [点击这里](https://brightdata.com/cp/data_api/gd_lyy3tktm25m4avu764/company_url?id=all\&tab=overview)。

* **互动指标**：\
  `num_likes`、`num_comments`、`top_visible_comments`。

* **公司详情**：\
  `company_id`、`company_name`、`company_url`、`followers`。

* **相关内容**：\
  `more_relevant_posts`、`additional_media_links`。

此 API 提供公司发布的帖子详细信息，帮助企业和分析师有效追踪动态、互动数据以及内容趋势。

## 职位列表信息 API

### 通过 URL 收集

此 API 允许用户通过提供 LinkedIn 职位 URL 来收集详细的职位信息。

**输入参数**：

<ParamField path="URL" type="string" required="true">
  LinkedIn 职位列表的 URL。
</ParamField>

**输出结构**：\
包含全面的数据点：

* **职位详情**：
  `job_posting_id`、`job_title`、`job_summary`、`job_seniority_level`、`job_function`、`job_employment_type`、`job_industries`、`job_base_pay_range`、`base_salary`、`job_description_formatted` 等。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lpfll7v5hcqtkxl6l?id=all\&tab=overview)。

* **公司详情**：
  `company_name`、`company_id`、`company_url`、`company_logo`。

* **职位元数据**：
  `job_location`、`job_posted_time`、`job_posted_date`、`job_num_applicants`、`discovery_input`、`apply_link`、`country_code`、`title_id`。

* **职位发布者信息**：
  `job_poster`。

该 API 提供对 LinkedIn 职位列表的全面概览，包括职位详情、公司信息、申请人数统计和元数据，以增强职位分析和申请跟踪。

### 通过关键词发现职位

此 API 允许用户根据关键词搜索、位置和其他筛选条件（如职位类型、经验水平等）发现 LinkedIn 职位。

**输入参数**：

<ParamField path="location" type="string" required="true">
  目标职位所在的具体位置。
</ParamField>

<ParamField path="keyword" type="string" required="true">
  用于搜索职位的关键词或职位名称（例如 "产品经理"）。使用引号可进行精确匹配。
</ParamField>

<ParamField path="country" type="string">
  以两位字母格式表示的国家代码（例如 `US`、`FR`）。
</ParamField>

<ParamField path="time_range" type="string">
  职位发布时间范围（例如 `past_week`、`past_month`）。
</ParamField>

<ParamField path="job_type" type="string">
  职位类型（例如 "全职"、"兼职"）。
</ParamField>

<ParamField path="experience_level" type="string">
  职位所需的经验水平（例如 "入门级"、"中高级"）。
</ParamField>

<ParamField path="remote" type="string">
  是否为远程职位（例如 "yes" 或 "no"）。
</ParamField>

<ParamField path="company" type="string">
  用于筛选职位的公司名称。
</ParamField>

<ParamField path="selective_search" type="boolean">
  设置为 `true` 时，排除不包含指定关键词的职位标题。
</ParamField>

**输出结构**：\
包含全面的数据点：

* **职位详情**：
  `job_posting_id`、`job_title`、`job_summary`、`job_seniority_level`、`job_function`、`job_employment_type`、`job_industries`、`job_base_pay_range`、`job_description_formatted`、`base_salary` 等。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lpfll7v5hcqtkxl6l/keyword?id=all\&tab=overview)。

* **公司详情**：
  `company_name`、`company_id`、`company_url`、`company_logo`。

* **职位元数据**：
  `job_location`、`job_posted_time`、`job_posted_date`、`job_num_applicants`、`job_poster`、`apply_link`、`country_code`、`title_id`。

* **申请详情**：
  `job_poster`、`application_availability`、`discovery_input`。

此 API 允许用户根据特定关键词、位置、职位类型等筛选和发现 LinkedIn 职位，并提供详细的职位列表和公司信息，以便进一步分析。

### 通过 URL 发现职位

此 API 允许用户从 LinkedIn 直接职位搜索 URL 发现职位列表，并根据特定 URL 查询提供职位详情、公司信息和职位元数据。

**输入参数**：

<ParamField path="URL" type="string" required="true">
  用于搜索职位的 LinkedIn 直接搜索 URL（例如按公司或职位名称）。
</ParamField>

<ParamField path="selective_search" type="boolean">
  设置为 `true` 时，搜索将排除与指定关键词或条件不匹配的职位标题。
</ParamField>

**输出结构**：\
包含全面的数据点：

* **职位详情**：
  `job_posting_id`、`job_title`、`job_summary`、`job_seniority_level`、`job_function`、`job_employment_type`、`job_industries`、`job_base_pay_range`、`job_description_formatted`、`base_salary` 等。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lpfll7v5hcqtkxl6l/url?id=all\&tab=overview)。

* **公司详情**：
  `company_name`、`company_id`、`company_url`、`company_logo`。

* **职位元数据**：
  `job_location`、`job_posted_time`、`job_posted_date`、`job_num_applicants`、`job_poster`、`apply_link`、`country_code`、`title_id`。

* **申请详情**：
  `job_poster`、`application_availability`、`discovery_input`。

此 API 允许用户从 LinkedIn 搜索 URL 获取详细的职位列表，提供职位机会、公司详情等信息，以实现高效的职位发现和申请跟踪。

## 公司信息 API

### 通过 URL 获取

该 API 允许用户通过提供 LinkedIn 公司资料的 URL 来收集详细的公司信息。

**输入参数**：

<ParamField path="URL" type="string" required="true">
  LinkedIn 公司资料的 URL。
</ParamField>

**输出结构**：\
包含全面的数据点：

* **公司详情**：\
  `id`、`name`、`about`、`slogan`、`description`、`specialties`、`organization_type`、`company_size`、`industries`、`founded` 等。

  > 查看所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_l1vikfnt1wgvvqz95w?id=all\&tab=overview)。

* **商业信息**：\
  `country_code`、`country_codes_array`、`locations`、`formatted_locations`、`headquarters`、`stock_info`、`funding`、`investors`、`crunchbase_url`、`get_directions_url`。

* **互动与网络**：\
  `followers`、`employees`、`employees_in_linkedin`、`alumni`、`alumni_information`、`affiliated`、`similar`。

* **媒体与元数据**：\
  `logo`、`image`、`url`、`updates`、`timestamp`。

该 API 提供 LinkedIn 公司资料的全面概览，包括业务详情、公司位置、校友网络、融资信息以及媒体资源。


# 社交媒体爬取 API 概览
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/social-media-apis/overview

社交媒体 API 套件提供广泛的数据收集工具，适用于多个平台。

#### 社交媒体 API 套件概述

社交媒体 API 套件旨在简化数据收集，同时提供对用户互动和内容传播的深入分析。用户可以参考详细指南，了解如何结合多个 API 以获取全面的数据。

#### 支持的平台

社交媒体 API 套件支持多个社交媒体平台，包括：

<CardGroup cols={4}>
  <Card title="Facebook" icon="facebook" href="/cn/scraping-automation/web-data-apis/web-scraper-api/social-media-apis/facebook" />

  <Card title="Instagram" icon="instagram" href="/cn/scraping-automation/web-data-apis/web-scraper-api/social-media-apis/instagram" />

  <Card title="LinkedIn" icon="linkedin" href="/cn/scraping-automation/web-data-apis/web-scraper-api/social-media-apis/linkedin" />

  <Card title="TikTok" icon="tiktok" href="/cn/scraping-automation/web-data-apis/web-scraper-api/social-media-apis/tiktok" />

  <Card title="Reddit" icon="reddit" href="/cn/scraping-automation/web-data-apis/web-scraper-api/social-media-apis/reddit" />

  <Card title="Twitter" icon="twitter" href="/cn/scraping-automation/web-data-apis/web-scraper-api/social-media-apis/twitter" />

  <Card title="Pinterest" icon="pinterest" href="/cn/scraping-automation/web-data-apis/web-scraper-api/social-media-apis/pinterest" />

  <Card title="Quora" icon="quora" href="/cn/scraping-automation/web-data-apis/web-scraper-api/social-media-apis/quora" />

  <Card title="Vimeo" icon="vimeo" href="/cn/scraping-automation/web-data-apis/web-scraper-api/social-media-apis/vimeo" />

  <Card title="YouTube" icon="youtube" href="/cn/scraping-automation/web-data-apis/web-scraper-api/social-media-apis/youtube" />
</CardGroup>

该 API 套件可用于分析用户资料、帖子及其互动情况（如评论和点赞）。以下是基于销售指南的 API 总览。

#### API 类型与数据连接

* **Profiles API（用户资料 API）**：收集用户或频道的资料数据，包括粉丝数、订阅数和内容统计信息。
* **Posts API（帖子 API）**：提供单个帖子或视频的数据，包括点赞数、观看数和标签信息。
* **Comments API（评论 API）**：分析用户与帖子的互动情况，例如评论的回复和点赞数据。

Facebook、YouTube、Instagram、TikTok 和 Pinterest 等平台均支持这些 API，从而实现一致且全面的社交数据收集。

#### 主要功能

1. **全面覆盖**：支持从 YouTube、TikTok 等视频平台到 Instagram、Facebook 等社交网络的广泛数据收集。
2. **最新数据**：每个 API 都支持按需数据获取，确保用户获取到最新的数据。
3. **可定制方案**：API 具有灵活性，允许用户自定义数据收集方式，并结合多个 API 以满足不同的需求。
4. **易于集成**：支持简单的 API 调用，方便集成到现有工作流中，降低开发者的学习成本。
5. **互联互通**：这些 API 可互相配合，用户可以利用一个 API 作为另一个 API 的输入，进行跨平台数据分析并获取全面的洞察信息。

> **示例：在 YouTube 上的数据分析**
>
> * 使用 **Profiles API** 获取特定频道的相关数据。
> * 通过 **Posts API** 获取该频道发布的视频数据。
> * 使用 **Comments API** 获取这些视频的评论数据。

这种互联方式适用于所有支持的平台，使用户能够分析用户资料、帖子及其相关互动，以进行深度数据研究。


# Pinterest API 抓取工具
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/social-media-apis/pinterest



## 概览

Pinterest API 套件提供多种 API，每种 API 旨在满足不同的 Pinterest 数据采集需求。以下是这些 API 之间的连接和交互方式概览，基于可用的功能：

<CardGroup cols={1}>
  <Card title="个人资料 API" icon="user" href="/cn/api-reference/web-scraper-api/social-media-apis/pinterest#profiles-api">
    该 API 允许用户根据单个输入（个人资料 URL）收集个人资料详细信息。

    <br />

    *   **发现功能**：

    *   通过关键词发现。

    <br />

    *   **重要字段**：

    *   `name`, `following_count`, `website`, `follower_count`。
  </Card>

  <Card title="帖子 API" icon="images" href="/cn/api-reference/web-scraper-api/social-media-apis/pinterest#posts-api">
    该 API 允许用户基于单个输入收集多个帖子。

    <br />

    *   **发现功能**：

      *   - 通过个人资料 URL 发现。

      *   - 通过关键词发现。

    <br />

    *   **重要字段**：

    *   `title`, `content`, `user_name`, `likes`。
  </Card>
</CardGroup>

## 个人资料 API

### 通过 URL 采集

该 API 允许用户使用提供的个人资料 URL 获取详细的 Pinterest 个人资料信息。

**输入参数**：

<ParamField path="URL" type="string" required="true">
  Pinterest 个人资料 URL。
</ParamField>

**输出结构**：\
包含丰富的数据点：

* **个人资料详情**：\
  `url`, `profile_picture`, `name`, `nickname`, `website`, `bio`, `country_code`, `profile_id`。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lk0zv93c2m9qdph46z?id=all\&tab=overview)。

* **互动与指标**：\
  `following_count`, `follower_count`, `boards_num`, `saved`。

* **附加信息**：\
  `last_updated`, `posts_page_url`, `discovery_input`。

该 API 允许用户收集 Pinterest 个人资料的详细信息，包括用户统计数据、互动指标和个人资料详情。

***

### 通过关键词发现

该 API 允许用户基于指定关键词发现 Pinterest 个人资料。

**输入参数**：

<ParamField path="keyword" type="string" required="true">
  用于搜索个人资料的关键词。
</ParamField>

**输出结构**：\
包含丰富的数据点：

* **个人资料详情**：\
  `url`, `profile_picture`, `name`, `nickname`, `website`, `bio`, `country_code`, `profile_id`。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lk0zv93c2m9qdph46z/keyword?id=all\&tab=overview)。

* **互动与指标**：\
  `following_count`, `follower_count`, `boards_num`, `saved`。

* **附加信息**：\
  `last_updated`, `posts_page_url`, `discovery_input`。

该 API 使用户能够查找与特定关键词相关的 Pinterest 个人资料，提供用户统计数据、互动情况和个人资料详情。

## 帖子 API

### 通过 URL 采集

该 API 允许用户使用提供的帖子 URL 收集特定 Pinterest 帖子的详细数据。

**输入参数**：

<ParamField path="URL" type="string" required="true">
  Pinterest 帖子 URL。
</ParamField>

**输出结构**：\
包含丰富的数据点：

* **帖子详情**：\
  `url`, `post_id`, `title`, `content`, `date_posted`, `post_type`。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lk0sjs4d21kdr7cnlv?id=all\&tab=overview)。

* **用户详情**：\
  `user_name`, `user_url`, `user_id`, `followers`。

* **帖子指标**：\
  `likes`, `comments_num`, `comments`, `categories`。

* **媒体与附件**：\
  `image_video_url`, `video_length`, `attached_files`。

* **标签与发现**：\
  `hashtags`, `discovery_input`。

该 API 允许用户获取特定 Pinterest 帖子的详细信息，包括用户互动、帖子内容、媒体及其他相关信息。

***

### 通过个人资料 URL 发现帖子

该 API 允许用户基于提供的个人资料 URL 获取特定 Pinterest 个人资料下的帖子。

**输入参数**：

<ParamField path="URL" type="string" required="true">
  要采集帖子的 Pinterest 个人资料 URL。
</ParamField>

<ParamField path="num_of_posts" type="number">
  要采集的帖子数量。如果省略，则没有限制。
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  要排除的帖子 ID 数组。
</ParamField>

<ParamField path="start_date" type="string">
  过滤帖子起始日期，格式为 `MM-DD-YYYY`（应早于 `end_date`）。
</ParamField>

<ParamField path="end_date" type="string">
  过滤帖子结束日期，格式为 `MM-DD-YYYY`（应晚于 `start_date`）。
</ParamField>

**输出结构**：\
包含丰富的数据点：

* **帖子详情**：\
  `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`。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lk0sjs4d21kdr7cnlv/profile_url?tab=overview)。

* **互动与指标**：\
  `followers`, `likes`, `comments_num`。

* **媒体与附件**：\
  `image_video_url`, `video_length`, `attached_files`。

* **附加信息**：\
  `discovery_input`。

该 API 允许用户从特定 Pinterest 个人资料中收集帖子，并支持按日期筛选、排除特定帖子，并获取包含媒体、评论和互动指标的详细帖子数据。

***

### 通过关键词发现帖子

该 API 允许用户基于特定关键词发现 Pinterest 帖子，实现高效的内容发现。

**输入参数**：

<ParamField path="keyword" type="string" required="true">
  用于搜索帖子的关键词，例如 "food" 或其他相关术语。
</ParamField>

**输出结构**：\
包含丰富的数据点：

* **帖子详情**：\
  `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`。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lk0zv93c2m9qdph46z/keyword?id=all\&tab=overview)。

* **互动与指标**：\
  `followers`, `likes`, `comments_num`。

* **媒体与附件**：\
  `image_video_url`, `video_length`, `attached_files`。

* **附加信息**：\
  `discovery_input`。

该 API 允许用户基于特定关键词搜索 Pinterest 帖子，并提供详细的内容、互动、媒体及相关指标信息，以实现高效发现。


# Quora API 抓取器
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/social-media-apis/quora



## 概览

<CardGroup cols={1}>
  <Card title="Posts API" icon="images" href="/cn/api-reference/web-scraper-api/social-media-apis/quora#posts-api">
    此 API 允许用户基于单个输入 URL 收集多个帖子。

    <br />

    *   **发现功能**：

    *   不适用

    <br />

    *   **重要字段**：

    *   `author_name`，`title`，`over_all_answers`，`shares`。
  </Card>
</CardGroup>

## Posts API

### 通过 URL 采集

此 API 允许用户使用提供的 Quora 帖子 URL，收集该帖子的详细信息。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Quora 帖子的 URL。
</ParamField>

**输出结构**：\
包含全面的数据点：

* **帖子详情**：\
  `url`，`post_id`，`title`，`post_date`，`originally_answered`，`over_all_answers`，`post_text`，`header`。

  > 查看所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lvz1rbj81afv3m6n5y?id=all\&tab=overview)。

* **媒体 & 链接**：\
  `pictures_urls`，`videos_urls`，`external_urls`。

* **互动 & 指标**：\
  `upvotes`，`shares`，`views`，`author_content_views`。

* **作者详情**：\
  `author_name`，`author_active_spaces`，`author_joined_date`，`author_about`，`author_education`。

* **热门评论**：\
  `top_comments`。

此 API 提供对 Quora 帖子的详细见解，包括内容、媒体、作者信息和互动指标，助力高效的帖子分析和内容追踪。


# Reddit API 爬取器
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/social-media-apis/reddit



## 概览

Reddit API 套件提供多种类型的 API，每种 API 旨在满足不同的 Reddit 数据采集需求。以下是这些 API 之间的交互方式概览，基于可用的功能：

<CardGroup cols={1}>
  <Card title="帖子 API" icon="images" href="/cn/api-reference/web-scraper-api/social-media-apis/reddit#posts-api">
    该 API 允许用户根据单个输入 URL 采集多个帖子。

    <br />

    *   **发现功能**：

    *   通过 Subreddit URL 发现。

    *   通过关键词发现。

    <br />

    *   **重要字段**：

    *   `url`、`title`、`num_comments`、`description`
  </Card>

  <Card title="评论 API" icon="comments" href="/cn/api-reference/web-scraper-api/social-media-apis/reddit#comments-api">
    该 API 允许用户通过帖子 URL 采集多个评论。

    <br />

    *   **发现功能**：

    *   不适用

    <br />

    *   **重要字段**：

    *   `url`、`comment`、`community_name`、`num_replies`
  </Card>
</CardGroup>

## 帖子 API

### 通过 URL 采集

该 API 允许用户使用提供的 URL 检索特定 Reddit 帖子的详细数据。

**输入参数**

<ParamField path="URL" type="string" required="true">
  需要检索的 Reddit 帖子 URL。
</ParamField>

**输出结构**:\
包含全面的数据点：

* **帖子详情**:\
  `post_id`、`url`、`title`、`description`、`num_comments`、`date_posted`、`tag`、`related_posts`、`comments`、`photos`、`videos`。

  > 查看所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lvz8ah06191smkebj4?id=all\&tab=overview)。

* **用户详情**:\
  `user_posted`。

* **社区详情**:\
  `community_name`、`community_url`、`community_description`、`community_members_num`、`community_rank`。

* **互动指标**:\
  `num_upvotes`。

该 API 可高效获取 Reddit 帖子信息，包括用户互动数据、社区详情及多媒体内容，支持高级分析和内容跟踪。

### 通过关键词发现

该 API 允许用户通过特定关键词发现 Reddit 帖子，并可选择按日期筛选和设置要检索的帖子数量。

**输入参数**

<ParamField path="keyword" type="string" required="true">
  用于搜索相关帖子的关键词。
</ParamField>

<ParamField path="date" type="string" required="true">
  过滤帖子发布时间，以确保结果符合指定时间范围。
</ParamField>

<ParamField path="num_of_posts" type="number">
  需要采集的帖子数量。如果未提供，则默认检索所有符合条件的帖子。
</ParamField>

**输出结构**:\
包含全面的数据点：

* **帖子详情**:\
  `post_id`、`url`、`user_posted`、`title`、`description`、`num_comments`、`date_posted`、`tag`、`related_posts`、`comments`。

  > 查看所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lvz8ah06191smkebj4/keyword?id=all\&tab=overview)。

* **社区详情**:\
  `community_name`、`community_url`、`community_description`、`community_members_num`、`community_rank`。

* **媒体详情**:\
  `photos`、`videos`。

该 API 使用户能够高效发现并分析与特定关键词相关的 Reddit 帖子，提供关于社区讨论、帖子热度及相关媒体内容的宝贵洞察。

### 通过 Subreddit URL 发现

该 API 允许用户使用 Subreddit URL 检索特定 Subreddit 中的帖子，并可选择基于特定标准对结果进行排序。

**输入参数**

<ParamField path="URL" type="string" required="true">
  需要采集帖子的 Subreddit URL。
</ParamField>

<ParamField path="sort_by" type="string">
  确定帖子排序方式（例如 `new`、`top`、`hot`）。
</ParamField>

**输出结构**:\
包含全面的数据点：

* **帖子详情**:\
  `post_id`、`url`、`user_posted`、`title`、`description`、`num_comments`、`date_posted`、`tag`、`related_posts`、`comments`。

  > 查看所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lvz8ah06191smkebj4/subreddit_url?id=all)。

* **社区详情**:\
  `community_name`、`community_url`、`community_description`、`community_members_num`、`community_rank`。

* **媒体详情**:\
  `photos`、`videos`。

该 API 提供了一种简化方式来探索和分析 Subreddit 内的帖子，帮助深入了解帖子内容、社区动态及相关媒体文件，非常适合监控 Subreddit 活动或提取帖子级别的数据进行进一步分析。

## 评论 API

### 通过 URL 收集

该 API 允许用户从特定的 Reddit 帖子或评论 URL 采集详细的评论数据，并可选择根据发布时间筛选评论。

**输入参数**

<ParamField path="URL" type="string" required="true">
  要获取评论的 Reddit 帖子或评论的 URL。
</ParamField>

<ParamField path="days_back" type="number">
  仅采集指定天数内发布的所有评论。
</ParamField>

**输出结构**\
包含全面的数据点：

* **评论详情**：\
  `comment_id`, `user_posted`, `comment`, `date_posted`, `replies`, `num_upvotes`, `num_replies`。

  > 所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lvzdpsdlw09j6t702?tab=overview)。

* **帖子详情**：\
  `post_url`, `post_id`, `post_language`, `post_state`, `post_type`, `images`。

* **社区详情**：\
  `community_name`, `community_url`, `community_description`, `community_members_num`, `community_rank`。

* **帖子属性**：\
  `is_moderator`, `is_pinned`, `has_bot_in_username`, `is_locked`, `is_admin_post`, `is_archived_post`, `is_moderator_post`, `is_quarantined_post`, `is_not_safe_for_work_post`, `is_eligible_for_content_blocking_post`, `is_promoted_post`。

该 API 提供对 Reddit 评论及其关联帖子的全面洞察，帮助用户有效分析互动情况、用户活动和内容趋势。


# TikTok API 抓取器
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/social-media-apis/tiktok



## 概述

TikTok API 套件提供多种类型的 API，每种 API 都针对从 TikTok 采集数据的特定需求进行设计。以下是这些 API 之间的交互概述，基于可用功能：

<CardGroup cols="1">
  <Card title="Profile API" icon="user" href="/cn/api-reference/web-scraper-api/social-media-apis/tiktok#profile-api">
    该 API 允许用户通过单一输入（个人资料 URL）采集个人资料详情。

    <br />

    *   **发现功能**：

    *   搜索的直接 URL

    <br />

    *   **主要数据列**：

    *   `nickname`，`awg_engagement_rate`，`followers`，`likes`
  </Card>

  <Card title="Posts API" icon="images" href="/cn/api-reference/web-scraper-api/social-media-apis/tiktok#posts-api">
    该 API 允许用户通过单一输入 URL 采集多个帖子。

    <br />

    *   **发现功能**：

    *   - TikTok 个人资料的直接 URL

    *   - 通过关键词发现

    *   - 发现的直接 URL

    <br />

    *   **主要数据列**：

    *   `url`，`share_count`，`description`，`hashtags`
  </Card>

  <Card title="Comments API" icon="comments" href="/cn/api-reference/web-scraper-api/social-media-apis/tiktok#comments-api">
    该 API 允许用户使用帖子 URL 采集多个评论。

    <br />

    *   **发现功能**：

    *   N/A

    <br />

    *   **主要数据列**：

    *   `url`，`comment_text`，`commenter_url`，`num_likes`
  </Card>
</CardGroup>

## Profile API

### 通过 URL 采集

该 API 允许用户使用提供的个人资料 URL 检索详细的 TikTok 个人资料信息。

**输入参数**：

<ParamField path="URL" type="string" required="true">
  TikTok 个人资料 URL。
</ParamField>

**输出结构**：\
包含全面的数据点：

* **个人资料详情**：\
  `account_id`，`nickname`，`biography`，`bio_link`，`predicted_lang`，`is_verified`，`followers`，`following`，`likes`，`videos_count`，`create_time`，`id`，`url`，`profile_pic_url`，`profile_pic_url_hd` 等。

  > 查看所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_l1villgoiiidt09ci?id=all\&tab=overview)。

* **互动指标**：\
  `awg_engagement_rate`，`comment_engagement_rate`，`like_engagement_rate`，`like_count`，`digg_count`。

* **隐私与设置**：\
  `is_private`，`relation`，`open_favorite`，`comment_setting`，`duet_setting`，`stitch_setting`，`is_ad_virtual`，`room_id`，`is_under_age_18`。

* **发现与热门视频**：\
  `region`，`top_videos`，`discovery_input`。

该 API 允许用户检索详细的 TikTok 个人资料信息，包括互动指标、隐私设置和热门视频，提供有关用户活动和个人资料数据的见解。

### 通过搜索 URL 发现

该 API 允许用户根据特定的搜索 URL 和国家/地区发现 TikTok 个人资料，并提供详细的个人资料信息。

**输入参数**：

<ParamField path="search_url" type="string" required="true">
  TikTok 搜索 URL。
</ParamField>

<ParamField path="country" type="string" required="true">
  执行搜索的国家/地区。
</ParamField>

**输出结构**：\
包含全面的数据点：

* **个人资料详情**：\
  `account_id`，`nickname`，`biography`，`bio_link`，`predicted_lang`，`is_verified`，`followers`，`following`，`likes`，`videos_count`，`create_time`，`id`，`url`，`profile_pic_url`，`profile_pic_url_hd` 等。

  > 查看所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_l1villgoiiidt09ci/search_url?id=all\&tab=overview)。

* **互动指标**：\
  `awg_engagement_rate`，`comment_engagement_rate`，`like_engagement_rate`，`like_count`，`digg_count`。

* **隐私与设置**：\
  `is_private`，`relation`，`open_favorite`，`comment_setting`，`duet_setting`，`stitch_setting`，`is_ad_virtual`，`room_id`，`is_under_age_18`。

* **发现与热门视频**：\
  `region`，`top_videos`，`discovery_input`。

该 API 使用户能够根据搜索条件发现 TikTok 个人资料，并提供有关用户活动、互动、隐私设置和热门内容的见解，有助于高效发现和分析 TikTok 用户。

## 帖子 API

### 通过 URL 采集

该 API 允许用户通过提供 TikTok 帖子 URL 来采集详细的帖子数据。

**输入参数**：

<ParamField path="URL" type="string" required="true">
  TikTok 帖子 URL。
</ParamField>

**输出结构**：\
包含丰富的数据点：

* **帖子详情**：\
  `post_id`、`description`、`create_time`、`share_count`、`collect_count`、`comment_count`、`play_count`、`video_duration`、`hashtags`、`original_sound`、`official_item`、`original_item`、`shortcode`、`video_url`、`music`、`cdn_url`、`width`、`carousel_images` 等。

  > 查看所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lu702nij2f790tmv9h?id=all\&tab=overview)。

* **个人资料详情**：\
  `profile_id`、`profile_username`、`profile_url`、`profile_avatar`、`profile_biography`、`account_id`、`profile_followers`、`is_verified`。

* **标记的用户和媒体**：\
  `tagged_user`、`carousel_images`。

* **附加信息**：\
  `tt_chain_token`、`secu_id`

***

### 通过个人资料 URL 发现

该 API 允许用户基于提供的个人资料 URL 获取 TikTok 个人资料的帖子，并可通过帖子数量、日期范围和排除特定帖子的选项进行筛选。

**输入参数**：

<ParamField path="URL" type="string" required="true">
  TikTok 个人资料 URL。
</ParamField>

<ParamField path="num_of_posts" type="number">
  要采集的帖子数量。如果未提供，则不限制。
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  要排除的帖子 ID 数组。
</ParamField>

<ParamField path="start_date" type="string">
  过滤帖子的起始日期（格式：mm-dd-yyyy），应小于 `end_date`。
</ParamField>

<ParamField path="end_date" type="string">
  过滤帖子的结束日期（格式：mm-dd-yyyy），应大于 `start_date`。
</ParamField>

<ParamField path="what_to_collect" type="string">
  指定要采集的帖子类型（例如 "post" 或 "reel"）。
</ParamField>

**输出结构**：\
包含丰富的数据点：

* **帖子详情**：\
  `post_id`、`description`、`create_time`、`share_count`、`collect_count`、`comment_count`、`play_count`、`video_duration`、`hashtags`、`original_sound`、`official_item`、`original_item`、`shortcode`、`video_url`、`music`、`cdn_url`、`width`、`carousel_images` 等。

  > 查看所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lu702nij2f790tmv9h/profile_url?id=all\&tab=overview)。

* **个人资料详情**：\
  `profile_id`、`profile_username`、`profile_url`、`profile_avatar`、`profile_biography`、`account_id`、`profile_followers`、`is_verified`。

* **标记的用户和媒体**：\
  `tagged_user`、`carousel_images`。

* **附加信息**：\
  `tt_chain_token`、`secu_id`。

该 API 允许用户发现和检索特定 TikTok 个人资料的帖子详细信息，包括帖子数据、创作者的个人资料信息以及标记的用户。支持高效内容发现和帖子分析。

***

### 通过关键词发现

该 API 允许用户基于特定关键词或标签搜索 TikTok 帖子，是发现 TikTok 平台相关内容的强大工具。

**输入参数**：

<ParamField path="search_keyword" type="string" required="true">
  要搜索的关键词或标签。
</ParamField>

<ParamField path="num_of_posts" type="number">
  要采集的帖子数量。如果未提供，则不限制。
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  要排除的帖子 ID 数组。
</ParamField>

<ParamField path="what_to_collect" type="string">
  指定要采集的帖子类型（例如 "post" 或 "reel"）。
</ParamField>

**输出结构**：\
包含丰富的数据点：

* **帖子详情**：\
  `post_id`、`description`、`create_time`、`digg_count`、`share_count`、`collect_count`、`comment_count`、`play_count`、`video_duration`、`hashtags`、`original_sound`、`post_type`、`discovery_input`、`official_item` 等。

  > 查看所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lu702nij2f790tmv9h/keyword?id=all\&tab=overview)。

* **个人资料详情**：\
  `profile_id`、`profile_username`、`profile_url`、`profile_avatar`、`profile_biography`、`account_id`、`profile_followers`、`is_verified`。

* **标记的用户和媒体**：\
  `tagged_user`、`carousel_images`。

* **附加信息**：\
  `tt_chain_token`、`secu_id`。

该 API 允许用户发现与特定关键词或标签匹配的 TikTok 帖子，并提供帖子详细信息、个人资料信息和媒体信息。这是探索 TikTok 趋势、内容和用户的绝佳工具。

***

### 通过发现 URL 发现

该 API 允许用户从特定 TikTok 发现 URL 采集详细的帖子数据。

**输入参数**：

<ParamField path="URL" type="string" required="true">
  TikTok 发现 URL。
</ParamField>

**输出结构**：\
包含丰富的数据点：

* **帖子详情**：\
  `post_id`、`description`、`create_time`、`digg_count`、`share_count`、`collect_count`、`comment_count`、`play_count`、`video_duration`、`hashtags`、`original_sound`、`post_type`、`discovery_input`、`official_item`、`original_item` 等。

  > 查看所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lu702nij2f790tmv9h/url?id=all\&tab=overview)。

* **个人资料详情**：\
  `profile_id`、`profile_username`、`profile_url`、`profile_avatar`、`profile_biography`、`account_id`、`profile_followers`、`is_verified`。

* **标记的用户和媒体**：\
  `tagged_user`、`carousel_images`。

* **附加信息**：\
  `tt_chain_token`、`secu_id`。

该 API 提供详细的 TikTok 发现 URL 相关帖子数据，方便访问热门内容、用户资料和帖子元数据，以便分析和探索。

## 评论 API

### 按 URL 采集

该 API 允许用户通过提供的 TikTok 帖子 URL 采集该帖子的详细评论数据。

**输入参数**：

<ParamField path="URL" type="string" required="true">
  TikTok 帖子 URL。
</ParamField>

**输出结构**：
包含全面的数据点：

* **帖子详情**：
  `post_url`，`post_id`，`post_date_created`。

  > 获取所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lkf2st302ap89utw5k?id=all\&tab=overview)。

* **评论详情**：
  `date_created`，`comment_text`，`num_likes`，`num_replies`，`comment_id`，`comment_url`。

* **评论者详情**：
  `commenter_user_name`，`commenter_id`，`commenter_url`。

该 API 提供 TikTok 帖子的详细评论数据，包括评论相关的指标以及评论者信息，以便进行有效的评论分析和互动跟踪。


# Twitter API Scrapers
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/social-media-apis/twitter



## 概览

Twitter API 套件提供多种类型的 API，每种 API 都针对 Twitter 数据收集的特定需求而设计。以下是这些 API 如何连接和交互的概览，基于可用功能：

<CardGroup cols={1}>
  <Card title="个人资料 API" icon="user" href="/cn/api-reference/web-scraper-api/social-media-apis/twitter#profiles-api">
    该 API 允许用户基于单一输入（个人资料 URL）收集个人资料详细信息。

    <br />

    *   **发现功能**：

    *   不适用

    <br />

    *   **重要字段**：

    *   `url`，`profile_name`，`is_verified`，`followers`。
  </Card>

  <Card title="帖子 API" icon="images" href="/cn/api-reference/web-scraper-api/social-media-apis/twitter#posts-api">
    该 API 允许用户基于单一输入 URL 收集多个帖子。

    <br />

    *   **发现功能**：

    *   通过个人资料 URL 发现。

    <br />

    *   **重要字段**：

    *   `name`，`description`，`replies`，`likes`。
  </Card>
</CardGroup>

## 个人资料 API

### 通过 URL 获取个人资料

该 API 允许用户使用提供的个人资料 URL 获取详细的 Twitter 个人资料信息。

**输入参数**：

<ParamField path="URL" type="string" required="true">
  Twitter 个人资料 URL。
</ParamField>

<ParamField path="max_number_of_posts" type="number">
  要收集的帖子数量。如果省略，则没有限制。
</ParamField>

**输出结构**：\
包含全面的数据点：

* **个人资料详情**：\
  `x_id`，`url`，`id`，`profile_name`，`biography`，`is_verified`，`profile_image_link`，`external_link`，`date_joined`，`location`，`birth_date`，`posts_count`，`posts`，`suggested_profiles`，`is_business_account`，`is_government_account`，`category_name`。

  > 获取所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lwxmeb2u1cniijd7t4?id=all\&tab=overview)。

* **互动指标**：\
  `followers`，`following`，`subscriptions`。

* **帖子详情**：\
  `posts`。

该 API 允许用户获取详细的 Twitter 个人资料信息，包括用户互动指标、帖子详情等，提供对用户活动和个人资料数据的深入洞察。

## 帖子 API

### 通过 URL 采集

该 API 允许用户使用提供的帖子 URL 获取特定 Twitter 帖子的详细信息。

**输入参数**：

<ParamField path="URL" type="string" required="true">
  Twitter 帖子 URL。
</ParamField>

<Note>API 限制：每个输入最多 1000 篇帖子。</Note>

**输出结构**：\
包含全面的数据点：

* **帖子详情**：\
  `id`，`user_posted`，`name`，`description`，`date_posted`，`url`，`tagged_users`，`replies`，`reposts`，`likes`，`views`，`external_url`，`hashtags`，`quotes`，`bookmarks`，`external_image_urls`，`videos`，`quoted_post`。

  > 获取所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lwxkxvnf1cynvib9co?id=all\&tab=overview)。

* **用户个人资料详情**：\
  `followers`，`biography`，`posts_count`，`profile_image_link`，`following`，`is_verified`。

* **父级帖子详情**：\
  `parent_post_details`。

该 API 允许用户获取特定 Twitter 帖子的详细信息，包括用户详情、互动指标和媒体内容，提供对帖子互动和用户活动的深入洞察。

### 通过个人资料 URL 发现帖子

该 API 允许用户在指定日期范围内发现并获取特定 Twitter 个人资料的帖子。

**输入参数**：

<ParamField path="URL" type="string" required="true">
  Twitter 个人资料 URL。
</ParamField>

<ParamField path="start_date" type="string">
  过滤帖子的起始日期，格式为 MM-DD-YYYY。
</ParamField>

<ParamField path="end_date" type="string">
  过滤帖子的结束日期，格式为 MM-DD-YYYY。
</ParamField>

**输出结构**：\
包含全面的数据点：

* **帖子详情**：\
  `id`，`user_posted`，`name`，`description`，`date_posted`，`url`，`tagged_users`，`replies`，`reposts`，`likes`，`views`，`external_url`，`hashtags`，`quotes`，`bookmarks`，`external_image_urls`，`videos`，`quoted_post`。

  > 获取所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lwxkxvnf1cynvib9co/profile_url?id=all\&tab=overview)。

* **用户个人资料详情**：\
  `followers`，`biography`，`posts_count`，`profile_image_link`，`following`，`is_verified`。

* **父级帖子详情**：\
  `parent_post_details`。

该 API 允许用户在指定时间范围内从特定 Twitter 个人资料中获取帖子，提供详细的帖子互动、用户数据和媒体内容的洞察。


# Vimeo API 抓取器
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/social-media-apis/vimeo



## 概览

Vimeo API 套件提供多种 API，每种 API 都专为从 Vimeo 采集特定数据而设计。以下是这些 API 之间的连接和交互概览，基于可用功能：

<CardGroup cols={1}>
  <Card title="Posts API" icon="images" href="/cn/api-reference/web-scraper-api/social-media-apis/vimeo#posts-api">
    此 API 允许用户基于单个输入 URL 采集多个帖子。

    <br />

    *   **发现功能**：

    *   通过个人资料 URL 发现。

    *   通过关键词和许可证发现。

    <br />

    *   **有趣的字段**：

    *   `title`，`video_length`，`views`，`likes`。
  </Card>
</CardGroup>

## Posts API

### 通过 URL 采集

此 API 允许用户使用提供的视频 URL 采集特定 Vimeo 视频的详细信息。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Vimeo 视频的 URL。
</ParamField>

**输出结构**：\
包含全面的数据点：

* **视频详情**\
  `video_id`，`title`，`url`，`video_url`，`video_length`，`description`，`data_posted`，`transcript`。

  > 查看所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lxk88z3v1ketji4pn?id=all\&tab=overview)。

* **互动与指标**\
  `views`，`likes`，`comments`，`collections`。

* **上传者详情**\
  `uploader`，`uploader_url`，`uploader_id`，`avatar_img_uploader`。

* **视频媒体与内容**\
  `preview_image`，`related_videos`，`music_track`。

* **许可证与质量**\
  `license`，`license_info`，`video_quality`。

* **视频尺寸**\
  `height`，`width`。

此 API 提供 Vimeo 视频的详细洞察，包括视频内容、上传者信息、媒体链接、互动指标等，支持高效的视频分析与内容追踪。

### 通过 URL 发现

此 API 允许用户基于特定 URL 和相关关键词发现 Vimeo 视频，并提供详细的视频信息与洞察。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Vimeo 帖子的 URL。
</ParamField>

<ParamField path="keyword" type="string" required="true">
  要在视频内容中搜索的关键词。
</ParamField>

<ParamField path="pages" type="number" required="true">
  要采集的结果页数。
</ParamField>

**输出结构**：\
包含全面的数据点：

* **视频详情**\
  `video_id`，`title`，`url`，`video_url`，`video_length`，`description`，`data_posted`，`transcript`。

  > 查看所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lxk88z3v1ketji4pn/url?id=all\&tab=overview)。

* **互动与指标**\
  `views`，`likes`，`comments`，`collections`。

* **上传者详情**\
  `uploader`，`uploader_url`，`uploader_id`，`avatar_img_uploader`。

* **视频媒体与内容**\
  `preview_image`，`related_videos`，`music_track`。

* **许可证与质量**\
  `license`，`license_info`，`video_quality`。

* **视频尺寸**\
  `height`，`width`。

此 API 允许用户通过 URL 和关键词发现 Vimeo 视频，并提供详细的视频内容、上传者信息和互动指标。

### 通过关键词和许可证发现

此 API 允许用户基于特定关键词和许可证类型发现 Vimeo 视频，并提供详细的视频信息与洞察。

**输入参数**

<ParamField path="keyword" type="string" required="true">
  要在视频内容中搜索的关键词。
</ParamField>

<ParamField path="license" type="string" required="true">
  用于筛选视频的许可证类型（例如：Creative Commons、标准许可证）。
</ParamField>

<ParamField path="pages" type="number" required="true">
  要采集的结果页数。
</ParamField>

**输出结构**：\
包含全面的数据点：

* **视频详情**\
  `video_id`，`title`，`url`，`video_url`，`video_length`，`description`，`data_posted`，`transcript`。

  > 查看所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lxk88z3v1ketji4pn/keyword_and_license?id=all\&tab=overview)。

* **互动与指标**\
  `views`，`likes`，`comments`，`collections`。

* **上传者详情**\
  `uploader`，`uploader_url`，`uploader_id`，`avatar_img_uploader`。

* **视频媒体与内容**\
  `preview_image`，`related_videos`，`music_track`。

* **许可证与质量**\
  `license`，`license_info`，`video_quality`。

* **视频尺寸**\
  `height`，`width`。

此 API 允许用户基于特定关键词和许可证类型发现 Vimeo 视频，并提供详细的视频内容、上传者信息和互动指标。


# YouTube API 爬取工具
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/social-media-apis/youtube



## 概述

YouTube API 套件提供多种 API，专为从 YouTube 采集特定数据而设计。以下是这些 API 的交互方式及可用功能概览：

<CardGroup cols={1}>
  <Card title="用户资料 API" icon="user" href="/cn/api-reference/web-scraper-api/social-media-apis/youtube#profiles-api">
    此 API 允许用户基于单一输入（个人资料 URL）收集用户资料详情。

    <br />

    *   **发现功能**：

    *   [通过关键词发现](/cn/api-reference/web-scraper-api/social-media-apis/youtube#discover-profiles-by-keywords)

    <br />

    *   **重要字段**：

    *   `name`、`url`、`videos_count`、`views`。
  </Card>

  <Card title="帖子 API" icon="images" href="/cn/api-reference/web-scraper-api/social-media-apis/youtube#posts-api">
    此 API 允许用户基于单一输入 URL 收集多个帖子。

    <br />

    *   **发现功能**：

    *   通过关键词发现。

    *   通过搜索过滤器发现。

    *   通过标签发现。

    *   通过频道 URL 发现。

    <br />

    *   **重要字段**：

    *   `url`、`title`、`likes`、`views`。
  </Card>

  <Card title="评论 API" icon="comments" href="/cn/api-reference/web-scraper-api/social-media-apis/youtube#comments-api">
    此 API 允许用户通过帖子 URL 收集多个评论。

    <br />

    *   **发现功能**：

    *   无

    <br />

    *   **重要字段**：

    *   `comment_text`、`replies`、`likes`、`username`。
  </Card>
</CardGroup>

## 用户资料 API

### 通过 URL 采集

此 API 允许用户使用提供的频道 URL 获取详细的 YouTube 频道信息。

**输入参数**：

<ParamField path="URL" type="string" required="true">
  YouTube 频道 URL。
</ParamField>

**输出结构**：\
包含丰富的数据点：

* **用户资料详情**：\
  `url`、`handle`、`name`、`description`、`created_date`、`identifier`、`id`、`handle_md5`。

* **互动指标**：\
  `subscribers`、`videos_count`、`views`。

  > 所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lk538t2k2p1k3oos71?id=all\&tab=overview)。

* **媒体资源**：\
  `profile_image`、`banner_img`。

  > 所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lk538t2k2p1k3oos71?id=all\&tab=overview)。

* **附加信息**：\
  `details`、`links`、`discovery_input`。

此 API 提供有关 YouTube 频道的详细信息，包括互动指标、用户资料图片及其他关键信息。

### 通过关键词发现

此 API 允许用户通过搜索与频道或其视频相关的特定关键词来发现 YouTube 频道。

**输入参数**：

<ParamField path="keyword" type="string" required="true">
  与频道或其视频相关的关键词。
</ParamField>

**输出结构**：\
包含丰富的数据点：

* **用户资料详情**：\
  `url`、`handle`、`name`、`description`、`created_date`、`identifier`、`id`、`handle_md5`。

  > 所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lk538t2k2p1k3oos71/keyword?id=all\&tab=overview)。

* **互动指标**：\
  `subscribers`、`videos_count`、`views`。

* **媒体资源**：\
  `profile_image`、`banner_img`。

* **附加信息**：\
  `details`、`links`、`discovery_input`。

此 API 通过关键词高效发现 YouTube 频道，提供用户资料信息、互动指标及相关详细信息。

## 帖子 API

### 通过 URL 收集

该 API 允许用户使用提供的视频 URL 从 YouTube 获取详细的视频信息。

**输入参数**：

<ParamField path="URL" type="string" required="true">
  YouTube 视频 URL。
</ParamField>

**输出结构**：\
包含丰富的数据点：

* **视频详情**：\
  `url`，`title`，`video_url`，`video_length`，`video_id`，`post_type`，`date_posted`，`description`，`music`，`transcript`，`formatted_transcript`。

  > 获取所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lk56epmy2i5g7lzu0k?id=all\&tab=overview)。

* **互动指标**：\
  `likes`，`views`，`num_comments`，`related_videos`。

* **频道详情**：\
  `youtuber`，`youtuber_id`，`handle_name`，`channel_url`，`subscribers`，`verified`，`avatar_img_channel`，`youtuber_md5`。

* **视频媒体与质量**：\
  `preview_image`，`viewport_frames`，`current_optimal_res`，`codecs`，`color`，`quality`，`quality_label`。

* **附加信息**：\
  `discovery_input`，`shortcode`，`is_sponsored`，`license`。

该 API 使用户能够获取 YouTube 视频的详细信息，包括元数据、互动指标和频道相关信息，支持内容分析与跟踪。

### 通过频道 URL 发现

该 API 允许用户通过 YouTube 频道的 URL 收集该频道发布的视频，并可使用可选过滤条件，如视频数量、日期范围和排序顺序。

**输入参数**：

<ParamField path="URL" type="string" required="true">
  YouTube 频道 URL。
</ParamField>

<ParamField path="num_of_posts" type="number">
  要收集的视频数量。如果省略，则无上限。
</ParamField>

<ParamField path="start_date" type="string">
  视频过滤起始日期（MM-DD-YYYY）。
</ParamField>

<ParamField path="end_date" type="string">
  视频过滤结束日期（MM-DD-YYYY）。
</ParamField>

<ParamField path="order_by" type="string">
  结果排序方式（例如按浏览量、日期或相关性排序）。
</ParamField>

**输出结构**：\
包含丰富的数据点：

* **视频详情**：\
  `url`，`title`，`video_url`，`video_id`，`video_length`，`date_posted`，`description`，`post_type`。

  > 获取所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lk56epmy2i5g7lzu0k/url?id=all\&tab=overview)。

* **频道详情**：\
  `youtuber`，`youtuber_id`，`channel_url`，`handle_name`，`avatar_img_channel`，`subscribers`，`youtuber_md5`，`verified`。

* **互动指标**：\
  `likes`，`views`，`num_comments`，`is_sponsored`。

* **媒体与技术信息**：\
  `preview_image`，`related_videos`，`music`，`shortcode`，`viewport_frames`，`current_optimal_res`，`codecs`，`color`，`quality`，`quality_label`，`license`。

* **字幕**：\
  `transcript`，`formatted_transcript`。

该 API 允许用户高效获取 YouTube 频道中的视频，提供详细的视频、频道和互动信息，并支持过滤和排序选项以增强分析能力。

### 通过关键词发现

该 API 允许用户使用特定关键词搜索 YouTube 视频，并可通过可选参数按日期范围和视频数量进行筛选。

**输入参数**：

<ParamField path="keyword" type="string" required="true">
  搜索视频的关键词。
</ParamField>

<ParamField path="num_of_posts" type="number">
  要收集的视频数量。
</ParamField>

<ParamField path="start_date" type="string">
  视频过滤起始日期（MM-DD-YYYY）。
</ParamField>

<ParamField path="end_date" type="string">
  视频过滤结束日期（MM-DD-YYYY）。
</ParamField>

**输出结构**：\
包含丰富的数据点：

* **视频详情**：\
  `url`，`title`，`video_url`，`video_id`，`video_length`，`date_posted`，`description`，`post_type`。

  > 获取所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lk56epmy2i5g7lzu0k/keyword?id=all\&tab=overview)。

* **频道详情**：\
  `youtuber`，`youtuber_id`，`channel_url`，`handle_name`，`avatar_img_channel`，`subscribers`，`youtuber_md5`，`verified`。

* **互动指标**：\
  `likes`，`views`，`num_comments`，`is_sponsored`。

* **媒体与技术信息**：\
  `preview_image`，`related_videos`，`music`，`shortcode`，`viewport_frames`，`current_optimal_res`，`codecs`，`color`，`quality`，`quality_label`，`license`。

* **字幕**：\
  `transcript`，`formatted_transcript`。

该 API 使用户能够通过关键词高效发现 YouTube 视频，并支持高级筛选功能，以实现精准的视频分析与检索。

### 通过搜索过滤条件发现

该 API 允许用户使用高级搜索过滤条件搜索 YouTube 视频，如上传日期、视频类型、时长和其他特性，以实现更精准和有针对性的视频发现。

**输入参数**：

<ParamField path="keyword_search" type="string" required="true">
  搜索视频的关键词。
</ParamField>

<ParamField path="upload_date" type="string">
  按上传日期筛选结果（例如：今天、本周、本月）。
</ParamField>

<ParamField path="type" type="string">
  指定视频类型（例如：视频、频道、播放列表）。
</ParamField>

<ParamField path="duration" type="string">
  按视频时长筛选（例如：短、中、长）。
</ParamField>

<ParamField path="features" type="string">
  指定视频附加特性（例如：4K、HD、字幕、直播）。
</ParamField>

**输出结构**：\
包含丰富的数据点：

* **视频详情**：\
  `url`，`title`，`video_url`，`video_id`，`video_length`，`date_posted`，`description`，`post_type`。

  > 获取所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lk56epmy2i5g7lzu0k/search_filters?id=all\&tab=overview)。

* **频道详情**：\
  `youtuber`，`youtuber_id`，`channel_url`，`handle_name`，`avatar_img_channel`，`subscribers`，`youtuber_md5`，`verified`。

* **互动指标**：\
  `likes`，`views`，`num_comments`，`is_sponsored`。

* **媒体与技术信息**：\
  `preview_image`，`related_videos`，`music`，`shortcode`，`viewport_frames`，`current_optimal_res`，`codecs`，`color`，`quality`，`quality_label`，`license`。

* **字幕**：\
  `transcript`，`formatted_transcript`。

该 API 提供 YouTube 高级搜索功能，允许用户通过多个参数筛选结果，实现精准和高效的视频发现。

### 通过标签发现

此 API 允许用户通过特定的标签搜索 YouTube 帖子，使用户能够发现与热门话题或特定主题相关的视频。

**输入参数：**

<ParamField path="hashtag" type="string" required="true">
  要搜索的标签 (例如：#fitness, #travel)。
</ParamField>

<ParamField path="num_of_posts" type="number">
  要收集的帖子数量。如果省略，则没有限制。
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  需要从结果中排除的帖子 ID 数组。
</ParamField>

<ParamField path="start_date" type="string">
  以 MM-DD-YYYY 格式指定筛选帖子的起始日期 (应早于 end\_date)。
</ParamField>

<ParamField path="end_date" type="string">
  以 MM-DD-YYYY 格式指定筛选帖子的结束日期 (应晚于 start\_date)。
</ParamField>

**输出结构：**\
包含全面的数据点：

* **视频详情：**\
  `url`, `title`, `video_url`, `video_id`, `video_length`, `date_posted`, `description`, `post_type`。

  > 获取所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lk56epmy2i5g7lzu0k/hashtag?id=all\&tab=overview)。

* **频道详情：**\
  `youtuber`, `youtuber_id`, `channel_url`, `handle_name`, `avatar_img_channel`, `subscribers`, `youtuber_md5`, `verified`。

* **互动指标：**\
  `likes`, `views`, `num_comments`, `is_sponsored`。

* **媒体和技术信息：**\
  `preview_image`, `related_videos`, `music`, `shortcode`, `viewport_frames`, `current_optimal_res`, `codecs`, `color`, `quality`, `quality_label`, `license`。

* **字幕信息：**\
  `transcript`, `formatted_transcript`。

此 API 通过搜索与特定标签相关的帖子，实现高效的视频发现，并提供筛选选项以优化搜索结果。

## 评论 API

### 通过 URL 收集

此 API 允许用户使用提供的视频 URL 检索特定 YouTube 视频的详细评论数据。

**输入参数：**

<ParamField path="URL" type="string" required="true">
  YouTube 视频的 URL。
</ParamField>

<ParamField path="load_replies" type="number">
  加载评论回复的次数。
</ParamField>

**输出结构：**\
包含全面的数据点：

* **评论详情：**\
  `comment_id`, `comment_text`, `likes`, `replies`, `replies_value`, `replies_without_names`。

  > 获取所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lk9q0ew71spt1mxywf?id=all\&tab=overview)。

* **用户详情：**\
  `username`, `user_channel`, `username_md5`。

* **附加信息：**\
  `date`, `url`, `video_id`。

此 API 使用户能够分析 YouTube 视频的评论，包括回复和用户详细信息，从而提供有关互动和受众参与度的洞察。


# 触发数据收集 API
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-api/trigger-a-collection

dca-api POST /datasets/v3/trigger
了解如何使用 Web Scraper API 触发数据收集，提供发现和 PDP 抓取器的选项。自定义请求，设置交付选项，并高效地检索数据。

## 正文

要供抓取器使用的输入。可以作为 JSON 或 CSV 文件提供：

<ParamField body="Content-Type" type="string">
  **`Content-Type: application/json`**

  输入的 JSON 数组

  > **示例**: `[{"url":"https://www.airbnb.com/rooms/50122531"}]`

  ***

  **`Content-Type: multipart/form-data`**

  一个 CSV 文件，字段名为 `data`

  > **示例** (curl): `data=@path/to/your/file.csv`
</ParamField>

## Web Scraper 类型

每种抓取器可能需要不同的输入。主要有两种类型的抓取器：

### 1. PDP

这些抓取器需要 URL 作为输入。PDP 抓取器从网页中提取详细的产品信息，如规格、定价和功能。

### 2. Discovery

Discovery 抓取器允许您通过搜索、类别、关键词等来探索和发现新实体/产品。

<Frame>
    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/ae.com.png?maxW=722&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=842745f86d0b1bf8f21c01a9173a4a26" alt="ae.com.png" width="722" height="162" data-path="images/scraping-automation/web-scraper-api/ae.com.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/ae.com.png?w=280&maxW=722&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d14ca4c537585865a367d34474b1747e 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/ae.com.png?w=560&maxW=722&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d4cf12ec3623d94c569f8d0369586b42 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/ae.com.png?w=840&maxW=722&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=eef53d2f33349c62801b7031078502c4 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/ae.com.png?w=1100&maxW=722&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=db7cbee95210992a4c4f3c354e13d015 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/ae.com.png?w=1650&maxW=722&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=261367510e2c8cfef829f17280d2c309 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/ae.com.png?w=2500&maxW=722&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=971845973232a822484cf486c3844795 2500w" data-optimize="true" data-opv="2" />
</Frame>

## 请求示例

### `PDP` 以 URL 输入

`PDP` 的输入格式始终是 URL，指向要抓取的页面。

```sh Sample Request
curl -H "Authorization: Bearer API_KEY" -H "Content-Type: application/json" -d '[{"url":"https://www.airbnb.com/rooms/50122531"},{"url":"https://www.airbnb.com/rooms/50127677"}]' "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_ld7ll037kqy322v05&format=json&uncompressed_webhook=true"
```

### 基于 `discovery` 方法的 Discovery 输入

```sh Sample Request
curl -H "Authorization: Bearer x2x3fdaaddrer" -H "Content-Type: application/json" -d '[{"keyword":"light bulb"},{"keyword":"dog toys"},{"keyword":"home decor"}]' "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l7q7dkf244hwjntr0&endpoint=https://webhook-url.com&auth_header=QWxhZGRpbjpPcGVuU2VzYW1l&notify=https://notify-me.com/&format=ndjson&uncompressed_webhook=true&type=discover_new&discover_by=keyword&limit_per_input=10"
```

`discovery` 的输入格式可以根据特定的抓取器有所不同。输入可以是：

<CodeGroup>
  ```JSON keywords
  [{"keyword": "light bulb"},{"keyword": "dog toys"},{"keyword": "home decor"}]
  ```

  ```JSON 搜索设置
  [{"url": "https://www.amazon.com/s?i=luggage-intl-ship", "sort_by": "Best Sellers"}]
  ```

  ```JSON 位置
  [{"location": "Europe"},{"location": "Greece"},{"location": "United States"}]
  ```
</CodeGroup>

以及更多。了解每个抓取器需要的输入，请参见 [这里](https://brightdata.com/cp/data_api).


# 根据请求级别选择交付类型
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-ide-api/Choose_a_delivery_type_on_request_level



您可以使用 API 为每个任务选择交付类型，而不是为每种交付类型创建重复的抓取工具。

<Frame>
    <img src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/hero-image.png?maxW=1308&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=c0b2fe035d6e7e5a7c588f6e90762340" alt="hero-image.png" width="1308" height="371" data-path="images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/hero-image.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/hero-image.png?w=280&maxW=1308&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=2e2b92998f618f879fac1211b882054f 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/hero-image.png?w=560&maxW=1308&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=f2a56e49fc9f13a26e3234e61fd5ed88 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/hero-image.png?w=840&maxW=1308&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=04df0e8b5584c3226142c059ff7bcb8b 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/hero-image.png?w=1100&maxW=1308&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=931d0c0c9ec256c46840799ee24e96a3 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/hero-image.png?w=1650&maxW=1308&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=53a11be50bffe6b9a251f3a2842eb67e 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/hero-image.png?w=2500&maxW=1308&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=0cecafda621ce9b46421f842d582ab43 2500w" data-optimize="true" data-opv="2" />
</Frame>

<Steps>
  <Step title="更新您的抓取工具">
    确保将您的抓取工具更新到最新版本以提高成功率

    <Frame>
            <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/update-available.png?maxW=1624&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=df87a15795545a363756958702990976" alt="update-available.png" width="1624" height="354" data-path="images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/update-available.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/update-available.png?w=280&maxW=1624&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b99489472e3b7faddd90161e0e3c3d00 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/update-available.png?w=560&maxW=1624&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=12026b857faa4fd04a8aa2c1d99c7238 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/update-available.png?w=840&maxW=1624&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=1dbfe7136f77d85694c1798798986316 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/update-available.png?w=1100&maxW=1624&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=cb34a39f5c79e5908904768381d6ba9b 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/update-available.png?w=1650&maxW=1624&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=14b6173f2572d87100cf04a1f5f1b7f9 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/update-available.png?w=2500&maxW=1624&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=1cd6714dacd0ae694733cbf6f76d7222 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="将交付类型设置为批处理">
    <Frame>
            <img src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/type-batch.png?maxW=1613&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=dd60e9b95d5573d7fe7a4409a4de1037" alt="type-batch.png" width="1613" height="353" data-path="images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/type-batch.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/type-batch.png?w=280&maxW=1613&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=457f6876d775594573995268a43661dc 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/type-batch.png?w=560&maxW=1613&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=873563b42435812f3a5e28f1d279fbc8 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/type-batch.png?w=840&maxW=1613&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=9dbfcd03ac80990bde022c7f47117dfc 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/type-batch.png?w=1100&maxW=1613&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=c55d8f1744ecab09d1cd7cf2522664bd 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/type-batch.png?w=1650&maxW=1613&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=c4d3954a5ee1aced17a67fa30080d7de 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/type-batch.png?w=2500&maxW=1613&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=649b5026abcf6398d1aaa20fad97d757 2500w" data-optimize="true" data-opv="2" />
            <img src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/on-completion.png?maxW=940&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=346027bcef3fdde227ba05b2c037559b" alt="on-completion.png" width="940" height="287" data-path="images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/on-completion.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/on-completion.png?w=280&maxW=940&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=9d48446843be9e86d4547238689f0114 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/on-completion.png?w=560&maxW=940&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=e225695298275c22580c6afd6b136221 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/on-completion.png?w=840&maxW=940&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=3e95408899b10f543eb6126f4c1f2b74 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/on-completion.png?w=1100&maxW=940&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=4e5dd538f482b201c6d975d589b10129 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/on-completion.png?w=1650&maxW=940&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=9af5a9e4fa834daefefa6df6850345e8 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/web-scraper-ide/Choose_a_delivery_type_on_request_level/on-completion.png?w=2500&maxW=940&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=e420aaca6e545917f8dbafb2ecbfc894 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    当交付类型设置为实时时，批处理 API 将返回以下错误消息。

    ```json 错误
    "error": "Cannot trigger a batch job with a real-time scraper. Use /trigger_immediate endpoint instead"
    ```
  </Step>

  <Step title="使用首选 API 触发抓取工具">
    <Tabs>
      <Tab title="启动批处理任务">
        `dca/trigger`

        [触发抓取工具，获取批量采集方法](/cn/api-reference/web-scraper-ide-api/Trigger_a_scraper_for_batch_collection_method)

        <CodeGroup>
          ```sh Shell
          curl "https://api.brightdata.com/dca/trigger?collector=ID_COLLECTOR&queue_next=1" -H "Content-Type: application/json" -H "Authorization: Bearer API_KEY" -d '[{"url":"https://targetwebsite.com/product_id/"}]'
          ```

          ```json Sample Response
          {
              "collection_id":"j_l3daejgw1wnpjxxxxx",
              "start_eta":"2022-05-19T17:28:48.056Z"
          }
          ```
        </CodeGroup>
      </Tab>

      <Tab title="启动实时任务">
        `dca/trigger_immediate`

        [Trigger a scraper for real-time collection](/cn/api-reference/web-scraper-ide-api/Receive_data_from_real_time_work_scraper)

        <CodeGroup>
          ```sh Shell
          curl "https://api.brightdata.com/dca/trigger_immediate?collector=ID_COLLECTOR" -H "Content-Type: application/json" -H "Authorization: Bearer API_KEY" -d '{"url":"https://targetwebsite.com/product_id/"}'
          ```

          ```json Sample Response
          {
              "response_id":"z2805t1652973963340rg6252xxxxxx"
          }
          ```
        </CodeGroup>
      </Tab>
    </Tabs>

    <Note>
      批量响应以 `j_****` 开头，实时响应以 `z****` 开头
    </Note>
  </Step>

  <Step title="接收数据">
    * [接收批量数据](/cn/api-reference/web-scraper-ide-api/Receive_batch_data)
    * [由实时工作抓取工具接收数据](/cn/api-reference/web-scraper-ide-api/Receive_data_from_real_time_work_scraper)
  </Step>
</Steps>


# 开始使用 API
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-ide-api/Getting_started_wtih_the_API



1. 注册（或登录）我们的控制面板
2. 插入目标 URL（作为收集数据来源的网站）或选择现成的模板
3. 设置抓取工具的交付偏好：批处理或实时
4. 由 API 启动

<Tip>
  不是开发人员？ 联系我们的支持人员，轻松上手。
</Tip>

数据抓取工具分为两个抓取系统：

<Tabs>
  <Tab title="批处理">
    这是处理大量数据的有效方法。 数据在一段时间内批量收集。 收集、输入和处理数据后，将生成批处理结果。 您可以一次性交付所有结果，也可以在收集结果时将其流式传输到您的系统。
  </Tab>

  <Tab title="实时">
    This is an ideal way to get a fast response for one request. This is useful in environments where you have a limited amount of time to crawl a page and get the data.
  </Tab>
</Tabs>

数据抓取工具 API 有四个一般工作流程：

1. [批量触发器 + 推送交付](/cn/api-reference/web-scraper-ide-api/Trigger_a_scraper_for_batch_collection_method)
2. [批量触发器 + API 轮询](/cn/api-reference/web-scraper-ide-api/Receive_batch_data)
3. [实时触发器 + 推送交付](/cn/api-reference/web-scraper-ide-api/Trigger_a_scraper_for_real_time_collection)
4. [实时触发器 + API 轮询](/cn/api-reference/web-scraper-ide-api/Receive_data_from_real_time_work_scraper)


# 接收批量数据
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-ide-api/Receive_batch_data



**API 端点:** `GET` `/dca/dataset?id={id_dataset}`

<ParamField query="ID" type="字符串" 必填项>
  数据集的唯一标识
</ParamField>

<ParamField header="Authorization" type="字符串" 必填项>
  身份验证 Bearer Key `-H "Authorization: Bearer API_KEY"`
</ParamField>

<ResponseExample>
  ```json Waiting for Dataset
  {
   "status": "building",
   "message": "Dataset is not ready yet, try again in XXs"
  }
  ```

  ```json Dataset (Ready)
  [
   {
   "Image": "https://target网站.com/product_ID.png",
   "Title": "product_name",
   "Price": "product_price",
   "input": {
   "url": "https://targetwebsite.com/product_id/"
   }
   }
  ]
  ```
</ResponseExample>

<RequestExample>
  **Shell**

  ```sh Shell
  curl "https://api.brightdata.com/dca/dataset?id=ID_DATASET" -H "Content-Type: application/json" -H "Authorization: <Bearer API_KEY>"
  ```

  ```js NodeJS
  #!/usr/bin/env node
  require('request-promise')({
   url: 'https://api.brightdata.com/dca/dataset?id=ID_DATASET',
   headers: {'Content-Type': 'application/json','Authorization':'Bearer API_KEY'},
  }).then(function(data){ console.log(data); },
   function(err){ console.error(err); });
  ```

  ```java Java
  package example;  
    
  import org.apache.http.entity.ContentType;  
  import org.apache.http.HttpHost;  
  import org.apache.http.client.fluent.*;  
    
  public class Main {  
      public static void main(String[] args) {  
          String body = "[{\"url\":\"https://targetwebsite.com/product_id/\"}]";  
          String res = Executor.newInstance()  
              .execute(  
                      Request.Post("https://api.brightdata.com/dca/trigger?collector=COLLECTOR_ID&queue_next=1")  
                      .addHeader("Authorization", "Bearer API_KEY")  
                      .addHeader("Content-Type", "application/json")  
                      .bodyString(body, ContentType.APPLICATION_JSON))  
              .returnContent().asString();  
          System.out.println(res);  
      }  
  }
  ```

  ```cs C#
  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/dca/dataset?id=ID_DATASET"),
   Headers = {  
   {"Content-Type", "application/json"},
   {"Authorization", "Bearer API_KEY"}
   }
   };
   var response = await client.SendAsync(requestMessage);
   var responseString = await response.Content.ReadAsStringAsync();
   Console.WriteLine(responseString);
   }
  }
  ```

  ```python Python
  #!/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 = {'Content-Type': 'application/json','Authorization': 'Bearer API_KEY'}
  r = requests.get('https://api.brightdata.com/dca/dataset?id=ID_DATASET', headers=headers)
  print(r.content)
  ```
</RequestExample>


# 从实时运行抓取器接收数据
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-ide-api/Receive_data_from_real_time_work_scraper



**API 端点:** `GET` `/dca/get_result?response_id={ID_RESPONSE}`

<ParamField query="response_id" type="字符串" 必填项>
  响应的唯一标识
</ParamField>

<ParamField header="Authorization" type="字符串" 必填项>
  身份验证 Bearer Key `-H "Authorization: Bearer API_KEY"`
</ParamField>

<ResponseExample>
  ```json Sample (old scrapers)
  {
      "input": {
          "url": "https://targetwebsite.com/product_id/"
      },
      "line_1": "Lorem ipsum dolor sit amet",  
      "line_2": "consectetur adipisicing elit"
  }
  ```

  ```json Sample (new scrapers)
  [  
   "line_1": "Lorem ipsum dolor sit amet",  
   "line_2": "consectetur adipisicing elit"  
  ]
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "https://api.brightdata.com/dca/get_result?response_id=ID_RESPONSE" -H "Authorization: Bearer API_KEY"
  ```

  ```js NodeJS
  #!/usr/bin/env node
  require('request-promise')({
   url: 'https://api.brightdata.com/dca/get_result?response_id=ID_RESPONSE',
   headers: {'Authorization':'Bearer API_KEY'},
  }).then(function(data){ console.log(data); },
   function(err){ console.error(err); });
  ```

  ```java Java
  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/dca/get_result?response_id=ID_RESPONSE"))  
   .returnContent().asString();  
   System.out.println(res)
   }  
  }
  ```

  ```cs C#
  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/dca/get_result?response_id=ID_RESPONSE"),
   Headers = {
   {"Authorization", "Bearer API_KEY"}
   }
   };
   var response = await client.SendAsync(requestMessage);
   var responseString = await response.Content.ReadAsStringAsync();
   Console.WriteLine(responseString);
   }
  }
  ```

  ```python Python
  #!/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/dca/get_result?response_id=ID_RESPONSE', headers=headers)
  print(r.content)
  ```
</RequestExample>


# 触发抓取工具，进行批量采集
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-ide-api/Trigger_a_scraper_for_batch_collection_method



**API 端点:** `POST` `/dca/trigger?collector={ID_COLLECTOR}`

## `POST` Body

<ParamField body="Authorization" type="字符串" 必填项>
  raw JSON `-d '[{"url":"https://targetwebsite.com/product_id/"}]'`
</ParamField>

## 查询参数

<ParamField query="collector" type="字符串" 必填项>
  抓取工具的唯一标识
</ParamField>

<ParamField query="version" type="字符串">
  设置为 `dev` 以触发抓取工具的开发版本
</ParamField>

<ParamField query="name" type="字符串">
  `human_name` - 批量采集的数据名称，须易于识别和理解
</ParamField>

### 选择 `trigger_behavior` 参数：

<ParamField query="queue_next" type="整数" default="1">
  {  /* TODO: Need more info on this? Does 1 means True and 0 means False? */}

  如果抓取队列中已有任务，则将该作业推送至队列中
</ParamField>

<ParamField query="queue" type="字符串">
  发送另一批请求，这些请求将在上一批请求完成后开始处理
</ParamField>

<ParamField query="confirm_cancel" type="整数" default="1">
  {  /* TODO: Need more info on this? Does 1 means True and 0 means False? */}

  取消正在运行的作业，然后提交并运行新的请求
</ParamField>

<ParamField query="no_downloads" type="整数" default="1">
  {  /* TODO: Need more info on this? Does 1 means True and 0 means False? */}

  禁止下载媒体文件
</ParamField>

<ParamField query="deadline" type="字符串" placeholder="1h">
  设置作业截止时间，作业将在指定时间后终止

  * h：小时
  * m：分钟
  * s：秒
</ParamField>

## 标头

<ParamField header="Authorization" type="字符串" 必填项>
  授权持有者密钥 `-H "Authorization: Bearer API_KEY"`
</ParamField>

<ParamField header="Content-Type" type="字符串" 必填项>
  JSON/CSV/Multipart `-H "Content-Type: application/json"`
</ParamField>

<ResponseExample>
  ```json Sample Response
  {
   "collection_id": "ID_DATASET",
   "start_eta": "2021-11-07T13:26:22.702Z"
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "https://api.brightdata.com/dca/trigger?collector=ID_COLLECTOR&queue_next=1" -H "Content-Type: application/json" -H "Authorization: Bearer API_KEY" -d '[{"url":"https://targetwebsite.com/product_id/"}]'
  ```

  ```js NodeJS
  #!/usr/bin/env node
  require('request-promise')({
   method: 'POST',
   url: 'https://api.brightdata.com/dca/trigger?collector=ID_COLLECTOR&queue_next=1',
   json: [{'url': 'https://targetwebsite.com/product_id/'}],
   headers: {'Authorization': 'Bearer API_KEY'},
  }).then(function(data){ console.log(data); },
   function(err){ console.error(err); });
  ```

  ```java Java
  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 = "[{\"url\":\"https://targetwebsite.com/product_id/\"}]";
   String res = Executor.newInstance()
   .addHeader("Authorization", "Bearer API_KEY")  
   .execute(Request.Post("https://api.brightdata.com/dca/trigger?collector=ID_COLLECTOR&queue_next=1"))  
   .bodyString(body, ContentType.APPLICATION_JSON))  
   .returnContent().asString();  
   System.out.println(res)
   }  
  }
  ```

  ```cs C#
  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("https://api.brightdata.com/dca/trigger?collector=ID_COLLECTOR&queue_next=1"),
   Headers = {
   {"Authorization", "Bearer API_KEY"}
   },  
   Content = new StringContent(JsonConvert.SerializeObject([  
   new {  
   url = "https://targetwebsite.com/product_id/"  
   }  
   ]), Encoding.UTF8, "application/json"))
   };
   var response = await client.SendAsync(requestMessage);
   var responseString = await response.Content.ReadAsStringAsync();
   Console.WriteLine(responseString);
   }
  }
  ```

  ```python Python
  #!/usr/bin/env python
  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');
  import requests
    
  data = [{'url': 'https://targetwebsite.com/product_id/'}]
  headers = {'Content-Type': 'application/json','Authorization': 'Bearer API_KEY'}
  r = requests.post('https://api.brightdata.com/dca/trigger?collector=ID_COLLECTOR&queue_next=1', data=data, headers=headers)
  print(r.content)
  ```
</RequestExample>


# 触发抓取工具，进行实时采集
Source: https://docs.brightdata.com/cn/api-reference/web-scraper-ide-api/Trigger_a_scraper_for_real_time_collection



**API 端点:** `POST` `/dca/trigger_immediate?collector={ID_COLLECTOR}`

## `POST` Body

<ParamField body="Authorization" type="字符串" 必填项>
  raw JSON `-d '[{"url":"https://targetwebsite.com/product_id/"}]'`
</ParamField>

## 查询参数

<ParamField query="collector" type="字符串" 必填项>
  抓取工具的唯一标识
</ParamField>

<ParamField query="version" type="字符串">
  设置为 `dev` 以触发抓取工具的开发版本
</ParamField>

<ParamField query="name" type="字符串">
  `human_name` - 实时采集的数据名称，须易于识别和理解
</ParamField>

## 标头

<ParamField header="Authorization" type="字符串" 必填项>
  授权持有者密钥 `-H "Authorization: Bearer API_KEY"`
</ParamField>

<ParamField header="Content-Type" type="字符串" 必填项>
  JSON/CSV/Multipart `-H "Content-Type: application/json"`
</ParamField>

<ResponseExample>
  ```json Sample Response
  {
   "response_id": "ID_RESPONSE",
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell
  curl "https://api.brightdata.com/dca/trigger_immediate?collector=ID_COLLECTOR" -H "Content-Type: application/json" -H "Authorization: Bearer API_KEY" -d "{\"url\":\"https://targetwebsite.com/product_id/\"}"
  ```

  ```js NodeJS
  #!/usr/bin/env node
  require('request-promise')({
   method: 'POST',
   url: 'https://api.brightdata.com/dca/trigger_immediate?collector=ID_COLLECTOR',
   json: {'url': 'https://targetwebsite.com/product_id/'},
   headers: {'Authorization': 'Bearer API_KEY'},
  }).then(function(data){ console.log(data); },
   function(err){ console.error(err); });
  ```

  ```java Java
  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 = "{\"url\":\"https://targetwebsite.com/product_id/\"}";
   String res = Executor.newInstance()
   .addHeader("Authorization", "Bearer API_KEY")  
   .execute(Request.Post("https://api.brightdata.com/dca/trigger_immediate?collector=ID_COLLECTOR"))  
   .bodyString(body, ContentType.APPLICATION_JSON))  
   .returnContent().asString();  
   System.out.println(res)
   }  
  }
  ```

  ```cs C#
  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("https://api.brightdata.com/dca/trigger_immediate?collector=ID_COLLECTOR"),
   Headers = {
   {"Authorization", "Bearer API_KEY"}
   },  
   Content = new StringContent(JsonConvert.SerializeObject( new {  
   url = "https://targetwebsite.com/product_id/"  
   }), Encoding.UTF8, "application/json"))
   };
   var response = await client.SendAsync(requestMessage);
   var responseString = await response.Content.ReadAsStringAsync();
   Console.WriteLine(responseString);
   }
  }
  ```

  ```python Python
  #!/usr/bin/env python
  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');
  import requests
    
  data = {'url': 'https://targetwebsite.com/product_id/'}
  headers = {'Content-Type': 'application/json','Authorization': 'Bearer API_KEY'}
  r = requests.post('https://api.brightdata.com/dca/trigger_immediate?collector=ID_COLLECTOR', data=data, headers=headers)
  print(r.content)
  ```
</RequestExample>


# 抓取任何网站
Source: https://docs.brightdata.com/cn/datasets/custom-datasets/Scrape-any-web



**解锁自定义数据集的强大功能，以抓取任何您想要的数据网站**

在从网站抓取数据时，没有一种通用的方法可以适用。网络上的每个域或URL都有其独特的结构、挑战和要求。无论您是想从电子商务网站、房地产门户、招聘网站、社交媒体平台或其他任何领域提取数据，Bright Data 的 **Custom Dataset（自定义数据集）** 产品都是解决方案。这就是为什么它是您所有网页抓取需求的终极工具。

**什么是 Custom Dataset（自定义数据集）？**

Custom Dataset 是一种先进且用户友好的解决方案，旨在帮助您从任何网站精确提取所需的数据，无论您的需求有多复杂或具体。使用此产品，您无需担心构建自己的抓取基础设施、处理技术难题或应对网站不断变化的结构。

很简单：您提供要抓取的域或URL，分享所需的数据点或格式，Bright Data 负责完成其余的工作。换句话说，Custom Dataset 是您的全方位、按需提供的抓取解决方案，专为您的需求量身定制。

**为什么要为任何域或URL使用 Custom Dataset？**

**根据您的需求量身定制**

不同的网站有不同的结构、布局和规则。Custom Dataset 专为适应任何网站或域名而设计。无论您是在寻找产品价格、竞争分析、市场趋势、潜在客户还是客户评价，Custom Dataset 都能个性化满足您的确切要求。

**适用于任何网站**

无论网站所属的行业或复杂性如何，Custom Dataset 都可以应用于从几乎任何在线域中抓取信息。它非常适合从动态内容、带有 CAPTCHA 保护或其他反爬机制的网站中提取数据。

**无需技术专业知识**

忘记花费数小时编写抓取程序或处理复杂的网页结构吧。Bright Data 的专家团队会处理所有技术难题，让您专注于利用数据推动业务增长。

**可扩展且高效**

Custom Dataset 为扩展性而构建。无论您是需要用于一次性项目的小数据集，还是需要定期进行的大规模数据提取，这一解决方案都能轻松应对。

**可靠且准确的数据**

在数据准确性至关重要时，Bright Data 总能交付。Custom Dataset 确保您获得干净、结构化、可信赖的数据，并以您需要的格式（如 JSON、CSV、Excel 等）整齐打包。

**它是如何工作的？**

**提交您的请求**

访问 Bright Data 的网站，分享您要抓取的域或URL。描述您的具体要求，例如特定的数据字段或您希望的数据交付格式。

**我们构建并执行抓取程序**

我们的专家团队将构建一个自定义管道并抓取请求的数据。您无需担心代理、浏览器自动化或错误处理的复杂性——我们为您处理所有细节。

**接收您的数据**

以您喜欢的格式获取高质量、即用型数据。利用这些数据做出明智决策、优化运营或获得竞争优势。

**为什么选择 Custom Dataset？**

当您寻找从特定域或URL抓取数据的解决方案时，Custom Dataset 是您可以信赖的产品。相比费力使用通用的抓取工具或编写自定义代码（这些方法可能并不适合所有网站），Bright Data 的 Custom Dataset 提供了一种精简且可靠的选择，确保您快速、无忧地获取所需数据。

无论您是企业、研究人员、初创公司还是开发者，Custom Dataset 都是您从任何URL随时访问任何数据的快捷通道。因此，下次您需要抓取网页时，请将 Custom Dataset 作为您的首选解决方案。

立即探索 Bright Data 的 Custom Dataset 产品，让您的数据驱动项目焕发生机！


# 自定义数据集 API
Source: https://docs.brightdata.com/cn/datasets/custom-datasets/custom-dataset-api



此更新可使您以更精确、更简化的方式请求和管理您的数据采集，从而根据您的特定需求更有效地生成数据集。

了解何时使用每个 API:

## 没有客户定义视图的初始采集:

3 个主要 API 端点在数据采集工作流程中具有不同的用途，可促进高效获取定制数据集的结构化流程。

### 请求采集:

端点: `POST` [https://api.brightdata.com/datasets/request\_collection](https://api.brightdata.com/datasets/request_collection)

**参数:**

<ParamField query="dataset_id" type="string" required>
  数据集 ID
</ParamField>

<ParamField query="type" type="string" required>
  `discover_new` 或 `url_collection`
</ParamField>

<ParamField body="inputs" type="array">
  Array - json
</ParamField>

<ParamField body="file" type="multipart">
  multipart - csv
</ParamField>

```sh 示例
curl "https://api.brightdata.com/datasets/request_collection?dataset_id=gd_l1viktl72bvl7bjuj0&type=discover_new" -H "Authorization: Bearer API_KEY" -H "Content-Type: application/json" -k -d '[{"id":"user-id"}]'
```

处理可能需要几分钟时间，具体取决于输入的数量。 当您请求查找（`discover_new`）时，找到所有链接 (PDP) 可能需要一些时间。

***

### 查看以上采集的状态:

端点:  `GET` [https://api.brightdata.com/datasets/request\_collection](https://api.brightdata.com/datasets/request_collection)

**参数:**

<ParamField query="request_id" type="string" required>
  从先前的 API 获取。
</ParamField>

<ParamField query="freshness_ms" type="string" required>
  设置数据新鲜度。

  如果数据在此期限内（例如，请求在 1 周之前采集，5 天前采集），则会发生 0 次新的抓取。

  * 1 周: 604,800,000 毫秒
  * 1 个月: 2,592,000,000 毫秒
</ParamField>

```sh 示例
curl -k "https://api.brightdata.com/datasets/request_collection?request_id=REQUEST_ID&freshness_ms=2592000000" -H "Authorization: Bearer API_KEY" 
```

说明发现的记录数量和新鲜度的响应:

```json
{
    "dataset_id": request_job.dataset_id,
    "total_lines": 100,
    "fresh_count": 30,
    "name": "linkedin_companies custom input",
    "status": "done",
    "request_id": "XXXX",
}
```

请求仍在运行:

```json
{
    "total_lines": 100,
    "status": "running",
}
```

一个（或多个）输入有问题: 在这种情况下，此 url 以 URL 形式发送

```json
{
    "request_id": "xxxx",  
    "error": "Validation failed",
    "error_code": "validation",
    "validation_errors": [
        {
            "line": "{\"URL\":\"https://www.tiktok.com/search?q=tjd\"}",
            "index": 1,
            "errors": [
                ["url", "Required field"]
            ]
        }
    ]
}
```

***

### 启动采集:

端点:  `POST` [https://api.brightdata.com/datasets/initiate\_collection](https://api.brightdata.com/datasets/initiate_collection)

**参数:**

<ParamField body="request_id" type="string" required>
  您正在查询的采集请求的唯一标识符。
</ParamField>

<ParamField body="freshness_ms" type="string" required>
  以毫秒为单位的时间，表示所需的数据新鲜度。
</ParamField>

<ParamField body="request_id" type="string" required>
  以毫秒为单位的时间，表示所需的数据新鲜度。
</ParamField>

```sh 示例
curl -X POST -k "https://api.brightdata.com/datasets/initiate_collection" -d '{"request_id":"j_ln2x567b2961de0d1x","freshness_ms":2592000000}' -H "Authorization: Bearer API_KEY" -H "content-type: application/json"
```

## 定义视图后的采集:

***

### 启动采集:

端点:  `POST` [https://api.brightdata.com/datasets/initiate](https://api.brightdata.com/datasets/initiate)

**参数:**

<ParamField query="dataset_id" type="string" required />

<ParamField query="view" type="string" required />

<ParamField query="type" type="string" required>
  `discover_new` 或 `url_collection`
</ParamField>

<ParamField body="inputs" type="array">
  Array - json
</ParamField>

<ParamField body="file" type="multipart">
  multipart - csv
</ParamField>

```sh 示例
curl "https://api.brightdata.com/datasets/initiate?dataset_id=XXX_DATASET_ID&type=url_collection&view=XXX_VIEW_ID" -H "Authorization: Bearer API_KEY" -H "Content-Type: application/json" -k -d '[{"id":"user-id"}]'
```

数据集将传送到为此视图配置的设置。

现在，利用这些增强的功能，用户可以更有效地定制其数据采集流程，确保生成的数据集符合其项目要求。

***

### 如何检索已采集的快照结果

```sh
curl "https://api.brightdata.com/datasets/snapshots/snapshot_id/download" -H "Authorization: Bearer API_KEY" 
```


# 交付选项
Source: https://docs.brightdata.com/cn/datasets/custom-datasets/delivery-options

本文介绍了快照准备就绪后获取数据集的相关选项。

要设置数据集的交付偏好，只需点击“交付设置”选项卡即可:

* 选择文件格式：
  * JSON
  * NDJSON
  * CSV
  * JSON Lines
* 选择如何接收数据：
  * Amazon S3 ([AWS S3 用户角色权限](/cn/datasets/custom-datasets/delivery-options#aws-s3-user-role-permissions))
  * Google Cloud Storage ([如何查找您的 Google 云私钥](/cn/datasets/custom-datasets/delivery-options#how-to-find-your-google-cloud-private-key))
  * Google Cloud PubSub
  * Microsoft Azure 存储
  * SFTP/FTP
  * Snowflake ([Snowflake 交付配置指南](/cn/datasets/custom-datasets/delivery-options#snowflake-delivery-configuration-guide-only-visible-to-agents-and-admins))

<Frame>
  ![](https://brightdata.zendesk.com/hc/article_attachments/22455157046161)
</Frame>

您还可以为每个快照设置交付首选项，为此，只需点击快照，然后点击“导出”，设置所需的存储参数即可：

<Frame>
  ![](https://brightdata.zendesk.com/hc/article_attachments/22455157047441)
</Frame>

可以通过点击“下载 + 格式化”按钮直接从 CP 下载数据集：

<Frame>
  ![](https://brightdata.zendesk.com/hc/article_attachments/22455219252497)
</Frame>


# 常见问题解答
Source: https://docs.brightdata.com/cn/datasets/custom-datasets/faqs



<AccordionGroup>
  <Accordion title="如何请求数据收集器（自定义数据集）？">
    ...
  </Accordion>
</AccordionGroup>


# 请求
Source: https://docs.brightdata.com/cn/datasets/custom-datasets/request



## 简介

Bright Data 的“请求定制数据集”功能提供了一种简化的、量身定制的数据收集方法。本指南概述了请求和获取适合特定需求的定制数据集的步骤。

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/-sABq4yq7wU?si=Hppi5lDKTz3yHop7" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />
</Frame>

## 分步流程

<Steps>
  <Step title="发起请求">
    * 访问： 导航到“请求数据集”部分，开始自定义数据集请求。
  </Step>

  <Step title="指定数据要求">
    * 详细信息：为数据集选择具体信息，适用于单个或多个请求。
  </Step>

  <Step title="设置与审查">
    * 示例数据集：创建并审查示例数据集。
    * 架构审查：审查和调整由 AI 生成的架构，或上传自定义的 JSON 格式架构。
    * 批准：进行必要的调整后，点击“批准架构”。
  </Step>

  <Step title="审查数据示例">
    * 检查示例：评估 AI 创建的数据集样本，确保其符合您的标准。
    * 格式选项：下载 JSON 或 CSV 格式的示例以进行详细审查。
    * 批准：点击“批准示例”以确认其符合您的要求。
  </Step>

  <Step title="定义数据收集范围">
    * 范围选项：从“所有内容”、“网站的一部分”或“唯一网址”中选择。
    * 详细说明： 提供独特产品记录的估计值和具体的收集细节（如“电子产品中的所有电视”）。
    * 确认：点击“批准范围”以完成选择。
  </Step>

  <Step title="设置验证规则">
    * 规则配置：设置最小和最大记录的参数、记录完整性以及抓取错误的限制。
    * 质量保证：这些规则可确保数据的准确性和完整性。
    * 完成：点击“批准规则并完成审查”。
  </Step>

  <Step title="完成请求并继续付款">
    * 最终审查：确保所有细节准确且完整。
    * 付款：点击“继续”进入付款步骤。
  </Step>

  <Step title="付款流程">
    * 账单详情：输入您的账单信息。
    * 付款方式：选择您的首选付款方式。
    * 确认：完成付款以启动数据样本准备。
  </Step>

  <Step title="订单确认和跟踪">
    * 确认：完成付款以启动数据样本准备。
    * 跟踪：使用“跟踪您的请求”功能监控进度。
  </Step>

  <Step title="数据收集进度">
    * 幕后：系统正在积极收集和验证目标网站的数据。
  </Step>

  <Step title="数据样本审查">
    * 通知： 数据样本准备就绪后，接收电子邮件或仪表板通知。
    * 验证结果：审查验证结果以确保数据的准确性和完整性。
    * 样本审查：检查数据样本的质量和相关性。
    * 选项：下载样本、报告问题或继续购买完整数据集。
  </Step>

  <Step title="购买选项">
    * 一次性购买：立即获取当前数据集快照。
    * 订阅：选择定期更新数据集，定期收费。
  </Step>

  <Step title="敲定完整数据集请求">
    * 决定：根据您的需求选择适当的购买选项。
    * 完成：确认订单，并按预计时间接收完整的数据集。
  </Step>
</Steps>


# 客户数据验证
Source: https://docs.brightdata.com/cn/datasets/data-validation/data-validation-for-customers



## 概述

Bright Data 的自动数据集创建平台包括数据集交付之前的验证和批准阶段。该平台便于错误处理、验证检查和客户定制, 确保数据的准确性和可靠性。这些验证检查对于节省时间、减少数据错误，以及将数据质量保持在所需水平至关重要。
<img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/flow-chart.png?maxW=1115&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=12819037e023f4d155f8e5c0c6d439ae" alt="flow-chart.png" width="1115" height="291" data-path="images/datasets/data-validation/data-validation-for-customers/flow-chart.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/flow-chart.png?w=280&maxW=1115&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=41c964dac2c72cb83ad925b42d3d570a 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/flow-chart.png?w=560&maxW=1115&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=8eeaefd7e816d0ffe306350cb9aeb69e 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/flow-chart.png?w=840&maxW=1115&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=430d70df35aae8c11062266a7b9c9988 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/flow-chart.png?w=1100&maxW=1115&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b824e6f8f08ef7b47b1044e5ca2f3b2d 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/flow-chart.png?w=1650&maxW=1115&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=673de1116859748970c4756345eca7f1 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/flow-chart.png?w=2500&maxW=1115&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b831cec2510beb14222e4a2249ad86cf 2500w" data-optimize="true" data-opv="2" />

## 运行机制?

数据集快照准备就绪后：

<Tabs>
  <Tab title="✅ 如果所有验证测试均已通过">
    用户将获得数据集，并在平台上显示所有测试均已通过。
  </Tab>

  <Tab title="❌ 如果所有/部分验证测试失败">
    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>

当用户批准数据集快照后，将进入交付阶段。

## 验证规则

<AccordionGroup>
  <Accordion title="独特性">
    数据集必须包含一定百分比的唯一值。

    * 示例：在 LinkedIn 公司个人资料数据集中，每家公司的 LinkedIn 网址都应该是唯一的。如果存在重复的网址，则会多次列出同一家公司，这违反了唯一性规则。
  </Accordion>

  <Accordion title="填写率">
    数据集必须包含填写值的最小百分比。

    * 示例：在 LinkedIn 公司个人资料数据集中，至少 90% 的个人资料必须填写“行业”字段。如果超过 10% 的个人资料缺少此信息（将“行业”字段留空），则数据集不符合要求的填写率。
  </Accordion>

  <Accordion title="必填字段">
    某些字段必须填写；如果保持空白，则会出现错误。

    * 示例：在 LinkedIn 数据集中，“公司名称”和“总部位置”等字段可能是必填字段。任何缺少此信息的个人资料都将标记为错误。
  </Accordion>

  <Accordion title="数据稳定性">
    与先前收集的值相比，数字值的变化不得超过 X。

    * 示例：如果定期更新数据集，则除非有已知原因（例如合并），否则公司的员工人数不应在两次更新之间发生巨大变化（例如，员工人数从 50 人突然跃升至 5000 人）。
  </Accordion>

  <Accordion title="类型验证">
    根据其字段类型（例如字符串、数字、日期）验证每个条目的数据类型，并标记为不匹配以进行更正。

    * 示例：数据集应仅接受“创建日期”字段中的日期格式。如果输入了“未知”之类的文本字符串，则应将其标记以进行更正。
  </Accordion>

  <Accordion title="架构和字段自定义验证">
    创建自定义规则以验证字段是否存在及其值是否有效，例如要求大小字符串为 “S”、“M” 或 “L”。

    * 示例：数据集可能有一个“公司规模”字段，可接受的值如“小型”、“中型” 和 “大型”。如果记录的值不在这些选项范围内，则必须对其进行标记。
  </Accordion>

  <Accordion title="最低记录阈值">
    数据集必须有 X 条记录（每个 URL 应包含来自总网址输入的 X 条记录）。

    * 示例：如果数据集旨在代表特定行业（例如技术）中的公司，则必须至少包含该行业的公司概况数量才能视为具有完整性和代表性。
  </Accordion>

  <Accordion title="数据大小波动阈值">
    确定数据集大小的波动是否在 +/-X% 范围内。

    * 示例：对于每月更新的数据集，除非特定事件或趋势正在影响该行业，否则列出的公司总数不应在上月到下月间产生大幅波动（例如，增长或减少超过 10%）。
  </Accordion>

  <Accordion title="记录完整性验证">
    检查数据集中的每条记录，确保其中的留白字段或空字段比例不高。如果所记录的留白或空字段超过预定阈值（例如 70%），则会触发错误。

    * 示例：在 LinkedIn 公司个人资料数据集中，如果特定公司的个人资料中有 70% 以上的字段（如行业、规模、位置、描述）为空，则此规则会将其标记为不完整。
  </Accordion>

  <Accordion title="唯一身份和重复项验证">
    检测并解决由于身份分配不当或输入错误而导致数据集中出现多条重复记录的问题。它确保每条记录都是不同的，并准确地代表一个唯一的数据点。

    * 示例：在 LinkedIn 数据集中，此规则将识别由于分配唯一标识符时出现错误而多次列出同一家公司的情况。例如，如果公司资料的细微差异（例如公司名称的拼写不同）导致同一家公司作为单独的条目出现，则该规则会将其标记为需要更正的条目。
  </Accordion>
</AccordionGroup>

## 主要组件和功能

<Frame caption="数据集测试的总体视图（所有结果、通过、失败）">
  <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/overall-view.png?maxW=1210&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=93876c856b319c6fbbe43592f6df6017" alt="overall-view.png" width="1210" height="790" data-path="images/datasets/data-validation/data-validation-for-customers/overall-view.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/overall-view.png?w=280&maxW=1210&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=d08865c5849f3dff464299bf2d3a6c6f 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/overall-view.png?w=560&maxW=1210&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=aed691a69421db2910c6f9c7a2a8532d 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/overall-view.png?w=840&maxW=1210&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=bd9c8f9b6bf1b624102988a7ebcd9277 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/overall-view.png?w=1100&maxW=1210&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=4780add7f22d844702ff69a01c4d90ce 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/overall-view.png?w=1650&maxW=1210&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=d080d331d48ec38150cd93a2a73dd8a4 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/overall-view.png?w=2500&maxW=1210&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=f2d5d06b12289559987d2f852cedf589 2500w" data-optimize="true" data-opv="2" />
</Frame>

### 评估验证测试结果

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate.png?maxW=1350&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=a46801d3bf21f084a5cb1280eb33a18e" alt="evaluate.png" width="1350" height="1004" data-path="images/datasets/data-validation/data-validation-for-customers/evaluate.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate.png?w=280&maxW=1350&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=7d07bf3c201ae93bddbd5616a06012d8 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate.png?w=560&maxW=1350&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=1a32dbf49d7195020d793722eff908da 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate.png?w=840&maxW=1350&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=70b5b6e0da38ce7a5cfab910fc5a25d1 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate.png?w=1100&maxW=1350&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=d315b716565d270f762682191e0186d7 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate.png?w=1650&maxW=1350&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=f4feebb172924f9eb5e0fe4564c2808f 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate.png?w=2500&maxW=1350&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6cc15544458dab2e98b7834fa7e41d1d 2500w" data-optimize="true" data-opv="2" />
</Frame>

处理数据集快照验证错误后，系统会通知用户进行评估并选择是否：

1. 批准
2. 暂时批准
3. 拒绝快照。

### 评估操作

对于每一次失败的验证测试，用户有三个选择：

1. **设置新的阈值**
   1. 设置自定义值 - 如果开发者未达到默认设定值，则用户可以选择新的阈值。设置新的阈值后，快照将返回给开发人员。
   2. 设置为 X% - 接受开发者达到的成功率，并将阈值设置为开发人员设法提取的值。

2. **忽略测试（仅限一次）** - 接受开发人员仅提取一次的值（下一个数据集快照的默认值不会改变）

3. **拒绝** - 用户不接受对失败测试的调整；问题将返回给开发者进行修复。
   . 如果需要更多修复，该状态将标记为“已拒绝”，稍后将重新发送给客户审批。

<Frame>
  <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate-options.png?maxW=879&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=547a2146b2ead6345ace3859816d70ae" alt="evaluate-options.png" width="500" width="879" height="1232" data-path="images/datasets/data-validation/data-validation-for-customers/evaluate-options.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate-options.png?w=280&maxW=879&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6f71c3eaa75b781b1f95649b6069e4e8 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate-options.png?w=560&maxW=879&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6a1a6441c9f26000b93eaea36cc7de5b 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate-options.png?w=840&maxW=879&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6ea2507acd1499712eec35cd4f2462b1 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate-options.png?w=1100&maxW=879&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=31f8f60a8456e076658b4b410b8b5fed 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate-options.png?w=1650&maxW=879&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=c343b4fd4b53905ba0e3026b6b1b3a27 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate-options.png?w=2500&maxW=879&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=1b8f3e84dc9f2a067e58fa7a3fe07c77 2500w" data-optimize="true" data-opv="2" />
</Frame>

如果所有问题都已忽略/批准，请单击“交付数据集”以交付快照。

<Note>客户批准处于等待状态 14 天时，快照交付将自动交付。</Note>

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/validations-results.png?maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=94a3afc1c1186f2c496c33a0826eab68" alt="validations-results.png" width="1600" height="565" data-path="images/datasets/data-validation/data-validation-for-customers/validations-results.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/validations-results.png?w=280&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=19dbf11efe7bfcde6ea788cc7b3c15a0 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/validations-results.png?w=560&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=64079c6ab95bef85cd25f7f88c051c39 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/validations-results.png?w=840&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=4029dcf24ca08207c297d49ac1dcf39b 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/validations-results.png?w=1100&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=836d215a871a9dd2fa17d18cce13b66c 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/validations-results.png?w=1650&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=f9eef38db2c23df5f3e6d91dfc37a338 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/validations-results.png?w=2500&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=2fe15504f2cf0400bd4bd9fec4c4a8ed 2500w" data-optimize="true" data-opv="2" />
</Frame>

如果所有/部分问题都已拒绝，请单击“发回给开发者”将其发回以进行更多修复。

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/failed-results.png?maxW=1360&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=9169f93834fd3265cc2cd909b9024dc6" alt="failed-results.png" width="1360" height="978" data-path="images/datasets/data-validation/data-validation-for-customers/failed-results.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/failed-results.png?w=280&maxW=1360&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=7a1964fe89bece10e4f8a6a8ddc850e4 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/failed-results.png?w=560&maxW=1360&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=e531019f227c3e7edcc958061f2e3d82 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/failed-results.png?w=840&maxW=1360&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=3495b4607ea6bb4fbc7df81abde4ebb9 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/failed-results.png?w=1100&maxW=1360&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=838bd3eecd88d145f39edd42462f6cd6 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/failed-results.png?w=1650&maxW=1360&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=49671aceb6f34552b4bdf6622289f732 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/failed-results.png?w=2500&maxW=1360&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=e36b410ed3e3512d8bdbdf432bd3ffbc 2500w" data-optimize="true" data-opv="2" />
</Frame>

## 通信和通知

用户通过控制面板中的账户和电子邮件收到状态更新的通知。


# 合作伙伴数据验证
Source: https://docs.brightdata.com/cn/datasets/data-validation/data-validation-for-partners



## 概述

我们正在推出新的数据暂存流程，使开发人员和所有者都能在交付数据集之前验证和批准数据集。

这一系统将便于错误处理、验证检查和客户定制，确保准确性和可靠性。

它将协助每个人节省时间，减少开启工单的次数，并保持所需质量水平，以保持我们想要的品质水平。

<img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/flowchart.png?maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=cd2fbe2d19db86b53a4cdf5647cbc730" alt="flowchart.png" width="1600" height="651" data-path="images/datasets/data-validation/data-validation-for-partners/flowchart.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/flowchart.png?w=280&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=58fd93b36089202ba043484be99a0f28 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/flowchart.png?w=560&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=c0b36d891f08b37b0f5eefb1fe087194 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/flowchart.png?w=840&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=f943bfc5c06f5525e0450e04478f11fa 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/flowchart.png?w=1100&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=a3f8de7e0743a8f6d01e6a327f4fae71 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/flowchart.png?w=1650&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=3c6dae48cd2ab517c2e133694d2ebb02 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/flowchart.png?w=2500&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=ef4ea8a03826a9d3d5607684e3f137b8 2500w" data-optimize="true" data-opv="2" />

## 运行机制：

数据集快照准备就绪后，我们将运行其验证测试。

<Tabs>
  <Tab title="✅ 如果所有验证测试都没问题">
    客户将获得数据集快照，并在 CP 上显示所有测试均已通过。
  </Tab>

  <Tab title="❌ 如果所有/部分验证测试失败">
    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>

客户批准后，快照将进入交付阶段。

## 验证测试

<AccordionGroup>
  <Accordion title="独特性">
    确保数据集中唯一值的最小百分比。
  </Accordion>

  <Accordion title="填写率">
    确保填写值的最低百分比。
  </Accordion>

  <Accordion title="持久性验证">
    填写后将字段设为必填字段；如果之后留空，则会触发错误。
  </Accordion>

  <Accordion title="数据稳定性">
    与先前的值相比，数值编号的变化幅度不得超过 X。
  </Accordion>

  <Accordion title="类型验证">
    根据其字段类型（例如字符串、数字、日期）检查每个条目的数据类型，以确保完整性并在处理之前标记为不匹配以进行更正。
  </Accordion>

  <Accordion title="架构和字段自定义验证">
    建立自定义规则以验证特定字段是否存在以及字段值是否有效，例如要求大小字符串为 “S”、“M” 或 “L”；任何其他值均视为错误。
  </Accordion>

  <Accordion title="最低记录阈值">
    初始数据集需要至少 X 条记录（在特定 URL 中，应符合总网址输入中最少 X 条记录）
  </Accordion>

  <Accordion title="数据大小波动阈值">
    验证 +/-X% 范围内的波动。
  </Accordion>
</AccordionGroup>

## **主要组件和功能**

<Frame caption="点击特定快照进行查看时">
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/snapshots.png?maxW=1093&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=57ca2368ed0415abbadc42aefa6711c2" alt="snapshots.png" width="1093" height="398" data-path="images/datasets/data-validation/data-validation-for-partners/snapshots.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/snapshots.png?w=280&maxW=1093&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=578e26d9b28f7a6368607c8c87421bfd 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/snapshots.png?w=560&maxW=1093&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b8e3833b983ede6a522e7278246a9e4c 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/snapshots.png?w=840&maxW=1093&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=537581cf956eee52f4a5e4682ebd69aa 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/snapshots.png?w=1100&maxW=1093&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=47dfe889b4b92e425c2a35733bf33b78 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/snapshots.png?w=1650&maxW=1093&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=bb728c9bffb3b248968faff00d8fee61 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/snapshots.png?w=2500&maxW=1093&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=5d08159b704f1783b3894e6aa92a36fa 2500w" data-optimize="true" data-opv="2" />
</Frame>

<AccordionGroup>
  <Accordion title="数据集测试视图">
    数据集测试视图有三个筛选选项（“所有结果”、“通过”、“失败”）
        <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/dataset-view.png?maxW=1135&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6ac0a97c39a72d78c43310020c4e467f" alt="dataset-view.png" width="1135" height="659" data-path="images/datasets/data-validation/data-validation-for-partners/dataset-view.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/dataset-view.png?w=280&maxW=1135&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=e3c57853319881652224b464350c923d 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/dataset-view.png?w=560&maxW=1135&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=10f134a59ce1ffd48b1dd003c53eb362 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/dataset-view.png?w=840&maxW=1135&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=cfa8debd2b7c0a9b4e11c1a258a9b4b2 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/dataset-view.png?w=1100&maxW=1135&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=d613a92ee82a2ad99d30ddc18d68f84d 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/dataset-view.png?w=1650&maxW=1135&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=00b9bbda4d7c3076f880f710e57effa6 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/dataset-view.png?w=2500&maxW=1135&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=42b0edf16c95f71679694f0c4bd16e01 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="“重新解析”按钮">
    此操作让您可以重新解析缓存的数据
        <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-button.png?maxW=965&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6b63955022b9731ac3748671474221d4" alt="reparse-button.png" width="965" height="422" data-path="images/datasets/data-validation/data-validation-for-partners/reparse-button.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-button.png?w=280&maxW=965&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=8c7d0e8bd380ab23f608eb8fe8b7743b 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-button.png?w=560&maxW=965&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6c832684af3f8224ccf54297c41932dd 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-button.png?w=840&maxW=965&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=55260279d4c56ed8348759298fb3d29c 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-button.png?w=1100&maxW=965&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=c39e4e9875b26f9d72216761d78b76da 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-button.png?w=1650&maxW=965&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=71cdf20702b467c226558d568ed2d68e 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-button.png?w=2500&maxW=965&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=64b9569f5b3cd2ea572351c763c8faa6 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="“忽略”按钮">
    由于数据看起来很正常/或者特定数据集未达到阈值是合理的，则可以选择覆盖测试，（注意！ 如果需要进行覆盖，则需要向客户写一份解释）

    <Frame>
            <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ignore-button.png?maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=5b24b7806978a1983c7c15f0dc389a38" alt="ignore-button.png" width="683" height="326" data-path="images/datasets/data-validation/data-validation-for-partners/ignore-button.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ignore-button.png?w=280&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=4060397d32804058bbb5e7fffda25f42 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ignore-button.png?w=560&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=20bda2bcc06b69cf3f807c57c4d1200b 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ignore-button.png?w=840&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=4c4c25636a607adb50ad9e08412e2847 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ignore-button.png?w=1100&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=8701c77a7410b2b2f581325bdc4253ec 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ignore-button.png?w=1650&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=2cf8cf0df987caecd5201c7e9c8a85d2 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ignore-button.png?w=2500&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=e1c9d06f8f360c5666c0c7b5df726463 2500w" data-optimize="true" data-opv="2" />
            <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/undo-ignore.png?maxW=1052&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=d317ecb60d189f44e149136b10c71630" alt="undo-ignore.png" width="1052" height="248" data-path="images/datasets/data-validation/data-validation-for-partners/undo-ignore.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/undo-ignore.png?w=280&maxW=1052&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=7276d66677de5f0ac428584f0b357de4 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/undo-ignore.png?w=560&maxW=1052&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=0505d53aba55294de0dfb8dd74a02196 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/undo-ignore.png?w=840&maxW=1052&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=9b38b3b8310f8795579f0795edfca336 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/undo-ignore.png?w=1100&maxW=1052&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=432d45cf7415b56584a31a049e95377d 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/undo-ignore.png?w=1650&maxW=1052&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=0e2bf58d813319bf883da01b5f146fcd 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/undo-ignore.png?w=2500&maxW=1052&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=44ccb9d497ae738219a00c86fcc41bd9 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    <Frame>
            <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/confirm-undo.png?maxW=453&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=414e461cff4e625d400c8f40a7fa9247" alt="confirm-undo.png" width="453" height="317" data-path="images/datasets/data-validation/data-validation-for-partners/confirm-undo.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/confirm-undo.png?w=280&maxW=453&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=fd3104aadbed923cf3be323d6321a7cc 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/confirm-undo.png?w=560&maxW=453&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=431a72f7176fd1661775390d97cfbfd9 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/confirm-undo.png?w=840&maxW=453&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6ffa4a9b9a7db5850a919b44cbaa00cf 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/confirm-undo.png?w=1100&maxW=453&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=81c8354f2af53bf6bc59e2435074837e 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/confirm-undo.png?w=1650&maxW=453&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=a31fe388a391df3bdb4676a6898827e1 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/confirm-undo.png?w=2500&maxW=453&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=7bc5bcf4e13aceb0e39229c3c7c8a921 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>

  <Accordion title="“显示相关记录”和“查看和编辑代码”">
    如果测试失败，请点击“显示相关记录”以查看记录示例，然后点击“查看并编辑代码”进入 IDE 并开始修复问题

        <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/view-edit-code.png?maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=ff79c4c50f6a8d6fcb136efd328194ae" alt="view-edit-code.png" width="683" height="326" data-path="images/datasets/data-validation/data-validation-for-partners/view-edit-code.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/view-edit-code.png?w=280&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=2cd661dd0f299f61134b7122a3935237 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/view-edit-code.png?w=560&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=af261da0f15d7ae5b1ab5c44a94bc54e 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/view-edit-code.png?w=840&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=7ee0e1c5d7622039df4b2941af1f7677 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/view-edit-code.png?w=1100&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=c905b21f00a280ac5d4af6468b8abd9e 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/view-edit-code.png?w=1650&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=02c44540dfbe78163230227b6df06aba 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/view-edit-code.png?w=2500&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=689cfaf435c8586b8bc11265e95fd9c6 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="“重新解析”或“重新爬取”按钮">
    完成所需修复工作后，即可根据需要重新解析或重新爬取
        <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-recrawl.png?maxW=940&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=829de4b8213c4141c7398fc5d371ee4f" alt="reparse-recrawl.png" width="940" height="459" data-path="images/datasets/data-validation/data-validation-for-partners/reparse-recrawl.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-recrawl.png?w=280&maxW=940&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=debf73c716c51536c8bdb37efdc342ff 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-recrawl.png?w=560&maxW=940&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6eb8bc0ef55fe993fa168411dab97f30 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-recrawl.png?w=840&maxW=940&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=31e7ec4ac266216b13341594ac4e284d 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-recrawl.png?w=1100&maxW=940&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=f317d4c6708f67df259f1307cb7748ed 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-recrawl.png?w=1650&maxW=940&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=1965804d321e2b4051b4c4899b9b56eb 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-recrawl.png?w=2500&maxW=940&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=4cbfd6258effde1ca8bcaeaf6040a692 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="重新运行测试">
    此操作可以让您在需要时再次运行验证测试
        <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/rerun-tests.png?maxW=1207&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=176960f70de8124961cf69ff740ef610" alt="rerun-tests.png" width="1207" height="653" data-path="images/datasets/data-validation/data-validation-for-partners/rerun-tests.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/rerun-tests.png?w=280&maxW=1207&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=733dae143970c8be242a8c9d2a55d0de 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/rerun-tests.png?w=560&maxW=1207&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=dd65b2ee14b9f7b98bf366250fade0ef 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/rerun-tests.png?w=840&maxW=1207&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=3381ea5f704c8fa87518e76337fa0076 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/rerun-tests.png?w=1100&maxW=1207&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=41a7c3c57839d6164c4a9849e77f216c 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/rerun-tests.png?w=1650&maxW=1207&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6ed847afd060c1230b735984b9883b4a 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/rerun-tests.png?w=2500&maxW=1207&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=5c8b9ef43cbe0c723294c437ac86babd 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="IDE 按钮">
    此操作让您在需要编辑收集器并重新爬取（例如，如果根本没有记录）时，可以在上下文中重定向到 IDE
        <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ide-button.png?maxW=1191&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=0b173d31228a23553c3f6a8fe68920cf" alt="ide-button.png" width="1191" height="582" data-path="images/datasets/data-validation/data-validation-for-partners/ide-button.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ide-button.png?w=280&maxW=1191&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=5fdf6a41ac0070b6a6a7f1885501edbf 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ide-button.png?w=560&maxW=1191&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=d524e461d15738f2e13c713764bd2322 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ide-button.png?w=840&maxW=1191&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=64ad7a417c84477e25a184a08361a9c4 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ide-button.png?w=1100&maxW=1191&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=9227cc64d4a063a200519d6fd04c3ae0 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ide-button.png?w=1650&maxW=1191&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=a478fad6801ab3b4d6d9a65f0fb5fd62 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ide-button.png?w=2500&maxW=1191&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=1452cd3bfc20372686eab2b0b06c3319 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="“交付数据集”按钮">
    查看所需数据并修复/忽略问题后，您应该点击此按钮并将快照发送给所有者进行审查。 对于被忽略的测试，应提供理由来解释您为什么选择忽略测试
        <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/deliver-dataset.png?maxW=693&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b60f449494927445cd782e91e830dd47" alt="deliver-dataset.png" width="693" height="219" data-path="images/datasets/data-validation/data-validation-for-partners/deliver-dataset.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/deliver-dataset.png?w=280&maxW=693&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=c248dc71a5b5d1cc390d9099afb38772 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/deliver-dataset.png?w=560&maxW=693&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=cf081898fb26c49387273fbabda3e380 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/deliver-dataset.png?w=840&maxW=693&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=2a3bd5137871f84a53da3daaf6bad781 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/deliver-dataset.png?w=1100&maxW=693&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=fa94cfa2e7bf8440f37ae7898d95a8bf 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/deliver-dataset.png?w=1650&maxW=693&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=112e19ae5636411d844c7d96058646fd 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/deliver-dataset.png?w=2500&maxW=693&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=08b50d2f0b456a0a4fc2ac4b4c7751c3 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="已拒绝的测试">
    如果所有者未接受所有已拒绝的测试，则问题将发回给您，并将标有“已拒绝”标签以进行更多修复，然后重新发送给所有者审批
        <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/failed.png?maxW=1045&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=92197da043c697340ec8326453058902" alt="failed.png" width="1045" height="847" data-path="images/datasets/data-validation/data-validation-for-partners/failed.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/failed.png?w=280&maxW=1045&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=520729e69d38d879e90c628a40c3c931 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/failed.png?w=560&maxW=1045&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=1c8eccc30b4e5e63ef6fe027bc92f551 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/failed.png?w=840&maxW=1045&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=15ac15df25e2d6f76738e03ed371feff 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/failed.png?w=1100&maxW=1045&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=007b98ec1dc8f3a9ab2471d6075476e3 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/failed.png?w=1650&maxW=1045&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=3a506dcccd0c8afcb615e939824f302d 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/failed.png?w=2500&maxW=1045&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=dc977f6d7234eb301cd65b986481742a 2500w" data-optimize="true" data-opv="2" />
  </Accordion>
</AccordionGroup>

## 通信和通知

状态更改和其他通知将在 CP 上通过扩音器显示给您。

## 工单和错误

现在，我们引入暂存流程后，修复收集器并不是错误/问题的终点

该过程包括两个步骤：

1. 修复收集器
2. 修复快照

因此，将对错误处理工作流程进行修改，以便与新的两步流程保持一致。
<Note>在快照交付给数据集所有者之前，不应允许将与验证问题相关的工单标记为“已解决”！</Note>

## 对流程的更改：

我们正在从工单上的选项中移除“解决”按钮


# Bright Data 数据集
Source: https://docs.brightdata.com/cn/datasets/introduction



<Card>
  <CardGroup>
    <Card title="数据集市场" href="/datasets/marketplace" icon="store">
      大量访问预建的、结构化的、经过验证的数据集
    </Card>

    <Card title="自定义数据集" href="/datasets/custom-datasets" icon="table">
      使用我们的数据集创建平台生成自定义数据集
    </Card>
  </CardGroup>
</Card>


# 自定义与筛选
Source: https://docs.brightdata.com/cn/datasets/marketplace/customization-and-filtering



<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-button.png?maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=74d41eaec3585419393963a1e18a1f7c" alt="" width="1920" height="941" data-path="images/datasets/marketplace/customization-and-filtering/customize-button.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-button.png?w=280&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=ff3a6c838c70b119d1f454ab0a0660da 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-button.png?w=560&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=57e3f7b595f14ebb6bf5ba33f24bfb14 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-button.png?w=840&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=4a305394c301d8c4e9e5edcf632b1563 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-button.png?w=1100&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=26c1571610e04131356385e805f47ccd 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-button.png?w=1650&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=a027b0decfcff39476ee17eae8fd5650 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-button.png?w=2500&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=32ee58161e009a94019838ca17c09311 2500w" data-optimize="true" data-opv="2" />
</Frame>

## 自定义字段

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-fields.png?maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=8e9120747dfc36ba132028a32f3608fb" alt="" width="1920" height="941" data-path="images/datasets/marketplace/customization-and-filtering/customize-fields.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-fields.png?w=280&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=8051466e974d7cebd91364fc9cdfb9a4 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-fields.png?w=560&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=8be5057a09e22f149f8dfe13e72f993f 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-fields.png?w=840&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=eae826fc4ae6c93a91c2a4d4c00b50a6 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-fields.png?w=1100&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=370a8e0bf5445c409a4b86a03e16a086 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-fields.png?w=1650&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=ac16e52782bd0652ce918938063c504b 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-fields.png?w=2500&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=82015c8e5ac78e2b700713b0cae42305 2500w" data-optimize="true" data-opv="2" />
</Frame>

## 筛选

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/filter.png?maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=7fddcbd41434196e775fd33ac589fb64" alt="" width="1920" height="941" data-path="images/datasets/marketplace/customization-and-filtering/filter.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/filter.png?w=280&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=af00ed80f09a075f51571618e38af256 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/filter.png?w=560&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=f7bc65341dea91730cb6bb65b4539a6d 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/filter.png?w=840&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=a1dc2d0e7708f83739effd531e213b9d 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/filter.png?w=1100&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=fbe3b10254f9060698f3d845e96698f0 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/filter.png?w=1650&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=3806065116b5813f7d924b1441ea167f 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/filter.png?w=2500&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=9994166384b612d949ad9a724173a557 2500w" data-optimize="true" data-opv="2" />
</Frame>

### 使用 UI 筛选数据集

1. 先导航到您想要筛选的数据集。
2. 点击右上角的筛选图标按钮。
3. 菜单会弹出，您可以为视图添加名称，以便识别查询。
4. 在 **“包含筛选条件”** 部分选择适当的筛选条件，例如国家、职位或日期。
5. 点击 **“创建子集”** 按钮以生成筛选后的视图。

### 筛选功能

#### **选择 (Select)**

* 通过该功能，从预定义列表（如国家或地区）中选择一个或多个精确匹配项。适用于处理已知值集合的情况。

#### **布尔值 (Boolean)**

* 通过布尔值（`true` 或 `false`）进行筛选，以查找符合特定条件的记录，例如已验证或未验证的社交媒体账户。

#### **日期 (Date)**

* 该筛选器允许指定日期范围（起始日期和结束日期），适用于趋势分析或按日期筛选事件。

#### **数值 (Number)**

* 可用选项：
  * **等于 (Is)：** 匹配精确数值。
  * **不等于 (Not)：** 排除指定数值。
  * **存在 (Exist)：** 筛选非空数值字段。
  * **列表（精确匹配）(List exact match)：** 匹配列表中的精确数值。
  * **小于 / 小于等于 (Lower than / Lower or equal to)：** 筛选小于或等于特定数值的记录。
  * **大于 / 大于等于 (Greater than / Greater or equal to)：** 筛选大于或等于特定数值的记录。

#### **字符串 (String)**

* 通过字符串值进行筛选，可使用精确匹配、排除、列表匹配或模式匹配来优化搜索结果。

#### **数组 (Array)**

* 使用 **“数组包含” (Array includes)** 筛选器，检查某个值是否存在于数组字段中，例如特定标签。

### 创建基于规则的分组筛选器

* 点击 **“+添加筛选条件” (Add filter)** 下拉菜单，并选择 **“添加分组” (Add group)** 以创建分组筛选器。
* 分组筛选器允许您设置规则，例如筛选 **类别** 为 **“电子产品”** 且 **品牌** 为 **“Dell”** 或 **“Apple”** 的数据集。

### 局限

* 不能嵌套分组，每个筛选器最多允许两个分组。

如果您需要更复杂的查询，请联系您的账户经理获取自定义查询和筛选的支持。


# 数据集视图
Source: https://docs.brightdata.com/cn/datasets/marketplace/dataset-view



## 数据样本

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/data-sample.png?maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=9e65f41b597df8f0e4d6109aa8639379" alt="" width="1857" height="920" data-path="images/datasets/marketplace/dataset-view/data-sample.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/data-sample.png?w=280&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=3fb80a6b2fa9db5af4b0753bf6be6fec 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/data-sample.png?w=560&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=9b09cdc29637742a44f105b675c4d64b 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/data-sample.png?w=840&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=fef557e7e9357e5c5f325b73213fbae5 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/data-sample.png?w=1100&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=fc74e331069e03eea7a0dde2c58e4c3e 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/data-sample.png?w=1650&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=a96c9eb701015a701905dd24b4990727 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/data-sample.png?w=2500&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b69508c9f82e2917ed67231559a8882b 2500w" data-optimize="true" data-opv="2" />
</Frame>

* 数据字段
* 记录
* 新鲜度
* 最少订单
* 下载数据示例：JSON、CSV、数字记录（显示 30 条记录，但您会得到 1000 条记录）
* CSV/JSON
* 创建子集
* 联系我们
* 购买选项

### 自定义

* 自定义 - 通过隐藏/显示和重命名字段来创建自定义子集，并根据您的要求筛选数据集。
* 自定义字段
* 筛选

## 字典

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/dictionary.png?maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=c94b6e7c28622a3a5c99c094b16499d3" alt="" width="1857" height="920" data-path="images/datasets/marketplace/dataset-view/dictionary.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/dictionary.png?w=280&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=8de81e6ca37e8c0469ebdfb20546946b 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/dictionary.png?w=560&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=58a338a4480ad32b212c0a6fd424152e 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/dictionary.png?w=840&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=336c3fbfc0f3236c810a5cc3cd36519a 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/dictionary.png?w=1100&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=62220f03b546e7bc5dffa48035d03bda 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/dictionary.png?w=1650&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b22f4fe26395dcaad5e5a59416bb7c0b 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/dictionary.png?w=2500&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=cd1a7edc7cc117c156fea18dd3c96820 2500w" data-optimize="true" data-opv="2" />
</Frame>

* 搜索属性
* 表
  * 列名
  * 描述
  * 数据类型

## 用例

<Frame>
    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/dataset-view/use-cases.png?maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=1db96600c87b4b2a5d5e53dff54176e0" alt="" width="1857" height="920" data-path="images/datasets/marketplace/dataset-view/use-cases.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/dataset-view/use-cases.png?w=280&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f263393dfaca5f3759ca7f46703285b1 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/dataset-view/use-cases.png?w=560&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=28cef98a701461ea6f1b4a1931d2465d 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/dataset-view/use-cases.png?w=840&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=475252be27bc2ead06b7c81c9c8e2857 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/dataset-view/use-cases.png?w=1100&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=e5711bb2dec06923cf2d589e3d876ae3 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/dataset-view/use-cases.png?w=1650&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b12a4a8bd9452d1c1fb225e86a4df1ec 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/dataset-view/use-cases.png?w=2500&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=42e3f14473060bc97543e25b46cdd029 2500w" data-optimize="true" data-opv="2" />
</Frame>

* 案例研究
* 相关子集
* 与哪个类别有关

## 简介

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/about.png?maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=f60f8b6ab0bc48a0d8feb0818d222796" alt="" width="1857" height="920" data-path="images/datasets/marketplace/dataset-view/about.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/about.png?w=280&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=fd09be28eff2883e57fe09811f57bce4 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/about.png?w=560&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=63a3510583313a31eafd8f1e922317d9 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/about.png?w=840&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=359171a00159a85e12e9dbf4ee5fc785 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/about.png?w=1100&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=d88339dc5bccf95454285039d80d36cd 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/about.png?w=1650&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=1f90a448ad73ad0bc945b7cc1362e538 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/about.png?w=2500&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=efe3689460b487f3eb898d27bdf0606e 2500w" data-optimize="true" data-opv="2" />
</Frame>

* 关于数据集的描述
* 我们从哪个域名收集信息
* 用例类别
* 自定义数据集 CTA
* 交付选项
* 常见问题解答

## 由 API 发起

* 能够通过 API 或 UI 提交请求，根据您自己的 URL（输入）收集新数据
* +添加输入
* 上传 CSV
* 创建访问令牌以启动收集
* 设置预期记录
* 数据收集选择
  * 探索新纪录
  * 特定网址集合
* 购买选项


# 常见问题解答
Source: https://docs.brightdata.com/cn/datasets/marketplace/faqs



<AccordionGroup>
  <Accordion title="数据集市场上有哪些可用的数据集？">
    以下是数据集市场中可立即下载的部分数据集列表：

    **热门数据集**

    * Amazon产品
    * Crunchbase公司信息
    * Facebook - 按群组URL分类的帖子
    * Github存储库
    * Glassdoor公司概览信息
    * LinkedIn公司信息
    * LinkedIn个人档案
    * LinkedIn帖子
    * 路透社新闻
    * Zillow房地产租售信息

    数据集按类别划分。 以下是主要类别及部分数据集：

    **电子商务数据**

    * 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

    **房地产数据**

    These datasets include information regarding housing data, real estate prices, rent prices etc.

    * Bayut阿联酋房地产租售信息
    * Booking.com房地产租售信息
    * Dubizzle阿联酋房地产租售信息
    * PropertyFinder房地产租售信息
    * 美国消费者房地产
    * ZoomProperty阿联酋房地产租售信息
    * 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

    **社交媒体数据**

    * facebook.com
    * instagram.com
    * linkedin.com
    * pinterest.com
    * reddit.com
    * tiktok.com
    * unashamedcataddicts.quora.com
    * vimeo.com
    * x.com
    * youtube.com

    **旅游数据**

    * Booking.com酒店客房定价和空房信息
    * Deliveroo餐厅列表
    * OpenTable餐厅列表
    * Short-Term Rental Occupancy & 定价 Dataset
    * Talabat餐厅列表
    * Tripadvisor餐厅列表
    * Zomato阿联酋餐厅列表
    * airbnb.com

    **B2B数据**

    * 商业联系人数据集
    * 商业公司统计数据
    * 商业情报数据集
    * 商业位置（POI）数据集
    * 公司层次结构数据集
    * 在线意图数据
    * 政治公众人物名单
    * 技术安装基础数据源
    * 美国B2B员工
    * 美国消费者人口统计数据
    * 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

    数据集市场不断更新，提供最新的数据集。 For the complete list, click on "Web Data" on the sidebar, and then on "数据集 市场" on the top bar.

    If the domains you need aren't exist in the 市场, you can request them through the Custom Dataset (CDS).
  </Accordion>

  <Accordion title="你们提供免费数据集吗？">
    是的！你可以下载一些免费的数据集：

    * espn.com - NBA data
    * goodreads.com
    * imdb.com
    * worldpopulationreview\.com

    数据集市场不断更新，提供最新的数据集。 要查看完整列表，请点击侧栏上的“Web Data”（网络数据），然后点击顶栏上的 “数据集 市场”（数据集市场）。
  </Accordion>

  <Accordion title="为什么市场数据集中的时间戳与交付日期不同？">
    计划的运行是为了确保及时交付。

    交付截止日期是根据之前的收集周期和估计的刷新持续时间计算的。

    因此，收集可能会在交付日期之前开始，以确保数据按时交付。
  </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>


# 通过 API 筛选数据集
Source: https://docs.brightdata.com/cn/datasets/marketplace/filter-dataset-by-api



请参阅 [筛选数据集](/cn/api-reference/marketplace-dataset-api/filter-dataset) API 参考页面


# 数据集市场概览
Source: https://docs.brightdata.com/cn/datasets/marketplace/overview

数据集市场是一个集中的平台，提供来自多个网站的定期更新、符合道德标准的数据集，并支持灵活的数据定制和获取解决方案。

## 数据集市场简介

数据集市场是一个一站式平台，可用于发现、定制和购买来自 120 多个网站的高质量数据集。数据集定期更新，并从公开可用的信息中合规获取，确保数据的准确性和合规性。无论您需要即用型数据还是按需解决方案——涵盖社交媒体、房地产、B2B 数据或 AI 训练等领域——灵活的购买选项和全面的定制功能都能让您轻松获取所需数据。

## 快速入门

<Card>
  <CardGroup>
    <Card title="浏览" href="/datasets/marketplace/browse" icon="store">
      浏览多个网站的预构建、经过验证的数据集。
    </Card>

    <Card title="数据集视图" href="/datasets/marketplace/dataset-view" icon="dataset">
      在购买前查看数据样本、数据字段和定制选项。
    </Card>

    <Card title="筛选数据集" href="/datasets/dataset-view" icon="filter">
      通过高级筛选、隐藏字段和自定义子集优化数据集。
    </Card>

    <Card title="下载数据样本" href="/datasets/dataset-view" icon="download">
      预览并以多种格式下载任意数据集的样本。
    </Card>

    <Card title="填充率与统计数据" href="/datasets/dataset-view" icon="statistics">
      查看数据完整性和字段覆盖情况，确保数据准确性。
    </Card>

    <Card title="购买选项与定价" href="/datasets/pricing" icon="price">
      了解一次性购买、订阅及其他灵活的定价模式。
    </Card>

    <Card title="数据交付与导出" href="/datasets/export" icon="export">
      了解如何通过电子邮件、API、Webhook 和各种云服务接收数据集。
    </Card>
  </CardGroup>
</Card>


# 定价
Source: https://docs.brightdata.com/cn/datasets/marketplace/pricing



* 预先收集的记录
* 新纪录
* 定价是根据获取和收集数据的计算成本和记录成本来确定的。

## 数据交付和导出

<Frame>
    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/pricing/delivery.png?maxW=1920&auto=format&n=2RrKkArDJDw55ilE&q=85&s=86c4542c7d0032076b9e61d48934a9c5" alt="" width="1920" height="941" data-path="images/datasets/marketplace/pricing/delivery.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/pricing/delivery.png?w=280&maxW=1920&auto=format&n=2RrKkArDJDw55ilE&q=85&s=dbab3fc91cdc3f280681e90ae5f66710 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/pricing/delivery.png?w=560&maxW=1920&auto=format&n=2RrKkArDJDw55ilE&q=85&s=9d32e31c03aafcaa2c0f4edd8be41b94 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/pricing/delivery.png?w=840&maxW=1920&auto=format&n=2RrKkArDJDw55ilE&q=85&s=6402bad0bac4dc2b1aee8eb678da32c3 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/pricing/delivery.png?w=1100&maxW=1920&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2c30b3d8e13796f2bc6756c13cd46e1a 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/pricing/delivery.png?w=1650&maxW=1920&auto=format&n=2RrKkArDJDw55ilE&q=85&s=528ba89f32c577fcd291bf2dc832ecc4 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/pricing/delivery.png?w=2500&maxW=1920&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a498afe2901fbfa75fdeb49fe35c4a8a 2500w" data-optimize="true" data-opv="2" />
</Frame>

* 电子邮件
* API下载
* Webhook
* Amazon S3
* Google Cloud存储
* Google Cloud PubSub
* Microsoft Azure
* Snowflake
* SFTP


# 购买选项
Source: https://docs.brightdata.com/cn/datasets/marketplace/purchase-options



* 购买选项 → 灵活性
  * 一次性购买
  * 订阅
* 选择数据类型
  * 预先收集的数据 - 访问最近收集、随时可供使用的数据。
  <Frame>
      <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/pre-collected-data.png?maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2dbff1e630a4380aa79efc4a36d40897" alt="" width="1857" height="920" data-path="images/datasets/marketplace/purchase-options/pre-collected-data.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/pre-collected-data.png?w=280&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d0499e04d09f8871468ee440006197c4 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/pre-collected-data.png?w=560&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a256806c2049185dc9c7d4c03b1b59ed 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/pre-collected-data.png?w=840&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=489eb3bebaf12d94a42e289e17a85749 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/pre-collected-data.png?w=1100&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=488cd37a64d17f39fa61a1b600cca207 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/pre-collected-data.png?w=1650&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=c35165f1b6835953d81389b9612ac6bd 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/pre-collected-data.png?w=2500&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=6fdb49522cca1563c0ae950be707c9df 2500w" data-optimize="true" data-opv="2" />
  </Frame>
  * 最新数据 - 访问在收集后立即可用的最新数据。
  <Frame>
      <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/fresh-data.png?maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=76b2fefe24b3b8205b98e2012c18efcc" alt="" width="1857" height="920" data-path="images/datasets/marketplace/purchase-options/fresh-data.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/fresh-data.png?w=280&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=23296b23be933052c590f3bf691fe2a1 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/fresh-data.png?w=560&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=53cc2fd0fde4121c8243e4ccf23fb252 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/fresh-data.png?w=840&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=57b6745919a628eb7708a2fb01a8272b 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/fresh-data.png?w=1100&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=8757f94529ee516472ab56d4a8f1addd 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/fresh-data.png?w=1650&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b1eb9943c3dcb54faaa8af35ef7b065b 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/fresh-data.png?w=2500&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=62e336e90ab94fe8d044d202ac058435 2500w" data-optimize="true" data-opv="2" />
  </Frame>
* 数据分布 - 有5.44亿条记录可用，涵盖时间范围为2021年4月12日至2024年2月27日
* 特定时间范围 - 访问特定时间范围内的数据。（从今天起回溯）

<Frame>
    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/specific-time-range.png?maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=088eed35e12c698bbc4f82dc6424e0f3" alt="" width="1857" height="920" data-path="images/datasets/marketplace/purchase-options/specific-time-range.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/specific-time-range.png?w=280&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7fc1c1f51e2b24f731fff06cd2a30794 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/specific-time-range.png?w=560&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=03cd6d2e38086db46d9a9e0d9d922d6b 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/specific-time-range.png?w=840&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=1bf6eef1618c7e1efe45a904a789449a 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/specific-time-range.png?w=1100&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=98977d4d1f610949dee99c4833658f1a 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/specific-time-range.png?w=1650&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=71773932557e2e6f684dc393ff6a08d9 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/specific-time-range.png?w=2500&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=43a37796a6475be2be229630ffa554af 2500w" data-optimize="true" data-opv="2" />
</Frame>

* 仅适用于预先收集的数据。
* 选择时段
* 为其余记录收集最新数据
  * 处理请求时，将会抓取超出指定时间范围的记录，这将产生额外费用。 刷新时间取决于数据集的大小。 快照准备就绪后，您将收到电子邮件通知。
  * 随着数据的变化，这些记录可能不再符合您的筛选条件，可能会被排除在您的数据集之外。 如果这些记录以后不符合您的筛选条件，则将会被移除，但您仍需要支付初始抓取的费用。
* 设置记录限制-输入您想要的记录数量。 记录是随机选择的。 请注意，价格将根据记录数量而变化。
* 订单
  * 数据集名称 - “LinkedIn人员档案数据集”
  * 记录总数 - 5.44亿条记录
  * “记录” - 总记录费用
  * 记录数量 - 5.44亿条记录
  * 每条记录收费 - 0.0006美元
  * 小计-（不含增值税或销售税）
  * 总计
* 价格调整（最高快照费用）
* 小数据集费用（最低快照费用）

<Frame>
    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/544m.png?maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=74619f4679cb47e8f5abaa8b52076e4d" alt="" width="1857" height="920" data-path="images/datasets/marketplace/purchase-options/544m.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/544m.png?w=280&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=bc5c6ac88abb2e95e30ee0d81e9a346c 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/544m.png?w=560&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=01513d7688dba8e483da114fd2588c90 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/544m.png?w=840&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=124cbe1a23f29a989fd4c80ff9f0e61b 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/544m.png?w=1100&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=bd752dea74b29422108e9a0649f12bf5 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/544m.png?w=1650&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=96fa7045c2df80c358c76ba151958ffd 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/544m.png?w=2500&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=6cb4464c6a6133cd78359d1fd36600f4 2500w" data-optimize="true" data-opv="2" />
</Frame>


# Bright Data's API 令牌
Source: https://docs.brightdata.com/cn/general/account/api-token



Bright Data API 令牌是一种在通过 API 向 Bright Data 发送请求时替换您的证书（即电子邮件地址和密码）的安全方法。使用 API 需要 API 令牌，这样可以始终确保您的账户凭证安全可靠。

## 生成 API 令牌

<Steps>
  <Step title="登录">
    登录到 Bright Data 的控制面板。导航到您的账户设置

    <Frame>
            <img src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/account-settings.png?maxW=367&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=9a3ad5fb0edb7329cda260660f7990a3" alt="account-settings.png" width="367" height="406" data-path="images/api-reference/unlocker/api_token/account-settings.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/account-settings.png?w=280&maxW=367&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=d68d1b84509ffc3abe6d5658e7247ca0 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/account-settings.png?w=560&maxW=367&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=26442123af9491950574767e1cc63edc 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/account-settings.png?w=840&maxW=367&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=b70201e0d32ec20f55a6cd070c1b6c2e 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/account-settings.png?w=1100&maxW=367&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=baaa283fea5846fc9f0134249eb4983c 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/account-settings.png?w=1650&maxW=367&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=626e310a7aa9ab46a8511b9aafe827f2 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/account-settings.png?w=2500&maxW=367&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=4f785e9da5bea9fe53fb9ab446432e7b 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="点击添加令牌">
    <Warning>
      If the 'API Key' section is not visible, switch to your **admin account**. You need to be logged in as admin to generate an API key.
    </Warning>

    <Frame>
            <img src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/add-token.png?maxW=1493&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=d50c2aa687f672597105913f7d598ebe" alt="add-token.png" width="1493" height="827" data-path="images/api-reference/unlocker/api_token/add-token.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/add-token.png?w=280&maxW=1493&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=37b437a767c7a98eba9db8edc912e009 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/add-token.png?w=560&maxW=1493&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=26ef9ce402133255e30d7e19a58a1ce4 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/add-token.png?w=840&maxW=1493&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=1d1bc0e3656e60e492456231eeb767d6 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/add-token.png?w=1100&maxW=1493&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=e065f7293d2db131c151bee722aaae63 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/add-token.png?w=1650&maxW=1493&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=1554878d8f2ca269409ca54217175372 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/add-token.png?w=2500&maxW=1493&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=234ae2f42e480441d11a38953bcb6363 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="设置令牌到期日期">
    设置令牌到期日期（或选择 “无限制”）、许可权限，选择所要生成令牌的用户，然后点击 “保存”

    <Frame>
            <img src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/save-token.png?maxW=1569&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=9d4d2e6b6771102b04028542c936e523" alt="save-token.png" width="1569" height="540" data-path="images/api-reference/unlocker/api_token/save-token.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/save-token.png?w=280&maxW=1569&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=cf610bf83fe9640edda84bd830ce7d0a 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/save-token.png?w=560&maxW=1569&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=d02c72bb27165eae8ac335cff34199b1 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/save-token.png?w=840&maxW=1569&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=56ae9df6b58f222dce7365fbc496b503 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/save-token.png?w=1100&maxW=1569&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=91ec0066e48e9e3203f6e8306b618dd1 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/save-token.png?w=1650&maxW=1569&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=bce46d5f1926e55028dfcc47ea4615cd 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/save-token.png?w=2500&maxW=1569&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=8779ec8b2515f21cc527793b1a2e1437 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="保存您的令牌">
    <Warning>
      您的令牌生成之后，务必将其保存，因其仅供一次性使用（仅限查看！）
    </Warning>

    <Frame>
            <img src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/new-api-token.png?maxW=559&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=9ea5cfc2114ffd5553589701ba717754" alt="new-api-token.png" width="559" height="340" data-path="images/api-reference/unlocker/api_token/new-api-token.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/new-api-token.png?w=280&maxW=559&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=6443e27f70476949a12081e57c3b4901 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/new-api-token.png?w=560&maxW=559&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=acfeecaa90036e1027158df2708ef2d7 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/new-api-token.png?w=840&maxW=559&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=4ad364236bc9a165136eaced1bb31a96 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/new-api-token.png?w=1100&maxW=559&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=33b4d144bd8dcccdd1a2004a9c093405 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/new-api-token.png?w=1650&maxW=559&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=734839d5018204759c0c40120d5d16f6 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/new-api-token.png?w=2500&maxW=559&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=9457403178157b8298fd6f8bd5f39f03 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>
</Steps>

<Tip>
  创建令牌之后，您将无法再次查看，但是，您仍然可以在任何时候对其刷新、更改其到期日期以及将其撤消。

  <Frame>
        <img src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/token-edit-buttons.png?maxW=601&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=abaf6db2e4b304ce0454a763a3793189" alt="token-edit-buttons.png" width="601" height="156" data-path="images/api-reference/unlocker/api_token/token-edit-buttons.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/token-edit-buttons.png?w=280&maxW=601&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=c1854e9d3616264818db5b9a3c19fb04 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/token-edit-buttons.png?w=560&maxW=601&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=f85267f923596c47da4746a51516add1 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/token-edit-buttons.png?w=840&maxW=601&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=db3dab1f82f23cf9d8d7bb6d11e225c8 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/token-edit-buttons.png?w=1100&maxW=601&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=bc219dc827ea50cdc6a1cc71c40b824a 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/token-edit-buttons.png?w=1650&maxW=601&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=5728a76b4fbf712ff1284b6574c579e8 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/api-reference/unlocker/api_token/token-edit-buttons.png?w=2500&maxW=601&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=9981b00fc732566fcd742fb1cdf9fa7e 2500w" data-optimize="true" data-opv="2" />
  </Frame>
</Tip>


# 计费
Source: https://docs.brightdata.com/cn/general/account/billing-and-pricing/billing



<Info>
  我们网站上发布的所有价格均为美元价格
</Info>

<AccordionGroup>
  <Accordion title="Bright Data 计费如何进行？">
    最低月度承诺 - 每个计划都要求您在账户处于 “活跃” 状态时承诺在每月初支付最低金额。此最低承诺将为您的基本使用量设定限制：一旦您的使用量超过最低承诺金额，您将需要额外增加资金才能继续使用我们的服务。

    <Note>
      [若要了解更多信息，请访问我们的定价页面。](https://brightdata.com/pricing).
    </Note>
  </Accordion>

  <Accordion title="如何重新验证我的账户以解决计费问题？">
    如果您的账户被冻结，您将立即收到一封电子邮件，说明如何解决相关问题。请发送电子邮件至 [compliance@brightdata.com](mailto:compliance@brightdata.com) 联系您的专属客户经理或 Bright Data 的合规团队。若要恢复您的冻结账户，您需要提供以下信息：

    <Tabs>
      <Tab title="注册公司">
        * 公司注册表
        * 标记的付款方式照片
      </Tab>

      <Tab title="非注册公司">
        * Photo ID, driver's license, or passport
        * 标记的付款方式照片
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="如果我只使用数据中心 IP，Bright Data 计费周期将如何运作？">
    当客户仅使用数据中心 IP 时，我们会每天计算其费用。 我们从您账户的当前余额中减去这笔每日费用，显示可供使用的剩余余额。 费用根据所使用的 IP 类型（共享与专用）以及使用的带宽/GB 计算。 我们还会计算新增功能（例如专属时间或专用域/主机）的任何额外费用。将在每月 1 日向您收取上述费用。您账户中的剩余余额将反映可供将来使用的金额。
  </Accordion>

  <Accordion title="Bright Data 计费周期如何运作？">
    Bright Data 的计费周期从每月的 1 日开始。这意味着，只要您的账户处于活跃状态，我们就会在每月 1 日自动向您收取月度账户承诺的费用。
  </Accordion>

  <Accordion title="如果我在计费周期中期（当月中旬）加入 Bright Data 会怎样？">
    如果您在月中加入 Bright Data，您的第一笔最低账户承诺付款将在您加入当天收取，使用量仅将追溯适用于当月账户的活跃日期。

    示例：您在 6 月 25 日加入 Bright Data 固定网络，您的价格计划的月度承诺最低为 500 美元，您的第一笔付款为 500 美元。

    7 月 1 日会怎样？

    * 我们的系统将看到您的账户在 6 月份仅活跃了 6 天，即当月的 20 ％，因此最低月度承诺的相对部分将为 100 美元。除非您的使用费用高于这个水平，否则您 6 月份的费用将是 100 美元。
    * 我们将向您发送发票，并从您的余额中扣除 100 美元，以抵消 6 月份的费用，您的余额则为 400 美元。
    * 由于在每月 1 日，您的余额需要符合您的最低月度承诺，因此我们现在将从您的信用卡中扣除 100 美元，以便将其充值至 500 美元，从而满足您 7 月份的最低月度承诺。
  </Accordion>

  <Accordion title="我是否会收到发票？">
    是。 每月 1 日，您将会收到发票。 发票将提供您上个月的使用详情。它将详细说明您的使用量与您的最低账户承诺金额（以及当月增加的任何额外资金（如果适用）的关系。
  </Accordion>

  <Accordion title="我的计费周期使用哪个时区？">
    所有账单计算均根据我们的控制面板时区（UTC+0）进行。 这会如何影响您的计费？ 您可以选择启用和禁用您的区域。 启用/禁用的时间将采用 UTC 时间，因此将相应地收取每日费用。
  </Accordion>

  <Accordion title="我不会每天使用 Bright Data，而是按每个项目使用。 我还需要支付全部最低月度承诺费用吗？">
    在您不使用我们服务的时段，您可以关闭您的区域。 服务计费仅适用于相关服务激活当月的相对部分。
    所有账单计算均根据我们的控制面板时区（UTC+0）进行。 这会如何影响您的计费？ 您可以选择启用和禁用您的区域。 启用/禁用的时间将采用 UTC 时间，因此将相应地收取每日费用。
  </Accordion>

  <Accordion title="如果我处理退款争议会怎样？">
    如果您处理信用卡退款或银行争议，且原因不合理，每次收费 Bright Data 都将收取 150 美元的手续费。
  </Accordion>

  <Accordion title="为什么我的账户因计费问题被冻结？">
    由于以下原因之一，账户会因计费问题而被冻结：

    * 付款方式和个人资料之间存在差异
    * 用户登录的国家/地区与信用卡所在的国家/地区不同
    * 处理被拒付款的尝试次数过多
    * 使用 3D Secure 对信用卡付款进行身份验证失败
  </Accordion>

  <Accordion title="如何将用户添加到发票收件人列表？">
    若要将电子邮件地址添加到发票收件人列表，请按以下指南操作

    <Steps>
      <Step title="点击控制面板侧栏上的 “计费” 按钮" />

      <Step title="点击顶部的 “更多... “按钮" />

      <Step title="在打开的菜单中，选择 “发票收件人”">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=09367e30af944caf167bf8a0ffc46829" alt="invoice_recipients_1.png" width="1832" height="971" data-path="images/general/account/management/invoice_recipients_1.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?w=280&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=1983cb5945ff947e6c286bc6f8ab99a8 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?w=560&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f54aaa54c041320ada6767706a1e7a5b 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?w=840&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d6a957e29daea06bbe7be8cb79aff3da 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?w=1100&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=80be0487679dc68b41c0737045dd1e9a 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?w=1650&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a8a35399b5b52f88a3d0eb8bf3ed2516 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?w=2500&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=4866ebbefac11eccf6b9a4a3b629e2ab 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>

      <Step title="在打开的 “发票收件人” 屏幕中，点击 “+ 添加新收件人” 按钮">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0d042c1ea0b4b8dc76fabe7320fe42ca" alt="invoice_recipients_2.png" width="1832" height="971" data-path="images/general/account/management/invoice_recipients_2.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?w=280&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=cb2082331db22e71f5a5a863e091e048 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?w=560&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f6786b1016e02063457c96a60e30b6ea 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?w=840&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2c90a1517e982e3e520ffd65c141875e 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?w=1100&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a1bf6f49b135c41d2560d9e014aa2378 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?w=1650&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=4972f48ab86a5e206659037950091f8f 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?w=2500&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d8969c06b36840e1fa5e88cb48d77e60 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>

      <Step title="添加姓名和电子邮件地址" />

      <Step title="点击 “添加” 按钮">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=acbf69c45c0a99e93befee928028833a" alt="invoice_recipients_3.png" width="1832" height="971" data-path="images/general/account/management/invoice_recipients_3.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?w=280&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=048c906142eb824ec76e688b4df60b3c 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?w=560&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=8f4cf055730c467654dc724263359282 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?w=840&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=868c04a24357978015f13017eebe5751 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?w=1100&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b850084212797f6a998b1423cc81d683 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?w=1650&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=363db4ee96f448d3790e8f5e92d0b63a 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?w=2500&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2bf2b5e12c030cbad5365c9c8aab618d 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="如果我的账户整月都未处于 “活跃” 状态怎么办？">
    如果您的余额在您处于不活跃状态的月份中有剩余资金，则不会损失余额，但将在下个月的第一天则会向您收取费用，以使余额达到最低月度承诺金额。

    <Frame>
            <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=461ba2fad1ade576a4b7636303201a38" alt="suspend-account.gif" width="1636" height="930" data-path="images/general/account/management/suspend-account.gif" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=280&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=ffacd4b65d0bc5d426e83604bed389d8 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=560&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=3671d8c5ac1587c00328d2b1bcc84551 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=840&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=fceba9b829928b927402d4afc8644830 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=1100&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=89cc585e58fbd3508922f8df031b9b74 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=1650&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=8628a80ddde18def9f86207fba43fe89 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=2500&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=9d6d2e3ea432805c6a3cf10ad622b2ec 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>

  <Accordion title="如何防止我的账户被暂停？">
    为确保您的账户永不被暂停，我们强烈建议您使用我们的自动充值选项。 它可以在您账户的 “计费” 部分中激活，以确保服务不中断。 当您的可用余额降至账户总余额的 85％ 以下时，自动充值开始生效。 设置的金额完全由您决定，可以是任何面额。

    <Frame>
            <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0679252187dcfcbbcb7ea6933ff224d3" alt="billing.png" width="1636" height="908" data-path="images/general/account/management/billing.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=280&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=74f77cfe2a0a1b803959f5c91ccf807a 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=560&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=275eefd9fbab4348f48a95acb827cf15 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=840&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a3b0159fb5f9796c846936da4c195c49 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=1100&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=85cac55acaa2cb75b10774b80bab38ed 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=1650&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=68cda9963a09fe6fadb8251c930a42b2 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=2500&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f9f5ac28559057e8bd37f68a7bce4ffc 2500w" data-optimize="true" data-opv="2" />
            <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2cb4c6f0fba79d02253bfc9de5752865" alt="payment-settings.png" width="1636" height="906" data-path="images/general/account/management/payment-settings.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=280&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=be1def4c17998b60ec90db3740a3313d 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=560&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=56277ebb81c6c579adbff893c6ed6be0 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=840&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f85bf08c6412d085c8a2cf3725fa637e 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=1100&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5decdee1951245ce50a78142d82c0a8e 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=1650&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7fbacafe6d64ac4640abf5c80fc88541 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=2500&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=48466fed40c5f77fad47c9b15dee0763 2500w" data-optimize="true" data-opv="2" />
            <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=05fe690214c08c8768ef61f47ce5f129" alt="confirm.png" width="1636" height="930" data-path="images/general/account/management/confirm.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=280&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=1ab229ead7204b277947e50dd95ee6d4 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=560&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f28e922cead5523d167721d41c5d0bd8 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=840&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=551aabe9e218d1d0cb3256a881ad649c 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=1100&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2156e393892f3251923cd07bc6c64c68 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=1650&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=66f6137d8aa5a5241e7e21737bbdc37c 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=2500&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=c8c0ab9aefd38282e9440be3cedd8df1 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>
</AccordionGroup>


# Bright 奖励计划简介
Source: https://docs.brightdata.com/cn/general/account/billing-and-pricing/bright-rewards-program



## 资格

Bright 奖励计划会员必须具备以下条件：

1. 已订阅我们的一款产品
2. 在过去 3 个月中积极使用我们的服务

## 赚取和兑换积分

成为符合条件的客户后，您即可根据所选计划开始赚取 Bright 积分。 根据奖励计划的条款和条件，您可以使用 Bright 积分购买 Bright Data 的服务。 您获得的 Bright 积分将显示在您的 CP 账单页面上。

<Frame>
    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/bright-rewards-program/earn-and-redeem-points.png?maxW=1254&auto=format&n=2RrKkArDJDw55ilE&q=85&s=29e1043ab424ddf3baf3a35a9653e032" alt="earn-and-redeem-points.png" width="1254" height="256" data-path="images/general/account/billing-and-pricing/bright-rewards-program/earn-and-redeem-points.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/bright-rewards-program/earn-and-redeem-points.png?w=280&maxW=1254&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5d03468ad368c1f492acc8a1b7674108 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/bright-rewards-program/earn-and-redeem-points.png?w=560&maxW=1254&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5eaff8b9ebdfebdc7a3d2c7537811a64 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/bright-rewards-program/earn-and-redeem-points.png?w=840&maxW=1254&auto=format&n=2RrKkArDJDw55ilE&q=85&s=19fd3326dd0d02285a5242cd1b0759b5 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/bright-rewards-program/earn-and-redeem-points.png?w=1100&maxW=1254&auto=format&n=2RrKkArDJDw55ilE&q=85&s=c49e3eb726d879501cf79fde8ec5a3dc 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/bright-rewards-program/earn-and-redeem-points.png?w=1650&maxW=1254&auto=format&n=2RrKkArDJDw55ilE&q=85&s=548f1e3f35df21fedfaa8e8aafe5672d 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/bright-rewards-program/earn-and-redeem-points.png?w=2500&maxW=1254&auto=format&n=2RrKkArDJDw55ilE&q=85&s=8bf8851c830d35573cd125c4e4d16b74 2500w" data-optimize="true" data-opv="2" />
</Frame>

## 有效期

根据奖励计划条款和条件中的规定，在忠诚度奖励计划中赚取的 Bright 积分具备有效期。 我们鼓励您在 Bright 积分到期之前进行兑换，以确保充分利用获得的奖励。


# 跟踪您的使用情况：成本浏览器
Source: https://docs.brightdata.com/cn/general/account/billing-and-pricing/costs-explorer

我们深知透明度和对数据使用及费用的控制至关重要。因此，我们推出了成本浏览器功能，这是一个强大的工具，可为您提供详细的使用统计信息和成本分析。

### 在哪里找到成本浏览器

您可以通过[此链接](https://brightdata.com/cp/billing/costs)访问成本浏览器。\
或者，您也可以在控制面板左侧的 **计费** 选项卡中轻松找到它。然后，查找标有 **"成本浏览器"** 的专属选项卡。

### 成本浏览器提供的功能

成本浏览器功能提供全面的使用统计数据，可按以下方式细分：每个产品、每个区域、费用类型等，涵盖您在所选时间段内每天或每小时的使用情况。您还可以查看 数据集 和 采集器 消耗资金的详细分布。数据支持 折线图、柱状图和表格 形式展示。

这使您能够准确查看资金的分配情况。

### 实时准确性

成本分析器中显示的所有信息都是准确的，并会实时更新。这确保您始终可以获取最新的数据。

### 自定义选项

成本浏览器提供丰富的自定义选项，允许您根据具体需求调整数据展示方式。无论您需要 **详细的使用分析** 还是 **整体概览**，成本浏览器都能满足您的需求。

### 可视化且用户友好

成本分析器中的数据以可视化、易读的格式呈现，使您能够一目了然地了解您的使用情况和成本。这些表格和图表还可以下载为 `.csv` 文件。

### 解答您的疑问

如果您对使用情况有任何疑问，或者想更好地理解您的账单，成本分析器就是您的最佳选择。它提供所有您需要的答案，是管理开支的重要工具。


# 常见问题解答
Source: https://docs.brightdata.com/cn/general/account/billing-and-pricing/faqs



<AccordionGroup>
  <Accordion title="Where can I find my credentials like host name, username and password?">
    Your credentials can be found in the "Overview" tab or your "Access parameters" tab.

    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="收费结构是否因国家/地区而异？">
    不会，所有国家/地区每 GB 都按相同的费率收费。
  </Accordion>

  <Accordion title="是否由于不同的域名，收取的费用有所不同？">
    某些域名需要特殊权限或产品。

    如果您不确定要将哪种产品用于您的用例，最好让您的专属客户经理或支持团队参加集成会议。
  </Accordion>

  <Accordion title="我可以限制我的每日使用量吗？">
    可以。

    在“区域”（Zone）页面的“使用量上限”列下，可以通过下列两种方式限制您的每日使用量：

    * 带宽（字节）
    * 花费（美元）

    达到每日使用量后，这一区域将自动暂停。

    <Frame>
            <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/cost-structure/limit-daily-usage.gif?maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=be56f810f1eab8bea9badfb96bd8ee22" alt="limit-daily-usage.gif" width="1636" height="930" data-path="images/general/account/billing-and-pricing/cost-structure/limit-daily-usage.gif" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/cost-structure/limit-daily-usage.gif?w=280&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=4e39c83c4e21fb8df3e54e08b58bbd1d 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/cost-structure/limit-daily-usage.gif?w=560&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b2d2d0dd8db3696efda2212f37d5ee42 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/cost-structure/limit-daily-usage.gif?w=840&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=028d59b763ed6f1b22a4466ea87d6575 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/cost-structure/limit-daily-usage.gif?w=1100&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=de8116411b8a445f3b33715b3d4897d9 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/cost-structure/limit-daily-usage.gif?w=1650&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=740adebd19027140e606e4cf978f5ed9 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/cost-structure/limit-daily-usage.gif?w=2500&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=31082164e1e7cea15eb726ad9f75a84a 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    <Tip>
      区域限制每 15 分钟计算一次，不会立即生效，因此区域的使用时间可能会超过其 15 分钟限制。
    </Tip>

    <Note>
      当负载较高时，统计计算可能会延迟。 要手动更新区域中的使用情况统计信息，请点击区域名称打开该区域，进入统计表，然后在所需日期附近按下 recalc 按钮。等到屏幕顶部的红色“正在加载...”通知消失，然后刷新页面。然后，统计数据将处于最新状态。
    </Note>
  </Accordion>

  <Accordion title="我可以在没有按月付费的情况下使用 Bright Data 吗？">
    绝对可以！

    您可以使用 Bright Data 数据中心、互联网服务提供商（ISP）、住宅和移动网络，无需按月付费。\
    仅需点击区域名称旁边的铅笔符号，然后将套餐调整为“即用即付”即可。

    <Note>
      如果 IP 类型是按 IP /专用类型或 GIP 付费，则将按分配给该区域的 IP 向您收费。
    </Note>
  </Accordion>

  <Accordion title="谁有资格获得免费试用？">
    Everyone who signs up to Bright Data automatically gets a free trial to.

    The free trial can be used for all Bright Data products.

    For additional details, see [here](https://docs.brightdata.com/cn/general/faqs#what-is-playground-mode).

    <Info> 以协助进行试用配置。</Info>
  </Accordion>

  <Accordion title="你们是否推出了高级定价计划？">
    是的，我们的数据中心和互联网服务提供商套餐涵盖无限的数据量。\
    <Info>请联系您的客户经理，获取每月无限流量套餐的有关信息</Info>
  </Accordion>

  <Accordion title="如何管理我的账单详情？">
    要管理您的账单详情，请访问 [https://brightdata.com/cp/billing/settings。](https://brightdata.com/cp/billing/settings。) 您可以在此处添加新的付款方式、删除现有付款方式、为账户设置主要付款方式，并设置余额提醒。
  </Accordion>
</AccordionGroup>


# 付款
Source: https://docs.brightdata.com/cn/general/account/billing-and-pricing/payment



<Info>
  我们网站上发布的所有价格均以美元为单位
</Info>

<AccordionGroup>
  <Accordion title="我需要在线登录才能存入预付款吗？">
    是的，我们会将预付款请求发送到您的电子邮箱，您可以在[账单页面](https://brightdata.com/cp/billing)完成该请求。
  </Accordion>

  <Accordion title="自动充值是如何运作的？">
    有两种付款计划供用户选择：

    <Tabs>
      <Tab title="每月充值">
        如果您不使用自动充值或决定将其关闭，您会在每月的1日被收取新月份的月费。如果您没有最低月费计划，而是使用即用即付计划，您的账户不会自动充值。
      </Tab>

      <Tab title="按预设金额充值">
        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="你们的付款验证流程是怎么样的？">
    Bright Data根据威慑、预防和打击恶意活动的原则，维持高合规标准，以确保我们的网络既能保护客户安全，又符合道德标准。 为此，我们要求您使用您的首选付款方式验证身份。 我们会进行预授权扣款，并向您送上5美元的额外奖励，以感谢您的帮助和合作。

    这些授权是为了让Bright Data可以确保卡是有效的，并检查您的账户是否有足够的资金进行购买。

    这些是授权请求，并非收费。您无需为授权付费。

    授权可能会在您的账户中保留1-14个工作日，具体取决于您的银行。 如果您在14个工作日后仍看到待处理的授权，请联系您的银行以获取更多信息。
  </Accordion>

  <Accordion title="我可以在我的Bright Data账户中开设多少个区域？">
    你可以在你的Bright Data账户中免费开设最多50个区域。 每个额外的区域收费每月5美元
  </Accordion>

  <Accordion title="Can I get a refund?">
    No - payments are non-refundable. See the [Master Service Agreement terms](https://docs.brightdata.com/cn/general/policy/license#consideration)
  </Accordion>
</AccordionGroup>


# 可接收的付款方式
Source: https://docs.brightdata.com/cn/general/account/billing-and-pricing/payment-methods



<Tabs>
  <Tab title="PayPal">
    <Steps>
      <Step title="转到账单页面">
        [账单页面](https://brightdata.com/cp/billing) > 点击添加付款方式。.
      </Step>

      <Step title="选择“PayPal”作为您的付款方式。">
        然后，您将被重定向到 PayPal 页面。
      </Step>
    </Steps>
  </Tab>

  <Tab title="支付宝">
    <Steps>
      <Step title="转到账单页面">
        [账单页面](https://brightdata.com/cp/billing) > 点击添加付款方式。
      </Step>

      <Step title="Select &#x22;支付宝&#x22; as your payment method.">
        然后，您将被重定向到支付宝页面。
      </Step>
    </Steps>
  </Tab>

  <Tab title="Payoneer">
    <Steps>
      <Step title="转到账单页面">
        [账单页面](https://brightdata.com/cp/billing) > 点击添加付款方式。
      </Step>

      <Step title="Select &#x22;Payoneer&#x22; as your payment method.">
        然后，您将被重定向到 Payoneer 页面。
      </Step>
    </Steps>
  </Tab>

  <Tab title="信用卡">
    <Steps>
      <Step title="转到账单页面">
        [账单页面](https://brightdata.com/cp/billing) > 点击添加付款方式。
      </Step>

      <Step title="Select &#x22;信用卡&#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="电汇">
    <Warning>
      电汇 payments are only available after a payment of \$5,000 is made.
    </Warning>

    <Steps>
      <Step title="转到账单页面">
        [账单页面](https://brightdata.com/cp/billing) > 点击添加付款方式。
      </Step>

      <Step title="Select &#x22;Other&#x22; as your payment method." />

      <Step title="Select the &#x22;电汇&#x22; option as your payment method.">
        Now you can click the "Add Balance" button and make a payment with 电汇.
      </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>


# 高级IP
Source: https://docs.brightdata.com/cn/general/account/billing-and-pricing/premium-ips



<AccordionGroup>
  <Accordion title="什么是高级IP？">
    高级IP是精心挑选的IP地址，选择的依据是其在各种数据中心和ISP代理网络中的卓越成功率和可靠性。 这些高级IP代表了抓取解决方案的巅峰，为访问电子商务、旅游和社交媒体顶级域名的用户提供无与伦比的性能和稳定性。
  </Accordion>

  <Accordion title="为什么要使用高级IP？">
    高级IP的高性能IP地址可确保智能路由。 使用高级IP可以显著提高抓取性能，您将享有更高的成功率和减低带宽费用等优势。
  </Accordion>

  <Accordion title="高级IP如何运作？">
    当您使用高级IP时，您的请求将通过已知成功率最高的IP地址进行无缝路由，这些IP都是最适合您的地理位置和域名需求的。

    只需在数据中心代理区域的配置中选择高级IP即可：

    <Frame>
            <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/datacenter/premium-ips.png?maxW=542&auto=format&n=JpbB64sgI_r6D502&q=85&s=0ec87981f4e6d85edbb37b04668b52ef" alt="" width="542" height="267" data-path="images/general/faqs/datacenter/premium-ips.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/datacenter/premium-ips.png?w=280&maxW=542&auto=format&n=JpbB64sgI_r6D502&q=85&s=39802803ffcce4a1f8fb2b2b7e4462e6 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/datacenter/premium-ips.png?w=560&maxW=542&auto=format&n=JpbB64sgI_r6D502&q=85&s=72101a63758d0c380fdfe0444bcaffd9 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/datacenter/premium-ips.png?w=840&maxW=542&auto=format&n=JpbB64sgI_r6D502&q=85&s=d02528298107d02fd907cc929cc1e334 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/datacenter/premium-ips.png?w=1100&maxW=542&auto=format&n=JpbB64sgI_r6D502&q=85&s=7c402379816f78e8b7bea37d16c64219 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/datacenter/premium-ips.png?w=1650&maxW=542&auto=format&n=JpbB64sgI_r6D502&q=85&s=2c4b389dac6b8f9d019eb957bf01b84c 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/datacenter/premium-ips.png?w=2500&maxW=542&auto=format&n=JpbB64sgI_r6D502&q=85&s=cc20777e121defe540333180eab5d8b3 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>
</AccordionGroup>


# Bright Data 促销代码
Source: https://docs.brightdata.com/cn/general/account/billing-and-pricing/promo-codes



Bright Data 提供促销代码，可帮助您节省订阅计划的费用。通过应用促销代码，您可以在特定产品或服务上获得专属折扣。本指南将向您介绍有关促销代码的所有信息。

## 如何应用促销代码

要将促销代码应用到您的订阅计划，请按照以下步骤操作：

### 步骤 1. 前往“计费”页面

<Steps>
  <Step title="访问 Bright Data 网站">
    访问 [Bright Data](https://brightdata.com/cp/start) 页面并登录您的账户。
  </Step>

  <Step title="进入 &#x22;计费&#x22; 页面">
    在左侧导航栏中点击 [计费](https://brightdata.com/cp/billing) 页面。

    <Frame>
            <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/billing-button.png?maxW=1918&auto=format&n=2RrKkArDJDw55ilE&q=85&s=cadc29f2c1e79ce1de62f75de5c6de5e" alt="billing-button" width="1918" height="911" data-path="images/general/account/billing-and-pricing/promo-codes/billing-button.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/billing-button.png?w=280&maxW=1918&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b1fa062d2bd8a5e51cd7186132a1df35 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/billing-button.png?w=560&maxW=1918&auto=format&n=2RrKkArDJDw55ilE&q=85&s=ca84608e952839da96607da2eb55bc8b 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/billing-button.png?w=840&maxW=1918&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d39cdadfbb19c14b78af185031b02c96 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/billing-button.png?w=1100&maxW=1918&auto=format&n=2RrKkArDJDw55ilE&q=85&s=75c25265e0111fef4d1f8668477c8743 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/billing-button.png?w=1650&maxW=1918&auto=format&n=2RrKkArDJDw55ilE&q=85&s=39dd5d4be1326d376788c19a11d814b1 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/billing-button.png?w=2500&maxW=1918&auto=format&n=2RrKkArDJDw55ilE&q=85&s=87bbc1e74445ed4c4a413180a5f8468e 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>
</Steps>

### 步骤 2. 应用促销代码

您可以通过以下两种方式之一应用促销代码：

<Tabs>
  <Tab title="按量付费计划">
    <Steps>
      <Step title="点击 &#x22;应用促销代码&#x22;">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/click-on-apply-promo-code.png?maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f398aebb339181ebdca63d9bd982240b" alt="click-on-apply-promo-code" width="3400" height="1708" data-path="images/general/account/billing-and-pricing/promo-codes/click-on-apply-promo-code.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/click-on-apply-promo-code.png?w=280&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=c145858d88881e0f1697de82890e7e7e 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/click-on-apply-promo-code.png?w=560&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b11297a46daa545fed8af4bb293c31a4 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/click-on-apply-promo-code.png?w=840&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=1ba64aea7f03341f07519ca475a5b9ae 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/click-on-apply-promo-code.png?w=1100&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5ea40867ab82a425ea4c7c7b69e88074 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/click-on-apply-promo-code.png?w=1650&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=95b0334d11038627e285ce6f2501d7c9 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/click-on-apply-promo-code.png?w=2500&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=62dae6f153c6612f311ae6b5067f1f84 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>

      <Step title="输入促销代码">
        要激活促销，请在“输入促销代码”字段中输入您的代码，然后点击“应用”。

        <Frame>
                    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/enter-promo-code.png?maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5ed6dc87835e13103858b75cc2c8cd8f" alt="enter-promo-code" width="3400" height="1708" data-path="images/general/account/billing-and-pricing/promo-codes/enter-promo-code.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/enter-promo-code.png?w=280&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=70113e8c1c2572baec7c557a3a7491cd 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/enter-promo-code.png?w=560&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=fd7064eec13daae5fbed76f604f8348c 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/enter-promo-code.png?w=840&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=c077e91aa1b931ed04bc86086c5cece3 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/enter-promo-code.png?w=1100&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=46f356a515ae5533833882c250ade846 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/enter-promo-code.png?w=1650&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=753e82277114d795d2c162c1ac16cb80 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/enter-promo-code.png?w=2500&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b0b38d114461c5e43a156db383780878 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>

      <Step title="恭喜 🎉">
        您已成功激活促销代码，新的折扣价格已应用到您的计划中。

        <Frame>
                    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-promo-added.png?maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=bb1db87b6a763b0e48533ba79e6873f8" alt="payg-promo-added.png" width="3400" height="1708" data-path="images/general/account/billing-and-pricing/promo-codes/payg-promo-added.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-promo-added.png?w=280&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=21cf8078bfbfb409cd557d835739c182 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-promo-added.png?w=560&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=12d8c4915fbb4acf576c6a67f6e51a8f 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-promo-added.png?w=840&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=bf922fb888e2624cb7dfdff8c8e1afc7 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-promo-added.png?w=1100&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d9fb67ed453c6d4f567f7a908c6bb1de 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-promo-added.png?w=1650&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=85ac18b6e465fd61be21d84d61a3300c 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-promo-added.png?w=2500&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=14b7c1325767fd763ad68cfee8895286 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>

      <Step title="查看更新后的价格">
        您可以通过进入“计费”页面的“概览”选项卡，在“您的产品” > “所有产品”下查看相关产品的折扣价格。或者，您可以直接打开一个区域并开始使用！

        <Frame>
                    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-confirm-discount.png?maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f9a9eddd2dfe4a1f67d676bd4a095d3b" alt="payg-confirm-discount" width="3400" height="1708" data-path="images/general/account/billing-and-pricing/promo-codes/payg-confirm-discount.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-confirm-discount.png?w=280&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=72f2ad6fd6c2b363ea867307c412b9fd 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-confirm-discount.png?w=560&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=156e0165d9bceb7a62ea3e74d3e86647 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-confirm-discount.png?w=840&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a74244a0835d825337b3b5d5f3ee0ffb 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-confirm-discount.png?w=1100&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0cf12204c0cba12d08ab1254a8552794 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-confirm-discount.png?w=1650&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=060fd17820243d8d3586ab8650b15ad7 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-confirm-discount.png?w=2500&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=65a24683d7a5adb9175a326811b89301 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="订阅计划">
    <Steps>
      <Step title="点击 &#x22;更改计划&#x22;">
        在 [概览](https://brightdata.com/cp/billing/overview) 选项卡中，点击 [更改计划](https://brightdata.com/cp/pricing_packages) 按钮。

        <Frame>
                    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/change-plan.png?maxW=1564&auto=format&n=2RrKkArDJDw55ilE&q=85&s=597815599a55f790a694baf952816fd5" alt="change-plan" width="1564" height="837" data-path="images/general/account/billing-and-pricing/promo-codes/change-plan.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/change-plan.png?w=280&maxW=1564&auto=format&n=2RrKkArDJDw55ilE&q=85&s=89ed7bc56f67743ef9452b7680c2d94e 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/change-plan.png?w=560&maxW=1564&auto=format&n=2RrKkArDJDw55ilE&q=85&s=cfef64321dae8b311804d95f49c73353 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/change-plan.png?w=840&maxW=1564&auto=format&n=2RrKkArDJDw55ilE&q=85&s=80413a3fc5036a2198e0e8347770f80c 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/change-plan.png?w=1100&maxW=1564&auto=format&n=2RrKkArDJDw55ilE&q=85&s=23bc23aa16a4d645a2bf84bae1390e7c 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/change-plan.png?w=1650&maxW=1564&auto=format&n=2RrKkArDJDw55ilE&q=85&s=c32f026b14ab39a73940635d5cefb640 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/change-plan.png?w=2500&maxW=1564&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7254fcc54540b8d0b41fd942703e5412 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>

      <Step title="选择订阅">
        选择您想要的订阅计划，然后点击“升级”按钮。

        <Frame>
                    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/subscription-plans.png?maxW=1183&auto=format&n=2RrKkArDJDw55ilE&q=85&s=68290db47b72db2a7dc4fd8d718ae9b0" alt="subscription-plans" width="1183" height="849" data-path="images/general/account/billing-and-pricing/promo-codes/subscription-plans.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/subscription-plans.png?w=280&maxW=1183&auto=format&n=2RrKkArDJDw55ilE&q=85&s=4f48b02eac9532d375d396cf19d5ebc6 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/subscription-plans.png?w=560&maxW=1183&auto=format&n=2RrKkArDJDw55ilE&q=85&s=e9e07a89df85cc3dbe13dcc1c32ad009 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/subscription-plans.png?w=840&maxW=1183&auto=format&n=2RrKkArDJDw55ilE&q=85&s=049d28e8bfa42a104f13453b35bf9794 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/subscription-plans.png?w=1100&maxW=1183&auto=format&n=2RrKkArDJDw55ilE&q=85&s=4626e42d48ddd89692784d0eda08544c 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/subscription-plans.png?w=1650&maxW=1183&auto=format&n=2RrKkArDJDw55ilE&q=85&s=14d54a05f325c27c37cfab202dd14b6a 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/subscription-plans.png?w=2500&maxW=1183&auto=format&n=2RrKkArDJDw55ilE&q=85&s=33d27948a98e5b12aef884a5ee1e6fc1 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>

      <Step title="输入促销代码">
        要激活促销，请在“输入促销代码”字段中输入您的代码，然后点击“应用”。当您看到促销代码有效的确认信息后，点击“支付 & 确认升级”。

        <Frame>
                    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/apply-promo-code.png?maxW=1095&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a98b44b79374b40445523adbbd652fe3" alt="apply-promo-code" width="1095" height="699" data-path="images/general/account/billing-and-pricing/promo-codes/apply-promo-code.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/apply-promo-code.png?w=280&maxW=1095&auto=format&n=2RrKkArDJDw55ilE&q=85&s=e8b9287a0b2de53b5b132713dae10aaf 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/apply-promo-code.png?w=560&maxW=1095&auto=format&n=2RrKkArDJDw55ilE&q=85&s=ae2a85f6c1097fb21b32b726e96009ee 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/apply-promo-code.png?w=840&maxW=1095&auto=format&n=2RrKkArDJDw55ilE&q=85&s=8eed4b2bed9a972b01f25b5a76827797 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/apply-promo-code.png?w=1100&maxW=1095&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b770928744d2fdd89a0923665c1bac9c 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/apply-promo-code.png?w=1650&maxW=1095&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0d426b64c09b4b1c7b3d1ad13a676f17 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/apply-promo-code.png?w=2500&maxW=1095&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5f1dd8743e28cfdbc27f9138556f4b37 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>

      <Step title="恭喜 🎉">
        您已成功激活促销代码，新的折扣价格已应用到您的计划中。

        <Frame>
                    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-promo-added.png?maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=74643cb19fe2612ff11a61dc984ec515" alt="sub-promo-added.png" width="3400" height="1708" data-path="images/general/account/billing-and-pricing/promo-codes/sub-promo-added.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-promo-added.png?w=280&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f02f6f0d6b7a36537c0b06d5a747b3b6 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-promo-added.png?w=560&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=e393e7f91309d888fc9c00cfc09f4843 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-promo-added.png?w=840&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=eef3682ad9335538aa6bdcb75ae8504a 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-promo-added.png?w=1100&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2095f9e5e7ae9668f9a20edac4ae0997 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-promo-added.png?w=1650&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=3a2439719d4feee8e52f8ba2cf201009 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-promo-added.png?w=2500&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d927a0ebe03ece8368ca0345e5780dbc 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>

      <Step title="查看更新后的价格">
        您可以通过进入“计费”页面的“概览”选项卡，在“您的产品” > “所有产品”下查看相关产品的折扣价格。或者，您可以直接打开一个区域并开始使用！

        <Frame>
                    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-confirm-discount.png?maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0c916fe5546ab894a17f09ac42e6e40d" alt="sub-confirm-discount" width="3400" height="1708" data-path="images/general/account/billing-and-pricing/promo-codes/sub-confirm-discount.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-confirm-discount.png?w=280&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=ff6b21579efdd7c71260eae9f78dc273 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-confirm-discount.png?w=560&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a4a3d3d0adcad2a4233b4da46ec0bef0 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-confirm-discount.png?w=840&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=ee2208988c734df272ae53d12d17f332 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-confirm-discount.png?w=1100&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a1a0989c388ee60723577317dfd932f4 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-confirm-discount.png?w=1650&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=97389e9d30f0789f7483cbd0864da686 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-confirm-discount.png?w=2500&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0b72da3b22c8e89c945a757c9f22d9b4 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>
    </Steps>
  </Tab>
</Tabs>

## 常见问题

<AccordionGroup>
  <Accordion title="促销代码可以与‘首笔存款等额匹配’促销活动一起使用吗？">
    是的，您可以同时使用促销代码和首笔存款等额匹配促销。

    促销代码将直接应用到您的订阅计划，减少您的计划费用。此外，当您向账户进行首次存款时，我们将匹配您的存款金额，最高可达 \$500。

    <Note>等额匹配存款优惠仅适用于首次存款。</Note>
  </Accordion>
</AccordionGroup>


# 账户管理
Source: https://docs.brightdata.com/cn/general/account/management



<AccordionGroup>
  <Accordion title="如何重新验证我的账户以解决账单问题？">
    如果您的账户被冻结，您将立即收到一封电子邮件，说明如何解决这一问题。 请通过 [compliance@brightdata.com](mailto:compliance@brightdata.com)联系您的专属客户经理或 Bright Data 的合规团队。
    . 要恢复您的冻结账户，需要提供以下信息：

    <Tabs>
      <Tab title="注册公司">
        * 公司注册表
        * 已标记的付款方式照片
      </Tab>

      <Tab title="非注册公司">
        * Photo ID, driver's license, or passport
        * 已标记的付款方式照片
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="为什么我的账户因账单问题而被冻结？">
    账号因账单问题而被冻结，是出于以下某一项原因：

    * 付款方式和个人详细信息不匹配
    * 用户登录的国家/地区与信用卡所在的国家/地区不同
    * 处理拒付的尝试次数过多
    * 未能使用 3D secure 对信用卡付款进行身份验证
  </Accordion>

  <Accordion title="如何为我的账户设置密码？">
    * 请访问 [https://brightdata.com/cp/setting/auth。](https://brightdata.com/cp/setting/auth。)
    * 在“设置密码”部分，输入所需的密码。
    * 确保您的密码包含数字、大写和小写字母，以及至少一个特殊字符。
    * 重新输入密码以确认您的密码。
    * 点击“保存密码”。
    * 如果出现提示，请输入您的 2FA 代码以验证操作。
  </Accordion>

  <Accordion title="如何将用户添加到发票收件人列表？">
    要将电子邮件地址添加到发票收件人列表中，请遵循以下指导

    <Steps>
      <Step title="点击“控制面板”侧栏上的“账单”按钮" />

      <Step title="点击顶部“更多...”按钮" />

      <Step title="在打开的菜单中，选择“发票收件人”">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=09367e30af944caf167bf8a0ffc46829" alt="invoice_recipients_1.png" width="1832" height="971" data-path="images/general/account/management/invoice_recipients_1.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?w=280&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=1983cb5945ff947e6c286bc6f8ab99a8 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?w=560&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f54aaa54c041320ada6767706a1e7a5b 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?w=840&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d6a957e29daea06bbe7be8cb79aff3da 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?w=1100&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=80be0487679dc68b41c0737045dd1e9a 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?w=1650&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a8a35399b5b52f88a3d0eb8bf3ed2516 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?w=2500&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=4866ebbefac11eccf6b9a4a3b629e2ab 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>

      <Step title="在打开的“发票收件人”屏幕中，点击“+ 添加新收件人”按钮">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0d042c1ea0b4b8dc76fabe7320fe42ca" alt="invoice_recipients_2.png" width="1832" height="971" data-path="images/general/account/management/invoice_recipients_2.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?w=280&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=cb2082331db22e71f5a5a863e091e048 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?w=560&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f6786b1016e02063457c96a60e30b6ea 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?w=840&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2c90a1517e982e3e520ffd65c141875e 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?w=1100&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a1bf6f49b135c41d2560d9e014aa2378 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?w=1650&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=4972f48ab86a5e206659037950091f8f 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?w=2500&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d8969c06b36840e1fa5e88cb48d77e60 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>

      <Step title="添加姓名和电子邮件地址" />

      <Step title="点击“添加”按钮">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=acbf69c45c0a99e93befee928028833a" alt="invoice_recipients_3.png" width="1832" height="971" data-path="images/general/account/management/invoice_recipients_3.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?w=280&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=048c906142eb824ec76e688b4df60b3c 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?w=560&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=8f4cf055730c467654dc724263359282 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?w=840&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=868c04a24357978015f13017eebe5751 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?w=1100&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b850084212797f6a998b1423cc81d683 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?w=1650&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=363db4ee96f448d3790e8f5e92d0b63a 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?w=2500&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2bf2b5e12c030cbad5365c9c8aab618d 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="如果我的账户整月都未处于“活跃”状态怎么办？">
    如果您在处于不活跃状态的月份中，您的余额中有剩余资金，则不会损失余额，但将在下个月的第一天向您收取费用，以使该余额达到最低月度承诺金额。

    <Frame>
            <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=461ba2fad1ade576a4b7636303201a38" alt="suspend-account.gif" width="1636" height="930" data-path="images/general/account/management/suspend-account.gif" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=280&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=ffacd4b65d0bc5d426e83604bed389d8 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=560&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=3671d8c5ac1587c00328d2b1bcc84551 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=840&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=fceba9b829928b927402d4afc8644830 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=1100&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=89cc585e58fbd3508922f8df031b9b74 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=1650&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=8628a80ddde18def9f86207fba43fe89 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=2500&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=9d6d2e3ea432805c6a3cf10ad622b2ec 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>

  <Accordion title="如何防止我的账户被关停？">
    为确保您的账户永不被关停，我们强烈建议您使用我们的自动充值选项。 可以在您的账户的“账单”部分中激活这一选项，以确保服务不会中断。 当您的可用余额降至账户总余额的 85％ 以下时，自动充值开始生效。 设置的金额完全由您决定，可以是任何面额。 You can find the auto recharge section [here](https://brightdata.com/cp/billing/settings).

    <Frame>
            <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0679252187dcfcbbcb7ea6933ff224d3" alt="billing.png" width="1636" height="908" data-path="images/general/account/management/billing.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=280&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=74f77cfe2a0a1b803959f5c91ccf807a 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=560&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=275eefd9fbab4348f48a95acb827cf15 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=840&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a3b0159fb5f9796c846936da4c195c49 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=1100&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=85cac55acaa2cb75b10774b80bab38ed 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=1650&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=68cda9963a09fe6fadb8251c930a42b2 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=2500&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f9f5ac28559057e8bd37f68a7bce4ffc 2500w" data-optimize="true" data-opv="2" />
            <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2cb4c6f0fba79d02253bfc9de5752865" alt="payment-settings.png" width="1636" height="906" data-path="images/general/account/management/payment-settings.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=280&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=be1def4c17998b60ec90db3740a3313d 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=560&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=56277ebb81c6c579adbff893c6ed6be0 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=840&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f85bf08c6412d085c8a2cf3725fa637e 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=1100&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5decdee1951245ce50a78142d82c0a8e 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=1650&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7fbacafe6d64ac4640abf5c80fc88541 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=2500&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=48466fed40c5f77fad47c9b15dee0763 2500w" data-optimize="true" data-opv="2" />
            <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=05fe690214c08c8768ef61f47ce5f129" alt="confirm.png" width="1636" height="930" data-path="images/general/account/management/confirm.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=280&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=1ab229ead7204b277947e50dd95ee6d4 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=560&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f28e922cead5523d167721d41c5d0bd8 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=840&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=551aabe9e218d1d0cb3256a881ad649c 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=1100&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2156e393892f3251923cd07bc6c64c68 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=1650&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=66f6137d8aa5a5241e7e21737bbdc37c 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=2500&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=c8c0ab9aefd38282e9440be3cedd8df1 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>
</AccordionGroup>


# 推荐计划
Source: https://docs.brightdata.com/cn/general/account/referral-program

Bright Data 的推荐计划为您提供了一种简单的方式，通过向他人推荐我们的平台来赚取奖励。无论是向同事介绍，还是向企业推荐 Bright Data，您都可以从您带来的每位客户的收入中获得最高 50% 的分成。本指南将介绍该计划的运作方式、与联盟计划的区别，以及如何立即开始赚取收益。

Bright Data 的推荐计划为您提供了一种简单的方式，通过向他人推荐我们的平台来赚取奖励。以下是该计划的运作方式：

1. **分享您的推荐链接**：加入推荐计划后，您将获得一个专属推荐链接。分享此链接给可能受益于 Bright Data 服务的个人或企业。

2. **赚取佣金**：当有人通过您的链接注册并订阅付费计划时，您将获得佣金。具体而言，您可以获得 50% 的收入分成，每位客户最高可达 \$2,500。

3. **获取账户积分**：或者，您可以选择将奖励以 Bright Data 账户积分的形式领取，并在此选项下额外获得 5% 的奖励。

### 常见问题

* **Bright Data 的推荐计划如何运作？**\
  通过我们的推荐计划，您可以通过分享 Bright Data 赚取奖励。分享您的专属推荐链接后，当被推荐用户注册并消费 \$100 时，您将获得 \$100 账户积分。此外，您还可以获得 50% 的收入分成，每位客户最高可达 \$2,500。

* **我在哪里可以找到我的推荐代码？**\
  注册推荐计划后，您的专属推荐代码将在您的账户仪表板中显示。您可以复制并分享给潜在的 Bright Data 用户。

* **如何通过推荐计划赚钱？**\
  您可以通过以下两种方式赚钱：

  * 当被推荐用户消费 \$100 时，您将获得 \$100 账户积分。
  * 通过 50% 的收入分成，每位客户最高可赚取 \$2,500。

* **我可以追踪我的推荐收益吗？**\
  是的，您可以在 Bright Data 账户仪表板中监控您的推荐进度和收益。

欲了解更多信息或加入推荐计划，请访问我们的[推荐计划页面](https://brightdata.com/referral/)。

**推荐计划 vs. 联盟计划 – 有何区别？**
如果您想知道推荐计划与 Bright Data 的联盟计划是否相同，答案是否定的。主要区别如下：

* **推荐计划**：适合现有用户，向同事、朋友或企业推荐 Bright Data。您可以通过直接邀请他人注册来赚取奖励。
* **联盟计划**：更适合营销人员、博主和影响者，通过内容、广告或网站向更广泛的受众推广 Bright Data。

如果您对联盟计划感兴趣，[点击此处了解更多](https://brightdata.com/affiliate)。


# SSL 证书
Source: https://docs.brightdata.com/cn/general/account/ssl-certificate



The SSL certificate allows you to establish end-to-end encrypted connections when using [Residential Proxies](https://docs.brightdata.com/cn/proxy-networks/residential/introduction), the [Unlocker API](https://docs.brightdata.com/cn/scraping-automation/web-unlocker/introduction) or the [SERP API](https://docs.brightdata.com/cn/scraping-automation/serp-api/introduction).

如果您只是进行初步测试，也可以不使用 SSL 证书，稍后再使用。

使用 SSL 证书非常简单。 只需下载证书并选择在环境中的使用方式。

## 下载 SSL 证书

1. **右键**单击此[链接上的](https://brightdata.com/static/brightdata_proxy_ca.zip)将该文件“另存为”到您的硬盘中。
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.

## 在代码中使用 SSL 证书

如果您编写抓取代码，在大多数情况下，您无需在环境中安装 SSL 证书。 只需在代码中加载 SSL 证书即可。 例如，对于 CURL：

```sh
curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<account-id>-zone-<zone-name>:<zone-password> --cacert <PATH TO CA.CRT> "https://geo.brdtest.com/mygeo.json"
```

具体语法可参考仪表板中的 Bright Data 示例代码。

## 安装 SSL 证书

在某些情况下，例如使用某些不允许从硬盘加载证书的第三方工具时，您仍需要在计算机上安装 SSL 证书。

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

### Installation instructions

这只需要 2 分钟，只需按照以下说明操作即可：

<Tabs>
  <Tab title="Windows">
    * 如果您还没有这样做，请右键单击此链接，将文件“另存为”到您的硬盘中: [https://brightdata.com/static/brightdata\_proxy\_ca.zip](https://brightdata.com/static/brightdata_proxy_ca.zip)
    * 双击 ca.crt 文件
    * 按照 Windows 的说明安装证书。
    * 重启电脑
    * 重启，您就可以连接到所需的 Bright Data 产品（住宅代理、Unlocker API 或 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 src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/browser-settings.png?maxW=328&auto=format&n=JpbB64sgI_r6D502&q=85&s=791cc2c607d3d13c7464010a67f40bc0" alt="browser-settings.png" width="328" height="639" data-path="images/general/faqs/proxy-networks/browser-settings.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/browser-settings.png?w=280&maxW=328&auto=format&n=JpbB64sgI_r6D502&q=85&s=da13be814c7f4a6ac8acd9035b00189f 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/browser-settings.png?w=560&maxW=328&auto=format&n=JpbB64sgI_r6D502&q=85&s=a129f5a9b8982f68482257e0f258cf8f 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/browser-settings.png?w=840&maxW=328&auto=format&n=JpbB64sgI_r6D502&q=85&s=11ecb004af0076e9e9987c4aef356070 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/browser-settings.png?w=1100&maxW=328&auto=format&n=JpbB64sgI_r6D502&q=85&s=8a67f1905b1e9ce68c795b1983ddbb63 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/browser-settings.png?w=1650&maxW=328&auto=format&n=JpbB64sgI_r6D502&q=85&s=c6373e1dced8b9a7954b6b9149b0ee51 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/browser-settings.png?w=2500&maxW=328&auto=format&n=JpbB64sgI_r6D502&q=85&s=896bd65b7fa149f106c3e86b5c67f34f 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="Go to 隐私 and security and click on 安全">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/privacy-and-security.png?maxW=1369&auto=format&n=JpbB64sgI_r6D502&q=85&s=97f690f3c265a5b1acb968aeaf63d45b" alt="privacy-and-security.png" width="1369" height="707" data-path="images/general/faqs/proxy-networks/privacy-and-security.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/privacy-and-security.png?w=280&maxW=1369&auto=format&n=JpbB64sgI_r6D502&q=85&s=644e0ec062a92e20d05e07b5f676a620 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/privacy-and-security.png?w=560&maxW=1369&auto=format&n=JpbB64sgI_r6D502&q=85&s=cef7b3e3c88331e2e5c09e3dc0fb000b 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/privacy-and-security.png?w=840&maxW=1369&auto=format&n=JpbB64sgI_r6D502&q=85&s=0973ec2531a5b696aae58fe152730f80 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/privacy-and-security.png?w=1100&maxW=1369&auto=format&n=JpbB64sgI_r6D502&q=85&s=d4e6569f3d55422abf1e6be38e40afaa 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/privacy-and-security.png?w=1650&maxW=1369&auto=format&n=JpbB64sgI_r6D502&q=85&s=d6928e3944cef242b058b24868daf303 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/privacy-and-security.png?w=2500&maxW=1369&auto=format&n=JpbB64sgI_r6D502&q=85&s=a10e6bad30a3d894ab89940388dcfd80 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="Scroll down and click on Manage certificate">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/manage-certificate.png?maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=da9136a6d648f19f3c9c2fc024f3415e" alt="manage-certificate.png" width="1343" height="861" data-path="images/general/faqs/proxy-networks/manage-certificate.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/manage-certificate.png?w=280&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=ebdce8d69ec188e2ed4507c6e03b0055 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/manage-certificate.png?w=560&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=c006b980541d9d75dfed1081df21a50d 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/manage-certificate.png?w=840&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=b4cac3dd309b09e60704021a28f86ac2 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/manage-certificate.png?w=1100&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=f2f747af84f03f6ecef0d3d96406b072 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/manage-certificate.png?w=1650&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=41546fee949a249aaccdabd90c15b342 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/manage-certificate.png?w=2500&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=0406d41abf99fb60312a12005b095ab9 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="Go to Trusted Certification Authorities and click Import">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-certification-authorities.png?maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=ab0a662c80162697e0988842acd4351a" alt="trusted-certification-authorities.png" width="1343" height="861" data-path="images/general/faqs/proxy-networks/trusted-certification-authorities.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-certification-authorities.png?w=280&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=7ca0d49f5b9001e05016f7a3ce7e0bc4 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-certification-authorities.png?w=560&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=2105a367cfd0b693ce93945eeb956f4d 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-certification-authorities.png?w=840&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=2f1ec81b7f93534adac69b4a4f9d2c24 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-certification-authorities.png?w=1100&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=91f1e1ad49f8782cd0a87eaf100c10a4 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-certification-authorities.png?w=1650&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=e034b275b06d1299e368d5681abd7805 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-certification-authorities.png?w=2500&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=8b308a5a086c744f352c948915f6deb9 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="Click on Next">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-next.png?maxW=553&auto=format&n=JpbB64sgI_r6D502&q=85&s=a9f53ab37b9dc202212a04e2e9030cd9" alt="click-next.png" width="553" height="532" data-path="images/general/faqs/proxy-networks/click-next.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-next.png?w=280&maxW=553&auto=format&n=JpbB64sgI_r6D502&q=85&s=fb76e6c3b9a8982728e4b5699dee7b69 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-next.png?w=560&maxW=553&auto=format&n=JpbB64sgI_r6D502&q=85&s=f212b587109e40d7032a7dba5a877631 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-next.png?w=840&maxW=553&auto=format&n=JpbB64sgI_r6D502&q=85&s=46c867b652531473aac6c2820ea17bb8 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-next.png?w=1100&maxW=553&auto=format&n=JpbB64sgI_r6D502&q=85&s=5fc698a062b6ab6854dd79aab5b4b4be 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-next.png?w=1650&maxW=553&auto=format&n=JpbB64sgI_r6D502&q=85&s=b8fd509f8b98a2f7b0b01480a1fdad1e 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-next.png?w=2500&maxW=553&auto=format&n=JpbB64sgI_r6D502&q=85&s=37e9b04a20bba1f232923f00596c340d 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="Click Browse and select the certificate you just downloaded, and click Next">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-browse.png?maxW=562&auto=format&n=JpbB64sgI_r6D502&q=85&s=5330686f6d054f65065c4be2cdfc9ab0" alt="click-browse.png" width="562" height="545" data-path="images/general/faqs/proxy-networks/click-browse.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-browse.png?w=280&maxW=562&auto=format&n=JpbB64sgI_r6D502&q=85&s=f7e03faa14f92d14e278f7b90f7e92a9 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-browse.png?w=560&maxW=562&auto=format&n=JpbB64sgI_r6D502&q=85&s=0126983fff8924b669995a1175c138e2 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-browse.png?w=840&maxW=562&auto=format&n=JpbB64sgI_r6D502&q=85&s=3a960c899b1b3359b87ae4b6c0696f6b 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-browse.png?w=1100&maxW=562&auto=format&n=JpbB64sgI_r6D502&q=85&s=311d5c3b8b925be7e862e44a53e26073 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-browse.png?w=1650&maxW=562&auto=format&n=JpbB64sgI_r6D502&q=85&s=4aa11d3ce811ec01cf88ec4491ee4a11 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-browse.png?w=2500&maxW=562&auto=format&n=JpbB64sgI_r6D502&q=85&s=6a4aaf09034242ced058b9e74cf0a8f7 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="Select &#x22;Place all certificates in the following store&#x22; and click Next">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/place-all-certificates.png?maxW=556&auto=format&n=JpbB64sgI_r6D502&q=85&s=e6449d7344f1cf708cbdc330ca1adf57" alt="place-all-certificates.png" width="556" height="537" data-path="images/general/faqs/proxy-networks/place-all-certificates.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/place-all-certificates.png?w=280&maxW=556&auto=format&n=JpbB64sgI_r6D502&q=85&s=298a1a0ac77519bed737312ae5ae752f 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/place-all-certificates.png?w=560&maxW=556&auto=format&n=JpbB64sgI_r6D502&q=85&s=e2a67c5f0ba88ee103b362e6fa56e9dd 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/place-all-certificates.png?w=840&maxW=556&auto=format&n=JpbB64sgI_r6D502&q=85&s=62307d9e73281f5447161ca657f9aa23 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/place-all-certificates.png?w=1100&maxW=556&auto=format&n=JpbB64sgI_r6D502&q=85&s=b646d7e9eda18f7e2efa77a762a575da 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/place-all-certificates.png?w=1650&maxW=556&auto=format&n=JpbB64sgI_r6D502&q=85&s=0bef55d69e75134d8aa2b6d7b66e2e59 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/place-all-certificates.png?w=2500&maxW=556&auto=format&n=JpbB64sgI_r6D502&q=85&s=6aa41eec506e7eb7df7f604bbc1e05bc 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="Make sure Certificate Store Selected by User is &#x22;Trusted Root Certification Authorities&#x22;, and click Finish">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-root-certification-authorities.png?maxW=663&auto=format&n=JpbB64sgI_r6D502&q=85&s=af610b6c52d0ebf46fdf84c80f08d4a1" alt="trusted-root-certification-authorities.png" width="663" height="639" data-path="images/general/faqs/proxy-networks/trusted-root-certification-authorities.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-root-certification-authorities.png?w=280&maxW=663&auto=format&n=JpbB64sgI_r6D502&q=85&s=c7a326326da1fc85642f5520f3a86271 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-root-certification-authorities.png?w=560&maxW=663&auto=format&n=JpbB64sgI_r6D502&q=85&s=fd57e8a6ae17bc7f0ce18b265b680af2 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-root-certification-authorities.png?w=840&maxW=663&auto=format&n=JpbB64sgI_r6D502&q=85&s=9b4243f81a313185d61cc065a6986ddb 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-root-certification-authorities.png?w=1100&maxW=663&auto=format&n=JpbB64sgI_r6D502&q=85&s=2ebfbfc02fc120f574f7a81b1d9d95d8 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-root-certification-authorities.png?w=1650&maxW=663&auto=format&n=JpbB64sgI_r6D502&q=85&s=cbb06c02fed98838e7616f4dec7d6f2e 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-root-certification-authorities.png?w=2500&maxW=663&auto=format&n=JpbB64sgI_r6D502&q=85&s=f772fe90bc0ead58d4c0ee9126dac944 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="Click OK">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-ok.png?maxW=509&auto=format&n=JpbB64sgI_r6D502&q=85&s=9beb536fe2c8fb80f5449142a25319e2" alt="click-ok.png" width="509" height="352" data-path="images/general/faqs/proxy-networks/click-ok.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-ok.png?w=280&maxW=509&auto=format&n=JpbB64sgI_r6D502&q=85&s=1397b8d76af694e0dadad7a0d262102a 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-ok.png?w=560&maxW=509&auto=format&n=JpbB64sgI_r6D502&q=85&s=7bc85bb25b2306a54283d34cc63bf4e5 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-ok.png?w=840&maxW=509&auto=format&n=JpbB64sgI_r6D502&q=85&s=462ea18abe143161024f6f30727bac22 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-ok.png?w=1100&maxW=509&auto=format&n=JpbB64sgI_r6D502&q=85&s=198c15d82b2dbbc068e09d62085f0307 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-ok.png?w=1650&maxW=509&auto=format&n=JpbB64sgI_r6D502&q=85&s=efa5546f697e486acef9e10cf92d7c7f 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-ok.png?w=2500&maxW=509&auto=format&n=JpbB64sgI_r6D502&q=85&s=531122bc17c891b5e9ccf9f813c73f65 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Firefox">
    * Type in the address bar: `about:preferences#advanced`
    * Under “安全” 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 certificate through 'My files'.
    * Enter your password and press next.
    * Choose a name, preferably something you will recognize like Bright Data.
    * Under 'Used for', choose 'VPN and apps' and click OK.
    * 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>

## 如何忽略 SSL 错误？

在某些情况下，您需要安装我们的证书或忽略 SSL 错误，才能访问特定产品或功能。 如果您不想安装我们的证书，则可以忽略 SSL 错误。 请查看以下不同编程语言的代码片段，高亮部分是为忽略 SSL 错误而需要添加到代码中的内容。

<CodeGroup>
  ```sh Curl
  # Add -k to ignore ssl errors
  curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> -k "http://lumtest.com/myip.json"
  ```

  ```js NodeJS
  #!/usr/bin/env node
  /*This sample code assumes the request-promise package is installed. If it is not installed run: "npm install request-promise"*/
  require('request-promise')({
      url: 'http://lumtest.com/myip.json',
      proxy: 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:33335',

      // Make sure you set reject rejectUnauthorized to false
      rejectUnauthorized: false,
  })
  .then(function(data){ console.log(data); },
      function(err){ console.error(err); });
  ```

  ```python Python
  #!/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:33335',
              'https': 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:33335'}))
      print(opener.open('http://lumtest.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:33335',
              'https': 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:33335'}))
      print(opener.open('http://lumtest.com/myip.json').read())

  ```

  ```cs C#
  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, ssl政策Errors) => true;

          var client = new WebClient();
          client.Proxy = new WebProxy("brd.superproxy.io:33335");
          client.Proxy.Credentials = new NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>");
          Console.WriteLine(client.DownloadString("http://lumtest.com/myip.json"));
      }
  }
  ```

  ```ruby Ruby
  #!/usr/bin/ruby

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

  uri = URI.parse('http://lumtest.com/myip.json')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 33335, '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
  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", 33335);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("http://lumtest.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", 33335));
          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
  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:33335")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("http://lumtest.com/myip.json"))
      End Sub
  End Module

  ```

  ```php PHP
  <?php
  $curl = curl_init('http://lumtest.com/myip.json');
  curl_setopt($curl, CURLOPT_PROXY, 'http://brd.superproxy.io:33335');
  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
  #!/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:33335");
  $agent->ssl_opts(verify_hostname => 0, SSL_verify_mode => SSL_VERIFY_NONE);
  print $agent->get('http://lumtest.com/myip.json')->content();
  ```
</CodeGroup>

## SSL 分析如何工作？

某些功能需要 Proxy Manager 访问 HTTPS 流量。 这可以通过在代理端口配置页面上启用 SSL 分析选项来实现。

一旦允许 Proxy Manager 终止 SSL，您还需要信任 [Bright Data Certificate Authority (CA)](https://brightdata.com/static/brightdata_proxy_ca.zip)。

Proxy Manager 将与目标网站创建安全的加密 HTTPS 连接，解密流量以记录请求，并根据您的设置运行规则，然后将响应通过加密 HTTPS 连接传回您的客户端，该连接带有由我们的 CA 证书签名的证书。


# 如何通过 Bright Data 设置 Entra ID（原 Azure Active Directory）SSO 和配置
Source: https://docs.brightdata.com/cn/general/authentication/How_to_set_up_Azure_SSO_Entra_ID_with_Bright_Data



* 应用程序准备工作
* 设置 SSO
* 设置 SCIM 配置

## 应用程序准备工作

* 访问 [https://entra.microsoft.com/](https://entra.microsoft.com/) 并登录账户。
* 创建企业应用程序：

<img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_1.png?maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7c781eab79b502213685134dfd66657a" alt="" width="1827" height="928" data-path="images/general/authentication/entra-sso/entra_1.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_1.png?w=280&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=518cc0d79f171b143a7e095ce727b785 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_1.png?w=560&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=577f6864bfbd49269cf9b1cc6d08d887 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_1.png?w=840&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=e5dbdedb23c82c3f21ecf8bcba6f6c19 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_1.png?w=1100&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=1b1683299c81a04771ccc819a24d33c7 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_1.png?w=1650&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=27be4bca87ccd3a9d110d39d52be71dc 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_1.png?w=2500&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=efe4ebdb265f10d0e194e1c9abcf0dc5 2500w" data-optimize="true" data-opv="2" />

* 点击“创建自己的应用程序”
* 输入应用程序名称
* 选择“集成其他未在应用库中列出的应用程序（非库应用程序）”
* 点击“创建”

<img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_2.png?maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=ffb8097c7f7f59a9548a9303294a6682" alt="" width="1827" height="929" data-path="images/general/authentication/entra-sso/entra_2.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_2.png?w=280&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0c4365117da440ead7953b8992ce6287 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_2.png?w=560&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=711812b184191d7490e40217f0221796 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_2.png?w=840&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=3d183b141b50736d8136acf876a0c618 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_2.png?w=1100&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a60ff56640f6a6592f6fbc3ed1f78942 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_2.png?w=1650&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7c53bb8094d7432f03695e2430aa70e2 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_2.png?w=2500&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=9cdaaa0efdd51bb0467a895485c5efb0 2500w" data-optimize="true" data-opv="2" />

## 设置 SSO

* 访问 [https://brightdata.com，并登录账户。](https://brightdata.com，并登录账户。)
* 在左侧菜单中选择“设置”->“账户设置”->“密码和身份验证”，并启用“Microsoft Entra ID (Azure AD) ”

<img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_3.png?maxW=1727&auto=format&n=2RrKkArDJDw55ilE&q=85&s=363633e6e17e1d1f1c1180cc59ecefd0" alt="" width="1727" height="919" data-path="images/general/authentication/entra-sso/entra_3.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_3.png?w=280&maxW=1727&auto=format&n=2RrKkArDJDw55ilE&q=85&s=04953f0002f7cc1bf28618d71e5a2b51 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_3.png?w=560&maxW=1727&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a0ed1108cd80ca62fbab74c59b175ad7 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_3.png?w=840&maxW=1727&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d2522a453f511f999d66e50598964d6b 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_3.png?w=1100&maxW=1727&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b643cfe8fbabff8ffb6bfa5633e52a99 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_3.png?w=1650&maxW=1727&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7101953c6cbbf5ea85d90c9fa916b30b 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_3.png?w=2500&maxW=1727&auto=format&n=2RrKkArDJDw55ilE&q=85&s=e8e845da6721f74fddd1ba342459006c 2500w" data-optimize="true" data-opv="2" />

* 从“应用程序注册”视图中选择应用程序。
* 将“应用程序（客户端）ID”复制到“客户端 ID”
* 将“目录（租户）ID”复制到“OAuth2 颁发者（租户）”
* 转到“添加证书或密钥”

<img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_4.png?maxW=1824&auto=format&n=2RrKkArDJDw55ilE&q=85&s=1d06803a840bc4734d40613910bfaf95" alt="" width="1824" height="930" data-path="images/general/authentication/entra-sso/entra_4.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_4.png?w=280&maxW=1824&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b7f84eeedc3e4f5aec737b4bb9687398 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_4.png?w=560&maxW=1824&auto=format&n=2RrKkArDJDw55ilE&q=85&s=092e3201624675bba4eb74e18a41a692 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_4.png?w=840&maxW=1824&auto=format&n=2RrKkArDJDw55ilE&q=85&s=975c78d657edd45dabc3c838af0d9b9c 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_4.png?w=1100&maxW=1824&auto=format&n=2RrKkArDJDw55ilE&q=85&s=30b4b064f0d7edfa51b54aedb3c70a91 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_4.png?w=1650&maxW=1824&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2a73baf65dc8f14af213f046d66c8d1f 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_4.png?w=2500&maxW=1824&auto=format&n=2RrKkArDJDw55ilE&q=85&s=bedfd481f0ac0f3a7a1be3578bccfc6a 2500w" data-optimize="true" data-opv="2" />

* 在密钥界面，点击“新建客户端密钥”
* 填写描述信息
* 点击“添加”

<img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_5.png?maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=fdb841efb69d0190c0a0f769e7b7afb4" alt="" width="1823" height="930" data-path="images/general/authentication/entra-sso/entra_5.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_5.png?w=280&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=42d9eb4314c394071e7927353f964db4 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_5.png?w=560&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b046bda1e7ed6fa50b81715d97b52666 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_5.png?w=840&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=6a2d7532308c47e5668c42571e667417 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_5.png?w=1100&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a5a25d7d3a19440de457a7cd2660b891 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_5.png?w=1650&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=c9e98348663be1e47a1e5d7b84f29dcf 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_5.png?w=2500&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=3f7223efafc591f24f27881db2d45a39 2500w" data-optimize="true" data-opv="2" />

* 创建密钥后，将密钥值复制到“客户端密钥”。
* 复制“登录重定向 URI”，供后续步骤使用

<img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_6.png?maxW=1828&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7acde46086998d4ffe8e63199af3c502" alt="" width="1828" height="929" data-path="images/general/authentication/entra-sso/entra_6.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_6.png?w=280&maxW=1828&auto=format&n=2RrKkArDJDw55ilE&q=85&s=827c8773ff259635ebd8207ad15c2074 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_6.png?w=560&maxW=1828&auto=format&n=2RrKkArDJDw55ilE&q=85&s=6772611b247c8b501dd0db869fc0c940 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_6.png?w=840&maxW=1828&auto=format&n=2RrKkArDJDw55ilE&q=85&s=070d753ddbb6c3174598f96f2c113377 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_6.png?w=1100&maxW=1828&auto=format&n=2RrKkArDJDw55ilE&q=85&s=e6959021f4ddd0b3a08a8c165e222e93 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_6.png?w=1650&maxW=1828&auto=format&n=2RrKkArDJDw55ilE&q=85&s=61937846fce6ca3e7ab43c8880c15c7b 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_6.png?w=2500&maxW=1828&auto=format&n=2RrKkArDJDw55ilE&q=85&s=22a6d6ee5ce54aa56fe55f48347404c9 2500w" data-optimize="true" data-opv="2" />

* 在“身份验证”界面，点击“添加平台”并选择“Web”

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_7.png?maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=e212dca82b1761ef3537e4b4f1770708" alt="" width="1825" height="930" data-path="images/general/authentication/entra-sso/entra_7.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_7.png?w=280&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=eb1b61ff9ed8231765e72510d97c9e61 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_7.png?w=560&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=4c6e9c0919e1b9593d84607ef3122d06 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_7.png?w=840&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=724e25ab8c4ee221916a0ba3e7cf42c7 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_7.png?w=1100&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=812b12a73f2fb1dc8da3c81061b18240 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_7.png?w=1650&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=38ce36d237db1fd420e239287dcb491a 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_7.png?w=2500&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=ba6d7e78c17715cb9d0bca05914bf4fd 2500w" data-optimize="true" data-opv="2" />

* 将之前复制的“登录重定向 URI”粘贴到“重定向 URI”中，然后点击“配置”以保存设置：

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_8.png?maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=93443c8fb1040fad609f8d00dedbc68c" alt="" width="1825" height="930" data-path="images/general/authentication/entra-sso/entra_8.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_8.png?w=280&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=5960b1c7f0f02b4a5aaa40cbbf332f94 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_8.png?w=560&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=5bfb191f8c32af6a98809f11dd774b35 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_8.png?w=840&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=4faa15ad81cefdfc33957529a984fbd4 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_8.png?w=1100&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=2d827a282c58f244d759af7574010c72 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_8.png?w=1650&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=eadd58fe4061e429d8494719a0a88dec 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_8.png?w=2500&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=bd691f17d8548fdecf653aef7f831f6b 2500w" data-optimize="true" data-opv="2" />

* 在 BrighData 控制面板中激活 EntraID 集成并测试登录情况：

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_9.png?maxW=892&auto=format&n=JpbB64sgI_r6D502&q=85&s=ff616537b6a6403b0b95caaa215e156f" alt="" width="892" height="916" data-path="images/general/authentication/entra-sso/entra_9.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_9.png?w=280&maxW=892&auto=format&n=JpbB64sgI_r6D502&q=85&s=61e9654c0cad5fd14e47a0c8168188d2 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_9.png?w=560&maxW=892&auto=format&n=JpbB64sgI_r6D502&q=85&s=78a0549f631a9d3f662d5014f0c0aad8 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_9.png?w=840&maxW=892&auto=format&n=JpbB64sgI_r6D502&q=85&s=347b3d46c0edd1c42699e27499325b15 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_9.png?w=1100&maxW=892&auto=format&n=JpbB64sgI_r6D502&q=85&s=2ee5db05c558a36af2fc81007d7dc946 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_9.png?w=1650&maxW=892&auto=format&n=JpbB64sgI_r6D502&q=85&s=0245a00dc737ed717a2f9dded73c5cb5 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_9.png?w=2500&maxW=892&auto=format&n=JpbB64sgI_r6D502&q=85&s=fe8648ab67e63bf7fc85efa4ecb94805 2500w" data-optimize="true" data-opv="2" />

## 设置 SCIM 配置

* 从 BrightData EntraID 设置的 SCIM 部分复制“身份验证令牌”：

<img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_10.png?maxW=671&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5493e28779dc051ca21b5fec20377b3c" alt="" width="671" height="878" data-path="images/general/authentication/entra-sso/entra_10.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_10.png?w=280&maxW=671&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b1b5c0020ad168f43195a994b807e61e 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_10.png?w=560&maxW=671&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7bf2d3aa73728c33a16ed70ac44e5b34 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_10.png?w=840&maxW=671&auto=format&n=2RrKkArDJDw55ilE&q=85&s=db2ec194ca9473c0cf74114d283eb748 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_10.png?w=1100&maxW=671&auto=format&n=2RrKkArDJDw55ilE&q=85&s=42311e9ed64b710c09690e90fee21fbf 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_10.png?w=1650&maxW=671&auto=format&n=2RrKkArDJDw55ilE&q=85&s=bd4135886d9a0576addea1b71f192e70 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_10.png?w=2500&maxW=671&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5e4c6f8ed8e08d3090ced82990921b24 2500w" data-optimize="true" data-opv="2" />

* 从“企业应用程序”视图中选择应用程序并转到“配置”设置：

<img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_11.png?maxW=1559&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0dbfb546a11c25b7f2adbe41b552fbd7" alt="" width="1559" height="930" data-path="images/general/authentication/entra-sso/entra_11.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_11.png?w=280&maxW=1559&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d9a7d3a0caf1ddab2271663c9c63dffc 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_11.png?w=560&maxW=1559&auto=format&n=2RrKkArDJDw55ilE&q=85&s=e9f45f0272fde8b1ad3b83a4e2ecf967 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_11.png?w=840&maxW=1559&auto=format&n=2RrKkArDJDw55ilE&q=85&s=82b37917db490de806834f3655e8e588 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_11.png?w=1100&maxW=1559&auto=format&n=2RrKkArDJDw55ilE&q=85&s=ecf3a064ff8c3c8df73bb678e8ab441f 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_11.png?w=1650&maxW=1559&auto=format&n=2RrKkArDJDw55ilE&q=85&s=93c9e44daaada6f5f7bad08084839928 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_11.png?w=2500&maxW=1559&auto=format&n=2RrKkArDJDw55ilE&q=85&s=05e1f78d3c70f266edfc050d1f4eab58 2500w" data-optimize="true" data-opv="2" />

* 在“管理”菜单下选择“配置”：

<img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_12.png?maxW=1557&auto=format&n=2RrKkArDJDw55ilE&q=85&s=11e02485b11bc5994cd0abd9282f5682" alt="" width="1557" height="931" data-path="images/general/authentication/entra-sso/entra_12.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_12.png?w=280&maxW=1557&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d1ded1d4b7afc0a5ff6149dbdcc54e67 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_12.png?w=560&maxW=1557&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0457c4c5f8e5d823b93f9cd26ae737ca 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_12.png?w=840&maxW=1557&auto=format&n=2RrKkArDJDw55ilE&q=85&s=3600cda8335e4ae6706c7b847546ca74 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_12.png?w=1100&maxW=1557&auto=format&n=2RrKkArDJDw55ilE&q=85&s=14881715d8228591f30346859f21892d 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_12.png?w=1650&maxW=1557&auto=format&n=2RrKkArDJDw55ilE&q=85&s=4df5a4838b27f1e77062e58748eeb1a3 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_12.png?w=2500&maxW=1557&auto=format&n=2RrKkArDJDw55ilE&q=85&s=514f5acb683eddf7b373f7e7500ac1dc 2500w" data-optimize="true" data-opv="2" />

* 选择“自动”配置模式
* 在“租户 URL”中填入“[https://brightdata.com/users/auth/scim”](https://brightdata.com/users/auth/scim”)
* 在“密钥令牌”中填入之前从 BrightData 控制面板设置中复制的值
* 测试连接状态。 右上角应会显示成功提示
  保存设置

<img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_13.png?maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=ea06d9313586f183538bc02643a49867" alt="" width="1823" height="931" data-path="images/general/authentication/entra-sso/entra_13.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_13.png?w=280&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5485262e009cb27470e7367ffb3f8657 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_13.png?w=560&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=07678a643a6f1b25fe24f3b6eda51663 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_13.png?w=840&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f631d3aa1f03b9c2e1f983b25ba97486 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_13.png?w=1100&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7580495adba255f8e2ebe48219b57895 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_13.png?w=1650&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=3ffdab48f7851520624c7842f13a8f33 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_13.png?w=2500&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=3cd4b119fb86714bf8fa28704446e12f 2500w" data-optimize="true" data-opv="2" />

* 返回“概述”选项卡，点击“开始配置”。
* 您可以在“按需配置”页面测试配置，但需要先在“用户和群组”页面为 BrightData 应用程序分配用户：

<img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_14.png?maxW=1825&auto=format&n=2RrKkArDJDw55ilE&q=85&s=436dd154728b89ce4b900c0c7acd1eb0" alt="" width="1825" height="930" data-path="images/general/authentication/entra-sso/entra_14.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_14.png?w=280&maxW=1825&auto=format&n=2RrKkArDJDw55ilE&q=85&s=306072b2d536772a21ca3faffebb4840 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_14.png?w=560&maxW=1825&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d63f2130805df0aa615874128f7ce144 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_14.png?w=840&maxW=1825&auto=format&n=2RrKkArDJDw55ilE&q=85&s=03ac11f933f5f6b76fa906814cd1df60 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_14.png?w=1100&maxW=1825&auto=format&n=2RrKkArDJDw55ilE&q=85&s=69cdc18175bef45bfae49a83fdda8605 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_14.png?w=1650&maxW=1825&auto=format&n=2RrKkArDJDw55ilE&q=85&s=cd6b83aa615e8077992891b43add0072 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_14.png?w=2500&maxW=1825&auto=format&n=2RrKkArDJDw55ilE&q=85&s=dcb30338fd4f3f62e9a6fd2a9f829eaa 2500w" data-optimize="true" data-opv="2" />


# 如何在 Bright Data 中设置 Okta SSO？
Source: https://docs.brightdata.com/cn/general/authentication/How_to_set_up_SSO_with_Okta_in_Bright_Data



**要求**

* 具有管理员权限的 Okta 组织账户
* 具有管理员权限的 Bright Data 账户

**步骤：**

1. 在 Okta 管理员控制面板中，选择“应用程序 > 应用程序”

```sh
https://[your_domain]-admin.okta.com/admin/apps/active
```

2. 点击“创建应用程序集成”

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_1.png?maxW=612&auto=format&n=JpbB64sgI_r6D502&q=85&s=b768bf0a8ce3c3f63b99bef61ca50293" alt="mceclip0.png" width="612" height="234" data-path="images/general/authentication/okta_1.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_1.png?w=280&maxW=612&auto=format&n=JpbB64sgI_r6D502&q=85&s=3f037236806b42db852f042e4dbc2fb0 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_1.png?w=560&maxW=612&auto=format&n=JpbB64sgI_r6D502&q=85&s=cc3a014ced6d9f77b0b638ceefb5ad98 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_1.png?w=840&maxW=612&auto=format&n=JpbB64sgI_r6D502&q=85&s=fc172737ab0c032023edde212af2d837 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_1.png?w=1100&maxW=612&auto=format&n=JpbB64sgI_r6D502&q=85&s=cb8e33d4ff35a1543f2b26470ad828a7 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_1.png?w=1650&maxW=612&auto=format&n=JpbB64sgI_r6D502&q=85&s=c6b9af552cbde5062b4e0872036814ce 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_1.png?w=2500&maxW=612&auto=format&n=JpbB64sgI_r6D502&q=85&s=0b9e2082dc797dcba597ab71f7c618cf 2500w" data-optimize="true" data-opv="2" />

3. 选择“OIDC - OpenID 连接”作为登录方法

4. 选择“Web 应用程序”作为应用程序类型，然后点击“下一步”

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_2.png?maxW=853&auto=format&n=JpbB64sgI_r6D502&q=85&s=220370677e6254f725419f453e1f1174" alt="mceclip1.png" width="853" height="739" data-path="images/general/authentication/okta_2.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_2.png?w=280&maxW=853&auto=format&n=JpbB64sgI_r6D502&q=85&s=c180f9271f2a815d68be63e203250830 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_2.png?w=560&maxW=853&auto=format&n=JpbB64sgI_r6D502&q=85&s=578632f8d2e6ec4c172d9d8a6afe2eaf 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_2.png?w=840&maxW=853&auto=format&n=JpbB64sgI_r6D502&q=85&s=ead0c37dbaa255359bb24ba95ec1e895 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_2.png?w=1100&maxW=853&auto=format&n=JpbB64sgI_r6D502&q=85&s=31635abcd8308f915e796e9246ac193a 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_2.png?w=1650&maxW=853&auto=format&n=JpbB64sgI_r6D502&q=85&s=64d1719f4cf901142b21045fcd004568 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_2.png?w=2500&maxW=853&auto=format&n=JpbB64sgI_r6D502&q=85&s=3b3dae426f963d0d4011a58769f3f861 2500w" data-optimize="true" data-opv="2" />

5. 此时，系统会跳转至新的 Web 应用程序集成页面。 您可以在该页面中为应用程序集成命名（建议使用“Bright Data 控制面板”这一名称）。

6. 在“授权类型”中，同时选择隐式授权和授权码

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_3.png?maxW=932&auto=format&n=JpbB64sgI_r6D502&q=85&s=5375f8bc4b277cfd7f2c50ab8728ba0d" alt="mceclip0.png" width="932" height="554" data-path="images/general/authentication/okta_3.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_3.png?w=280&maxW=932&auto=format&n=JpbB64sgI_r6D502&q=85&s=286521949a838d01c27b36051ccc741b 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_3.png?w=560&maxW=932&auto=format&n=JpbB64sgI_r6D502&q=85&s=db76aeb62fa97afc98148e57bf981807 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_3.png?w=840&maxW=932&auto=format&n=JpbB64sgI_r6D502&q=85&s=6086f64b53703187dff7eaaa5649b7fb 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_3.png?w=1100&maxW=932&auto=format&n=JpbB64sgI_r6D502&q=85&s=72759b53fe4e36c4847df501570b9729 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_3.png?w=1650&maxW=932&auto=format&n=JpbB64sgI_r6D502&q=85&s=4a2dae5694e197672673ee366e2efef3 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_3.png?w=2500&maxW=932&auto=format&n=JpbB64sgI_r6D502&q=85&s=264618b0d9cbcc3311111f9e9a09f15f 2500w" data-optimize="true" data-opv="2" />

7. 进入 Bright Data 控制面板: [https://brightdata.com/cp/setting](https://brightdata.com/cp/setting)

8. 打开 OKTA 配置对话框

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_4.png?maxW=460&auto=format&n=JpbB64sgI_r6D502&q=85&s=81e9f6c3b293a8adb5ec4e9938d61bee" alt="mceclip1.png" width="460" height="420" data-path="images/general/authentication/okta_4.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_4.png?w=280&maxW=460&auto=format&n=JpbB64sgI_r6D502&q=85&s=19aff0df2d573e7cfedb73f3a74c596c 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_4.png?w=560&maxW=460&auto=format&n=JpbB64sgI_r6D502&q=85&s=58155b30cd71ff97527db70de5c5cd59 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_4.png?w=840&maxW=460&auto=format&n=JpbB64sgI_r6D502&q=85&s=a717a394c52bb1bd2ff420d3a1b4810d 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_4.png?w=1100&maxW=460&auto=format&n=JpbB64sgI_r6D502&q=85&s=b87c69d864d1d7db5c68c1582fc68597 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_4.png?w=1650&maxW=460&auto=format&n=JpbB64sgI_r6D502&q=85&s=450fa4066b0b76820be3ce3d84071c7f 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_4.png?w=2500&maxW=460&auto=format&n=JpbB64sgI_r6D502&q=85&s=f9f70a604e8e0d897868a1ffa9924745 2500w" data-optimize="true" data-opv="2" />

9. 复制“登录重定向 URI”

**<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_5.png?maxW=630&auto=format&n=JpbB64sgI_r6D502&q=85&s=59813ea2ccb44a857bfe4d1ca4987b7a" alt="mceclip2.png" width="630" height="630" data-path="images/general/authentication/okta_5.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_5.png?w=280&maxW=630&auto=format&n=JpbB64sgI_r6D502&q=85&s=687e98e67e65f940ee875cf27271539a 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_5.png?w=560&maxW=630&auto=format&n=JpbB64sgI_r6D502&q=85&s=b47fa9f3195e261b9269d49d81ca23e6 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_5.png?w=840&maxW=630&auto=format&n=JpbB64sgI_r6D502&q=85&s=ffaba70438529845ee133ee8fddafbd6 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_5.png?w=1100&maxW=630&auto=format&n=JpbB64sgI_r6D502&q=85&s=043c0c2de1034d7df5f7e321e0ec6c8e 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_5.png?w=1650&maxW=630&auto=format&n=JpbB64sgI_r6D502&q=85&s=5f809409000fdbbe5500890cb10f0aa7 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_5.png?w=2500&maxW=630&auto=format&n=JpbB64sgI_r6D502&q=85&s=a95f902f57af0ed794b53d981fa00f41 2500w" data-optimize="true" data-opv="2" />**

10. 将其粘贴到 OKTA 新应用程序设置中的相应字段

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_6.png?maxW=964&auto=format&n=JpbB64sgI_r6D502&q=85&s=cefc6b273911636e036b58ebf4b1585b" alt="mceclip3.png" width="964" height="625" data-path="images/general/authentication/okta_6.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_6.png?w=280&maxW=964&auto=format&n=JpbB64sgI_r6D502&q=85&s=59072ad41d4a78ba044a9ba64e67690e 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_6.png?w=560&maxW=964&auto=format&n=JpbB64sgI_r6D502&q=85&s=06878d2024635818fba8164a23e5c970 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_6.png?w=840&maxW=964&auto=format&n=JpbB64sgI_r6D502&q=85&s=3c6427c82c066fffe48da91edbb7dcf3 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_6.png?w=1100&maxW=964&auto=format&n=JpbB64sgI_r6D502&q=85&s=88f0b70c76d0d7b3a6a3dc92d57f94de 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_6.png?w=1650&maxW=964&auto=format&n=JpbB64sgI_r6D502&q=85&s=ec7f4d53571189933b04e3af9de6a6d6 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_6.png?w=2500&maxW=964&auto=format&n=JpbB64sgI_r6D502&q=85&s=6814c9a78d84c22680fe917d668202da 2500w" data-optimize="true" data-opv="2" />

11. 对“退出 URI”执行相同操作

12. 在“分配”中，选择所需的访问级别

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_7.png?maxW=894&auto=format&n=JpbB64sgI_r6D502&q=85&s=e7474bba0735eccd8390823ceb708497" alt="mceclip6.png" width="894" height="291" data-path="images/general/authentication/okta_7.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_7.png?w=280&maxW=894&auto=format&n=JpbB64sgI_r6D502&q=85&s=155ce53b704ac84870a6ff34d5223657 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_7.png?w=560&maxW=894&auto=format&n=JpbB64sgI_r6D502&q=85&s=228b73c8af168fd39403e11befeb9231 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_7.png?w=840&maxW=894&auto=format&n=JpbB64sgI_r6D502&q=85&s=505fe2382afbfd31a1c92716a4db21ba 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_7.png?w=1100&maxW=894&auto=format&n=JpbB64sgI_r6D502&q=85&s=da51040eb1269a07503637e0541e0238 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_7.png?w=1650&maxW=894&auto=format&n=JpbB64sgI_r6D502&q=85&s=3fb76d422d6a9332288111acde398cd0 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_7.png?w=2500&maxW=894&auto=format&n=JpbB64sgI_r6D502&q=85&s=d8169b852ea0cec13c60515badf67763 2500w" data-optimize="true" data-opv="2" />

13. 点击“保存”

14. 系统随即跳转至新的应用程序集成设置页面。

将客户端 ID、客户端密钥和 Okta 域名复制到 Bright Data 控制面板中的 OKTA 设置对话框。

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_8.png?maxW=769&auto=format&n=JpbB64sgI_r6D502&q=85&s=6bccd18bedfeea6768d60fffdaf741c7" alt="mceclip4.png" width="769" height="582" data-path="images/general/authentication/okta_8.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_8.png?w=280&maxW=769&auto=format&n=JpbB64sgI_r6D502&q=85&s=25c9f971b216ff19b18bccc1cb7cd11b 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_8.png?w=560&maxW=769&auto=format&n=JpbB64sgI_r6D502&q=85&s=bd2ce353401e999b9676edd5ed84fe8a 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_8.png?w=840&maxW=769&auto=format&n=JpbB64sgI_r6D502&q=85&s=078c57004e58871499ff19b37fc86735 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_8.png?w=1100&maxW=769&auto=format&n=JpbB64sgI_r6D502&q=85&s=d645961a97a217fc950103d6346e47e1 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_8.png?w=1650&maxW=769&auto=format&n=JpbB64sgI_r6D502&q=85&s=a47ef4b76f7903a117abdc533702b9a7 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_8.png?w=2500&maxW=769&auto=format&n=JpbB64sgI_r6D502&q=85&s=b78d4b563cdcb8fda6f9afee78351e5e 2500w" data-optimize="true" data-opv="2" />

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_9.png?maxW=613&auto=format&n=JpbB64sgI_r6D502&q=85&s=978fc36deae8b4496b6d76a1fb26ecf8" alt="mceclip5.png" width="613" height="630" data-path="images/general/authentication/okta_9.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_9.png?w=280&maxW=613&auto=format&n=JpbB64sgI_r6D502&q=85&s=2e56a4c2369b52a3a0598f46af66c707 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_9.png?w=560&maxW=613&auto=format&n=JpbB64sgI_r6D502&q=85&s=5030a2ce747b1aaa4f4f7cabd22d2d24 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_9.png?w=840&maxW=613&auto=format&n=JpbB64sgI_r6D502&q=85&s=9112962386abb34e4c467eb3dd8d051e 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_9.png?w=1100&maxW=613&auto=format&n=JpbB64sgI_r6D502&q=85&s=7c14e8d77f4dc62c5cec360e5fb8fbf3 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_9.png?w=1650&maxW=613&auto=format&n=JpbB64sgI_r6D502&q=85&s=d229d61c4371285c2801ce487b221239 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_9.png?w=2500&maxW=613&auto=format&n=JpbB64sgI_r6D502&q=85&s=a38d882b56a1973c8a22e57af3d9d93f 2500w" data-optimize="true" data-opv="2" />

15. 点击“激活”。

如果选择“允许所有人访问”，请跳过第 16 步

16. 进入“分配”选项卡，分配可使用此集成的用户

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_10.png?maxW=767&auto=format&n=JpbB64sgI_r6D502&q=85&s=83afcce0cd4d66f576121268ef6724e4" alt="mceclip6.png" width="767" height="721" data-path="images/general/authentication/okta_10.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_10.png?w=280&maxW=767&auto=format&n=JpbB64sgI_r6D502&q=85&s=21b79f6aed1c320e314e10a54262b43f 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_10.png?w=560&maxW=767&auto=format&n=JpbB64sgI_r6D502&q=85&s=f180e1c26153aef0dc0fb4f4d23a12ce 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_10.png?w=840&maxW=767&auto=format&n=JpbB64sgI_r6D502&q=85&s=68ef36920a9c87b0adc8b6dc93fb7e7a 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_10.png?w=1100&maxW=767&auto=format&n=JpbB64sgI_r6D502&q=85&s=d121eff0b679609db48115d98e7e46ef 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_10.png?w=1650&maxW=767&auto=format&n=JpbB64sgI_r6D502&q=85&s=1fe7ccc486937c2ca28b0589573c094a 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_10.png?w=2500&maxW=767&auto=format&n=JpbB64sgI_r6D502&q=85&s=d0b69772191b7b4de81bc6af2e79319d 2500w" data-optimize="true" data-opv="2" />

17. 进入 Bright Data 设置页面，确保所有需要访问该集成的用户均已添加。

我们正在努力开发用户配置支持功能，目前需要您手动管理。

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_11.png?maxW=829&auto=format&n=JpbB64sgI_r6D502&q=85&s=0db1bcf7715180ccaddb84bc501cf161" alt="mceclip7.png" width="829" height="547" data-path="images/general/authentication/okta_11.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_11.png?w=280&maxW=829&auto=format&n=JpbB64sgI_r6D502&q=85&s=f86760c1885bad5169dceab88b576668 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_11.png?w=560&maxW=829&auto=format&n=JpbB64sgI_r6D502&q=85&s=4fc0c0784f0e62d8798d7b566ed48c1b 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_11.png?w=840&maxW=829&auto=format&n=JpbB64sgI_r6D502&q=85&s=41d3263f50313e067e414076a12c82f9 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_11.png?w=1100&maxW=829&auto=format&n=JpbB64sgI_r6D502&q=85&s=5f342cd494866b977b7d101e829e39b8 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_11.png?w=1650&maxW=829&auto=format&n=JpbB64sgI_r6D502&q=85&s=b71db0156db0fb7490b22dcd4b54a1d0 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_11.png?w=2500&maxW=829&auto=format&n=JpbB64sgI_r6D502&q=85&s=ee44da33ede423215008fd3c09b40f83 2500w" data-optimize="true" data-opv="2" />

***以下为可选步骤， 旨在确保用户能够通过其控制面板或 Okta Chrome 扩展程序启动身份验证。***

18. 向下滚动到“常规设置”，然后点击编辑

19. 进行以下设置：

* 登录发起者：Okta 或应用程序
* 应用程序可见性：向用户显示应用程序图标
* 登录流程：重定向到应用程序以启动登录（符合 OIDC 标准）
* 从控制面板复制“启动登录 URI”

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_12.png?maxW=619&auto=format&n=JpbB64sgI_r6D502&q=85&s=d5e402a75faae98d784bfa7b4982ae71" alt="mceclip8.png" width="619" height="632" data-path="images/general/authentication/okta_12.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_12.png?w=280&maxW=619&auto=format&n=JpbB64sgI_r6D502&q=85&s=3055e7f4588fbe0b55a96351fdeba556 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_12.png?w=560&maxW=619&auto=format&n=JpbB64sgI_r6D502&q=85&s=12fe3c4b301827d15bc6a1bcdbaedde8 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_12.png?w=840&maxW=619&auto=format&n=JpbB64sgI_r6D502&q=85&s=d0d968e0d4af9942019f2252ff8faf3b 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_12.png?w=1100&maxW=619&auto=format&n=JpbB64sgI_r6D502&q=85&s=f7a5676cd966b865dc18690e232d72e3 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_12.png?w=1650&maxW=619&auto=format&n=JpbB64sgI_r6D502&q=85&s=e570e8282662bc842f371dd3c8f9fab5 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_12.png?w=2500&maxW=619&auto=format&n=JpbB64sgI_r6D502&q=85&s=4d3793d27c17feb442526bb40cb12ae5 2500w" data-optimize="true" data-opv="2" />

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_13.png?maxW=771&auto=format&n=JpbB64sgI_r6D502&q=85&s=aa33e957fdbc71a15456ed458407ae5a" alt="mceclip9.png" width="771" height="609" data-path="images/general/authentication/okta_13.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_13.png?w=280&maxW=771&auto=format&n=JpbB64sgI_r6D502&q=85&s=a3acf0dae024ba03e1f09d2e92895454 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_13.png?w=560&maxW=771&auto=format&n=JpbB64sgI_r6D502&q=85&s=cca23929e4428ce70952f532ff4929cb 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_13.png?w=840&maxW=771&auto=format&n=JpbB64sgI_r6D502&q=85&s=26e8a3a0cd136b63bb22c0a0ee4b4adc 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_13.png?w=1100&maxW=771&auto=format&n=JpbB64sgI_r6D502&q=85&s=66d91741a9bd6e26a1d17ec04b12994c 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_13.png?w=1650&maxW=771&auto=format&n=JpbB64sgI_r6D502&q=85&s=0fd63b33d180d2f2c419860bd67a617b 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_13.png?w=2500&maxW=771&auto=format&n=JpbB64sgI_r6D502&q=85&s=f65e4d3d99c49b789794f87a8406e3a2 2500w" data-optimize="true" data-opv="2" />

20. 保存更改。 **至此，集成配置已经完成，可以使用了。**

**注意事项**

* Okta 域名应使用应用程序集成设置中显示的域名 (yourcompany.okta.com)，而非管理员界面中看到的域名 (yourcompany-admin.okta.com)

* 请确保向 Bright Data 提供的凭据正确无误，我们无法验证这些凭据。

* 登录重定向 URI 是确保 SSO 功能正常运行的必要条件

* 如果希望通过 Okta Chrome 扩展程序或 Okta 控制面板使用该功能，需要配置启动登录 URI


# Snowflake 数据交付配置指南
Source: https://docs.brightdata.com/cn/general/cloud-providers/snowflake



<否te>
  Snowflake 配置可用于“数据集”交付，但不支持数据收集器（如网页抓取工具）。
</否te>

## 立即开始

为了确保数据集能够高效传输至您的 Snowflake 环境，我们特地提供了详细的分步设置指南。 请按照以下步骤操作：

<Steps>
  <Step title="选择或创建数据库">
    首先，确定是使用现有数据库还是创建新的数据库。 如果选择创建新的数据库，请使用以下命令：

    ```sql
    CREATE DATABASE <database>;
    ```

    <Tip>
      请记得将 `<database>` 替换为您希望使用的数据库名称。
    </Tip>
  </Step>

  <Step title="选择或创建架构">
    确定是使用现有架构还是创建新的架构。 默认情况下，所有数据库都包含一个名为 PUBLIC 的架构。 如果希望使用其他架构，请使用以下命令：

    ```sql
    CREATE SCHEMA <schema>;
    ```

    <Tip>
      请将 `<schema>` 替换为您自己的架构名称。
    </Tip>
  </Step>

  <Step title="选择或创建仓库">
    选择使用现有仓库还是创建新的仓库。 创建新的仓库时，请参考 Snowflake 针对数据加载场景的仓库配置建议。要创建仓库，请使用以下命令：

    ```sql
    CREATE WAREHOUSE <warehouse>;
    ```

    <Tip>
      请将 `<warehouse>` 替换为您希望使用的仓库名称。
    </Tip>
  </Step>

  <Step title="选择或创建内部命名暂存区">
    接下来，选择使用现有内部命名暂存区还是创建新的暂存区。 要创建新的暂存区，请使用以下命令：

    ```sql
    CREATE STAGE <stage>;
    ```

    <Tip>
      请记得将 `<stage>` 替换为您希望使用的暂存区名称。
    </Tip>
  </Step>

  <Step title="创建角色">
    您需要创建一个具有所选暂存区写入权限的角色。要创建角色，请使用以下命令：

    ```sql
    CREATE ROLE <role_name>;
    ```

    <Tip>请将 `<role_name>` 替换为您选择的角色名称。</Tip>
  </Step>

  <Step title="为角色授予仓库权限">
    接下来，请使用以下命令，为新角色授予所选仓库的必要操作权限：

    ```sql
    GRANT OPERATE ON WAREHOUSE <warehouse> TO ROLE <role_name>;
    ```

    <Tip>
      请记得将 `<warehouse>` 和 `<role_name>` 分别替换为具体仓库名称和角色名称。
    </Tip>
  </Step>

  <Step title="为角色启用暂存区写入权限">
    要为角色启用暂存区写入权限，请使用以下命令：

    ```sql
    GRANT WRITE ON STAGE <stage> TO ROLE <role_name>;
    ```

    <Tip>
      同样，请将 `<stage>` 和 `<role_name>` 替换为您选择的暂存区名称和角色名称。
    </Tip>
  </Step>

  <Step title="创建 BrightData 用户">
    接下来，创建 BrightData 新用户，用于直接向 Snowflake 上传数据。 请使用以下命令：

    ```sql
    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>
      请将 `<user_name>`、`<password>` 和 `<login>` 分别替换为您选择的用户名、密码和登录名。
    </Tip>
  </Step>

  <Step title="为新用户授予角色权限">
    最后，为新用户授予您创建的角色权限：

    ```sql
    GRANT ROLE <role_name> TO USER <user_name>;
    ```

    <Tip>
      请将 `<role_name>` 和 `<user_name>` 替换为您的角色名称和用户名称。
    </Tip>
  </Step>

  <Step title="建立 IP 白名单">
    如果您的 Snowflake 账户启用了网络策略，需要将以下 IP 加入白名单：

    ```sql
    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>
      请将 `<policy_name>` 替换为您的网络策略名称。  \
      请将 `<existing_whiltelisted_ips>` 替换为当前已列入白名单的 IP 列表。
    </Tip>

    大功告成！您已完成 Snowflake 环境的配置，可以接收来自我们平台的数据了。

    如遇任何问题或需要进一步帮助，请联系我们的支持团队。

    如需了解更多关于数据加载性能和仓库大小注意事项的信息，[请点击此处](https://docs.snowflake.com/en/user-guide/warehouses-overview#impact-on-data-loading)。
  </Step>
</Steps>


# 常见问题解答
Source: https://docs.brightdata.com/cn/general/faqs



<AccordionGroup>
  <Accordion title="How do I set up a password for my account?">
    Even if you first signed in with 'magic link' or 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 a 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.
  </Accordion>

  <Accordion title="如何查看分配给您的区域的 IP？">
    要查看分配给您的区域的 IP 列表，只需导航到 **[“我的代理页面”](https://brightdata.com/cp/zones)**，点击您的代理区域，向下滚动到\*\*“分配的 IP”**部分，然后只需点击**“显示分配的 IP”**或**“下载 IP 列表”\*\*。

        <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/review-allocated-ips.gif?maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=4ac48f6f03794d299cb4405f79915c43" alt="review-allocated-ips.gif" width="1600" height="734" data-path="images/general/faqs/review-allocated-ips.gif" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/review-allocated-ips.gif?w=280&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=845ba00d00aa919393dc8d51e12325bb 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/review-allocated-ips.gif?w=560&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=56d29c0e699219ac8c349fd5f28f3ad9 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/review-allocated-ips.gif?w=840&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=1395a6218866308015019c02566e5f70 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/review-allocated-ips.gif?w=1100&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=d23d6a84dca5587c47d9e3eca8be2639 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/review-allocated-ips.gif?w=1650&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=e32cc8e442cf29d2603377850484a98f 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/review-allocated-ips.gif?w=2500&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=5f231fd9046bea17dcc7c4efa15575e4 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="如何查看您的区域的统计数据？">
    可通过两种方法查看您的区域统计数据：

    <Tabs>
      <Tab title="通过控制面板">
        * 要查看所有区域的统计数据，请访问您的控制面板：
          <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/statistics-via-control-panel.png?maxW=1827&auto=format&n=JpbB64sgI_r6D502&q=85&s=0a452c8f98f958c1e589d9b5c6f2a39c" alt="statistics-via-control-panel.png" width="1827" height="977" data-path="images/general/faqs/statistics-via-control-panel.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/statistics-via-control-panel.png?w=280&maxW=1827&auto=format&n=JpbB64sgI_r6D502&q=85&s=370d9c0870beab0d7ea6e70632aed187 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/statistics-via-control-panel.png?w=560&maxW=1827&auto=format&n=JpbB64sgI_r6D502&q=85&s=1622618370f5886a0e7e0d1df90ad56b 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/statistics-via-control-panel.png?w=840&maxW=1827&auto=format&n=JpbB64sgI_r6D502&q=85&s=99254d5a5d07f3359023ac59a71fab87 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/statistics-via-control-panel.png?w=1100&maxW=1827&auto=format&n=JpbB64sgI_r6D502&q=85&s=e122ba52a02442b1a13ea43122edf155 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/statistics-via-control-panel.png?w=1650&maxW=1827&auto=format&n=JpbB64sgI_r6D502&q=85&s=679cf990fb003bd3bfa727068ba991f1 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/statistics-via-control-panel.png?w=2500&maxW=1827&auto=format&n=JpbB64sgI_r6D502&q=85&s=63b01636438fc0226434d9f920e6b94c 2500w" data-optimize="true" data-opv="2" />

        * 要查看特定区域的统计数据，请转到该区域的设置并点击“统计数据”选项卡：

                <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/specific-zone-statics.gif?maxW=1828&auto=format&n=JpbB64sgI_r6D502&q=85&s=8d9b0b7803937295dfa88f65f1a61c3d" alt="specific-zone-statics.gif" width="1828" height="978" data-path="images/general/faqs/specific-zone-statics.gif" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/specific-zone-statics.gif?w=280&maxW=1828&auto=format&n=JpbB64sgI_r6D502&q=85&s=dd16979adfc4c479392498c5beb7d333 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/specific-zone-statics.gif?w=560&maxW=1828&auto=format&n=JpbB64sgI_r6D502&q=85&s=1304ce4d2fb7d36de3b43a272d9ec191 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/specific-zone-statics.gif?w=840&maxW=1828&auto=format&n=JpbB64sgI_r6D502&q=85&s=84ffe3178008e4254082790d85155ba4 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/specific-zone-statics.gif?w=1100&maxW=1828&auto=format&n=JpbB64sgI_r6D502&q=85&s=d6210af7402afb17dd681a72965b5b69 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/specific-zone-statics.gif?w=1650&maxW=1828&auto=format&n=JpbB64sgI_r6D502&q=85&s=99b14ee687827f061b61570f687c575f 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/specific-zone-statics.gif?w=2500&maxW=1828&auto=format&n=JpbB64sgI_r6D502&q=85&s=e9f0787e2ffe657df061d04d05b4ad8c 2500w" data-optimize="true" data-opv="2" />
      </Tab>

      <Tab title="通过 API">
        * Please visit [this page](/cn/api-reference/) to see all available API endpoints (in multiple languages) and example responses related to viewing statistics.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="如何设置带宽使用限制？">
    默认情况下，所有代理区域的使用量均不受限制，您可以通过以下4个参数之一设置限制：

    * \美元/天
    * \美元/月
    * 字节/天
    * 字节/月
      要在您的某个区域设置此限制，请从 Bright Data 的[“我的代理页面”](https://brightdata.com/cp/zones)

    <Steps>
      <Step title="点击该区域进入任何区域的设置。" />

      <Step title="转到“访问参数”选项卡。">
                <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/access-parameters.png?maxW=677&auto=format&n=JpbB64sgI_r6D502&q=85&s=ad5851a40f1682ebaea99ebdcb76bfb5" alt="access-parameters.png" width="677" height="159" data-path="images/general/faqs/access-parameters.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/access-parameters.png?w=280&maxW=677&auto=format&n=JpbB64sgI_r6D502&q=85&s=5f253ab6f22fc1e00d85996877a0e4bb 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/access-parameters.png?w=560&maxW=677&auto=format&n=JpbB64sgI_r6D502&q=85&s=f6c0770efec376a1b83568073112cd28 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/access-parameters.png?w=840&maxW=677&auto=format&n=JpbB64sgI_r6D502&q=85&s=efc6b3ea5efe39c2386a6c850c536650 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/access-parameters.png?w=1100&maxW=677&auto=format&n=JpbB64sgI_r6D502&q=85&s=92177767e6ccb273df48eb59be751b0b 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/access-parameters.png?w=1650&maxW=677&auto=format&n=JpbB64sgI_r6D502&q=85&s=4249286cbaadc7cd111065c4baa66a0a 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/access-parameters.png?w=2500&maxW=677&auto=format&n=JpbB64sgI_r6D502&q=85&s=9030a70dddaa719da958a7db8d7fbf42 2500w" data-optimize="true" data-opv="2" />
      </Step>

      <Step title="向下滚动到“限制”，默认值为“无限制”" />

      <Step title="点击“编辑”按钮">
                <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/edit-limit.png?maxW=760&auto=format&n=JpbB64sgI_r6D502&q=85&s=480e8cf3e0e398f883060e49997cfbd4" alt="edit-limit.png" width="760" height="914" data-path="images/general/faqs/edit-limit.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/edit-limit.png?w=280&maxW=760&auto=format&n=JpbB64sgI_r6D502&q=85&s=d858e2ed0dc784f0ea045d24f46584c2 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/edit-limit.png?w=560&maxW=760&auto=format&n=JpbB64sgI_r6D502&q=85&s=e1646ebeecf9062e56d1e867ece660d5 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/edit-limit.png?w=840&maxW=760&auto=format&n=JpbB64sgI_r6D502&q=85&s=f8e462850ca5c1a9e52f0cbb0e69273f 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/edit-limit.png?w=1100&maxW=760&auto=format&n=JpbB64sgI_r6D502&q=85&s=f60b727398e1e6d5f41e38860b67a290 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/edit-limit.png?w=1650&maxW=760&auto=format&n=JpbB64sgI_r6D502&q=85&s=93fa8e96a98de6bde5a95b4a81174470 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/edit-limit.png?w=2500&maxW=760&auto=format&n=JpbB64sgI_r6D502&q=85&s=6091b8915d838870a857e7af22ee0bb8 2500w" data-optimize="true" data-opv="2" />
      </Step>

      <Step title="启用“支出限制”选项。">
                <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/spend-limit-toggle.png?maxW=647&auto=format&n=JpbB64sgI_r6D502&q=85&s=538be0ae45872d54c0e04b66f86a4b02" alt="spend-limit-toggle.png" width="647" height="353" data-path="images/general/faqs/spend-limit-toggle.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/spend-limit-toggle.png?w=280&maxW=647&auto=format&n=JpbB64sgI_r6D502&q=85&s=3c349d0ed961b11d0a15deb59de18fa8 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/spend-limit-toggle.png?w=560&maxW=647&auto=format&n=JpbB64sgI_r6D502&q=85&s=62bf1bb05d536e612da8c4b28209c15f 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/spend-limit-toggle.png?w=840&maxW=647&auto=format&n=JpbB64sgI_r6D502&q=85&s=696869723d255a0042ac06252ce4727e 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/spend-limit-toggle.png?w=1100&maxW=647&auto=format&n=JpbB64sgI_r6D502&q=85&s=7aa3c5e067a2d79fd14bb8a1d0597b53 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/spend-limit-toggle.png?w=1650&maxW=647&auto=format&n=JpbB64sgI_r6D502&q=85&s=803b5006aacf617c7c759b84e57c5c22 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/spend-limit-toggle.png?w=2500&maxW=647&auto=format&n=JpbB64sgI_r6D502&q=85&s=3c13b6c017bbdec90e3d5dd332ea0e7a 2500w" data-optimize="true" data-opv="2" />
      </Step>

      <Step title="设置要使用的参数，然后点击“更新”" />

      <Step title="您将在限制部分和代理页面的“使用/支出限制”列中看到相应更改。" />
    </Steps>
  </Accordion>

  <Accordion title="如何计算住宅 IP 的成本效益？">
        <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/cost-limits-table.png?maxW=680&auto=format&n=JpbB64sgI_r6D502&q=85&s=f6e33fce8ba7d3fd4d545118219311a3" alt="cost-limits-table.png" width="680" height="369" data-path="images/general/faqs/cost-limits-table.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/cost-limits-table.png?w=280&maxW=680&auto=format&n=JpbB64sgI_r6D502&q=85&s=9c5c12beaa3e8465e0c5f440ef76a15e 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/cost-limits-table.png?w=560&maxW=680&auto=format&n=JpbB64sgI_r6D502&q=85&s=103bfaa9572b82ce6c8ed44fc6c1a827 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/cost-limits-table.png?w=840&maxW=680&auto=format&n=JpbB64sgI_r6D502&q=85&s=d749da83e1fb01277f17292163d45a59 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/cost-limits-table.png?w=1100&maxW=680&auto=format&n=JpbB64sgI_r6D502&q=85&s=be46e176b51c935021854bdce4bc41f0 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/cost-limits-table.png?w=1650&maxW=680&auto=format&n=JpbB64sgI_r6D502&q=85&s=66f1328446b561ff0a044fdae6a229f1 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/cost-limits-table.png?w=2500&maxW=680&auto=format&n=JpbB64sgI_r6D502&q=85&s=2a7d0087bb879d9abfe5b724f7d35b7d 2500w" data-optimize="true" data-opv="2" />

    **我们是如何计算该表格的？**

    您的公司需要通过每小时向特定网站发送1000个 http 请求来从网络收集信息。 您编写抓取工具代码并通过服务器运行它。 目标网站允许每分钟50个来自同一 IP 的请求，然后才会屏蔽您的抓取工具。 现在，您必须购买更多的代理。

    **假设您选择数据中心代理：**\
    您不想共享 IP，所以您购买了200个专用的数据中心 IP。 您花2个小时编写抓取工具与新数据中心代理的集成代码，然后运行新程序。 这次，您的目标网站需要3天才能检测到您的抓取工具。 检测到代理后，您必须购买新的代理，然后再次重复此过程，每天检查以确保代理未被检测到。每月费用（所有数字均来自真实客户）：

    * 200个专用 IP：500美元
    * 带宽：（1000个请求 X 每个请求 20KB X 24小时 X 30天 = 14.5GB）：每月3美元
    * 开发人员（2小时集成 X 10 + 每3天1小时用于管理代理）：每月工作约3天或大约900美元

    仅这些东西，您每月的总成本就至少要1400美元，而开发人员每小时30美元的工资是非常保守的。此外，如果您的目标网站在屏蔽您之前发送错误信息，或者您的信息流每隔几天中断一次，这可能会对您的品牌或收入来源造成损害，这并不能解释信息可靠性的缺乏。

    **假设您选择 Bright Data 住宅代理：**\
    您购买 40GB 的基本套餐，可以访问无限的住宅 IP。与您的抓取工具集成需要2个小时。由于平均每天有300万个住宅 IP 可用，您的目标网站无法检测到您的抓取工具，这使您可以专注于其他项目。

    带宽和无限 IP 每月的费用仅为500美元。您的信息始终是可靠的，因为您的请求总是会成功，并且访问权限永远不会在月中被切断。当您的业务由于这种抓取而增长，并且您的项目每月超过600MB时，费用差异可能远远高于约1000美元。

    Bright Data 还允许您在不使用时暂停账户，这样您的每月费用就可以低于500美元。首先使用5美元的免费数据中心流量券来测试 Bright Data 的优点，然后申请访问我们的住宅网络以进行廉价而可靠的数据收集。
  </Accordion>

  <Accordion title="我的区域名称旁边的黄色警告图标是什么？">
    > **这是提醒您设置访问白名单**

    为了限制未经授权的服务器访问您的代理区域，我们建议您设置 IP 白名单。 这将确保只有您识别出的 IP 才可以访问您的代理区域，从而实现更高的安全性和控制力。

    请咨询您的 IT 或网络专家，确保您的出站 IP 是固定的并且不会改变，否则您可能会阻止自己或贵公司的其他授权用户访问代理区域。
  </Accordion>

  <Accordion title="如何建立 IP 白名单？">
    您可以选择允许哪些外部 IP 在不传递凭据或不会被屏蔽的情况下指定目标代理端口。 在代理管理器上加入白名单时，授予的权限有3个级别：

    1. 允许访问用户界面的 IP。 自动允许这些 IP 访问所有代理和端口。 "转到“常规设置”，为“管理员列入白名单的 IP”选择“添加 IP”。
       <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/admin-whitelisted-ips.png?maxW=570&auto=format&n=JpbB64sgI_r6D502&q=85&s=fe87e933ab462d84d68cf6c47793b649" alt="admin-whitelisted-ips.png" width="570" height="254" data-path="images/general/faqs/admin-whitelisted-ips.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/admin-whitelisted-ips.png?w=280&maxW=570&auto=format&n=JpbB64sgI_r6D502&q=85&s=3c9a8b4e7278bcd93b3bf1fcbe4d7814 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/admin-whitelisted-ips.png?w=560&maxW=570&auto=format&n=JpbB64sgI_r6D502&q=85&s=e473255236e7a4b6e72bdda9345e22b9 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/admin-whitelisted-ips.png?w=840&maxW=570&auto=format&n=JpbB64sgI_r6D502&q=85&s=e0652a90985e9a026ec0e93825cc6b8b 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/admin-whitelisted-ips.png?w=1100&maxW=570&auto=format&n=JpbB64sgI_r6D502&q=85&s=07a9aec7b1e2f5d49b7d89f95b1b0a70 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/admin-whitelisted-ips.png?w=1650&maxW=570&auto=format&n=JpbB64sgI_r6D502&q=85&s=b09cdc1ef4240a38c0626374a7652e03 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/admin-whitelisted-ips.png?w=2500&maxW=570&auto=format&n=JpbB64sgI_r6D502&q=85&s=af67c42c27c6e0a15d0ed2091a5bf5cb 2500w" data-optimize="true" data-opv="2" />
    2. 允许访问所有代理的 IP。 这些 IP 可以访问所有端口。 "转到“常规设置”，为“代理列入白名单的 IP”选择“添加 IP”。\
       <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-whitelisted-ips.png?maxW=571&auto=format&n=JpbB64sgI_r6D502&q=85&s=bd4d7c6c3275a8694b9f4a0641a292ca" alt="proxy-whitelisted-ips.png" width="571" height="267" data-path="images/general/faqs/proxy-whitelisted-ips.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-whitelisted-ips.png?w=280&maxW=571&auto=format&n=JpbB64sgI_r6D502&q=85&s=fd2d6f1fd3d2220c0d74272b4578c343 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-whitelisted-ips.png?w=560&maxW=571&auto=format&n=JpbB64sgI_r6D502&q=85&s=57853bca20f9f2a361a9ed9c208d9f67 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-whitelisted-ips.png?w=840&maxW=571&auto=format&n=JpbB64sgI_r6D502&q=85&s=5ebac449686d362f80da2172dd51cb4f 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-whitelisted-ips.png?w=1100&maxW=571&auto=format&n=JpbB64sgI_r6D502&q=85&s=99659fc680d666ab93e051e32a392f2d 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-whitelisted-ips.png?w=1650&maxW=571&auto=format&n=JpbB64sgI_r6D502&q=85&s=a38db6259b8ac75b5d2eb9c0bcbf8fe3 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-whitelisted-ips.png?w=2500&maxW=571&auto=format&n=JpbB64sgI_r6D502&q=85&s=de71a4809c85eaa9be38e634e7bc0896 2500w" data-optimize="true" data-opv="2" />
    3. 允许访问单个端口的 IP。 这些 IP 可以访问分配给它们的唯一端口。 转到端口设置（只需点击端口本身）
       <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-ports.png?maxW=565&auto=format&n=JpbB64sgI_r6D502&q=85&s=cbb2ebcbbf0455ae5d47906e6fe3f2ec" alt="proxy-ports.png" width="565" height="62" data-path="images/general/faqs/proxy-ports.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-ports.png?w=280&maxW=565&auto=format&n=JpbB64sgI_r6D502&q=85&s=1811d11c5e46cee38f8b00bac8ce655e 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-ports.png?w=560&maxW=565&auto=format&n=JpbB64sgI_r6D502&q=85&s=8846791e400343ecc364cb621bed5197 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-ports.png?w=840&maxW=565&auto=format&n=JpbB64sgI_r6D502&q=85&s=631fb81d7645b3367cc19f20ac0a1b85 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-ports.png?w=1100&maxW=565&auto=format&n=JpbB64sgI_r6D502&q=85&s=b14afa8c97b2369ddd93afa9f8e0d314 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-ports.png?w=1650&maxW=565&auto=format&n=JpbB64sgI_r6D502&q=85&s=11afc61c4227a89445b9c79d2ac2e55e 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-ports.png?w=2500&maxW=565&auto=format&n=JpbB64sgI_r6D502&q=85&s=e747555355d96d50066a342d724ed408 2500w" data-optimize="true" data-opv="2" />\
       转到“常规”，然后为“列入白名单的 IP”选择“添加 IP”。
       <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/add-ip.png?maxW=579&auto=format&n=JpbB64sgI_r6D502&q=85&s=c03be4faf6a92815b48f8e164cc875d4" alt="add-ip.png" width="579" height="113" data-path="images/general/faqs/add-ip.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/add-ip.png?w=280&maxW=579&auto=format&n=JpbB64sgI_r6D502&q=85&s=c157b93deeddc7c9bbe6773e0eb5388b 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/add-ip.png?w=560&maxW=579&auto=format&n=JpbB64sgI_r6D502&q=85&s=0a7e4e91e6dc98ec62a0e231580ce6a8 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/add-ip.png?w=840&maxW=579&auto=format&n=JpbB64sgI_r6D502&q=85&s=6c98c9ce03576d7421b11a811b15a87b 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/add-ip.png?w=1100&maxW=579&auto=format&n=JpbB64sgI_r6D502&q=85&s=5539b252636230bda8b4e9502ad37505 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/add-ip.png?w=1650&maxW=579&auto=format&n=JpbB64sgI_r6D502&q=85&s=84ca66970071abe156d6eb5d8b203931 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/add-ip.png?w=2500&maxW=579&auto=format&n=JpbB64sgI_r6D502&q=85&s=dc1e409a761e2a35d4c3a34b7d3ee7c5 2500w" data-optimize="true" data-opv="2" />

    此方法需要身份验证令牌。

    在远程服务器上运行以下命令：

    ```sh
    curl -X GET "http://127.0.0.1:22999/api/gen_token" -H "accept: application/json"
    ```

    这将为您生成一个身份验证令牌：

    ```sh 输出
    "token":"<API_KEY>"
    ```

    现在：

    * 将令牌从代理管理器服务器复制到新的网络爬虫服务器
    * 从您的新服务器发出此请求：

    ```sh
    curl <remote-server-IP>:22999/api/add_wip -X POST -H "Content-Type: application/json" -H "Authorization: <API_KEY>" -d '{"ip":"<CRAWLER_IP>"}'
    ```

    网络爬虫的 IP 现在已在代理管理器上列入白名单。

    <Warning>
      使用此方法加入白名单可授予访问所有端口的权限，而不是访问代理管理器用户界面/管理面板的权限。
    </Warning>
  </Accordion>

  <Accordion title="如何使用基于令牌的身份验证限制访问">
    当使用多个具有轮换 IP（指定远程安全的代理管理器为目标）的网络爬虫时，此工作流程是最佳的。 此方法需要身份验证令牌。

    从远程服务器内部运行 Terminal/CMD 中的下一个命令

    ```sh
    curl -X GET "http://127.0.0.1:22999/api/gen_token" -H "accept: application/json"
    ```

    这将为您生成一个身份验证令牌：

    ```sh 输出
    "token":" <API_KEY>"
    ```

    现在，您使用您刚刚创建的访问令牌即可发送请求：

    ```sh
    curl -x token:<API_KEY>@<remote-server-IP>:<Port> "target-site.com"
    ```
  </Accordion>

  <Accordion title="是否有办法知道我的公开数据是否被 Bright Data 的收集平台收集？">
    > **是**

    您可以在这里查看您的公开数据是否被收集：[https://brightdata.com/check\_your\_data。](https://brightdata.com/check_your_data。)
  </Accordion>

  <Accordion title="您只收集公共数据还是也收集私人数据？">
    我们从不收集私人数据。 我们只收集公开的数据。
  </Accordion>

  <Accordion title="什么是游乐场模式？">
    当您注册时，您的账户会在前三天自动进入“游乐场模式”，这样您无需添加付款方式即可立即尝试不同的 Bright Data 解决方案。

    要不受任何限制地测试或使用 Bright Data 的代理解决方案并获得5美元的免费信用额度，请验证您的账户以开始我们的30天有限试用。请注意，30天试用不适用于某些国家/地区。

    <Note>
      游乐场模式适用于小规模测试和探索，不适用于大规模测试或生产用途。 在您验证您的账户并开始我们的有限试用之前，产品的使用受速度、带宽和每秒请求数等限制。
    </Note>
  </Accordion>

  <Accordion title="什么是有限试用模式？">
    有限试用模式允许您免费探索我们的 Bright Data 代理解决方案，无需立即付款。您将获得5美元的信用额度，可用于在30天内使用我们的任何代理服务，这样您就有整整一个月的时间来测试和体验我们的产品。

    请注意，30天试用不适用于某些国家/地区。如果您没有看到此选项，请向您的账户添加资金以开始使用 Bright Data——您只需添加10美元，即可开始“即付即用”计划。

    #### 如何验证我的账户以开始“有限试用”并获得5美元的信用额度？

    账户验证非常简单，而且免费。 只需向您的账户添加有效的付款方式即可开始有限试用模式并获得5美元的信用额度。您不会被收费。

    #### 30天试用后会发生什么？

    在30天试用期结束时，您的免费信用额度将过期（如果尚未使用），您需要向您的账户添加资金才能继续使用我们的平台。

    #### 我是否可以将免费信用额度用于你们的任何代理产品？

    是，在试用期间，5美元的试用信用额度可用于我们的任何代理产品，让您可以测试最适合您需求的产品。
  </Accordion>

  <Accordion title="为什么我无法连接到 brightdata.com 网站或控制面板？">
    在极少数情况下，某些广告拦截程序/扩展程序可能会阻止对 Bright Data 网站的访问。 如果您遇到任何问题，请将 brightdata.com 列入白名单或禁用广告拦截器。
  </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           |
    | Russian Federation (the)                                   | ru           |
    | 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](www.brightvpn.com) - it is available for Windows and macOS, and does not even require you to open an account, ensuring complete anonymity.
  </Accordion>
</AccordionGroup>


# 消费者如何加入 Bright Data 对等网络
Source: https://docs.brightdata.com/cn/general/policy/How_do_consumers_join_the_Bright_Data_network_of_peers_



许多应用程序（例如游戏应用程序）要求其用户每隔一定时间间隔观看视频广告，以便游戏开发者能够产生收入。这会导致特别糟糕的用户体验，因为它会干扰对应用程序的体验，为广告浪费大约 20MB 的蜂窝数据，并耗尽用户的电池电量。

Bright Data 提供了一个极具吸引力的替代方案。

当这些应用程序供应商集成 Bright SDK 时，他们的用户可以选择不观看这些视频广告，以换取加入 Bright Data 网络。 Bright Data 仅在设备未使用时（因此绝不会干扰用户的体验）、设备插入电源或充电时才将其设备用作网络上的节点，并且始终优先使用 WiFi 而不是蜂窝数据。

对于选择加入 Bright Data 网络的每位用户，Bright Data 都会向应用程序供应商支付月费，而应用程序供应商则通过不展示广告（或者在某些情况下不为额外功能收取额外费用）将这笔价值转嫁给用户。

这为用户提供了显著改善的用户体验，因此应用程序供应商的产品也获得了更高采用率。

用户选择加入 Bright Data 网络，并且可以随时选择退出。 Bright Data 确保其应用程序合作伙伴完全遵守这种“选择加入”用户流程。

在我们的[Bright SDK](https://bright-sdk.com/)页面上查看更多信息。


# 隐私政策
Source: https://docs.brightdata.com/cn/general/policy/Privacy_Policy



<sub>*上次更新日期：2021年12月7日*</sub><br />
<sub>*上次审核日期：2022年10月31日*</sub>

在Bright Data，我们从事的是数据业务，正因为如此，我们非常重视数据隐私。我们的客户委托我们提供干浄、合规和符合道德标准的数据以协助其业务，同时保持最高的隐私标准。 我们的产品和服务遍及世界各地，因此，我们持续监控不断变化的全球隐私环境，并进行相应调整，以确保完全遵守隐私法律（包括欧盟的GDPR和加利福尼亚州的CCPA）。如果您是加利福尼亚州居民，请参阅本政策末尾的CCPA隐私声明。

本隐私政策既适用于主动选择使用我们服务的用户（如下所述），也适用于我们在运营中可能会处理其个人数据的个人。

欢迎继续阅读以了解我们的隐私政策详细内容，或者，如果对我们的政策或数据守法方面有任何疑问，请联系我们。

BrightData（下称“Bright Data”或“我们”）是brightdata.com网站（下称“本网站”）、BrightData软件（下称“本软件”）、Bright Data SDK（下称“SDK”）Bright Data SDK以及我们提供的任何配套服务、功能、内容和应用程序（以下统称为“本服务”）的所有者。我们关心您的隐私，并制定了本隐私政策，以帮助您决定是否使用本服务，并提供有关我们隐私准则的所有必要信息。 访问和使用本服务，或以其他形式向我们提供信息，即表示您同意并接受本隐私政策的条款（将会不时修订），并同意我们根据本隐私政策规定的方式收集和使用信息（如适用于您）。 我们建议您仔细阅读本隐私政策并定期查阅，以了解其内容及随后的任何更改。 如果您不同意本隐私政策的条款，请立即停止使用本服务，并且卸载（如适用）。

### [我们收集哪些类型的信息？](https://brightdata.com/privacy#info-types)

当您使用本服务时，我们会向您收集以下类型的数据（下称“用户数据”）：

* 非个人信息。 这些是未识别身份和无法识别身份的信息，由用户的活动生成。此类非个人信息可能包括以下信息──浏览器类型、您访问的网页、在这些页面上花费的时间、访问时间和日期。
* 个人信息。 个人信息是能够识别您身份或可能可以识别您身份的信息。 我们收集和保留的个人信息包括您的IP地址、姓名和电子邮件地址、身份证明文件（驾驶执照/身份证/护照）、办公/住宅住址、网名、付款和账单信息，或我们因注册过程和服务提供所需而可能不时要求的的其他信息。 在某些情况下，我们可能会录下与您的音频或视频通话，以符合我们必须遵守的用户合规评估要求和我们的内部指引。 当您在本服务上创建账户时，可以使用Gmail®等指定的第三方网站或服务（下称“第三方账户”）的凭据来创建账户。这样做，您就能够将您的账户和您的第三方账户关联。 如果您选择此选项，将出现一个第三方账户弹出框，其中会说明我们要获取的信息类型，您需要批准才能继续。 这些信息包括存储在您的第三方账户中的个人信息，例如用户名、电子邮件地址、头像、生日、性别和首选项。 任何与个人信息有明确联系或关联的匿名信息，均会在这种联系或关联存在期间被视为个人信息。
* 通过社交网络账户注册：当您通过社交网络账户（例如 Facebook、Google+）注册或登录本服务时，我们将能够访问您的社交网络账户中的基本信息，如您的全名、住宅地址、电子邮件地址、出生日期、头像、好友列表、个人描述，以及您在该账户上公开或同意与我们分享的任何其他信息。 在任何时候，我们都会遵守社交网络平台的条款、条件和限制。

如果我们将非个人信息与个人信息合并，我们会将合并后的信息视为个人信息。

我们还可能从各种在线来源收集公开发布的个人数据。 此类信息通常包括基本联系信息，如姓名、电子邮箱和职称（下称“公开数据”）。

### [处理的法律依据](https://brightdata.com/privacy#info-processong)

为了履行我们对您的合同义务和向您提供服务、保护我们的合法利益以及遵守我们的法律义务，我们必须处理用户数据。

公开数据的处理是根据我们的合法利益进行的，前提是此类利益不凌驾于您的基本权利和自由之上。

### [我们如何使用您的信息？](https://brightdata.com/privacy#info-use)

我们使用用户数据是为了向您提供本服务，并遵守我们的法律要求和内部指引。 这意味着我们将使用这些信息来设置您的账户；向您提供有关本服务的支持；就更新、营销优惠或您可能有的问题与您沟通，以及进行统计和分析研究以改善本服务。 为了向用户提供本服务，我们可能会使用公开数据。

我们不会出租或出售任何用户数据。 为了提供本服务，我们可能会与用户分享公开数据。

为了向您提供本服务、存储和分析，以及遵守我们的法律规定和内部指引，我们可能会其他可靠的第三方服务提供商或合作伙伴披露个人信息。 我们还可能向我们的子公司和关联公司转移或披露个人信息。

尽管有上述条款，我们不会向其他客户披露您的IP地址。 但是，当其他客户（例如网络中的其他对等点）使用您的IP地址访问网络时，他们可能会看到该IP地址，例如在查询其当前IP地址时。

在特殊情况下，如果我们有充分理由认为有必要：(1) 遵守法律、法规、传票或法院命令；(2) 侦测、防止或以其他方式处理欺诈、安全问题、违反我们政策的行为或技术问题；(3) 执行本隐私政策或您与我们之间的任何其他协议的条款，包括调查潜在违规行为；(4) 保护我们、我们的合作伙伴、我们的关联公司、用户或公众的权利、财产或安全，则我们也可能会分享您的个人信息和其他信息。

### [在EEA之外处理数据](https://brightdata.com/privacy#data-outside-eea)

请注意，我们的总部位于以色列，而上述的一些数据接收方可能位于欧洲经济区（EEA）之外。 在这种情况下，我们仅会与位于欧盟委员会批准的能提供足够数据保护水平的国家/地区的接收方分享您的数据，或者签订法律协议以确保数据保护水平足够。

### [安全和保密](https://brightdata.com/privacy#security)

我们使用符合行业标准的信息、安全工具和措施，以及内部程序和严格的指引，以防止信息滥用和数据泄露。 我们的员工有保密义务。 我们使用的措施和程序大大降低了数据滥用的风险，但我们无法保证我们的系统绝对安全。 如果您发现任何潜在的数据泄露或安全漏洞，请立即联系我们。 我们将采取一切措施（包括必要的预防措施）来调查事件。

### [您的选择和权利](https://brightdata.com/privacy#rights)

我们努力为您提供快速更新信息或删除信息的方式，除非我们出于合法的商业或法律目的而必须保留这些信息。 在更新您的个人信息时，我们可能会要求您验证身份，然后才能按照您的请求行事。

如果您是欧盟居民，请注意，以下特定权利适用于您的个人信息：(1) 获取确认以了解您的个人信息是否正在受到处理，并访问被存储的您的个人信息以及补充信息；(2) 获取您直接自愿提供给我们的个人信息副本，副本为结构化、常用和机器可读取的格式；(3) 要求更正我们控制下的您的个人信息；(4) 要求删除您的个人信息；(5) 反对我们处理您的个人信息；(6) 要求限制我们处理您的个人信息；(7) 向监督机构投诉。

但是，请注意，这些权利并非绝对的，可能会受我们自身合法利益和监管要求的限制。

要行使此类权利，您可以发送电邮至[privacy@brightdata.com](mailto:privacy@brightdata.com)联系我们：

### [信息保留](https://brightdata.com/privacy#retention)

我们将在提供本服务所需的时间内保留您的个人信息，以及在履行我们的法律义务、解决争议和执行我们的政策所需时保留您的个人信息。 保留期将取决于收集的信息类型和收集目的，并考虑到适用于该情况的规定，以及尽早在合理的时间内销毁未使用的过时信息的必要性。

我们可能随时自行更正、补充或移除不完整或不准确的信息。

### [信息保证免责声明](https://brightdata.com/privacy#warranty)

即使本政策中有其他规定，但我们对我们收集、存储和向您或他人披露的信息的准确性、正确性和安全性概不负责。

我们的政策仅适用于我们向您收集的信息的使用和披露。 如果您通过互联网向其他方或网站披露您的信息，不同的规则可能适用于其他方或网站对您向其披露的信息的使用或披露。 因此，我们建议您阅读您选择向其披露信息的每个第三方的条款和条件以及隐私政策。

### [所有权变更](https://brightdata.com/privacy#change-ownership)

如果Bright Data全部或部分的所有权或控制权发生变化（包括但不限于收购、合并或出售），我们保留将我们系统中存储的全部或部分用户数据和公开数据转移的权利。 您确认，在破产、资不抵债或被接管的情况下，我们可能无法控制您个人信息的使用和转移。

### [本隐私政策的变更](https://brightdata.com/privacy#privacy-change)

我们可能会不时自行决定修订本政策，因此请定期查閲。 上次修订日期会显示在“上次更新日期”标题中。本政策的任何变更都会在本网站上发布。 您在任何此类变更后继续使用本服务，将被视为您同意修订后的隐私政策。

### [联系我们](https://brightdata.com/privacy#contact-us)

如果您认为您的隐私未按照我们的隐私政策处理，或者您认为在使用本服务的过程中您的隐私受到任何人的损害，请发送电邮至[privacy@brightdata.com](mailto:privacy@brightdata.com)与Bright Data联系，我们的隐私专员将立即进行调查。

我们还在欧盟和英国任命了GDPR代表。 您可以就GDPR相关事宜联系这些代表：

GDPR - 欧洲代表：

根据GDPR第27条，Bright Data已任命欧洲数据保护办公室（EDPO）为其在欧盟的GDPR代表。 您可以就GDPR相关事宜联系EDPO，联系方式如下：

* 使用EDPO的在线申请表：[https://edpo.com/gdpr-data-request/](https://edpo.com/gdpr-data-request/)
* 致函EDPO（地址：Avenue Huart Hamoir 71, 1030 Brussels, Belgium）

英国《通用数据保护条例》（GDPR）- 英国代表：

根据英国GDPR第27条，Bright Data已任命EDPO UK Ltd为其在英国的英国GDPR代表。 您可以就英国GDPR相关事宜联系EDPO UK，联系方式如下：

* 使用EDPO的在线申请表：[https://edpo.com/uk-gdpr-data-request/](https://edpo.com/uk-gdpr-data-request/)
* 致函EDPO UK（地址：8 Northumberland Avenue, London WC2N 5BY, United Kingdom）

### [加利福尼亚州居民隐私声明](https://brightdata.com/privacy#privacy-california)

本声明是关于2018年《加利福尼亚州消费者隐私法案》（Civ. §§ 1798.100–1798.199）和总检察长制定的《加利福尼亚州消费者隐私法案条例》（以下统称为“CCPA”）中的具体披露规定。

如果您有残障，可以访问本隐私政策的其他格式，请联系[privacy@brightdata.com](mailto:privacy@brightdata.com)

在过去的12个月中，我们收集并披露了以下类别的个人信息：

<table>
  <tbody>
    <tr>
      <th>收集的个人信息类别</th>
      <th>收集的个人信息</th>
      <th>向其披露个人信息的服务提供商类别</th>
    </tr>

    <tr>
      <td>A. 标识符。</td>
      <td>B. 全名、电子邮件地址、设备标识符（包括某些软件和硬件信息，例如IP地址、互联网服务提供商、域服务器、计算机类型、浏览器类型、语言和操作系统）。</td>
      <td>C. 云服务。<br />D. 网站分析。<br />E. 关联公司。</td>
    </tr>

    <tr>
      <td>F.《加利福尼亚州客户记录法规》（Cal. Civ. Code § 1798.80(e)）中列出的个人信息类别。</td>
      <td>G. 地址、电话号码、财务信息（例如信用卡号）。</td>
      <td>H. 云服务。<br />I. 关联公司。</td>
    </tr>

    <tr>
      <td>J. 商业信息。</td>
      <td>K. 用户反馈。</td>
      <td>L. 云服务。<br />M. 关联公司。</td>
    </tr>

    <tr>
      <td>N. 互联网或其他电子网络活动信息。</td>
      <td>O. Information regarding the user's interaction with the website.</td>
      <td>P. 云服务。<br />Q. 网站分析。<br />R. 关联公司。</td>
    </tr>

    <tr>
      <td>S. 地理位置数据。</td>
      <td>T. 根据设备标识符确定的地理位置数据。</td>
      <td>U. 云服务。<br />V. 关联公司。</td>
    </tr>

    <tr>
      <td>W. Professional or<br />Employment-related Information.</td>
      <td>十、当前或过去的工作经历。</td>
      <td>Y. 云服务。<br />Z. 关联公司。</td>
    </tr>
  </tbody>
</table>

### [个人信息来源](https://brightdata.com/privacy#sources-of-info)

在过去的12个月中，我们从以下类别的来源收集了上述类别的个人信息：

* 通过本服务直接向消费者收集；
* 操作系统。
* 从在线来源收集的公开信息。

### [出售个人信息](https://brightdata.com/privacy#selling-info)

在过去的十二（12）个月中，我们可能为了商业目的而向第三方或企业出售了以下类别的个人信息：

* 标识符；

### [CCPA规定的用户权利](https://brightdata.com/privacy#undefined)

### [访问个人信息](https://brightdata.com/privacy#access-info)

您可以要求我们向您披露我们收集的关于您的个人信息的类别和具体内容、收集您的个人信息的来源类别、收集您的个人信息的业务或商业目的、我们为了业务目的披露的个人信息类别、我们出售的关于您的个人信息任何类别、我们与之共享您个人信息的第三方类别，以及出售您个人信息的业务或商业目的（如适用）。

### [删除请求](https://brightdata.com/privacy#deletion-request)

您有权要求我们删除向您收集并保留的任何个人信息，例外情况除外。

當我们收到并确认您的可验证消费者请求后，我们就会删除（并指示我们的服务提供商、分包商和顾问删除）您的个人信息，例外情况除外。

### [行使您的权利](https://brightdata.com/privacy#exercise-rights)

Y您可以向我们提交可验证的消费者请求，以行使您的权利（例如访问和删除），要提交请求请发送电邮至[privacy@brightdata.com](mailto:privacy@brightdata.com)，或拨打免费电话1-888-538-9204。您也可以致函我们的实体地址（列于本政策中）。\
只有您本人或经授权代表您行事的人才能提出与您的个人信息相关的消费者请求。

在请求中必须：

* 提供足够的信息，使我们能够合理地验证您是我们收集个人信息的本人或授权代表。
* 提供足够细节，详细描述您的请求，让我们能够正确理解、评估和回应您的请求。
* 如果我们无法验证您的身份或提出请求的权限、无法确认该个人信息与您相关，则我们无法回应您的请求或向您提供个人信息。 要提出可验证的消费者请求，不需要在我们这里创建账户。 我们只会将在可验证的消费者请求中提供的个人信息用于验证请求者的身份或提出请求的权限。

在12个月内，您最多只能请求两次数据副本。

如对我们收集的关于您的个人信息以及我们如何使用这些信息有一般的问题，请发送电邮至[privacy@brightdata.com](mailto:privacy@brightdata.com)联系我们

### [响应时间和格式](https://brightdata.com/privacy#response-time)

我们的目标是在收到可验证的消费者请求后的45天内回复。 如果我们需要更多时间，我们将在前45天内向您发出书面通知，说明原因和要延期多久。 我们将根据您的选择，通过信函或电子方式提供书面回复。 我们提供的任何披露将仅涵盖提出请求之前的12个月期间。 在合理可能的情况下，我们将以易于使用的格式提供您的个人信息，并让您可以不受阻碍地传输信息。

除非您的请求过多、重复或明显没有根据，否则我们不会收取处理或回复可验证消费者请求的费用。 如果我们确定该请求需要付费，我们将告诉您我们做出这一决定的原因，并在完成您的请求之前向您提供费用估算。

如果拒绝请求，我们将在回复中解释不能满足您的请求的原因。

请注意，这些CCPA权利并非绝对的，请求受任何适用的法律规定（包括法律和道德报告或文件保留义务）的约束。

### [指定代理人](https://brightdata.com/privacy#designating-agents)

在以下情况下，您可以指定授权代理人代表您根据CCPA提出请求：

* 授权代理人是向加利福尼亚州州务卿注册的自然人或企业实体；以及
* 您签署了一份书面声明，授权该授权代理人代表您行事。

如果您使用授权代理人提交行使知情权或删除权的请求，请邮寄一份经认证的书面声明副本以授权该授权代理人代表您行事，地址见于下列的联系信息。

如果您根据《遗嘱检验法典》第4000至4465条向授权代理人提供授权委托书，则可能无需执行这些步骤，我们将根据CCPA回复该授权代理人的任何请求。

### [无歧视](https://brightdata.com/privacy#non-discrimination)

如果您以加州消费者身份行使任何隐私权，不会受到我们歧视。 除非CCPA允许，否则我们不会：

* 拒绝向您提供商品或服务。
* 向您收取不同的商品或服务价格或费率，包括给予折扣或其他优惠，或施加罚款。
* 向您提供不同水平或质量的商品或服务。
* 建议您可能会获得不同的商品或服务价格或费率，或不同水平或质量的商品或服务。


# 什么是 Bright Data 平台？
Source: https://docs.brightdata.com/cn/general/policy/What_is_Bright_Data_platform



Bright Data Network 为您精确提供所需数据，让您的业务、项目研究或计划变得与众不同。它通过为个人用户和企业提供直接、便捷的访问来实现这一目标。 个人用户可通过最先进、最安全的平台 Bright VPN 获得访问权限。 企业或公司则可使用 Bright Data Collector 平台。 因此，Bright Data 实际上是虚拟互联网服务提供商 (ISP)。


# Bright Data 主服务协议
Source: https://docs.brightdata.com/cn/general/policy/license

_最后更新于 2023 年 7 月 12 日_

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/policy/license/service_agreement.svg?maxW=667&auto=format&n=JpbB64sgI_r6D502&q=85&s=a6761f35d151007003afbd68eb9beeef" alt="service_agreement.svg" width="667" height="233" data-path="images/general/policy/license/service_agreement.svg" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/policy/license/service_agreement.svg?w=280&maxW=667&auto=format&n=JpbB64sgI_r6D502&q=85&s=753e87622769ff43a0d16a8aedd4a7d9 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/policy/license/service_agreement.svg?w=560&maxW=667&auto=format&n=JpbB64sgI_r6D502&q=85&s=994829ace63d4abb34a8353fea5067f7 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/policy/license/service_agreement.svg?w=840&maxW=667&auto=format&n=JpbB64sgI_r6D502&q=85&s=e131a3779647843d37308de3d977e75e 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/policy/license/service_agreement.svg?w=1100&maxW=667&auto=format&n=JpbB64sgI_r6D502&q=85&s=39a8f1b618622d33e752e2c379e10391 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/policy/license/service_agreement.svg?w=1650&maxW=667&auto=format&n=JpbB64sgI_r6D502&q=85&s=17d84cd6960d94b6560b2cda5c50ad66 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/policy/license/service_agreement.svg?w=2500&maxW=667&auto=format&n=JpbB64sgI_r6D502&q=85&s=135d879ec4d5fecbb22a2a5d40f7ffe8 2500w" data-optimize="true" data-opv="2" />

本主服务协议（**“协议”**）是地址位于以色列内坦亚哈马谢夫街 4 号的 Bright Data 有限公司（**“Bright Data”**）与您或您所代表的实体（**“客户”**）之间达成的协议。本协议在您注册 Bright Data 时生效，或在您访问或使用Bright Data 服务时（如果此时间更早）生效，如下定义（**“生效日期”**）。如果您代表实体使用 Bright Data服务，则您向我们声明，您可以合法地代表客户签订本协议。

## Bright Data 职责

1. Bright Data 将根据本协议的规定，包括 Bright Data[的服务等级协议](https://brightdata.com/sla)（如果适用），向客户提供本协议中详述的或 Bright Data 平台上以其他方式提供的任何服务（**“服务”**）。Bright Data有权但没有义务出于计费目的监控客户对服务的使用，并核实没有误用或滥用网络的情况。如果 Bright Data认定有必要遵从任何传票、司法或政府要求或命令，如有投诉、调查或诉讼等情况，Bright Data可以与任何机构分享客户的相关信息。
2. 在 Bright Data成功完成客户合规审查程序后，将提供相关服务。此类审查可能包括 “了解您的客户”流程、与客户的视频通话以及 Bright Data自行决定批准客户使用服务所需的任何其他措施。客户将与 Bright Data合作，向其提供合规审查过程中合理要求的任何信息。

## 临时暂停

如果 Bright Data 自行确定出现以下情况，Bright Data可随时自行决定在通知客户后立即暂停客户访问或使用服务的权利：

1. 如果 Bright Data 自行确定出现以下情况，Bright Data可随时自行决定在通知客户后立即暂停客户访问或使用服务的权利：
2. 客户违反本协议，包括客户拖欠付款义务；或
3. 客户违反本协议下的任何陈述和保证，或向 Bright Data提供的与客户使用服务相关的任何其他陈述和保证。

## 客户保证和陈述

客户向 Bright Data 保证、陈述和承诺：

总则

1. 请注意，只有年满 18岁且至少达到适用司法管辖区允许的法定年龄的个人才能使用服务。如上所述，客户声明并保证就其个人而言，其已达到法定年龄。 客户进一步认可，Bright Data可能要求提供年龄证明作为提供服务的条件。
2. 如果本服务的使用将包含任何旨在由 Bright Data 作为“处理者”（此术语在适用的隐私立法中予以定义）进行处理的个人信息，则服务的提供也将受 [数据保护附录](https://brightdata.com/wp-content/uploads/2023/07/Bright-Data-Data-Protection-Agreement.pdf)的约束。
3. 客户将对其基于使用服务而采取的任何行为承担全部责任。
4. 客户有责任保护其使用服务的个人用户名和/或密码。客户不得与任何人共享其账户权限，也不得故意允许任何未经授权访问本服务的行为。如果检测到共享，则相关人员的账户将被禁用。
5. 客户不得在违反适用法律或法规或任何第三方权利（包括知识产权）的情况下使用服务，也不得以出于除提供给Bright Data的预期用例（如果适用）中所述的目的以外的任何方式或目的使用本服务。
6. 在不减损上述通则的前提下，客户只能按[照可接受使用政](https://brightdata.com/acceptable-use-policy)策使用服务，该政策可能会不时修订。
7. <u>代理服务的具体条款<br /></u>使用代理服务时，客户：\
   I. 不得使用本服务：(i)散布破解软件、warez、ROM、病毒、广告软件、蠕虫、特洛伊木马、恶意软件、间谍软件或任何其他类似的恶意活动和产品，或任何其他旨在中断、劫持、破坏、限制或对任何计算机软件、硬件、网络或电信设备功能产生不利影响的计算机代码、文件或程序；(ii)导致其目标用户无法使用任何网络资源，包括但不限于，通过 “拒绝服务 (DoS)” 或 “分布式拒绝服务 (DDoS)” 攻击；(iii)散布任何非法内容或鼓励任何非法活动；(iv)对任何第三方计算机或服务造成任何损害或服务中断；或(v)增强或运营与\
   II. 不得使用侵犯 Bright Data专利及其他知识产权的其他系统、产品或服务。\
   III. 未经 Bright Data事先书面授权，不得参与本服务的全部或部分转售。\
   IV. 未经 Bright Data事先书面批准，不得允许他人复制、反编译、反向工程、反汇编、尝试获取本服务或 Bright Data提供的任何服务或其任何部分的源代码、解密、修改或创建衍生作品，包括但不限于使用本服务对 Bright Data在提供服务时使用的 IP 地址进行映射。特此澄清，在提供服务时使用的 IP地址是个人和机密信息，严禁未经授权使用此类信息，未经授权使用此类信息可能会被视为违反适用法律和/或第三方权利。
8. <u><span>数据服务的具体条款（包括但不限于数据集、网页抓取工具 IDE 和 Bright Insights）</span><br /></u>使用数据服务时，客户不得散发、传输、复制、发布、许可、转让或出售任何数据，以提供类似或有竞争力的产品。

## 注意事项

1. 免费试用期结束后（如果得到 Bright Data 的授权），客户将输入有效的付款方式，作为进一步使用或访问服务的条件，具体费用以客户控制面板或特定插入订单或其他工作说明中规定的金额为准（**“订阅费”**）。订阅费不可取消，也不可退款。
2. 价格不含任何预扣税或其他税款，客户应负责支付所有此类适用的税款、征税或关税。
3. 客户同意接收 Bright Data 的电子发票和收据。
4. 如果未按照本协议条款支付订阅费，客户同意支付客户账户中任何未付差额的追讨成本和费用，包括但不限于律师费、法庭费用以及 Bright Data产生或支付的任何其他费用。

## 机密信息

如果一方（**“接收方”**）获得另一方（**“披露方”**）与本协议的谈判或履行相关的机密信息（定义见下文）的访问权限，则接收方同意：

1. 披露方应保留机密信息的所有权，接收方不得获得其中的任何权利，但在本协议规定的范围内使用此类机密信息的权利除外；
2. 接收方应至少采取与接收方保护自身机密信息相同的谨慎措施，保护机密信息免遭未经授权的披露或访问，且不得少于合理的谨慎措施，包括防止此类机密信息遭到未经授权的使用、访问、破坏、丢失和修改的措施；
3. 除非本协议中另有规定，否则接收方不得出于任何目的向任何第三方提供根据本协议披露的任何机密信息，但需要了解机密信息才能履行本协议的顾问、律师、分包商或潜在分包商除外，前提是他们同意受本条的条款和条件或其他足以要求他们根据本协议处理机密信息的书面协议的约束。接收方同意就任何违背或违反此类限制的行为向披露方进行赔偿。

**“机密信息”** 是指披露方向接收方披露的与协议相关的所有信息，无论是口头形式、视觉形式还是书面形式，包括但不限于：所有规格、公式、原型、计算机程序和所有记录、数据、想法、方法、技术、流程和预测、计划、营销信息、材料、创意、脚本和故事板、财务报表、备忘录、分析、注释、法律文件和其他数据和信息（无论以何种形式），以及改进、专利（无论是申请中的还是已正式注册）、商业秘密、任何专有技术、客户名单、客户信息、最终用户信息，以及第三方根据保密协议向披露方提供或披露方有法律义务保密的与披露方相关的任何信息，以及接收方通过视察披露方的物产而从披露方获悉的与披露方的产品、设计、商业计划、商业机会、财务、研究、开发、专有技术或人员相关的信息。本协议下的订阅费应被视为机密信息。\
机密信息将不包括：

1. 接收方合法地从有权转让或披露信息的第三方那里获得的信息，这种行为不会违约或违反本协议；或
2. 接收方先前合法知悉且没有任何保密义务的信息；或
3. 未因接收方不当行为而公开的信息；或
4. 由接收方独立开发的信息，在此过程中无需参考、使用或访问披露方的机密信息。

接收方可能会根据传票、司法或政府要求或命令披露机密
信息，在这种情况下，接收方不承担任何此类机密信息披
露的损害赔偿责任。

本协议下的保密义务将在本协议到期或终止后继续有效。

## 免责声明

BRIGHT DATA “按原样”提供服务及任何附带数据的使用，明确拒绝对服务或任何附带数据的条件、价值或质量作出任何明示或暗示的陈述和保证，包括但不限于对适销性、特定用途的适用性、非侵权、安全性、准确性、无病毒或其中任何缺陷的任何担保，以及因使用过程、交易、使用或贸易惯例而产生的保证。BRIGHT DATA进一步明确拒绝陈述或保证，即服务的使用将是连续的、不间断的或无错误的，或者其中包含的任何信息将是准确或完整的。

## 责任限制

在任何情况下，根据本协议，Bright Data 均不对与本协议（**“事件”**）相关的任何后果性、特殊性、间接性或惩罚性赔偿或任何损失、利润或收入（无论是合同、侵权、过失还是任何其他法律理论）承担任何责任，即使 Bright Data事先已被告知此类损害赔偿的可能性。根据本协议，Bright Data对任何索赔或损害赔偿或一系列此类索赔或损害赔偿的总责任仅限于 Bright Data在事件发生前一个月内根据本协议从客户那里实际收到的费用金额。

## 赔偿

如果第三方指控客户对任何服务的使用侵犯或盗用该第三方的知识产权，或违反适用的隐私法或任何其他适用法律或对该第三方造成损害，客户则将为 Bright Data抗辩，免除该第三方对 Bright Data提出或提起的任何索赔、要求、诉讼或程序（**“针对 BrightData的索赔”**），赔偿 Bright Data 因法院批准的针对Bright Data 的索赔和解而最终裁定由 Bright Data支付的任何直接损失和律师费，或 Bright Data根据法院批准的针对 Bright Data的索赔和解支付的任何金额，前提是 Bright Data (a)立即向客户发出针对 Bright Data 的索赔的书面通知，(b)给予客户针对 Bright Data索赔的抗辩与和解的全权控制权（除非客户无条件免除Bright Data 的所有责任，否则客户不得就针对 BrightData 的任何索赔达成和解），(c)给予客户一切合理的协助，费用由客户承担，以及（d）未经客户事先书面同意，Bright Data不得就此事进行谈判或达成任何和解。客户的上述义务不适用于仅基于 Bright Data违反本协议而对 Bright Data 提起的索赔。

## 期限和终止

1. 本协议自生效日期起生效，将持续到根据本协议的条款终止为止。
2. 除非双方另行商定的时间表或工作说明为提供服务之目的设定预先确定的期限，否则任何一方均有权在该日历月结束之前提前向另一方发出书面通知，立即终止本协议。本协议将在收到书面通知的日历月底终止，一方不会因此而对另一方承担任何责任。
3. 在下列情况下，Bright Data有权以书面形式通知客户“原因”立即终止本协议，（a）客户的任何行为或疏忽使 Bright Data有权暂停其访问或使用第 2节所述的系统（定义见下文）或服务；（b）客户违反本协议中的任何陈述或保证或向 Bright Data提供的与客户使用系统或服务相关的任何其他陈述和保证;（c）客户参与根据任何适用的法律或法规会将 BrightData 置于风险之中的行动或活动，具体由 Bright Data自行确定。Bright Data对本协议的终止不对客户或任何第三方承担任何责任。
4. 终止后，任何未付的对价金额立即到期应付（包括但不限于采集的数据，即使尚未提供给客户），此处授予的许可证将终止，客户应立即停止使用系统或服务。

## 特定服务条款

在不减损本协议其他条款通则的前提下，以下条款适用于客户希望从 Bright Data 获得的特定服务：

1. **代理服务和抓取浏览器 API**。\
   I. Bright Data开发、拥有并提供一项服务，该服务重定向用户通过其他用户的设备（“系统”）进行的通讯，从而使其可以匿名浏览互联网。根据本协议，本系统的这种用途可供商用。\
   II. 在本协议期限内，Bright Data授予客户有限的、可撤销的、不可转让的许可（无再许可权），允许其仅出于客户内部业务运营的目的访问和使用系统。\
   III. Bright Data保留本协议中未明确授予的任何及所有权利，包括但不限于对系统的所有权利。\
   IV. Bright Data可以保留客户采集的数据，并可自行决定将其用于自己的目的。\
   V.客户可以选择通过实施 “缓存代理”解决方案提高数据检索性能。在这种情况下，客户认可并同意，检索到的数据可能不是最新的可用数据。
2. **Web Scraper IDE.**\
   I. Bright Data开发、拥有并提供数据采集服务，该服务根据本协议中的条款采集并向其用户提供公开可用的数据。\
   II. 如果 Bright Data自行确定此类条款可能侵犯或违反任何适用的法律或法规或任何其他第三方权利，Bright Data则不会提供服务或数据。\
   III. 客户对数据采集服务的使用受所有适用法律的约束，包括但不限于数据保护和隐私法。在适用于个人数据处理的范围内，客户全权负责确定合法依据、提供通知、尊重数据主体权利及所有其他相关义务。
   IV. Bright Data可以保留其所采集或交付给客户的数据，并可自行决定将其用于自己的目的。
3. **数据集服务**。\
   I. Bright Data可能会不时以各种费用提供各种类别的数字信息数据集（**“数据集”**）。\
   II. 数据集只能用于合法有效的目的，并符合可能适用的国内和国际所有适用法律，包括但不限于适用的隐私和营销传播立法。\
   III. 数据集可能包含管辖此类数据集使用的其他条款和条件。\
   IV. 对于订阅购买数据集，将在可用时提供更新。\
   V. 任何数据集的变更请求均需获得 Bright Data的事先批准，并可能产生额外费用，具体费用将由客户与Bright Data 商定。
4. **数据洞察**\
   I. Bright Data 可能提供一项服务，旨在根据 Bright Data提供的预定数据集生成各种数据洞察。\
   II. 本协议的条款，包括但不限于有关免责声明和责任限制的条款，将管辖此类洞察的提供和可能的使用。\
   III. 这些洞察不构成法律、财务、商业或其他建议，对此类洞察的任何依赖完全由客户自行决定并自行承担风险。\
   IV. 未经 Bright Data 事先书面批准，Bright Data Insights中包含的信息不得与第三方共享。

## 其他

1. 本协议构成双方就此提及的事项达成的全部谅解。
2. 本协议下的所有通知或其他通讯均应通过电子邮件发送到双方在注册本服务时提供的电子邮件地址。
3. 在适用法律未禁止的范围内，客户放弃以集体诉讼形式在法庭或仲裁程序中提起与本协议相关的任何争议的权利，无论是作为集体诉讼的一员还是作为代表。
4. 本协议受以色列国法律管辖，排除其法律冲突规则，Tel-Aviv-Jaffa 法院对双方拥有专属管辖权。
5. 如果本协议的任何条款被具有司法管辖权的法院认定为与任何法律相抵触，则其余条款仍将完全有效，如同该条款从未存在一样。
6. 本协议任何一方未能或延迟行使本协议项下的任何权利、权力或补救措施，均不构成对该等权利、权力或补救措施的放弃。
7. Bright Data可在通知或不通知客户的情况下随时自行决定修订本协议。任何此类修订将在公开发布后立即生效。客户在进行任何此类修订后继续使用系统和服务，即表示接受修订后的协议。
8. Bright Data 可能会在宣传材料和 Bright Data的网站上使用客户的名称和/或徽标。

服务协议

* [Bright Data 职责](https://brightdata.com/license#toc_1_2)
* [临时暂停](https://brightdata.com/license#toc_1_3)
* [客户保证和陈述](https://brightdata.com/license#toc_1_4)
* [注意事项](https://brightdata.com/license#toc_1_5)
* [机密信息](https://brightdata.com/license#toc_1_6)
* [免责声明](https://brightdata.com/license#toc_1_7)
* [责任限制](https://brightdata.com/license#toc_1_8)
* [赔偿](https://brightdata.com/license#toc_1_9)
* [期限和终止](https://brightdata.com/license#toc_1_10)
* [特定服务条款](https://brightdata.com/license#toc_1_11)
* [其他规定](https://brightdata.com/license#toc_1_12)


# Bright Data 的收集活动是否违反国内版权和网络安全法
Source: https://docs.brightdata.com/cn/general/privacy/copyright-and-cyber-security-laws



> **否。**

Bright Data 为全球领先的版权保护和网络安全公司提供服务。\
Bright Data 与专家和律师事务所密切合作，以确认每个用例，并确保我们不允许收集受版权保护的材料，也不会违反任何网络安全法。
我们做的一些事情是常规互联网服务提供商从来不会做的：

* 假设登录背后的所有内容都是私密的或受版权保护的，我们不允许使用任何类型的凭据（无论真假）登录任何网络服务。
* 我们对收集活动进行速率限制，使其始终只占网站自然流量的很小比例
* 我们允许网站管理员对 Bright Network 收集器流量进行一定的阻止和速率限制控制


# Bright Data 如何确保安装其应用程序的用户的隐私和安全？
Source: https://docs.brightdata.com/cn/general/privacy/privacy-and-security-for-apps



Bright Data 非常重视用户的隐私和安全，并专门针对这一领域制定了24/7全天候运行的内部程序和测试。除此之外，我们每年还进行几次外部审计，涵盖在用户设备上运行的软件的所有安全和隐私方面。但是，这对我们来说还不够。我们希望用户的安全和隐私清晰、透明且不言自明。 我们正致力于以下重大举措，并在2021年底之前完成：

* 将 Bright Peer SDK 开源。 任何人都可以查看代码，分解我们的生产版本，比较代码并验证其是否相同。我们发布的每一个内部版本都被推向开源，供公众查看。
* 在沙盒环境中运行 Bright SDK。 无论用户使用什么权限安装 Bright 应用程序，它都将始终受到作为其运行环境的沙盒的限制。因此，即使获得 root 访问权限，它也无法真正从用户的私人数据中收集任何内容。
* 添加完全的用户控制权。 Bright 应用程序用户现在可以完全控制他们的设备何时作为网络上的对等方可用、为其分配多少带宽、资源级别，甚至可以对设备允许的目标域进行低级别的控制。 一切都是透明且可配置的。
* 通过与知名安全公司合作，确保通过住宅网络的网络流量安全。 每个目标域都会对照实时更新的黑名单，在通过用户设备发送任何流量之前，被标记为恶意、包含恶意软件或任何其他非法内容的网站都将被屏蔽


# Bright Data 如何保护最终用户的资源？
Source: https://docs.brightdata.com/cn/general/privacy/protect-end-users-resources



Bright Data 的专利空闲监控技术可确保在严格的限制下使用最终用户的设备，从而节省电池电量、带宽和数据套餐。这些限制包括限制对设备（如果正被最终用户使用）的使用进行限制的监测工具、最低电池电量阈值、仅在充电时使用的偏好、每台设备允许的最大每日带宽使用量以及每周最大使用量。

## Bright Data 应用程序是否会接触到用户的私人网络流量？

> **否**

Bright Data 应用程序不会接触到用户的私人网络流量，不会收集它、记录它或将其发送到任何地方。我们对此不感兴趣，这不关我们的事，且一直都是这样。

在移动操作系统中，Bright Data 软件受权限基础架构的限制，因此无法访问私人数据。 在桌面操作系统上，Bright Data 正在发布其软件的新版本，该版本将在沙盒中运行，这将明确表明它无权访问任何用户私人信息。


# 每周发布说明
Source: https://docs.brightdata.com/cn/general/release-notes

过去一周内实施的产品变更发布说明。向下滚动可查看前几周的发布说明。

<Note>
  有问题？点击这里[联系我们 >>>](https://brightdata.com/?hs_signup=160692)
</Note>

## 截至 2025 年 2 月 27 日的发布说明

### **代理产品（Proxy Products）**:

#### 🚀 改进

* 在区域概览页面新增按域名细分区域统计数据的选项：&#x20;

  <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image1.png?maxW=1461&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=0bdfdc6ddd56d01c06e868ae6e0c6735" alt="feb27_image1" width="1461" height="557" data-path="images/general/release-notes/feb27_image1.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image1.png?w=280&maxW=1461&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a694d3bbec95e049d5a920686afd1999 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image1.png?w=560&maxW=1461&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=995b03246cef428e7f5ef05e58143d6d 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image1.png?w=840&maxW=1461&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=874b97aa3ecaa41203e330c454d94a71 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image1.png?w=1100&maxW=1461&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=53d6503fbd9dc1f4ded647b94422e684 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image1.png?w=1650&maxW=1461&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=eedd571a4c4e40f38e2ab2c71aabb3d1 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image1.png?w=2500&maxW=1461&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=64b92d197d495fccd8b04e5341ee0985 2500w" data-optimize="true" data-opv="2" />

### **Unlocker API**:

#### 🆕 新功能

* 现在，您可以将 HTML 自动转换为 Markdown 语言。此功能在 API 和本地代理接口中均已支持。详见 [https://docs.brightdata.com/cn/scraping-automation/web-unlocker/features#scrape-as-markdown](https://docs.brightdata.com/cn/scraping-automation/web-unlocker/features#scrape-as-markdown)

### **数据集（Datasets）**:

#### 🆕 新功能

* **数据集过滤器支持日期表达式**：您现在可以在数据集过滤器中使用日期表达式（相对日期），从而更轻松地基于时间条件筛选数据。此功能适用于过滤 API 和数据集订阅，使筛选更加灵活和动态。
  **示例用例**：如果您希望仅筛选最近 7 天的数据，可以使用 "Last" 表达式，以获取过去一周的数据并排除更早的数据。&#x20;

  <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image2.png?maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a0cdc6d9e9e5b893c026eb4dd2ade3f9" alt="feb27_image2" width="1636" height="810" data-path="images/general/release-notes/feb27_image2.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image2.png?w=280&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=10c1e1eee69a2a198aa72614fd71ab43 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image2.png?w=560&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=fc13c3c022487c79bab8e013f5a1a1a2 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image2.png?w=840&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a3e34edec151c109fa67b41eb4fd6d4e 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image2.png?w=1100&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=88874254929b75c482d2e4bbc0b7b22e 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image2.png?w=1650&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=1f75a7fdfff73601e5a7ded9ed8e0de7 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image2.png?w=2500&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=3cc65a33aad7687fe5ef6661e83ad3c7 2500w" data-optimize="true" data-opv="2" />

#### 🚀 改进

* **优化了个人身份信息（PII）的屏蔽方式**，以提高数据安全性和合规性。
* **提高结算页面的报价生成速度**——加载时间更快，使获取报价数据和最终价格更加高效。
* **发布全新结算页面**——用户现在可以直接在结算页面查看新增和更新的记录。

#### 🐞 Bug 修复

* **修复数据预览表错误**——解决了导致数据集预览表加载缓慢的问题，确保数据预览更加流畅快捷。

### **Scrapers**:

#### 🆕 新功能

* **Perplexity Scraper** - 推出全新的 Perplexity Scraper，与我们的 ChatGPT Scraper 类似！此 Scraper 允许客户以编程方式与 Perplexity 交互，并以结构化数据的形式提取响应。现在，您可以自动化查询并轻松获取 Perplexity 的洞察信息。[立即试用](https://brightdata.com/cp/scrapers/browse?domain=perplexity.ai\&id=hl_f65438a5)&#x20;

  <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image3.png?maxW=1063&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a037cc37cf200f212b2bbc300f47a2d5" alt="feb27_image3" width="1063" height="441" data-path="images/general/release-notes/feb27_image3.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image3.png?w=280&maxW=1063&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=b71a0706ba4702188bf31c08c00cb709 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image3.png?w=560&maxW=1063&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a10b6db263961c2f9b25f799b7ea2b96 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image3.png?w=840&maxW=1063&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=b25ec9089eda9500eae32488274a8024 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image3.png?w=1100&maxW=1063&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f98d87b20042371950dcc6c2de63f879 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image3.png?w=1650&maxW=1063&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=6a18adff1845efb216fb3c83d0aa9be0 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image3.png?w=2500&maxW=1063&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=38b5bc54f467ce68f33ec9e015c4a6bd 2500w" data-optimize="true" data-opv="2" />

* **监控系统用于检测 Schema 变更** - 实施了首个 Schema 变更监控和警报系统，以提高数据准确性和稳定性。它可检测变化并发送自动通知，确保数据操作的连续性。未来几周内，该系统将进一步优化。

* **无代码 Scraper 新增数据交付功能** - 现在支持更多交付方式，使无代码用户能够更灵活地导出和访问爬取数据。&#x20;

  <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image4.png?maxW=1240&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c76b26f9ed3d5fe1eb50ed7a482c546c" alt="feb27_image4" width="1240" height="575" data-path="images/general/release-notes/feb27_image4.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image4.png?w=280&maxW=1240&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=5ff7251ab06d0e82c79d0b73502dda6d 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image4.png?w=560&maxW=1240&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=df9993f9b06ccf416577e29c1e10c20f 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image4.png?w=840&maxW=1240&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=045d95cb0b60bb9f81ae98fae045e07b 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image4.png?w=1100&maxW=1240&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=3b70361f9520906c774d68f3d6f704f2 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image4.png?w=1650&maxW=1240&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=49ba2545db685260b79d498b5dbf9aca 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image4.png?w=2500&maxW=1240&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=5b55af60849e4b746e34b8062ae115bc 2500w" data-optimize="true" data-opv="2" />

#### 🚀 改进

* **增强搜索选项以包含新结果类型** - 现在，搜索功能会显示数据点及其对应的 Scraper，方便用户更快找到相关 Scraper。&#x20;

  <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image5.png?maxW=1033&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=70f764bdaf0bc91db7f976e3688ec6ac" alt="feb27_image5" width="1033" height="431" data-path="images/general/release-notes/feb27_image5.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image5.png?w=280&maxW=1033&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=18c21612ecd5db7ce008f5f7b4fd57b9 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image5.png?w=560&maxW=1033&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=419cc46bdf202698a9a2d4d20f21ee0b 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image5.png?w=840&maxW=1033&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=264e0666a4509acccc276eaee55faa8e 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image5.png?w=1100&maxW=1033&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=139bc6a31069a1f8ce57c873a0a0dee3 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image5.png?w=1650&maxW=1033&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=02a326c3535f49264e28506f9251856f 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image5.png?w=2500&maxW=1033&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c02ff9c88a8e8ca22044a0d4c5428e3a 2500w" data-optimize="true" data-opv="2" />

* **默认启用“交付到外部存储”** - 为了优化工作流程，现在 Web Scraper API 会自动启用外部存储交付，减少手动配置步骤。

* **自定义 Scraper 请求优化** - 现在，用户只需提供两个 URL，系统会自动处理其余部分，使请求流程更加简化。

#### 🐞 Bug 修复

* 解决了影响自定义 Scraper 的问题，并实施了警报系统，以便在需要采取措施时通知合作伙伴。
* **修复未定义的 URL 结构** - 改进 URL 处理，确保在不同页面上实现一致且结构清晰的 URL。

## 归档发布说明（前几周）

<AccordionGroup>
  <Accordion title="截至 2025 年 2 月 20 日的发布说明">
    ### **代理产品（Proxy Products）**:

    #### 🆕 新功能

    * 新 API 现在可以提前提供待更换的代理列表，并为其做好准备。立即试用：[获取待更换代理 API](https://docs.brightdata.com/cn/api-reference/account-management-api/get-proxies-pending-replacement)。

    #### 🚀 改进

    * 通过预设的连接字符串（包括主机、端口、用户名和密码），更快地集成代理访问详情，并配有新一套配置指南：[集成指南](https://docs.brightdata.com/cn/integrations/introduction)。

    * 我们在错误目录中新增了错误代码，让您可以更快地找到并解决问题：[代理错误目录](https://docs.brightdata.com/cn/proxy-networks/errorCatalog)。

    * 我们增加了在亚洲的服务器部署，并进行了一些性能提升。

    ### **SERP API**:

    #### 🆕 新功能

    * **Google 生成式 AI 概述（Generative AI Overviews）** - 现在，您可以提高 SERP 结果中显示此概述的可能性：

      * [Google AI 概述参数](https://docs.brightdata.com/cn/scraping-automation/serp-api/query-parameters/google#ai-overview)

    * **Google Trends（谷歌趋势）** - 新增参数，可获取更精准的小部件特定数据：

      * \`brd\_trends = timeseries,geo\_map\`

      * [Google Trends 参数](https://docs.brightdata.com/cn/scraping-automation/serp-api/query-parameters/google#trends)

    ### **数据集（Datasets）**:

    #### 🆕 新功能

    * **数据集订阅的增量数据** - 现在，客户可以启用增量逻辑，仅接收新增或更新的记录，而不是每个收集周期获取完整数据集。这提高了数据的相关性，并支持灵活的快照对比。无需手动识别更改，我们的系统会自动处理。

      <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_1.png?maxW=969&auto=format&n=JpbB64sgI_r6D502&q=85&s=8c72be9bb8d271b356e0d0409579ed32" alt="feb20_1" width="969" height="908" data-path="images/general/release-notes/feb20_1.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_1.png?w=280&maxW=969&auto=format&n=JpbB64sgI_r6D502&q=85&s=df7dd8ab3a5a5e262f280c289d841082 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_1.png?w=560&maxW=969&auto=format&n=JpbB64sgI_r6D502&q=85&s=a1f5343f8abfc809cb43df7827381ac9 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_1.png?w=840&maxW=969&auto=format&n=JpbB64sgI_r6D502&q=85&s=f43e906d93d8a59230d2626dd3bbd120 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_1.png?w=1100&maxW=969&auto=format&n=JpbB64sgI_r6D502&q=85&s=c1d519eca23600478d6c18164be0b520 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_1.png?w=1650&maxW=969&auto=format&n=JpbB64sgI_r6D502&q=85&s=ab739f39695f24a264aef0e69cbd1834 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_1.png?w=2500&maxW=969&auto=format&n=JpbB64sgI_r6D502&q=85&s=9cecf0dfe5ca6d49f6e028646f01f135 2500w" data-optimize="true" data-opv="2" />

    #### 🚀 改进

    * **全新定价表** - 重新设计的定价表提供更清晰的信息，使客户更容易理解定价层级并做出明智决策。

    * **改进数据集结算确认页面** - 修复了结算确认页面问题，确保更流畅和可靠的购买体验。

    * **改进缺少支付详情的错误提示** - 现在，未添加支付和账单信息的客户在尝试购买时，将收到更清晰、信息更全面的错误提示。

    * **优化交付方式** - 重新排列交付选项的顺序，并改进 UI 以提升可用性。

    * **"更新数据集" 的快捷键** - 新增快捷键，让数据集更新更高效，同时改进 UI 以提升用户体验。

    * **更好的数据样本预览表** - 用户现在可以直观地展开表格行，并在弹出窗口中查看对象数据类型，以提高可读性。

    #### 🐞 错误修复

    * **修复路由错误** - 现在，在数据集页面导航时，不必要的查询参数将不再保留。

    * **修复促销卡片 UI 问题** - 促销卡片现在可以正确显示，符合预期的 UI 布局。

    ### **爬虫（Scrapers）**:

    #### 🆕 新功能

    * **AI 爬虫代理** – 我们推出了首个 AI 爬虫代理，允许用户仅提供网站域名即可提取数据。它会自动检索该域名下的所有 URL，并以 HTML、Markdown 或纯文本格式提取内容。适用于 AI 公司、研究人员和开发人员获取高质量的文本数据，用于训练模型、分析或内容生成。[立即试用](https://brightdata.com/cp/scrapers/browse?domain=example.com\&id=all)。

      <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_2.png?maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=70156e4c09154fe9d7c87f008902bf0c" alt="feb20_2" width="1999" height="1074" data-path="images/general/release-notes/feb20_2.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_2.png?w=280&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=26b1a86b0e8dbe4aeceee98f899abcb0 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_2.png?w=560&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=7516ca35e8001c0531b8c5377f444fd9 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_2.png?w=840&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=3744238cb580d64d8ce62b1cfb7c0190 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_2.png?w=1100&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=e18ccd701a12498c4e728297c93997f9 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_2.png?w=1650&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=cd3769261930a8cda20692b8a2019e8e 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_2.png?w=2500&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=d20d5a2469b9cf25d876aaf8309e108b 2500w" data-optimize="true" data-opv="2" />

      <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_3.png?maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=c57031c2487eac8579f54d7367d9a9bb" alt="feb20_3" width="1999" height="1066" data-path="images/general/release-notes/feb20_3.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_3.png?w=280&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=ad6b5bc4c172e5a05093c225b6dc68aa 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_3.png?w=560&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=49103e5560ce3b88289a937642218437 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_3.png?w=840&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=143b65c01ead061fa2abf092e6e25615 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_3.png?w=1100&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=229b33a378dceaed71d376ce991fa30f 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_3.png?w=1650&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=70bfa725755750a9e4da1036f3826b0a 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_3.png?w=2500&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=cb948374979f15e7f13384a6a21352bc 2500w" data-optimize="true" data-opv="2" />

      <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_4.png?maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=bbef9cdfe9a7ee5e8844dea38e876bbb" alt="feb20_4" width="1999" height="1475" data-path="images/general/release-notes/feb20_4.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_4.png?w=280&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=5f8d907b79f617382d3675991c3765f7 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_4.png?w=560&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=3b0cdec6c35921a08e52ccd70d6c6df0 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_4.png?w=840&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=7d4148ed9fd0fb3c87d864578ceff499 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_4.png?w=1100&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=ce2bc3a2416642e72e3ddd63c0e7fc42 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_4.png?w=1650&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=57da054476c3a0a0110905fabc4c1eba 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_4.png?w=2500&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=6044a55b9612c8c859f455a2eb1bc23f 2500w" data-optimize="true" data-opv="2" />

    * **ChatGPT 爬虫** - 我们推出了全新的 ChatGPT 爬虫，类似于我们的 SERP 爬虫！该爬虫允许客户以编程方式与 ChatGPT 交互，并将响应提取为结构化数据。现在，您可以自动化查询，并轻松提取 ChatGPT 的洞察数据。[立即试用](https://brightdata.com/cp/scrapers/browse?domain=chatgpt.com\&id=all)。

      <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_5.png?maxW=856&auto=format&n=JpbB64sgI_r6D502&q=85&s=cf1702fa3f678c4c93d248bf27653905" alt="feb20_5" width="856" height="387" data-path="images/general/release-notes/feb20_5.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_5.png?w=280&maxW=856&auto=format&n=JpbB64sgI_r6D502&q=85&s=d3fc28ec2a612eb6ed44a9fe502926a2 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_5.png?w=560&maxW=856&auto=format&n=JpbB64sgI_r6D502&q=85&s=407c4a73b8eb838f7ae122097f53c447 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_5.png?w=840&maxW=856&auto=format&n=JpbB64sgI_r6D502&q=85&s=72b8ada0df54d24cb0395ba98bc41248 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_5.png?w=1100&maxW=856&auto=format&n=JpbB64sgI_r6D502&q=85&s=caabb87b3f6fc5a05c742e2ab9419e78 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_5.png?w=1650&maxW=856&auto=format&n=JpbB64sgI_r6D502&q=85&s=3f171455dcc16617bf65d82706729f23 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_5.png?w=2500&maxW=856&auto=format&n=JpbB64sgI_r6D502&q=85&s=20430a7926ff3b0cdc45797c4e7047c9 2500w" data-optimize="true" data-opv="2" />

    * **日志页面新增"再次运行"按钮** - 现在，用户可以直接在日志页面单击 "再次运行" 按钮，快速重新运行相同请求，而无需手动重新输入参数。

      <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_6.png?maxW=1293&auto=format&n=JpbB64sgI_r6D502&q=85&s=c563343ee840f28acfbeec43565c479c" alt="feb20_6" width="1293" height="380" data-path="images/general/release-notes/feb20_6.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_6.png?w=280&maxW=1293&auto=format&n=JpbB64sgI_r6D502&q=85&s=eb630ed342a50443d3f3d28652311f7e 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_6.png?w=560&maxW=1293&auto=format&n=JpbB64sgI_r6D502&q=85&s=580abeec7e52c544b201c26e1fad4945 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_6.png?w=840&maxW=1293&auto=format&n=JpbB64sgI_r6D502&q=85&s=a6e18147454a77bd0f8489b2dc86a2e6 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_6.png?w=1100&maxW=1293&auto=format&n=JpbB64sgI_r6D502&q=85&s=31b64e192a9debcfa012921a5679f7e1 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_6.png?w=1650&maxW=1293&auto=format&n=JpbB64sgI_r6D502&q=85&s=9be2e87e202e9a0548af36ad7c322ad1 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_6.png?w=2500&maxW=1293&auto=format&n=JpbB64sgI_r6D502&q=85&s=22762545ed2d28a8cd2f18d8d890c8f3 2500w" data-optimize="true" data-opv="2" />

    #### 🚀 改进

    * **"我的爬虫" 表格优化** - 现在，正在运行或最近运行的爬虫将在 "我的爬虫" 表格顶部显示，无需滚动查找活动任务。

    * **WSA API** - 为了提升导航体验，我们将 "交付选项" 部分移动到 "管理 API" 选项卡，使 API 数据交付管理更直观。

    #### 🐞 错误修复

    * **No-Code 爬虫任务失败时，现在可下载错误详情**，以便用户更好地理解问题所在。之前，下载按钮是禁用的，使调试变得困难。

    * **修复 "报告问题" 功能** - 现在，客户在报告问题时，正确的快照会自动关联到工单，确保更高效的故障排除。
  </Accordion>

  <Accordion title="截至 2025 年 2 月 13 日的发布说明">
    ### 代理产品

    #### 🆕 新功能

    * **HTTP3 测试版已上线** - 代理网络已升级，以支持 HTTP3/QUIC 请求。如需试用，请联系 Bright Data 销售团队：[sales@brightdata.com](mailto:sales@brightdata.com)。

    #### 🚀 改进

    * 现在可以在 **“概览”** 选项卡中更轻松地 **复制您的代理凭据**，并支持不同格式。

    #### 🐞 Bug 修复

    * **修复** 账户管理 API 文档演示中的 **损坏的代码示例**。
    * **添加了缺失的文档**，修复了部分旧文档链接无法正确跳转的问题。

    ***

    ### **数据集**

    #### 🆕 新功能

    * **“AI 筛选助手”** 允许用户使用 **自然语言** 筛选数据集 - 只需用英文描述所需的筛选条件，即可获取相关记录。

      <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img1.png?maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=4c41f757706769bd079c90a5284aaae1" alt="feb13_img1" width="1600" height="859" data-path="images/general/release-notes/feb13_img1.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img1.png?w=280&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=be1895f9cc0bb4b4865e4bc0856c2c80 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img1.png?w=560&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=997b7ff37f1cd895c9bab15a10578fe9 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img1.png?w=840&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=b382bee03c45f8e3a68a2f3182c3ed43 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img1.png?w=1100&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=203a43a7bbffae0321ccbd9b42a04464 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img1.png?w=1650&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=f7d2c260b6e0c3a2ac0a0c9d917b3689 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img1.png?w=2500&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=b82a88f7568adbf891aa483d048a413a 2500w" data-optimize="true" data-opv="2" />

      <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img2.png?maxW=914&auto=format&n=JpbB64sgI_r6D502&q=85&s=3a1b74a8cab0f014189f6502e131e0aa" alt="feb13_img2" width="914" height="1056" data-path="images/general/release-notes/feb13_img2.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img2.png?w=280&maxW=914&auto=format&n=JpbB64sgI_r6D502&q=85&s=22cbf5e795d753c9a5a3017d07ab23cd 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img2.png?w=560&maxW=914&auto=format&n=JpbB64sgI_r6D502&q=85&s=0e3279c33bb058b0bb117320c1de7a56 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img2.png?w=840&maxW=914&auto=format&n=JpbB64sgI_r6D502&q=85&s=c443c14a2a12221b20a3305ed793748b 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img2.png?w=1100&maxW=914&auto=format&n=JpbB64sgI_r6D502&q=85&s=38dd52fbfd58a509e2a8e7cdccb1d2a1 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img2.png?w=1650&maxW=914&auto=format&n=JpbB64sgI_r6D502&q=85&s=bff8eea984f0fb5d8fe133fd2e70cf5c 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img2.png?w=2500&maxW=914&auto=format&n=JpbB64sgI_r6D502&q=85&s=99fff9bcdea6beb8949cdc50b349d3e2 2500w" data-optimize="true" data-opv="2" />

    * **支付链接共享** – 仪表板用户现在可以生成并分享支付链接，使他人（例如 CFO）无需登录控制面板即可完成购买。

      <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img3.png?maxW=1474&auto=format&n=JpbB64sgI_r6D502&q=85&s=b644a92e3966c57fa05926177d5ac2b9" alt="feb13_img3" width="1474" height="974" data-path="images/general/release-notes/feb13_img3.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img3.png?w=280&maxW=1474&auto=format&n=JpbB64sgI_r6D502&q=85&s=f23cfe716261c5a5ba4105df1a610c2c 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img3.png?w=560&maxW=1474&auto=format&n=JpbB64sgI_r6D502&q=85&s=3b57f88c8c20064ab4fe45d7fb33689c 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img3.png?w=840&maxW=1474&auto=format&n=JpbB64sgI_r6D502&q=85&s=5ef6bcf28405f2df48194572109a2bea 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img3.png?w=1100&maxW=1474&auto=format&n=JpbB64sgI_r6D502&q=85&s=2f5c3947e5e0fbfada32e8e041906a88 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img3.png?w=1650&maxW=1474&auto=format&n=JpbB64sgI_r6D502&q=85&s=a16c692babe9dd1cbf21f4e287832851 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img3.png?w=2500&maxW=1474&auto=format&n=JpbB64sgI_r6D502&q=85&s=a65413f953707339f03bade4efc20682 2500w" data-optimize="true" data-opv="2" />

    * **新增数据集统计信息** – 每个数据集现在包含额外的统计信息，例如记录的地理分布，并且该信息每月更新。

      <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img4.png?maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=0c2de9864f48053bc3ee3ddd814925be" alt="feb13_img4" width="1600" height="859" data-path="images/general/release-notes/feb13_img4.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img4.png?w=280&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=077a6651fe235ccc51e4fbd6aed1d642 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img4.png?w=560&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=56ec7e6de386953cba79053ca5805a5f 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img4.png?w=840&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=b9f9c3de4e4e0342b9c58b8d60c81442 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img4.png?w=1100&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=2a426a80c35778a77f17571921c2dae0 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img4.png?w=1650&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=b06f95f75f3b1a9c921a9f93813da746 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img4.png?w=2500&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=34fea29de603a22d35547a77775604f2 2500w" data-optimize="true" data-opv="2" />

    #### 🚀 改进

    * **增强筛选体验** – 现在，您可以在筛选和查看数据集时移动筛选窗口，避免遮挡数据表。
    * **更好的数据样本预览** – 我们限制了单元格大小以提高可读性，您现在可以单击字段以展开查看完整数据点。

    #### 🐞 Bug 修复

    * 修复了上传 CSV 文件作为筛选组件输入时的解析错误。
    * 现在确保记录数始终更新，以正确反映筛选效果。

    ***

    ### **抓取工具**

    #### 🆕 新功能

    * **自定义抓取工具** - 用户现在可以请求定制的抓取工具，以抓取在我们的市场上不可用的域名。只需提供 2 个 URL 即可开始 – [查看视频！](https://youtu.be/YhJWRQW6FSE)

    #### 🚀 改进

    * **自动电子邮件通知** – 现在，在客户首次触发抓取工具时，会自动发送电子邮件，以优化用户引导体验。
    * **API 代码示例支持多种语言** – 允许用户在所有 API 请求中复制自己喜欢的编程语言代码示例。
    * **减少“概览”选项卡中的示例数量** – 从 10 个减少到 5 个，以提供更清晰的界面。
    * **Bright AI** – 用户现在可以询问特定的用例，并获得相关建议及数据集的直接链接。

    #### 🐞 Bug 修复

    * 修复了抓取工具页面中的损坏链接。
  </Accordion>
</AccordionGroup>

***


# Bright Data 如何处理滥用举报？
Source: https://docs.brightdata.com/cn/general/security/abuse-report-handling



每份滥用举报都会送达合规团队。 举报者的有效性和真实性得到验证后，启动滥用程序。 该程序详细涵盖了谁负责该流程、谁进行调查、需要通知公司内外的哪些人等。

首先，作为预防措施，我们会封锁据称受到攻击的域，这样，如果确实正在造成损害，我们将会停止它，同时进行相应的调查。

对提交的日志进行分析，并将流量追溯到其来源。 如果滥用行为得到证实，所有信息都将转给合规官和法律团队，以采取适当的行动。

如果举报人想提起法律诉讼，他们可以向地方当局提起诉讼，Bright Data 将配合任何官方调查。


# Bright Data 如何确保网络安全？
Source: https://docs.brightdata.com/cn/general/security/network-security



大多数经过常规互联网服务提供商和虚拟互联网服务提供商的流量都使用 SSL 隧道进行加密，因此互联网服务提供商看不到其内容。 因此，互联网服务提供商可用的保护网络安全和防止非法活动的方法是有限的，并且主要针对大规模 DDoS 预防和域名黑名单。 但是，在 Bright Data，我们做得更多：

| 元素                                              | Bright Data 虚拟互联网服务提供商        | 常规互联网服务提供商 |
| ----------------------------------------------- | ----------------------------- | ---------- |
| 需要注册                                            | 是                             | 是          |
| 需要付款方式                                          | 是                             | 是          |
| 举报滥用行为的方法和程序                                    | 是                             | 是          |
| 在线 DDoS 检测                                      | 是                             | 是          |
| 全面屏蔽最热门的 DDoS 方法<sup>[2](#myfootnote2)</sup>    | 是                             | 否          |
| 每位客户的“了解客户”程序                                   | 是                             | 否          |
| 如果客户开始定位“了解客户”期间未报告的域名，则会发出合规警报                 | 是                             | 否          |
| 针对广告欺诈、虚假评论、虚假点赞、虚假账户创建、垃圾邮件等，部署主动屏蔽            | 是<sup>[1](#myfootnote1)</sup> | 否          |
| 阻止服务级别滥用或使用非网络流量攻击 <sup>[3](#myfootnote3)</sup> | 是                             | 否          |

***

> **底线**\
> Bright Data 虚拟互联网服务提供商网络比常规互联网服务提供商更安全，并且被用于攻击和滥用的可能性更低。

<Warning>
  Bright Data 不允许使用其产品和系统导致任何网络资源无法供其预期用户使用，包括但不限于通过拒绝服务（DoS）或分布式拒绝服务（DDoS）攻击
</Warning>

***

<sub><a name="myfootnote1">1</a>: 应用于30%的流量，计划到2022年底达到90％以上</sub><br />
<sub><a name="myfootnote2">2</a>: 2021年，前90%的 DDoS 攻击使用的方法：UDP 分片、DNS 反射、UDP 容量、LDAP 反射、DNS 查询、NTP 反射、ICMP（容量），</sub><br />
<sub><a name="myfootnote3">3</a>: 非网络流量是指任何不是 HTTP 协议的流量或者目标端口不同于标准 HTTP 端口`80/443`的流量。</sub>


# 安全概述
Source: https://docs.brightdata.com/cn/general/security/security-overview



每家公司、组织、研究所或公共机构都需要数据。 更具体地说，他们需要直接访问世界上最大的数据库——万维网。 因此，我们建立了 Bright Data 的在线数据收集网络，使每个企业或组织都能轻松、高效地利用公共网络信息提供的信息。无论是进行市场调研、制定定价策略、开展学术研究，还是决定公司的投资行动等，在线数据都能提供改进决策所需的所有可靠信息，因为在线数据能准确反映您所在行业或市场的实际情况。 简而言之，在线数据是任何组织在做出任何决策（无论多么重大或关键）时表现最好、最可靠的顾问。 然而，要利用这一无所不知的大型信息源并非易事。


# 事件日志
Source: https://docs.brightdata.com/cn/general/usage-monitoring/Event_log



要快速了解您的使用情况，请转到区域页面中的事件登录：

<Frame>
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-1.png?maxW=1644&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=e0dc9b1c870de186660cff56e47d1ba5" alt="event-log-1.png" width="1644" height="214" data-path="images/general/usage-monitoring/event_log/event-log-1.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-1.png?w=280&maxW=1644&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=6076eef1b09d5c83102485771284ad01 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-1.png?w=560&maxW=1644&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=db06ad60a1d49df67e822801e8fd4011 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-1.png?w=840&maxW=1644&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=673c4a85056d28a3f29a87bb4813d220 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-1.png?w=1100&maxW=1644&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=5e3296d6a4f06f65084f0a54deed2e3d 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-1.png?w=1650&maxW=1644&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a29803ca72b8d2cfcb0357d71e6dc3e1 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-1.png?w=2500&maxW=1644&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=b96bedb6f3aaa4705aa2ef1143e6779d 2500w" data-optimize="true" data-opv="2" />
</Frame>

事件日志将显示过去一小时内使用每个唯一 IP 发出的第一个请求的一行数据。

呈现的数据是：

* **日期**：请求的时间和日期
* **区域**：请求使用了哪个区域
* **来源 IP**：请求来自哪个 IP
* **URL**：请求的目标站点
* **结果**：请求成功或失败

<Frame>
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-2.png?maxW=1066&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=4e5a9f4e1a6639fd9942af87e659491b" alt="event-log-2.png" width="1066" height="403" data-path="images/general/usage-monitoring/event_log/event-log-2.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-2.png?w=280&maxW=1066&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=8072ce2470705d0988125cbf5e7d599d 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-2.png?w=560&maxW=1066&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=d228e3e2292b820148d94c068943240e 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-2.png?w=840&maxW=1066&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=e5de0adb4f7b45e7e1d96d5eab7faeb8 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-2.png?w=1100&maxW=1066&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=89a84e34fa8ab7b53418716059afd7f9 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-2.png?w=1650&maxW=1066&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=17da1b407e365cd4a390071e9007e0e8 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-2.png?w=2500&maxW=1066&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c8a19a5f3be2a2331112d51c19b93bec 2500w" data-optimize="true" data-opv="2" />
</Frame>


# 监测使用量
Source: https://docs.brightdata.com/cn/general/usage-monitoring/Monitoring_Residential_Network_Usage



要查看您当前的带宽消耗情况，只需转到您的住宅区域，点击顶部菜单中的“统计信息”，然后在“度量单位”部分打开下拉菜单，并将度量单位设置为“GB”。

<Frame>
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/Monitoring_Residential_Network_Usage/monitor-your-usage.gif?maxW=1600&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=fc4b011d10766bb6ca11493d455495bb" alt="monitor-your-usage.gif" width="1600" height="734" data-path="images/general/usage-monitoring/Monitoring_Residential_Network_Usage/monitor-your-usage.gif" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/Monitoring_Residential_Network_Usage/monitor-your-usage.gif?w=280&maxW=1600&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=df836aba9a1831a66d13de88d9a397c4 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/Monitoring_Residential_Network_Usage/monitor-your-usage.gif?w=560&maxW=1600&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=5ce218907c520e4de14304192925d76e 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/Monitoring_Residential_Network_Usage/monitor-your-usage.gif?w=840&maxW=1600&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f6b61bc10465557b8df7395c3320acb4 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/Monitoring_Residential_Network_Usage/monitor-your-usage.gif?w=1100&maxW=1600&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=6f6a7804850b07f91b6a2f2bab25281c 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/Monitoring_Residential_Network_Usage/monitor-your-usage.gif?w=1650&maxW=1600&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=e8a8035a267678c27f985c199acddbc0 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/Monitoring_Residential_Network_Usage/monitor-your-usage.gif?w=2500&maxW=1600&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f151911f9d943cf58e0d292e7d1880f2 2500w" data-optimize="true" data-opv="2" />
</Frame>

## 如何测量流量

您的住宅代理网络使用量是通过带宽消耗计算出来的。带宽是通过连接发送和下载的信息量。 您使用代理发送的每个请求都会消耗一定的带宽。 您的账单是根据使用的带宽量按美元计算的。

[请参阅我们的账单和定价页面，了解更多信息](/cn/general/account/billing-and-pricing)


# 用量
Source: https://docs.brightdata.com/cn/general/usage-monitoring/Usage



<AccordionGroup>
  <Accordion title="如何禁用区域以控制账户数据用量和余额？">
    如想暂时停用任何活动区域，您可轻松将其禁用。 我们的计费系统不会在您禁用区域期间收费，只会根据区域实际启用的时间收费，且仅在适用情况下，才会收取每月预付费。 您可随时通过控制面板重新激活相关区域。

    * 禁用所有区域也将停止收取预付费。 但只要有一个活动区域被启用，则适用执行预付套餐，会收取相应的费用。
    * 禁用数据中心区域或具有专用 IP 的住宅区域后，所有 IP 都将被释放回 IP 地址池中

    <Note>
      如在启用区域或区域功能（例如城市或国家/地区）后又在同一天内将其禁用，则将根据相关价目表，按照实际消耗的流量进行收费。
    </Note>
  </Accordion>

  <Accordion title="当我的实际用量超过账户最低使用量后，会发生什么？">
    当您在给定月份里使用了账户上 85％ 的余额资金后，我们将向您发送一封电子邮件，通知您为账户充值。 如不向账户充值，则您的账户仍将继续运行，直至账户余额全部用尽。 除非您为账户充值，否则您的账户将在余额用尽后被暂停。我们建议您开启“自动充值”功能，确保账户保持活跃，一直可用。
  </Accordion>

  <Accordion title="我的资金会结转至下个月吗？">
    如果账户整个月都处于“活跃”状态，则无论您的使用费用是否低于最低承诺消费额，您的每月消费金额都不会结转至下个月。\
    当处于“活跃”状态时，我们会根据您的价格套餐和每月承诺消费额，在每月第一天重新开始计算您的使用量和账单。
  </Accordion>

  <Accordion title="免费区域的上限是多少？">
    Bright Data 的客户最多可免费开通 50 个区域，超过该上限后，每开通一个区域就需支付 5 美元/月。
  </Accordion>

  <Accordion title="我可以限制每日用量吗？">
    可以，在“区域 [Zone](https://brightdata.com/cp/zones) ”页面的“用量限制 (Usage spent limit)” 一列中，您可通过下列两种方式限制每日用量：

    * 带宽（字节）
    * 花费（美元）

    达到每日用量后，相关区域将自动暂停。

    <Note>
      区域限制每 15 分钟计算一次，不会立即生效，因此区域的使用时间可能会超过其 15 分钟限制。
    </Note>

        <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/usage/daily-limit.gif?maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f61284113dc3954f75455efde81961d2" alt="usage-monitor.gif" width="1636" height="930" data-path="images/general/usage-monitoring/usage/daily-limit.gif" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/usage/daily-limit.gif?w=280&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=88a561f927e91a783a73afccb772fd13 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/usage/daily-limit.gif?w=560&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=e8f9038b58f285a48b6d6ce36b6471b6 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/usage/daily-limit.gif?w=840&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=bd9c1e8fed9aa5b4d6edbf7e4aaba654 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/usage/daily-limit.gif?w=1100&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=2cbcbc946c554525836e4bc33146fea4 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/usage/daily-limit.gif?w=1650&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=8402319df5b7cecbe97ddfe784cf716b 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/usage/daily-limit.gif?w=2500&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=506f12bdfff99068911e4eb4f9870030 2500w" data-optimize="true" data-opv="2" />

    <Note>
      当负载较高时，统计计算可能会延迟。 要手动更新区域中的用量统计信息，请点击区域名称打开该区域，进入统计表，然后在所需日期附近点击“重新计算 (recalc)” 按钮。等到屏幕顶部的红色提示“正在加载...”消失后，刷新页面即可。之后，屏幕上就会显示最新的统计数据。
    </Note>
  </Accordion>
</AccordionGroup>


# 带宽
Source: https://docs.brightdata.com/cn/general/usage-monitoring/bandwidth



<AccordionGroup>
  <Accordion title="带宽如何计算？">
    带宽根据传入和传出目标站点的数据总和计算：请求标头 + 请求数据 (POST) + 响应标头+响应数据。\
    <Note>试用期间使用的流量将在您的控制面板上列出，但不会计入您的账单。</Note>
  </Accordion>

  <Accordion title="如何获取区域的带宽统计信息">
    API 端点： `GET /api/zone/bw`

    可选参数: `from=2018-07-01T00:00:00&to=2018-07-02T00:00:00`

    <CodeGroup>
      ```sh Shell
      curl "https://api.brightdata.com/zone/bw?zone=ZONE" -H "Authorization: Bearer API_KEY"
      ```

      ```js Node.js
      #!/usr/bin/env node

      require('request-promise')({
          url: 'https://api.brightdata.com/zone/bw?zone=ZONE',
          headers: {
              'Authorization': 'Bearer API_KEY'
          },
      }).then(function(data) {
              console.log(data);
          },
          function(err) {
              console.error(err);
          });
      ```

      ```java Java
      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#
      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
      #!/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 示例响应
    {
      "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="如何获得所有区域的带宽统计信息">
    API 端点： `GET /api/customer/bw`

    可选参数: `from=2018-07-01T00:00:00&to=2018-07-02T00:00:00`

    <CodeGroup>
      ```sh Shell
      curl "https://api.brightdata.com/customer/bw" -H "Authorization: Bearer API_KEY"
      ```

      ```js Node.js
      #!/usr/bin/env node
      require('request-promise')({
       url: 'https://api.brightdata.com/customer/bw',
       headers: {'Authorization': 'Bearer API_KEY'},
      }).then(function(data){ console.log(data); },
       function(err){ console.error(err); });
      ```

      ```java Java
      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#
      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
      #!/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="如何获得区域的带宽和总成本">
    API 端点：`GET /api/zone/cost`

    可选参数: `from=2018-07-01T00:00:00&to=2018-07-02T00:00:00`

    <CodeGroup>
      ```sh Shell
      curl "https://api.brightdata.com/zone/cost?zone=ZONE" -H "Authorization: Bearer API_KEY"
      ```

      ```js Node.js
      #!/usr/bin/env node
      require('request-promise')({
       url: 'https://api.brightdata.com/zone/cost?zone=ZONE',
       headers: {'Authorization': 'Bearer API_KEY'},
      }).then(function(data){ console.log(data); },
       function(err){ console.error(err); });
      ```

      ```java Java
      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#
      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
      #!/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 示例响应
    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>


# 无限 DC 和 ISP 区域：公平使用
Source: https://docs.brightdata.com/cn/general/usage-monitoring/fair_use_allowance

在 DC 和 ISP 无限区域中，适用公平使用额度以防止滥用

#### 公平使用

Bright Data 对于无限区域的公平使用政策包括每个代理（IP）每月 100GB 的使用额度。无论是共享代理还是专用代理，公平使用额度都是相同的。

#### 我们如何计算公平使用？

我们将账户中相同区域类型的所有代理相加，并计算总公平使用额度。

例如，如果您的账户中 `datacenter_zone1` 里有 10 个代理，`datacenter_zone2` 里有 5 个代理，那么您的数据中心无限区域的总公平使用额度为 1,500 GB，该额度可在所有**数据中心**类型的**无限**区域之间共享。

如果您还拥有 2 个 ISP 类型的区域，每个区域有 20 个代理（合计 40 个 ISP 无限区域代理），那么您的公平使用额度将计算为：

* **数据中心** 区域：1,500 GB
* **ISP** 区域：4,000 GB

#### 数据中心区域的使用量可以计入 ISP 的公平使用额度吗？反之亦然？

不可以。每种区域类型都有其独立的公平使用额度，且仅在相同类型的区域之间共享。

#### 每月 1 号，我的公平使用额度会发生什么变化？

我们在每个日历月的 1 号计算新的公平使用额度，每个月的起始额度为 0（零），然后随着您通过代理传输的数据逐步累积。

#### 如果我使用共享代理，其他用户的流量会计入我的公平使用额度吗？

绝对不会。只有您的流量会计入您的公平使用额度。

#### 如果超过了公平使用额度会发生什么？

当您的使用量达到公平使用额度的 85% 和 100% 时，我们会发送电子邮件提醒。我们不会停止您的操作，但超过公平使用额度的数据将按照当前的 "按量付费" 费率计费。超出公平使用额度的费用被视为 "超额费用"，并会在您的账单明细中标记。

#### 如何避免超额费用？

为了避免超额费用：

1. 提前规划您的使用情况，并购买足够的代理来覆盖公平使用额度。
2. 监控您的使用情况，并在需要时为您的账户添加额外的代理，以保持在公平使用额度之内。

Bright Data 提供价格实惠的无限代理计划，我们建议您预留一定的额外额度，以应对突发的带宽消耗增长，避免产生超额费用。

#### 如果我已经产生了超额费用，能否通过添加代理来抵消？

我们的公平使用政策不允许在超额费用产生后通过增加代理来抵消或撤销这些费用。如果您认为超额费用被错误地应用，请联系我们的支持团队，我们将乐意协助您。

#### 我减少了区域中的代理数量，这会如何影响我的公平使用额度？

每减少一个代理，您的公平使用额度将立即减少 100GB。目前，我们不允许减少代理数量，因为这可能会导致您的账户因超出公平使用额度而被收取超额费用。

如果您尝试减少代理数量，控制面板将显示错误信息：

<Warning> `错误：无法将代理数量减少到低于公平使用额度。` </Warning>

#### Bright Data 提供无限住宅代理吗？

不提供。


# 如何抓取 XYZ 网站？
Source: https://docs.brightdata.com/cn/general/websites

本节将介绍一些实用提示和技巧，帮助您从感兴趣的特定网站获取所需信息。

<AccordionGroup>
  <Accordion title="如何抓取 LinkedIn 的公开网络数据？">
    在收集 LinkedIn 的公开网络数据时，您可以考虑以下三种简单明了的方案。 这些方案都能达到目的，您可以根据自身具体需求和可用资源来选择。

    **方案 1：现成数据集**

    第一种方案是使用数据集市场上提供的现成数据集。 要访问数据集市场，可以从侧边栏进入“网络数据”，然后从顶部菜单中选择“数据集市场”。

    这些数据集是预先编译的 LinkedIn 数据合集，包括用户个人资料或公司信息等。 如果您想省时省力，该方案是理想之选，因为您可以直接下载所需数据，无需自行抓取。 这种方案非常适合希望便捷获取大量数据、又不愿承担太多技术成本的企业或研究人员。

    **方案 2：使用网页抓取 API**

    借助此方案，您可轻松通过 API 实时抓取 LinkedIn 数据。只需访问此处，即可立即抓取所需信息: [https://brightdata.com/cp/scrapers/browse?domain=linkedin.com](https://brightdata.com/cp/scrapers/browse?domain=linkedin.com)

    您可轻松获取 LinkedIn 个人资料、公司信息等。

    **方案 3：Unlocker API或抓取浏览器**

    第三种方案是使用 Unlocker API或抓取浏览器主动抓取，自行收集 LinkedIn 数据。这种方式支持灵活按需定制。 借助 Unlocker API或抓取浏览器，您可以根据具体需求定制数据收集方案，并实时更新数据。这种方法非常适合因现成数据无法满足需求而需定制数据集或注重信息实时性和时效性的用户。

    以上方案各有优势。 现成数据集便捷高效，而网页抓取工具则能让您掌控全局、按需定制。 选择最适合您需求的方案，立即开始获取 LinkedIn 数据！
  </Accordion>

  <Accordion title="如何抓取 Instagram 的公开网络数据？">
    在收集 Instagram 的公开网络数据时，您可以考虑以下两种简单明了的方案。 这些方案都能达到目的，您可以根据自身具体需求和可用资源来选择。

    **方案 1：现成数据集**

    第一种方案是使用数据集市场上提供的现成数据集。 要访问数据集市场，可以从侧边栏进入“网络数据”，然后从顶部菜单中选择“数据集市场”。

    这些数据集是预先编译的 Instagram 数据合集，包括公开个人资料、帖子或参与度指标等。 此方案非常适合那些想要快速获取大量数据又不想费心自行抓取的用户。 这为那些需要即时访问数据以进行分析、把握趋势或研究受众的企业、营销人员或研究人员提供了便利之选。

    **方案 2：使用网页抓取 API**

    借助此方案，您可轻松通过 API 实时抓取 Instagram 数据。只需访问此处，即可立即抓取所需信息
    : [https://brightdata.com/cp/scrapers/browse?domain=instagram.com\\\&id=all](https://brightdata.com/cp/scrapers/browse?domain=instagram.com\\\&id=all)

    **Option 3方案 3：Unlocker API或抓取浏览器**

    第二种方案是使用 Unlocker API或抓取浏览器主动抓取，自行收集 Instagram 数据。这种方式提供了更大的灵活性和可控性，让您能够精准获取特定数据点，如话题标签、用户互动或最新帖子。 借助 Unlocker API或抓取浏览器，您可以根据具体需求定制数据收集方案，并实时更新数据集。

    两种方法各有优势。现成数据集可让您轻松上手、即刻使用，而网页抓取工具则能满足定制需求，并确保数据实时更新。 选择最适合您目标的方案，立即开始获取 Instagram 数据！
  </Accordion>

  <Accordion title="如何抓取 Google 的公开网络数据？">
    在收集 Google 的公开网络数据时，您可以考虑以下简单明了且功能强大的方案：SERP API

    收集 Google 数据最有效的方法就是使用 SERP API。 借助 SERP API（搜索引擎结果页面 API），您可以直接获取 Google 搜索引擎结果，无需手动抓取网站。 该方案对于那些需要获取 Google 搜索数据的用户来说尤其实用，能够收集排名、摘要、图片、地图等各种搜索特性数据。

    如需详细了解 SERP API 及其定制选项，请参阅 SERP API 文档: [https://docs.brightdata.com/scraping-automation/serp-api/introduction](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

    使用 SERP API 具有诸多优势。 首先，它简化了搜索数据的收集流程，让您可以专注于分析结果，而无需费心处理网页抓取的技术问题。 此外，它为获取最新实时搜索数据提供了可靠途径，确保信息的时效性和准确性。

    SERP API 还具有强大的定制功能，您可指定关键词、位置、语言和设备类型等参数。这种灵活性使其成为一款强大的工具，特别适合需要具体了解 Google 搜索结果的营销人员、SEO 专家和研究人员。

    虽然使用 SERP API 需要一定的设置和 API 请求方面的知识，但它比传统的网页抓取更加简单可靠，这是由于 Google 频繁更新并采取反抓取措施，传统的网页抓取往往面临诸多挑战。

    如果您希望高效且有效地收集 Google 搜索数据，那么 SERP API 无疑是理想之选。立即开始探索其功能，从 Google 搜索结果中获取宝贵洞察！
  </Accordion>

  <Accordion title="如何抓取 Shopee 的公开网络数据？">
    在收集 Shopee 的公开网络数据时，您可以考虑以下两种方案：

    1. 使用 [Unlocker API](https://docs.brightdata.com/scraping-automation/web-unlocker/introduction)

    2. 从数据集市场购买数据集: [https://brightdata.com/cp/datasets/browse/gd\_lk122xxgf86xf97py](https://brightdata.com/cp/datasets/browse/gd_lk122xxgf86xf97py)

    ### 使用 Unlocker API

    收集 Shopee 实时数据最有效的方法就是使用 Unlocker API，但请注意，由于该域名的特定限制，数据收集过程可能会较为缓慢。

    注意：在很多情况下，可能并不需要实时数据！ 您也许能从数据集中获得所需信息。 详见下文。

    如需详细了解 Unlocker API及其定制选项，请参阅 Unlocker API文档。

    [Unlocker API documentation](https://docs.brightdata.com/scraping-automation/web-unlocker/introduction).

    ### 使用现成数据集

    Bright Data 维护着一个专门收录 Shopee 信息的数据集，涵盖产品描述和价格等数据。

    该数据集不仅包含历史信息，同时还在不断更新。

    您可以轻松选择数据的时间范围，只接收最近收集的信息（例如最近 24 小时的数据）。

    只需访问 Shopee 数据集，即可立即下载所需的数据部分: [https://brightdata.com/cp/datasets/browse/gd\_lk122xxgf86xf97py](https://brightdata.com/cp/datasets/browse/gd_lk122xxgf86xf97py)
  </Accordion>

  <Accordion title="如何抓取 Zillow 的公开网络数据？">
    在收集 Zillow 的公开网络数据时，您可以考虑以下三种方案。 这些方案都能达到目的，您可以根据自身具体需求和可用资源来选择。

    **方案 1：现成数据集**

    第一种方案是使用数据集市场上提供的现成数据集。 只需访问房地产数据集，即可立即下载所需的数据部分: [https://brightdata.com/cp/datasets/browse?category=real\_estate](https://brightdata.com/cp/datasets/browse?category=real_estate)

    这些数据集是预先编译的 Zillow 数据合集，包括公开资料、房产销售和租赁价格等。 此方案非常适合那些想要快速获取大量数据又不想费心自行抓取的用户。 这为那些需要即时访问数据以进行分析、把握趋势或研究受众的企业、营销人员或研究人员提供了便利之选。

    **方案 2：使用网页抓取 API**

    借助此方案，您可轻松通过 API 实时抓取 Zillow 数据。只需访问此处，即可立即抓取所需信息: [https://brightdata.com/cp/scrapers/browse?domain=zillow.com\\\&id=all](https://brightdata.com/cp/scrapers/browse?domain=zillow.com\\\&id=all)

    **Option 3方案 3：Unlocker API或抓取浏览器**

    第三种方案是使用 Unlocker API或抓取浏览器主动抓取，自行收集 Zillow 数据。这种方式提供了更大的灵活性和可控性，让您能够精准获取特定数据点，如话题标签、用户互动或最新帖子。 借助 Unlocker API或抓取浏览器，您可以根据具体需求定制数据收集方案，并实时更新数据集。

    每种方法各有优势。 现成数据集可让您轻松上手、即刻使用，而网页抓取工具则能满足定制需求，并确保数据实时更新。 选择最适合您目标的方案，立即开始获取 Zillow 数据！
  </Accordion>

  <Accordion title="如何抓取 HomeDepot 的公开网络数据？">
    在收集 HomeDepot 的公开网络数据时，您可以考虑以下三种方案。 这些方案都能达到目的，您可以根据自身具体需求和可用资源来选择。

    **方案 1：现成数据集**

    第一种方案是使用数据集市场上提供的现成数据集。只需访问此处，即可立即下载所需的数据部分: [https://brightdata.com/cp/datasets/browse?search=homedepot](https://brightdata.com/cp/datasets/browse?search=homedepot)

    这些数据集是预先编译的 HomeDepot 数据合集。 HomeDepot 在加拿大和美国的数据均已收录在内。

    **方案 2：使用网页抓取 API**

    借助此方案，您可轻松通过 API 实时抓取 Zillow 数据。 只需访问此处，即可立即抓取所需信息: [https://brightdata.com/cp/scrapers/browse?domain=homedepot.com\\\&id=all](https://brightdata.com/cp/scrapers/browse?domain=homedepot.com\\\&id=all)

    HomeDepot 在加拿大和美国的数据均已收录在内。

    **方案 3：Unlocker API或抓取浏览器**

    T第二种方案是使用 Unlocker API或抓取浏览器主动抓取，自行收集 HomeDepot 数据。这种方式提供了更大的灵活性和可控性，让您能够精准获取特定数据点，如话题标签、用户互动或最新帖子。借助 Unlocker API或抓取浏览器，您可以根据具体需求定制数据收集方案，并实时更新数据集。

    每种方法各有优势。 现成数据集可让您轻松上手、即刻使用，而网页抓取工具则能满足定制需求，并确保数据实时更新。 选择最适合您目标的方案，立即开始获取 HomeDepot 数据！
  </Accordion>

  <Accordion title="如何抓取 Amazon 的公开网络数据？">
    在收集 Amazon 的公开网络数据时，您可以考虑以下三种方案。 这些方案都能达到目的，您可以根据自身具体需求和可用资源来选择。

    **方案 1：现成数据集**

    第一种方案是使用数据集市场上提供的现成数据集。 只需访问此处，即可立即下载所需的数据部分: [https://brightdata.com/cp/datasets/browse?search=amazon](https://brightdata.com/cp/datasets/browse?search=amazon)

    这些数据集是预先编译的 Amazon 数据合集，会定期更新，以确保时效性。 您可轻松获取 Amazon 在加拿大、德国、美国和所有其他国家/地区站点的域名信息。

    **方案 2：使用网页抓取 API**

    借助此方案，您可轻松通过 API 实时抓取 Amazon 数据。 只需访问此处，即可立即抓取所需信息: [https://brightdata.com/cp/scrapers/browse?domain=amazon.com\\\&id=all](https://brightdata.com/cp/scrapers/browse?domain=amazon.com\\\&id=all)

    您可轻松获取 Amazon 在加拿大、德国、美国和所有其他国家/地区站点的域名信息。

    **方案 3：Unlocker API或抓取浏览器**

    第三种方案是使用 Unlocker API或抓取浏览器主动抓取，自行收集 HomeDepot 数据。这种方式提供了更大的灵活性和可控性，让您能够精准获取特定数据点。借助 Unlocker API或抓取浏览器，您可以根据具体需求定制数据收集方案，并实时更新数据集。

    每种方法各有优势。 现成数据集可让您轻松上手、即刻使用，而网页抓取工具则能满足定制需求，并确保数据实时更新。 选择最适合您目标的方案，立即开始获取 Amazon 数据！
  </Accordion>

  <Accordion title="如何抓取 Facebook 的公开网络数据？">
    在收集 Facebook 的公开网络数据时，您可以考虑以下三种方案。 这些方案都能达到目的，您可以根据自身具体需求和可用资源来选择。

    **方案 1：现成数据集**

    第一种方案是使用数据集市场上提供的现成数据集。 只需访问此处，即可立即下载所需的数据部分: [https://brightdata.com/cp/datasets/browse?search=facebook](https://brightdata.com/cp/datasets/browse?search=facebook)

    这些数据集是预先编译的 Facebook 数据合集，会定期更新，以确保时效性。 您可轻松获取 Facebook 在加拿大、德国、美国和所有其他地区的域名信息。

    **方案 2：使用网页抓取 API**

    借助此方案，您可轻松通过 API 实时抓取 Facebook 数据。 只需访问此处，即可立即抓取所需信息: [https://brightdata.com/cp/data\_api?id=all\\\&search=facebook](https://brightdata.com/cp/data_api?id=all\\\&search=facebook)

    您可轻松获取 Facebook 在加拿大、德国、美国和所有其他地区的域名信息。

    **方案 3：Unlocker API或抓取浏览器**

    第三种方案是使用 Unlocker API或抓取浏览器主动抓取，自行收集 Facebook 数据。这种方式提供了更大的灵活性和可控性，让您能够精准获取特定数据点。 借助 Unlocker API或抓取浏览器，您可以根据具体需求定制数据收集方案，并实时更新数据。

    每种方法各有优势。 现成数据集可让您轻松上手、即刻使用，而网页抓取工具则能满足定制需求，并确保数据实时更新。 选择最适合您目标的方案，立即开始获取 Facebook 数据！
  </Accordion>

  <Accordion title="如何抓取 Glassdoor 的公开网络数据？">
    在收集 Glassdoor 的公开网络数据时，您可以考虑以下三种方案。 这些方案都能达到目的，您可以根据自身具体需求和可用资源来选择。

    **方案 1：现成数据集**

    第一种方案是使用数据集市场上提供的现成数据集。 只需访问此处，即可立即下载所需的数据部分: [https://brightdata.com/cp/datasets/browse?search=glassdoor](https://brightdata.com/cp/datasets/browse?search=glassdoor)

    这些数据集是预先编译的 Glassdoor 数据合集，会定期更新，以确保时效性。 您可轻松获取 Glassdoor 招聘信息、评价和公司信息等。

    **方案 2：使用网页抓取 API**

    借助此方案，您可轻松通过 API 实时抓取 Glassdoor 数据。 只需访问此处，即可立即抓取所需信息: [https://brightdata.com/cp/data\_api?search=glassdoor](https://brightdata.com/cp/data_api?search=glassdoor)

    您可轻松获取 Glassdoor 招聘信息、评价和公司信息等。

    **方案 3：Unlocker API或抓取浏览器**

    第三种方案是使用 Unlocker API或抓取浏览器主动抓取，自行收集 Glassdoor 数据。这种方式提供了更大的灵活性和可控性，让您能够精准获取特定数据点。 借助 Unlocker API或抓取浏览器，您可以根据具体需求定制数据收集方案，并实时更新数据。

    每种方法各有优势。 现成数据集可让您轻松上手、即刻使用，而网页抓取工具则能满足定制需求，并确保数据实时更新。 选择最适合您目标的方案，立即开始获取 Glassdoor 数据！
  </Accordion>

  <Accordion title="如何抓取 Shein 的公开网络数据？">
    在收集 Shein 的公开网络数据时，您可以考虑以下三种方案。 这些方案都能达到目的，您可以根据自身具体需求和可用资源来选择。

    **方案 1：现成数据集**

    第一种方案是使用数据集市场上提供的现成数据集。 只需访问此处，即可立即下载所需的数据部分: [https://brightdata.com/cp/datasets/browse?search=shein](https://brightdata.com/cp/datasets/browse?search=shein)

    这些数据集是预先编译的 Shein 数据合集，会定期更新，以确保时效性。 您可轻松获取 Shein 产品的信息。

    **方案 2：使用网页抓取 API**

    借助此方案，您可轻松通过 API 实时抓取 Shein 数据。 只需访问此处，即可立即抓取所需信息: [https://brightdata.com/cp/scrapers/browse?domain=us.shein.com\\\&id=all](https://brightdata.com/cp/scrapers/browse?domain=us.shein.com\\\&id=all)

    您可轻松获取 Shein 产品和类别的信息。

    **方案 3：Unlocker API或抓取浏览器**

    第三种方案是使用 Unlocker API或抓取浏览器主动抓取，自行收集 Shein 数据。这种方式提供了更大的灵活性和可控性，让您能够精准获取特定数据点。 借助 Unlocker API或抓取浏览器，您可以根据具体需求定制数据收集方案，并实时更新数据。

    每种方法各有优势。 现成数据集可让您轻松上手、即刻使用，而网页抓取工具则能满足定制需求，并确保数据实时更新。 选择最适合您目标的方案，立即开始获取 Shein 数据！
  </Accordion>

  <Accordion title="如何抓取 G2 的公开网络数据？">
    在收集 G2 的公开网络数据时，您可以考虑以下三种方案。 这些方案都能达到目的，您可以根据自身具体需求和可用资源来选择。

    **方案 1：现成数据集**

    第一种方案是使用数据集市场上提供的现成数据集。只需访问此处，即可立即下载所需的数据部分: [https://brightdata.com/cp/datasets/browse?search=g2](https://brightdata.com/cp/datasets/browse?search=g2)

    这些数据集是预先编译的 G2 数据合集，会定期更新，以确保时效性。 您可轻松获取 G2 产品评价的信息。

    **方案 2：使用网页抓取 API**

    借助此方案，您可轻松通过 API 实时抓取 G2 数据。 只需访问此处，即可立即抓取所需信息: [https://brightdata.com/cp/scrapers/browse?domain=g2.com\\\&id=all](https://brightdata.com/cp/scrapers/browse?domain=g2.com\\\&id=all)

    您可轻松获取 G2 产品评价的信息。

    **方案 3：Unlocker API或抓取浏览器**

    第三种方案是使用 Unlocker API或抓取浏览器主动抓取，自行收集 G2 数据。这种方式提供了更大的灵活性和可控性，让您能够精准获取特定数据点。 借助 Unlocker API或抓取浏览器，您可以根据具体需求定制数据收集方案，并实时更新数据。

    每种方法各有优势。 现成数据集可让您轻松上手、即刻使用，而网页抓取工具则能满足定制需求，并确保数据实时更新。 选择最适合您目标的方案，立即开始获取 G2 数据！
  </Accordion>
</AccordionGroup>


# 如何设置 Bright Data 与 AdsPower
Source: https://docs.brightdata.com/cn/integrations/adspower

使用 Bright Data 和 AdsPower 提升您的网络爬取和多账户管理能力。在管理多个账户时保持安全且不被检测到。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 AdsPower？

使用 AdsPower 掌控您的多账户管理！这款多功能浏览器非常适合市场营销人员、电商企业和社交媒体管理者，它提供了一种安全高效的方式来同时管理多个账户。每个浏览器配置文件都在其独立的环境中运行，确保您的活动不会被检测到或标记为异常。

AdsPower 为每个配置文件提供独特的数字指纹，包括 IP 地址、设备类型和用户代理等信息，使您的操作始终保持低调。不论是扩展电商业务、运行社交媒体广告活动，还是从事联盟营销，AdsPower 都能让您的多账户管理变得流畅且安全。

<Tip>
  通过在用户名中使用 `-session` 参数，在浏览会话期间保持一致的 IP。这一点很重要，因为 Bright Data 代理默认会在每次请求时轮换 IP。[了解更多](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 />

  新用户应优先选择 ISP 或数据中心代理，因为住宅代理在 [即时访问模式](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) 下无法与浏览器集成。<br />

  对于 **账户管理** 相关的使用场景，每个管理的账户应使用一个固定的专用静态 IP。[专用 ISP 代理](https://docs.brightdata.com/proxy-networks/isp/introduction) 是最佳选择。
</Tip>

## AdsPower 代理集成

将 Bright Data 代理与 AdsPower 集成简单快捷，按照以下步骤进行设置：

### 步骤 1. **下载 AdsPower**

前往 [AdsPower 官网](https://www.adspower.com/download) 下载并安装该应用程序。

### 步骤 2. **创建新配置文件**

安装完成后，打开应用程序，点击 **新建配置文件** 来创建您的第一个浏览器配置文件。

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower1.png?maxW=1016&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=08ba2036e97be3f658bc723b38b6e49f" alt="" width="1016" height="508" data-path="images/integrations/adspower1.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower1.png?w=280&maxW=1016&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=29355437effd7a9f16ce187aae4d1c47 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower1.png?w=560&maxW=1016&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=2dad2ba94f5cbdf7e4f247fe509f7062 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower1.png?w=840&maxW=1016&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=393692f884654859010985e7c144653b 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower1.png?w=1100&maxW=1016&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=e11bfcde2efb1fc7bebd05ef62b70c64 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower1.png?w=1650&maxW=1016&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=bd5e9d6775a22813da9aedf9438aab20 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower1.png?w=2500&maxW=1016&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=d95b874e7d7183fddde9d8a3cfcd5f27 2500w" data-optimize="true" data-opv="2" />
</Frame>

### 步骤 3. **配置您的代理**

接下来，我们来设置 Bright Data 代理，按照以下步骤操作：

* **代理类型**: 选择 `HTTP`、`HTTPS` 或 `SOCKS5`（根据您的代理类型）。
* **代理主机**: 输入 [`http://brd.superproxy.io/`](http://brd.superproxy.io/)。
* **代理端口**: `33335`
* **代理用户名**: 输入您的 Bright Data 代理区域 `username`。
* **代理密码**: 输入您的 Bright Data 代理区域 `password`。

### 步骤 4. **测试代理连接**

点击 **检查代理** 以确保代理配置正确。

<Note>
  某些版本的 AdsPower 使用 `google.com` 作为默认的测试网站。Bright Data 代理会阻止对 `google.com` 的访问，因此请确保测试网站不是搜索引擎网站。
</Note>

<Note>
  如果您选择了住宅代理或移动代理，必须安装 Bright Data SSL 证书，以确保端到端通信的安全性。**否则，您将遇到连接错误**。
  SSL 安装指南可在 [此处](https://docs.brightdata.com/general/account/ssl-certificate#ssl-certificate) 找到。
  另外，您可以在 AdsPower 中忽略 SSL 验证：在设置配置文件时，进入高级设置，在启动参数中粘贴 `--ignore-certificate-errors`。
</Note>

<Info>
  **如果需要特定国家的代理，可以输入格式 `your-username-country-us` 来获得美国出口节点。**
</Info>

所有设置完成后，点击 **确定** 保存配置。

### 步骤 5. **启动浏览器**

在 **标签** 下点击 **打开** 以启动已配置代理的浏览器。

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower4.png?maxW=1310&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=1ade62625dc17d22ff302bd3822de43d" alt="" width="1310" height="273" data-path="images/integrations/adspower4.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower4.png?w=280&maxW=1310&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c904bce08c44a90c86d0abcff99f4d79 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower4.png?w=560&maxW=1310&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=3f33facd4a428ee2c3bd2758f106146e 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower4.png?w=840&maxW=1310&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c4d81e2860bd5960d245d46857301ae0 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower4.png?w=1100&maxW=1310&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=9f4fa64b2eb15c2aeba8df504408b325 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower4.png?w=1650&maxW=1310&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f9ec356a70d3826f4a050a4104f49e01 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower4.png?w=2500&maxW=1310&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c694b6b7ea5780fc67a3d544218e6916 2500w" data-optimize="true" data-opv="2" />
</Frame>

就这样！您已成功将 Bright Data 代理集成到 AdsPower 中，现在可以开始使用了！


# 如何设置 Bright Data 与 Aezakmi
Source: https://docs.brightdata.com/cn/integrations/aezakmi

在 Aezakmi 中使用 Bright Data 提升您的匿名性并简化在线任务。按照本指南配置安全可靠的代理连接，为您的浏览器配置文件提供保障。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 Aezakmi？

Aezakmi 是一款浏览器自动化工具，适用于需要多个独立浏览器配置文件的营销人员、研究人员和开发者。结合 Bright Data，您可以确保安全、匿名，并通过定位代理访问特定地区的内容，同时避免 IP 封禁和追踪。

<Tip>
  通过在用户名中使用 `-session` 参数，在浏览会话期间保持一致的 IP。这一点很重要，因为 Bright Data 代理默认会在每次请求时轮换 IP。[了解更多](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 />

  新用户应优先选择 ISP 或数据中心代理，因为住宅代理在 [即时访问模式](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) 下无法与浏览器集成。<br />

  对于 **账户管理** 相关的使用场景，每个管理的账户应使用一个固定的专用静态 IP。[专用 ISP 代理](https://docs.brightdata.com/proxy-networks/isp/introduction) 是最佳选择。
</Tip>

## 为什么在 Aezakmi 中使用 Bright Data？

* **增强隐私**：隐藏您的真实 IP 地址，实现安全浏览。

* **地理定位**：使用特定国家的代理访问区域限制的内容。

* **稳定的性能**：确保所有浏览器配置文件都能获得可靠且不中断的连接。

## 如何在 Aezakmi 中集成 Bright Data？

按照以下步骤在 Aezakmi 中配置 Bright Data 代理：

### **步骤 1. 安装并登录 Aezakmi**

1\. 从 [官方网站](https://aezakmi.run/) 下载并安装 Aezakmi。

2\. 打开应用程序，并使用您的账户凭据登录。

### **步骤 2. 创建新的浏览器配置文件**

1\. 进入您的 [仪表板](https://account.aezakmi.run/#/dashboard) 或在 **Aezakmi 扩展** 中点击 **创建新配置文件**。

2\. 选择以下参数来配置您的浏览器配置文件：

* **操作系统**

* **浏览器**

* **屏幕分辨率**

* **显卡型号**

3\. 点击 **生成指纹**，创建一个独特的浏览器指纹配置文件。

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi1.png?maxW=1080&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=7ccfcee54726fdd1bc510511fc4df0c1" alt="" width="1080" height="643" data-path="images/integrations/aezakmi1.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi1.png?w=280&maxW=1080&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=3f88c09e3de1f17f5a327d417b405727 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi1.png?w=560&maxW=1080&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=1d72e45239d071ef92e7d85bc943e7df 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi1.png?w=840&maxW=1080&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=730b9dee1f5a3628d5936df6f9652421 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi1.png?w=1100&maxW=1080&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=0f212f9ea34a6ec4c7c887d16c83f7ef 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi1.png?w=1650&maxW=1080&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=26fe31afb4770c458f4c767e5a05d00c 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi1.png?w=2500&maxW=1080&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=6c207b77d1359fbf7f2beefecddc9965 2500w" data-optimize="true" data-opv="2" />
</Frame>

### **步骤 3. 启用代理**

1\. 在配置文件设置页面的 **配置文件名称** 字段中输入一个易于识别的名称。

2\. 切换 **启用代理** 为 *开启*，以激活代理配置选项。

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi2.png?maxW=1099&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=47a1b8a9903b225eb4af73d16e276b57" alt="" width="1099" height="182" data-path="images/integrations/aezakmi2.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi2.png?w=280&maxW=1099&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=4dd9faae2e03628d094daad918c22443 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi2.png?w=560&maxW=1099&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=4415989171dadbd10f8ac55a3f69776b 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi2.png?w=840&maxW=1099&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=2f8be488e9bb3b54817161c1d9c9c302 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi2.png?w=1100&maxW=1099&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=5fdaed477238b0c60841ec43bd1d5e68 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi2.png?w=1650&maxW=1099&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=417604b5865656de9df42e3ae7b3a5ce 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi2.png?w=2500&maxW=1099&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=0aa2f7b5691fd58cf9317b0fb11d6dec 2500w" data-optimize="true" data-opv="2" />
</Frame>

### **步骤 4. 配置代理设置**

1\. 在代理设置部分，输入您的 Bright Data 代理信息：

* **协议**: 选择 `HTTP`、`HTTPS` 或 `SOCKS5`（根据您的代理类型）。

* **地址**: 输入 [`http://brd.superproxy.io/`](http://brd.superproxy.io/)。

* **端口**: `33335`

* **用户名**: 输入您的 Bright Data 代理区域 `username`。

* **密码**: 输入您的 Bright Data 代理区域 `password`。

2\. 点击 **检查代理** 以验证您的连接，并确保测试成功。

<Note>
  对于地理定位代理，在用户名中添加国家代码，格式为 `your-username-country-XX`（例如 `your-username-country-US`）。
</Note>

### **步骤 5. 保存并启动**

* 代理信息验证完成后，点击 **保存指纹** 以应用设置并保存配置文件。

通过将 Bright Data 集成到 Aezakmi，您可以解锁安全高效的浏览体验。无论是管理多个账户、抓取数据，还是访问受地理限制的内容，Bright Data 都能确保隐私、安全性和稳定性。立即开始，最大化您的工作效率！


# 如何在 Android 上设置 Bright Data
Source: https://docs.brightdata.com/cn/integrations/android

快速在您的 Android 设备上配置 Bright Data 代理！该过程非常简单，不同设备之间仅有少许差异。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

在 Android 设备上设置代理服务器既简单又灵活。您可以为 **移动数据** 或 **Wi-Fi** 配置代理。选择您的网络类型并按照以下步骤进行操作！

## 为移动网络配置代理

**步骤 1. 访问网络设置**\
打开 **设置**，然后进入 **网络和互联网**（或 **连接**，具体取决于您的设备）。

**步骤 2. 查找 APN 设置**\
点击 **移动网络** 并选择 **接入点名称 (APN)**。

<Frame as="div" style={{width:"50%", height:"auto"}}>
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android3.png?maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=2d03047bc61a86090486da361efe875c" alt="" width="300" height="525" data-path="images/integrations/android3.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android3.png?w=280&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=adfe432341ed9772d4954ae69540b449 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android3.png?w=560&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=56e4262df2623b9ce040abc67b124b5e 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android3.png?w=840&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8036da15ac3f2fa9ac0d722d45154766 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android3.png?w=1100&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=5a26c186a7244476cca191ad8426137c 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android3.png?w=1650&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c31e2b57d2b849c6265f766c69688170 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android3.png?w=2500&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d741c9936c56e730c2b0a686f5a350f9 2500w" data-optimize="true" data-opv="2" />
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android4.png?maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=09ba55dab05eb02352fece1cc58c3576" alt="" width="300" height="349" data-path="images/integrations/android4.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android4.png?w=280&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=fd1f0180285e5e61781f52ff263707f0 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android4.png?w=560&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=43c0f9aa4903108c73564d7071ac1281 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android4.png?w=840&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=99366e3c711668f83100f1dcb22dfb92 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android4.png?w=1100&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d27956ab0d5f43035d98704755c0dd73 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android4.png?w=1650&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=7667572b4ed8e458fd2e88ce507b0bf6 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android4.png?w=2500&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=6b4c900c045848236437957b09278f50 2500w" data-optimize="true" data-opv="2" />
</Frame>

**步骤 3. 修改 APN 详情**\
选择您的活动 APN 并填写以下字段：

<Frame as="div" style={{width:"50%", height:"auto"}}>
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android5.png?maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=4f4d16e35e876e5c9bbcb0df04243f9a" alt="" width="300" height="156" data-path="images/integrations/android5.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android5.png?w=280&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c7f0f9c8bf1e86b5c8cd36a4e3c246bb 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android5.png?w=560&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=999c4054a36b20741001fb53c1cdc65c 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android5.png?w=840&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=b6a3268600c6ccf85850da63828f31c2 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android5.png?w=1100&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c722528da84440b83088b561c4fda0ba 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android5.png?w=1650&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d40fe59dedb4d34e35df32802c070716 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android5.png?w=2500&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=4fd90a837bc6e018dbdadf22b91e1bf8 2500w" data-optimize="true" data-opv="2" />
</Frame>

* **代理 (Proxy)**：输入 [`http://brd.superproxy.io/`](http://brd.superproxy.io/)
* **端口 (Port)**：33335
* **用户名 (Username)**：输入您的 Bright Data 代理用户名
* **密码 (Password)**：输入您的 Bright Data 代理密码

<Frame as="div" style={{width:"50%", height:"auto"}}>
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android6.png?maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=648d0d652ff3ea60866bcb8f449724f1" alt="" width="300" height="398" data-path="images/integrations/android6.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android6.png?w=280&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d42e85e2e7873dd783571d775c15e6fe 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android6.png?w=560&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=26d53da8cde4e77056f4eedf25f48ef3 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android6.png?w=840&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d3097f47f992670506e258f13be88720 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android6.png?w=1100&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=b330a986d618fb823c4fca235ffe9a8a 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android6.png?w=1650&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9b52c549686d1ce5f6939a8bb2b38191 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android6.png?w=2500&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=3fe1c9a34e56b35452e3c55bdf995ec7 2500w" data-optimize="true" data-opv="2" />
</Frame>

**步骤 4. 保存并重新连接**\
保存您的更改，然后通过关闭并重新打开移动数据来刷新连接。

## 为 Wi-Fi 网络配置代理

**步骤 1. 访问网络设置**\
打开 **设置**，然后进入 **网络和互联网（或连接）** > **Wi-Fi**。

<Frame as="div" style={{width:"50%", height:"auto"}}>
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android1.png?maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=4b579d95b3ac79c69c7bc5ee20c572f4" alt="" width="300" height="534" data-path="images/integrations/android1.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android1.png?w=280&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=00a2c5fd1636a7431bce269df2c5435b 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android1.png?w=560&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=7f9485f110b5806f5077deb68443ec70 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android1.png?w=840&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=cc7b937a2e49f048e51d39440f7faf06 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android1.png?w=1100&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=9bb9780532f56a1eb6eff5ab7501632d 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android1.png?w=1650&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=aa89da33591f05d7e4987b17611d75ae 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android1.png?w=2500&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c5fb44fdb021c9bc480ef9505a3f39c3 2500w" data-optimize="true" data-opv="2" />
</Frame>

**步骤 2. 选择您的 Wi-Fi 网络**\
点击已连接的网络并选择 **设置**（或 **编辑**）图标。

<Frame as="div" style={{width:"50%", height:"auto"}}>
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android2.png?maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=7002b6f6e3ff36a260438d687008b549" alt="" width="300" height="210" data-path="images/integrations/android2.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android2.png?w=280&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=d319c747384e128f6ea9d33ce7aef6ee 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android2.png?w=560&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=4cdbc3bccc692cf84c105e45c0593502 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android2.png?w=840&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f02bf42b6713741eb64979561c7adf78 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android2.png?w=1100&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=3bab880a42990becee2d32c278a53747 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android2.png?w=1650&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=15c95e492992aff9e4789035054632b5 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android2.png?w=2500&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=b368f1798cd372c4c9b54d41f8555b6b 2500w" data-optimize="true" data-opv="2" />
</Frame>

**步骤 3. 启用手动代理配置**\
向下滚动至 **高级选项**，将 **代理** 设置为 **手动**。

**步骤 4. 修改代理详情**\
提供以下信息：

* **主机 (Host)**：输入 [`http://brd.superproxy.io/`](http://brd.superproxy.io/)
* **端口 (Port)**：33335

点击 **保存** 以应用配置，并确保更改生效。

您已准备就绪！配置 **Bright Data** 代理后，您的 Android 设备将享受 **更安全、更私密** 的浏览体验，非常适合访问受限网站或提升在线安全性。


# 如何使用 Antik 设置 Bright Data
Source: https://docs.brightdata.com/cn/integrations/antik

将 Bright Data 与 Antik 集成，以增强您的在线匿名性、简化任务，并安全管理浏览器配置文件。按照本分步指南配置 Bright Data 与 Antik，实现高效且私密的浏览体验。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 Antik？

Antik 是一款基于浏览器的自动化工具，适用于管理多个账户、网页爬取和地理定位活动。结合 Bright Data，Antik 可确保您的自动化和浏览需求在安全和私密的环境下进行。

<Tip>
  使用 `-session` 参数在您的用户名中，可以在整个浏览会话期间保持一致的 IP。这很重要，因为 Bright Data 代理默认会在每次请求时轮换 IP。[了解更多](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 />

  新用户应从 ISP 或数据中心代理入手，因为住宅代理与 [即时访问模式](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) 的浏览器集成不兼容。<br />

  对于 **账户管理** 相关的用例，每个账户应使用一致的专用静态 IP。应使用专用 [ISP 代理](https://docs.brightdata.com/proxy-networks/isp/introduction) 进行管理。
</Tip>

## 为什么要在 Antik 中使用 Bright Data？

* **隐私保护**：保护您的 IP 地址和在线身份。
* **地理定位**：使用 Bright Data 的国家/地区代理访问特定区域的内容。
* **可靠性**：稳定的连接确保无缝工作流。

## 如何将 Bright Data 与 Antik 集成

**步骤 1. 下载并登录 Antik**

1\. 访问 [Antik 官网](https://antik.io/) 并下载应用程序。\
2\. 安装软件并使用您的账户凭据登录。

**步骤 2. 创建新的浏览器配置文件**

1\. 在 Antik 仪表板中，进入 **Profiles** 选项卡。\
2\. 点击 **Create** 以开始配置新的浏览器配置文件。

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik1.png?maxW=1418&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=6a260647a83a2433b1a2b8c16ce3b7e4" alt="" width="1418" height="197" data-path="images/integrations/antik1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik1.png?w=280&maxW=1418&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e898e52e06fa94392c2d3d8ebe6516a4 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik1.png?w=560&maxW=1418&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=844c191576752d3592a403c073e5b9e8 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik1.png?w=840&maxW=1418&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=22a006cb62f481398ea3d50909f88b3f 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik1.png?w=1100&maxW=1418&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=7cddb706d8410e71e0f1fb0097083c4a 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik1.png?w=1650&maxW=1418&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=7f03cba50ed940aac49b016a7f97d220 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik1.png?w=2500&maxW=1418&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=329a98c5d19aa862083849fe7dd9e008 2500w" data-optimize="true" data-opv="2" />
</Frame>

**步骤 3. 启用代理设置**

1\. 在 **General Settings** 选项卡下，找到 **Name** 字段，并输入一个易于识别的名称，以便后续查找。\
2\. 转到 **New Proxy** 选项卡。

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik2.png?maxW=951&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=31ce21ecd4ad690e10f4cecfd874871f" alt="" width="951" height="573" data-path="images/integrations/antik2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik2.png?w=280&maxW=951&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d5a00d2bc179f6f6d0d6e59680fa4c1e 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik2.png?w=560&maxW=951&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=33838ac9877d080f37ebed4f19aee66e 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik2.png?w=840&maxW=951&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=1bdb0ae3ce02d112abc650340378f482 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik2.png?w=1100&maxW=951&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=0601aa9190eaa37ac79b0ede9107ddd2 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik2.png?w=1650&maxW=951&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=76fb8b22f294059c2f3dfb7ee029b4b4 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik2.png?w=2500&maxW=951&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=b8d83b0bbab2da5848052193e62365d6 2500w" data-optimize="true" data-opv="2" />
</Frame>

**步骤 4. 添加您的 Bright Data 代理详情**

1\. 前往您的 [Bright Data 仪表板](https://brightdata.com/cp/zones)，点击您的代理区域。\
2\. 在 **Overview** 选项卡下，复制以下格式的代理信息：

`host : port : username : password`（无空格）。

3\. 将此信息粘贴到 Antik 的 **Proxy** 字段中。\
4\. 代理配置验证完成后，点击 **Create** 以保存设置。

<Note>
  对于地理定位代理，请按 `your-username-country-XX`（例如 `your-username-country-US`）的格式设置您的用户名，以指定位置。
</Note>

**步骤 5. 保存并启动**

1\. 进入 **Profiles** 选项卡，选择新创建的配置文件。\
2\. 点击 **Start**，以 Bright Data 设置启动浏览器。

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik3.png?maxW=1216&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=428ac035b6d5c5ac1ff8396666671db6" alt="" width="1216" height="244" data-path="images/integrations/antik3.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik3.png?w=280&maxW=1216&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f03c9079272cad045ae07089dff9a466 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik3.png?w=560&maxW=1216&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=2fab2360016db14ce2f42ece28a1cfe2 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik3.png?w=840&maxW=1216&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c6e4aa0c20e42cded00c79241e3dba91 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik3.png?w=1100&maxW=1216&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=847b57da1884ca4c39cc9f279f90df30 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik3.png?w=1650&maxW=1216&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=b082c61475ef1d1597524dbfba23785e 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik3.png?w=2500&maxW=1216&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=b19e85e424b88595b10bbd36be6d9ef3 2500w" data-optimize="true" data-opv="2" />
</Frame>

通过将 Bright Data 与 Antik 集成，您可以实现安全、高效的浏览体验，使工作流程更加流畅和私密。无论是管理多个账户，还是针对特定地区，Bright Data 都能提供可靠的支持，让您保持领先。立即开始，享受无缝的浏览体验吧！


# 如何在 Apify 中使用 Bright Data
Source: https://docs.brightdata.com/cn/integrations/apify

让网络爬取更加顺畅！将 Oculus 代理集成到 Apify，可实现更流畅、匿名且高效的爬取工作流程，帮助您绕过 IP 封锁、地理限制和验证码等挑战。请按照本指南，在 Apify 中设置 Oculus 代理，以提高性能和可靠性。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 Apify？

Apify 是一个功能强大的网络爬取和自动化平台。它允许开发者创建和运行自定义网络爬取工具，称为 **Actors**（执行器），以自动化数据收集和处理任务。通过集成 Bright Data 代理，您可以增强 Apify 工作流的匿名性、稳定性和效率，确保任务顺利运行。

## 如何将 Bright Data 集成到 Apify

在本指南中，我们将使用 [**Web Scraper**](https://apify.com/apify/web-scraper) 执行器作为示例。

**步骤 1. 访问您的 Apify 仪表板和工具**

1\. 使用您的凭据登录 [Apify 账户](https://apify.com/)。

2\. 在仪表板中，转到 **Apify Store** 以浏览可用工具。使用搜索栏或按类别浏览，找到 Web Scraper 执行器。

**步骤 2. 启动 Web Scraper 执行器**

1\. 在左侧菜单的 **Actors** 部分找到 **Web Scraper 执行器**。

2\. 点击它，打开配置页面。

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify2.png?maxW=1485&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=cc8e557770d8c485a9d01c3ad0c948ae" alt="" width="1485" height="365" data-path="images/integrations/apify2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify2.png?w=280&maxW=1485&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=418b8df14022f463004762e359092f78 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify2.png?w=560&maxW=1485&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=17f40d3f770fabe2d74c82e47f59da68 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify2.png?w=840&maxW=1485&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8025128319a33a066445f7f8dbeed8a6 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify2.png?w=1100&maxW=1485&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ca5803dd1d1f83a8b0fdb8f6b1220a21 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify2.png?w=1650&maxW=1485&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=4b20468f6262f187d6a15d988a7c1628 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify2.png?w=2500&maxW=1485&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=aa4dae4576d635d38f2cb0694f7b858b 2500w" data-optimize="true" data-opv="2" />
</Frame>

**步骤 3. 定义爬取的目标 URL**

1\. 在 **输入（Input）** 选项卡中，找到 **基本配置（Basic Configuration）** 部分。

2\. 输入您想要爬取的网页目标 URL。

3\. 根据您的爬取需求添加一个或多个 URL。

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify3.png?maxW=858&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=1dbab9eb89a39f2fe5cf9cf1d3af3e0e" alt="" width="858" height="519" data-path="images/integrations/apify3.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify3.png?w=280&maxW=858&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=cccd2c60ff6827073dd63574e01241ff 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify3.png?w=560&maxW=858&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9ab7a00f038157d93117e3a81f443ebd 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify3.png?w=840&maxW=858&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=eaf136f6d87ca97905678d81e24f4ff3 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify3.png?w=1100&maxW=858&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f3b27fcf353eb02812feaa9e42635bb1 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify3.png?w=1650&maxW=858&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=34a15062efc05f319b1bbe33bab9b98d 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify3.png?w=2500&maxW=858&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=5deadcbffb13276b0de0ede6d85d34be 2500w" data-optimize="true" data-opv="2" />
</Frame>

<Note>
  Bright Data 合规性规定，搜索引擎（如 `google`）只能通过 SERP 代理区域访问。测试时，请使用非搜索引擎目标。
</Note>

**步骤 4. 设置自定义代理选项**

1\. 向下滚动至 **代理和浏览器配置（Proxy and Browser Configuration）** 部分。

2\. 选择 **自定义代理（Own proxies）** 以启用代理设置。

3\. 按以下格式输入您的 [Bright Data 代理详情](https://brightdata.com/cp/zones)：

```basic
http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]
```

4\. 使用您的 Bright Data 凭据，并在需要时修改用户名以访问特定国家/地区（例如：`your-username-country-US`）。

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify4.png?maxW=833&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=089cf11a5f2011c2080a9cb28df5f46b" alt="" width="833" height="401" data-path="images/integrations/apify4.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify4.png?w=280&maxW=833&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=db5d337c66c0a274a169ff278ba7ebc7 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify4.png?w=560&maxW=833&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=1a531746bcdf6312fbb19e3dab87f7f8 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify4.png?w=840&maxW=833&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a53d9ecc38f0d6ab7247d723290709b5 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify4.png?w=1100&maxW=833&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=807946426bed1209d0a31376204df199 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify4.png?w=1650&maxW=833&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9d36e0db88b464aba4052d5f45ab1b52 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify4.png?w=2500&maxW=833&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=3b36b288becec1909e9d48c419d24b41 2500w" data-optimize="true" data-opv="2" />
</Frame>

**步骤 5. 启动并验证执行器任务**

1\. 代理配置完成后，点击 **保存 & 启动（Save & Start）** 以启动执行器。

2\. 检查日志，确保任务运行顺利，并且 Bright Data 代理已激活。

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify5.png?maxW=828&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8fb602ea7af7830a7ea177fa7c2a7314" alt="" width="828" height="283" data-path="images/integrations/apify5.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify5.png?w=280&maxW=828&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=52146bfc1c4ad5894c2a2118f3f77203 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify5.png?w=560&maxW=828&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=333a0adc4645448aeb24b0821eeac10a 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify5.png?w=840&maxW=828&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=890f5be92f9df3a5d86a304df8cd815a 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify5.png?w=1100&maxW=828&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d3ccc77a72484b6ba3a6179c1f1c4891 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify5.png?w=1650&maxW=828&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=59ca41f71b5261b1890bb55e29f2717b 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify5.png?w=2500&maxW=828&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=2959f6953a843f9cfb9dc677065280c7 2500w" data-optimize="true" data-opv="2" />
</Frame>

通过将 Bright Data 代理集成到 Apify，您可以运行强大、匿名和地理定位的自动化工作流。无论是爬取数据、处理信息，还是管理大规模项目，Bright Data 都能确保 Apify 任务的顺畅和可靠性。立即开始构建更智能的自动化流程吧！


# 如何使用 Bright Data 与 BeautifulSoup
Source: https://docs.brightdata.com/cn/integrations/beautifulsoup

使用 Bright Data 和 BeautifulSoup 来增强您的网页爬取工作流程。本指南将指导您如何在 Python 脚本中集成 Bright Data 代理，以确保安全、可靠和匿名的数据采集。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 BeautifulSoup？

BeautifulSoup 是一个 Python 库，它简化了从 HTML 和 XML 文档中提取和整理数据的过程。结合 Bright Data 代理，它可以帮助您安全、匿名地爬取数据，并降低被检测和封锁的风险。

## 如何将 Bright Data 与 BeautifulSoup 集成

**步骤 0. 先决条件**

开始之前：

* 从 [python.org](https://www.python.org/) 下载最新的 Python 版本。

* 安装 BeautifulSoup 和 `requests` 库：

```bash
     pip install beautifulsoup4 requests
```

**步骤 1. 设置代理**

登录 Bright Data 账户，并选择要使用的代理区域。在 **概览** 下的 **访问详情** 中，您可以找到获取访问信息所需的详细信息。\*\*\*\*&#x20;

1. 登录您的 [Bright Data 账户](https://brightdata.com/cp/zones) 并获取代理凭据：

   * **主机**: [`http://brd.superproxy.io/`](http://brd.superproxy.io/)

   * **端口**: 33335

   * **用户名**: 您的 Bright Data 用户名。如果需要使用特定国家的代理，请修改用户名（例如：`your-username-country-US`）。

   * **密码**: 您的 Bright Data 代理区域密码。

2. 在您的脚本中定义代理详细信息：

```python
proxy = {
  "http": "http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]"
}
```

**步骤 2. 通过 requests 配置代理并使用 BeautifulSoup 解析数据**

以下是一个完整的示例脚本，展示如何使用 Bright Data 与 BeautifulSoup 进行安全的数据获取和解析：

```python
import requests
from bs4 import BeautifulSoup

# Bright Data 代理配置
proxy = {
    "http": "http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]",
    "https": "http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]"
}

# 目标 URL（用于验证代理）
url = "https://httpbin.org/ip" 

try:
    # 使用代理发送请求
    response = requests.get(url, proxies=proxy, timeout=10)
    response.raise_for_status()  # 处理 HTTP 错误

    # 解析 HTML 内容
    soup = BeautifulSoup(response.text, "html.parser")

    # 打印格式化的页面内容
    print("响应内容（IP 地址）：")
    print(soup.prettify())

except requests.exceptions.RequestException as e:
    print("使用代理时发生错误：", e)

```

**步骤 3. 验证输出**

如果 Bright Data 代理配置正确，您应该会在输出中看到代理的 IP 地址：

```json
{
  "origin": "123.45.67.89"
}
```

将 Bright Data 代理与 BeautifulSoup 集成，可以让您更安全、匿名和高效地爬取数据。无论是提取结构化数据、访问受地理限制的内容，还是管理大规模爬取任务，Bright Data 都能确保可靠性和隐私保护。立即使用 Bright Data 和 BeautifulSoup 开始更智能的爬取吧！


# 如何在 BitBrowser 中使用 Bright Data
Source: https://docs.brightdata.com/cn/integrations/bitbrowser

使用 Bright Data 和 BitBrowser 简化您的多账号浏览。本指南将指导您如何将 Bright Data 代理集成到 BitBrowser，以确保所有账号的安全、私密和高效浏览。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 BitBrowser？

BitBrowser 是一个多账号浏览解决方案，旨在安全高效地管理多个在线身份。每个账号都在独立的环境中运行，使您能够操作多个账户，同时降低被检测的风险。集成 Bright Data 代理可增加额外的匿名性，并确保您的工作流保持顺畅连接。

<Tip>
  通过在用户名中使用 `-session` 参数，在整个浏览会话中保持一致的 IP。这一点至关重要，因为 Bright Data 代理默认会在每次请求时更换 IP。 [了解更多](https://docs.brightdata.com/cn/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 />

  新用户应从 ISP 或数据中心代理开始，因为住宅代理不适用于 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 。<br />

  针对 **账号管理** 相关的使用场景，每个账号应使用一个稳定的静态专用 IP。应使用专用 [ISP 代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction) 进行此操作。
</Tip>

## 为什么在 BitBrowser 中使用 Bright Data？

* **增强隐私**：隐藏您的 IP 地址，确保您的在线活动匿名。
* **地理定位浏览**：使用 Bright Data 的国家/地区代理访问特定区域的内容。
* **稳定连接**：确保管理多个账号时的连接稳定性和可靠性。

## 如何在 BitBrowser 中使用 Bright Data

### **步骤 1：下载并安装 BitBrowser**

1. 访问官方 [BitBrowser 网站](https://www.bitbrowser.net/) 并下载适用于您的设备的应用程序。
2. 按照安装指南完成安装，并在安装完成后启动应用程序。
3. 使用您的凭据登录 BitBrowser 账号。

### **步骤 2：进入浏览器账号管理页面**

1. 登录后，您将进入 BitBrowser 的主界面。
2. 在菜单或仪表板中找到 **"浏览器账号"** 选项。

<Frame as="div" style={{width:"50%", height:"auto"}}>
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser1.png?maxW=202&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=7dcfe67975660a2a687b533a6d5e6510" alt="" width="202" height="324" data-path="images/integrations/bitbrowser1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser1.png?w=280&maxW=202&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=22f703b83eaee870de5e85fd62072526 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser1.png?w=560&maxW=202&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=35c3b610a3e69b317483c90befffcd8d 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser1.png?w=840&maxW=202&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f55affdb22903bcc5c9769cd26f68d4c 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser1.png?w=1100&maxW=202&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=1b568b78c4fe42063520e9ad57a6cd24 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser1.png?w=1650&maxW=202&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8418b7ca8fe005f22a62d82ca14d9a1e 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser1.png?w=2500&maxW=202&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=935e515d99c679b2d89e253ff80c0386 2500w" data-optimize="true" data-opv="2" />
</Frame>

### **步骤 3：创建新的浏览器账号**

1. 点击 **“+ 添加”** 按钮以创建新的浏览器账号。
2. 在账号设置窗口中，为该账号命名，以便后续识别。

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser2.png?maxW=1263&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=0b3ed88527c088fdea83a8a213a921ad" alt="" width="1263" height="324" data-path="images/integrations/bitbrowser2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser2.png?w=280&maxW=1263&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=494d91add63529adc3be8e139236d45a 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser2.png?w=560&maxW=1263&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=eb1cd7dffe7330dc6c26abb1b74fccf0 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser2.png?w=840&maxW=1263&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a09f926ef605b43c0bc04361470bb85b 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser2.png?w=1100&maxW=1263&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=0999999528bc1104bbb8850e5ef6eba0 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser2.png?w=1650&maxW=1263&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=7bf79df109beb513e970213d08fefcfb 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser2.png?w=2500&maxW=1263&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=85b7a2d473e07a8ac7f448e8d4b83fc1 2500w" data-optimize="true" data-opv="2" />
</Frame>

### **步骤 4：输入 Bright Data 代理信息**

登录您的 Bright Data 账号，并选择您要使用的代理区域。在 **概览** 页面下的 **访问详情** 中，您可以找到所需的代理信息。

1. 在账号配置页面向下滚动至 **"代理"** 部分。

2. 按以下方式输入您的 Bright Data 代理信息：

   * **类型**：根据 Bright Data 代理类型选择协议（`HTTP`、`HTTPS` 或 `SOCKS5`）。
   * **主机**：输入 [`http://brd.superproxy.io/`](http://brd.superproxy.io/) 作为服务器地址。
   * **端口**：33335
   * **用户名**：输入您的 Bright Data 代理用户名。对于特定区域的代理，请调整用户名格式（例如 `your-username-country-US`）。
   * **密码**：输入您的 Bright Data 代理密码。

3. 仔细检查所有输入信息，确保准确无误。

### **步骤 5：测试并保存代理设置**

1. 点击 **"检查代理"** 按钮以验证连接是否成功。
2. 如果测试成功，点击 **"确认"** 以保存账号设置。

### **步骤 6：启动账号并验证设置**

1. 在 **浏览器账号** 仪表板中，找到您刚刚创建的账号并点击 **"打开"**。
2. 浏览器启动后，访问 [httpbin.org/ip](http://httpbin.org/ip) 以确认显示的 IP 是否与您的 Bright Data 代理 IP 匹配。
3. 如果 IP 匹配，说明代理已成功集成，您的账号可以进行安全私密的浏览。

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser3.png?maxW=1259&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=112a1219819874b5fe4eb440955d75fc" alt="" width="1259" height="324" data-path="images/integrations/bitbrowser3.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser3.png?w=280&maxW=1259&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=4d57456c65cd2f47185666a0cc86c42b 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser3.png?w=560&maxW=1259&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=461a218279fb653f3d29f7039a8fab7f 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser3.png?w=840&maxW=1259&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=37b4b4fb656936f39729ef922d82b5f8 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser3.png?w=1100&maxW=1259&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=5f49f1a2cd700ae93cec958b4f040516 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser3.png?w=1650&maxW=1259&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=155574f41f30b1e5d597e3318f88fdc7 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser3.png?w=2500&maxW=1259&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e920dde2b117cad4305fdd5f09b7877a 2500w" data-optimize="true" data-opv="2" />
</Frame>

通过将 **Bright Data** 代理集成到 **BitBrowser**，您可以安全高效地管理多个在线身份。无论是管理社交媒体账号、电商运营还是研究任务，Bright Data 都能确保稳定、私密且具备地理灵活性的浏览体验。在 BitBrowser 上享受流畅的工作流和更高的匿名性吧！


# 如何使用 Bright Data 与 BrowserScan
Source: https://docs.brightdata.com/cn/integrations/browserscan

保护您的数字足迹！通过将 Bright Data 与 BrowserScan 结合，您可以测试浏览器的匿名性、验证代理配置，并确保您的在线活动保持私密。本指南将向您展示如何使用 Bright Data 代理设置浏览器并有效使用 BrowserScan。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 BrowserScan？

**BrowserScan** 是一个浏览器分析工具，旨在评估您的数字指纹并检测隐私风险。它会检查您的 IP 地址、时区、屏幕分辨率、已安装扩展等信息，帮助您降低在线可见性。

结合 **Bright Data** 后，BrowserScan 可帮助您测试和验证代理设置，确保您的浏览安全、私密，并符合您的需求。

<Tip>
  在浏览会话期间保持一致的 IP，请在用户名中使用 `-session` 参数。这很重要，因为 Bright Data 代理默认会在每个请求时更换 IP。[了解更多](https://docs.brightdata.com/cn/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 />

  新用户应从 ISP 或数据中心代理开始，因为住宅代理在 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 下无法与浏览器集成。<br />

  如果您的用例涉及 **账户管理**，请为您管理的每个账户使用一致的静态专用 IP，应使用专用的 [ISP 代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction)。
</Tip>

## 为什么要将 Bright Data 与 BrowserScan 结合？

使用 Bright Data 和 BrowserScan 具有以下优势：

* **更强的匿名性**：使用 Bright Data 隐藏您的真实 IP，减少被跟踪的可能性。

* **区域特定测试**：使用地理定位代理模拟特定国家/地区的浏览环境。

* **配置验证**：验证您的代理设置，确保其按预期运行。

## 如何使用 BrowserScan 进行 Bright Data 配置测试&#x20;

**步骤 1. 在浏览器中设置 Bright Data 代理**&#x20;

首先，配置您的浏览器以使用 Bright Data。请按照以下详细的设置指南：

* [Chrome 集成指南](https://docs.brightdata.com/cn/integrations/chrome)

* [Firefox 集成指南](https://docs.brightdata.com/cn/integrations/firefox)

如果您使用的是其他浏览器，请根据您的浏览器代理设置调整配置步骤。

**步骤 2. 在 BrowserScan 上验证您的代理**

浏览器配置完成后：

1. 在已配置的浏览器中打开 [BrowserScan](https://www.browserscan.net/)。
2. 允许网站分析您的浏览器设置和指纹信息。
3. 查看 IP 地址和位置信息，确认 Bright Data 代理是否正常工作。

将 **Bright Data** 与 **BrowserScan** 结合，您可以进行隐私测试、模拟特定地区的浏览，并安全地分析浏览器配置。无论是管理浏览器指纹，还是测试匿名性方案，Bright Data 都能提供可靠、安全的操作。立即开始优化您的工作流程，体验 Bright Data 与 BrowserScan 带来的便捷吧！


# 如何设置 Bright Data 与 Capsolver
Source: https://docs.brightdata.com/cn/integrations/capsolver

将 Bright Data 与 Capsolver 集成，以增强您的 CAPTCHA 解决流程。按照本指南安全配置代理，实现高效且不中断的自动化。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 Capsolver？

Capsolver 是一款 CAPTCHA 解决服务，旨在自动化绕过 CAPTCHA 挑战的过程。通过集成 Bright Data，您可以安全地解决 CAPTCHA，保持匿名，并轻松访问特定地区的内容。

## 为什么要将 Bright Data 与 Capsolver 结合？

* **匿名性**：在解决 CAPTCHA 任务时保护您的 IP 地址。

* **地理定位**：使用国家/地区特定代理访问本地 CAPTCHA 解决方案。

* **可靠连接**：确保不中断的服务，实现流畅的工作流程。

## 如何将 Bright Data 与 Capsolver 集成

**步骤 1. 登录 Capsolver**

* 访问 [Capsolver 官网](https://www.capsolver.com/)，并登录您的账户。

**步骤 2. 打开代理配置**

1\. 打开 **Capsolver 扩展**，进入 **设置** 页面。

2\. 找到 **代理** 选项，并将其切换为 *开启* 以启用代理设置。

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/capsolver1.png?maxW=460&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=46babca6bdb5357f3c6590ad6ee47043" alt="" width="460" height="643" data-path="images/integrations/capsolver1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/capsolver1.png?w=280&maxW=460&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=185235b9f3defc8db0704b38ae8a9504 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/capsolver1.png?w=560&maxW=460&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d13ee89a82f36554ce1244a0aa132825 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/capsolver1.png?w=840&maxW=460&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=580ad44a8f1cd838e24e0107ffd96820 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/capsolver1.png?w=1100&maxW=460&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=761f0465505436ac86ef4ccc5c2470dd 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/capsolver1.png?w=1650&maxW=460&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9ad419aa8ac9e648d69167b38b0e0478 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/capsolver1.png?w=2500&maxW=460&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=0437468b76f929867d59ba21a337787b 2500w" data-optimize="true" data-opv="2" />
</Frame>

**步骤 3. 添加您的 Bright Data 代理信息**

在代理配置页面，输入您的 Bright Data 账号信息：

* **Host**: [`http://brd.superproxy.io/`](http://brd.superproxy.io/)

* **Port**: 33335

* **用户名**：输入您的 Bright Data 用户名。

* **密码**：输入您的 Bright Data 密码。

<Note>
  若需使用特定国家/地区的代理，请将用户名格式设置为 `your-username-country-XX`（例如 `your-username-country-US`）以选择特定位置。
</Note>

将 Bright Data 与 Capsolver 集成，可实现安全高效的 CAPTCHA 解决流程。无论是批量处理 CAPTCHA，还是应对地理限制任务，Bright Data 都能确保无缝体验。立即完成设置，享受隐私保护和可靠性！


# 如何设置 Bright Data 与 ChangeDetection
Source: https://docs.brightdata.com/cn/integrations/changedetection

使用 ChangeDetection 和 Bright Data 安全、匿名地监控网站。通过集成 Bright Data，您可以跟踪网站更新，同时确保您的活动保持私密且不可检测。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 ChangeDetection？

**ChangeDetection** 是一款强大的网站更新监测工具，允许您跟踪内容变化、接收通知，并实时分析更新情况。无论是监控竞争对手、价格变动，还是产品可用性，ChangeDetection 都能确保您时刻掌握最新信息。通过集成 **Bright Data**，您可以增强隐私保护，绕过访问限制，并高效管理多个监测任务。

<Tip>
  在浏览会话期间保持一致的 IP，请在用户名中使用 `-session` 参数。这一点非常重要，因为 Bright Data 代理默认会在每个请求后轮换 IP。[了解更多](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 />

  新用户建议从 ISP 或数据中心代理开始，因为住宅代理与 [即时访问模式](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) 不兼容。<br />

  如果用于 **账户管理**，请为每个账户使用专属静态 IP，[ISP 代理](https://docs.brightdata.com/proxy-networks/isp/introduction) 是最合适的选择。
</Tip>

### 如何将 Bright Data 与 ChangeDetection 集成

**步骤 1. 安装并启动 ChangeDetection**

1\. 访问 [ChangeDetection 官网](https://changedetection.io/)，下载适用于您的操作系统的应用程序。

2\. 安装 ChangeDetection 并启动应用程序。

3\. 登录您的账户，进入仪表板。

**步骤 2. 配置代理设置**

1\. 在 ChangeDetection 仪表板中，打开 **设置** 菜单。

2\. 进入 **网络设置** 或 **代理设置** 部分。

**步骤 3. 输入您的 Bright Data 代理信息**

1. 在代理配置字段中输入您的 Bright Data 代理信息：

   * **协议**：根据您的代理类型选择 HTTP、HTTPS 或 SOCKS5。

   * **主机**：输入 [`http://brd.superproxy.io/`](http://brd.superproxy.io/)

   * **端口**：使用您的 [Bright Data 控制面板](https://brightdata.com/cp/zones) 提供的端口号。

   * **用户名**：输入您的 Bright Data 用户名。

   * **密码**：输入您的 Bright Data 密码。

<Note>
  **如果需要地理定位代理，请在用户名中包含国家代码（例如 `your-username-country-US` 代表美国代理）。**
</Note>

**步骤 4. 验证代理连接**

1. 测试代理连接以确保其正常工作：

   * 在相同的设置菜单中，查找 **测试代理** 或 **验证代理** 按钮。

   * 运行测试，确认代理配置是否正确。

2. 保存设置以应用代理配置。

**步骤 5. 使用 Bright Data 监控网站**

1. 返回 ChangeDetection 仪表板，开始添加要监控的网站。

2. 根据需求配置个性化任务，并确保它们使用代理设置以提高隐私性和效率。

通过在 **ChangeDetection** 中集成 **Bright Data**，您可以安全监控网站、绕过地理访问限制，并轻松管理多个监测任务。立即设置，享受无缝追踪和隐私保护的优势！


# 如何在 Chrome 中配置代理设置
Source: https://docs.brightdata.com/cn/integrations/chrome

使用 Chrome 代理优化您的浏览体验！代理可以保护您的隐私、访问受限网站，并管理多个账户。在本指南中，我们将引导您完成设置，帮助您充分利用 Chrome 代理。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

<Tip>
  在浏览会话期间保持一致的 IP，请在用户名中使用 `-session` 参数。这一点非常重要，因为 Bright Data 代理默认会在每个请求后轮换 IP。[了解更多](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 />

  新用户建议从 ISP 或数据中心代理开始，因为住宅代理与 [即时访问模式](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) 不兼容。<br />

  如果用于 **账户管理**，请为每个账户使用专属静态 IP，[ISP 代理](https://docs.brightdata.com/proxy-networks/isp/introduction) 是最合适的选择。
</Tip>

## 在 Chrome 中更改代理设置

准备好在 Chrome 中使用代理了吗？只需按照以下步骤操作，轻松完成设置：

### 步骤 1. **访问 Chrome 设置**

打开 Chrome，点击右上角的 **三点菜单**，然后从下拉菜单中选择 **设置**。

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome1.png?maxW=336&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e4d064e5ec0281faeea7683fc4133253" alt="" width="336" height="801" data-path="images/integrations/chrome1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome1.png?w=280&maxW=336&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=378890d0d4a2cb8fee0bd0958a8940a8 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome1.png?w=560&maxW=336&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=93f5ec7013ebf00b5b7cdd16b2e7c20b 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome1.png?w=840&maxW=336&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ebfb0c1eae66c0762ef52997835c2a7f 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome1.png?w=1100&maxW=336&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e613a61bed0fb11ec5206f136fd47fad 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome1.png?w=1650&maxW=336&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=2438bdc31ffea93e1df76ad193c92b7d 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome1.png?w=2500&maxW=336&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=b5d8b284a54e4124d4452c4cccac72a5 2500w" data-optimize="true" data-opv="2" />
</Frame>

### 步骤 2. **打开系统代理设置**

进入 **系统** 部分，选择 **打开您的计算机代理设置** 以继续。

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome2.png?maxW=1276&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=0c4992274e92d404332b8b96bb4f96ef" alt="" width="1276" height="724" data-path="images/integrations/chrome2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome2.png?w=280&maxW=1276&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8792b3601745b9e60f927c3bc49bfac8 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome2.png?w=560&maxW=1276&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=328c3323ac9a286b1317cf05a8e5870b 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome2.png?w=840&maxW=1276&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d6c9702a9d6488e2519a07d9f2fbabbe 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome2.png?w=1100&maxW=1276&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=13d4a606ff60a377f7b9c27938d32908 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome2.png?w=1650&maxW=1276&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=51c1c8f5cfa26922a72aca2b74522a5e 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome2.png?w=2500&maxW=1276&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=78eb3ce4d361b7275f1c8b17817dca08 2500w" data-optimize="true" data-opv="2" />
</Frame>

### 步骤 3. **在您的操作系统中配置代理**

由于 Chrome 使用操作系统的代理设置，您将被重定向到系统的代理配置界面。请根据您的操作系统进行相应设置：

* **在 Windows 上**：启用“使用代理服务器”，然后输入您在 [Bright Data 控制面板](https://brightdata.com/cp/zones) 中获取的代理地址和端口。
* **在 macOS 上**：选择适当的协议（如 HTTP 或 SOCKS5），然后输入代理地址、端口和凭据。操作简单快捷！

设置完成！现在，您的 Chrome 浏览器已成功配置 **Bright Data** 代理。无论是管理账户、全球购物，还是匿名浏览，您都可以享受安全流畅的体验。


# 如何将 Bright Data 集成到 ClonBrowser
Source: https://docs.brightdata.com/cn/integrations/clonbrowser

使用 Bright Data 在 ClonBrowser 上保护您的浏览和自动化工作流。本指南将引导您完成设置过程，确保您的浏览既私密又流畅。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 ClonBrowser？

**ClonBrowser** 是一款专为隐私保护用户、营销人员和自动化专家设计的多账户浏览器。它允许您管理多个浏览器配置文件，同时保持匿名，非常适合用于广告投放、数据抓取等在线任务。

<Tip>
  在浏览会话期间保持一致的 IP，请在用户名中使用 `-session` 参数。这一点非常重要，因为 Bright Data 代理默认会在每个请求后轮换 IP。[了解更多](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 />

  新用户建议从 ISP 或数据中心代理开始，因为住宅代理与 [即时访问模式](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) 不兼容。<br />

  如果用于 **账户管理**，请为每个账户使用专属静态 IP，[ISP 代理](https://docs.brightdata.com/proxy-networks/isp/introduction) 是最合适的选择。
</Tip>

## 如何将 Bright Data 集成到 ClonBrowser

### **步骤 1. 下载并安装 ClonBrowser**

1. 访问 [ClonBrowser 官网](https://www.clonbrowser.com/)，根据您的操作系统下载应用程序。
2. 安装应用程序，并使用您的账户凭据登录。

### **步骤 2. 设置新的浏览器配置文件**

1. 进入 **代理** 选项卡，找到配置文件管理部分。
2. 点击 **新建** 来创建新的浏览器配置文件。

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser1.png?maxW=913&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=dcdc16a54ae5220899242bb46e88b48e" alt="" width="913" height="276" data-path="images/integrations/clonbrowser1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser1.png?w=280&maxW=913&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=116a6bd7432791eb3963d35c788bbbbf 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser1.png?w=560&maxW=913&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d32308f20b4f627badc2bbe25d8e4d04 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser1.png?w=840&maxW=913&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=0fcbf20cd5033fc12f8f9cc87534e343 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser1.png?w=1100&maxW=913&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=dcd90f08e9268f79ca63530f827d9682 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser1.png?w=1650&maxW=913&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=14fa400a721d098e7e9ff983ae25f4ff 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser1.png?w=2500&maxW=913&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=904adc8b09ec4152998db4a86f713eec 2500w" data-optimize="true" data-opv="2" />
</Frame>

### **步骤 3. 配置代理详情**

1. 访问您的 [Bright Data 控制面板](https://brightdata.com/cp/zones)
2. 创建一个 `:` 分隔的代理字符串，格式如下：`Proxy Host:Proxy Port:Proxy Zone username:Proxy Zone password`
3. 将该代理字符串粘贴到 ClonBrowser 指定的代理字段中。
4. 点击 **解析**（Parse），自动填充必填字段（主机、端口、用户名、密码）。
5. 点击 **连接测试**（Connect Test）以确保代理连接正常。
6. 连接成功后，点击 **保存**（Save）以应用代理设置。

<Note>
  如果使用地理定向代理，请在用户名中包含国家代码（例如：`your-username-country-US`），以便访问指定地区的代理。
</Note>

### **步骤 4. 完成设置并开始浏览**

1. 返回 **代理** 选项卡，找到您刚刚配置的代理配置文件。
2. 点击 **Ping** 以确保代理正常运行。

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser2.png?maxW=1892&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a74288d7814e5e1e70023ee3ab36fec0" alt="" width="1892" height="222" data-path="images/integrations/clonbrowser2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser2.png?w=280&maxW=1892&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=138dedc739579aa2d58b50e370857019 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser2.png?w=560&maxW=1892&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=90640b0c6e6ad524bf6bc301920a67cb 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser2.png?w=840&maxW=1892&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=896c5994e8b397ce57c5fb9d982ce37d 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser2.png?w=1100&maxW=1892&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=62d1b4fbf812b59d14f9b3ea9f7ed9ff 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser2.png?w=1650&maxW=1892&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=3cdcd35b52a2a1546bfafda13c281c7d 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser2.png?w=2500&maxW=1892&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=369a41b577f06dc9a4993bc47699eb46 2500w" data-optimize="true" data-opv="2" />
</Frame>

按照上述步骤，您可以轻松地将 Bright Data 与 ClonBrowser 集成，确保安全、高效的浏览体验，满足您的各种需求。


# 如何在 Dolphin Anty 中设置 Bright Data
Source: https://docs.brightdata.com/cn/integrations/dolphin-anty

使用 Dolphin Anty 和 Bright Data 代理增强您的网络爬取和多账户管理。享受安全、高效的数据提取和强大的反检测功能。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 Dolphin Anty？

Dolphin Anty 是一款易于使用的反检测浏览器，专为需要管理多个账户而不被标记的营销人员、社交媒体管理者和电商专业人士打造。它为每个配置文件创建独特的数字指纹（如 IP 地址和设备类型），使平台无法将多个账户关联到同一用户。借助 Dolphin Anty，您可以安全地运行社交媒体广告活动、管理联盟营销以及处理电商任务，而无需担心账户被封。

<Tip>
  通过在用户名中使用 `-session` 参数，在整个浏览器会话中保持一致的 IP。这一点至关重要，因为 Bright Data 代理默认在每次请求时轮换 IP。[了解更多](https://docs.brightdata.com/cn/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 />

  新用户应从 ISP 或数据中心代理入手，因为住宅代理在 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 下不兼容浏览器集成。<br />

  对于 **账户管理** 相关的使用场景，请为每个管理的账户使用一个稳定的专用静态 IP，推荐使用专用 [ISP 代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction)。
</Tip>

## Dolphin Anty 代理集成

以下是快速入门指南：

### 第 1 步. **下载 Dolphin Anty**

访问 [Dolphin Anty 官网](https://dolphin-anty.com/) 下载并安装软件。

### 第 2 步. **创建并登录您的账户**

安装完成后，打开 Dolphin Anty，创建账户并登录。

### 第 3 步. **创建新配置文件**

点击 **+ 创建配置文件** 以开始设置新的浏览环境。

### 第 4 步. **添加新代理**

向下滚动至 **新代理** 部分，开始配置 Bright Data 代理。

### 第 5 步. **配置 Bright Data 代理**

按照以下格式输入您的代理信息：`type://host:port:username:password`

* **Type（类型）**：选择 `HTTP` 或 `SOCKS5`（根据您的代理类型）。
* **Host（主机）**：输入 [`http://brd.superproxy.io/`.](http://brd.superproxy.io/.)
* **Port（端口）**：使用 [Bright Data 控制面板](https://brightdata.com/cp/zones) 中提供的端口号。
* **Username（用户名）**：输入您的 Bright Data 代理 `用户名`。
* **Password（密码）**：输入您的 Bright Data 代理 `密码`。

点击 **⮂ 测试连接** 按钮验证连接是否成功。

<Info>
  **如果需要特定国家的代理，可以输入类似 `your-username-country-US` 的格式，以获取美国出口节点。**
</Info>

### 第 6 步. **保存设置**

一切设置完成后，点击 **+ 创建** 以保存您的配置文件。

***

完成！您已成功将 Bright Data 代理集成到 Dolphin Anty 中。


# 如何在 Easync 中设置 Bright Data
Source: https://docs.brightdata.com/cn/integrations/easync

在 Easync 上使用 Bright Data 提高自动化工作流程的效率。按照本指南配置 Bright Data，实现无缝且安全的操作。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 Easync？

**Easync** 是一款专为电商业务设计的自动化工具。它可以帮助用户优化订单履行、库存更新和跨平台价格追踪。通过集成 **Bright Data**，您可以增强 Easync 的功能，保持匿名访问、获取特定地区的数据，并降低 IP 封禁风险。

## 如何将 Bright Data 集成到 Easync

### **步骤 1. 登录 Easync**

要在 Easync 中启用 Bright Data，首先需要在您的操作系统上进行相应配置。请根据您的操作系统选择以下指南：

* [如何在 Windows 上设置 Bright Data](https://docs.brightdata.com/cn/integrations/windows)
* [如何在 macOS 上设置 Bright Data](https://docs.brightdata.com/cn/integrations/macos)

完成后，您的系统将准备好通过 Bright Data 进行流量路由。

### **步骤 2. 打开代理配置**

1\. 访问 [Easync 官网](https://easync.io/) 并登录您的账户。\
2\. Easync 会自动检测并使用您在操作系统上配置的代理设置。\
3\. 通过在 Easync 中执行简单操作来测试集成，例如：

* 获取产品详情
* 进行测试订单

这可以确保您的任务通过 Bright Data 安全路由。

### **步骤 3. 验证并监控设置**

1\. 打开浏览器或使用 [httpbin.org/ip](http://httpbin.org/ip) 服务，验证您的代理 IP 是否处于活动状态。\
2\. 在 Easync 中监控性能，确保代理在任务运行时正常工作。

通过在 Easync 集成 Bright Data，您可以自信地自动化任务，确保安全高效的操作。无论是处理订单还是分析数据，您的连接都将受到保护，并针对性能进行优化。


# 如何在 Firefox 中配置代理设置
Source: https://docs.brightdata.com/cn/integrations/firefox

掌控您的在线体验！在 Firefox 中设置代理可为您的浏览提供安全防护——无论是增强隐私、绕过限制，还是轻松管理多个账户，它都能助您一臂之力。按照本指南设置代理，释放 Firefox 的全部潜力。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

<Tip>
  通过在用户名中使用 `-session` 参数，确保整个浏览会话使用一致的 IP。这一点至关重要，因为 Bright Data 代理默认会在每次请求时更换 IP。[了解更多](https://docs.brightdata.com/cn/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 />

  新用户应优先选择 ISP 或数据中心代理，因为住宅代理在 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 下无法与浏览器集成。<br />

  如果您的用例涉及 **账户管理**，请为每个账户使用一致的静态专用 IP。应使用专用 [ISP 代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction) 来实现这一点。
</Tip>

## 在 Firefox 中更改代理设置

掌控您的 Firefox 浏览体验！设置代理很简单——按照以下步骤轻松完成配置：

<Steps>
  <Step title="访问 Firefox 设置">
    启动 Firefox 并点击位于右上角的 **菜单图标**（三条横线）。\
    在下拉菜单中选择 **设置**，进入浏览器的配置菜单。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox1.png?maxW=414&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=26976e24585c72939bbf91d7ea1133a5" alt="" width="414" height="954" data-path="images/integrations/firefox1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox1.png?w=280&maxW=414&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=4192fd43881bc4590318a69540393760 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox1.png?w=560&maxW=414&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=96e29a98d3d000392812d22ff6517047 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox1.png?w=840&maxW=414&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c4ab4e5d2e2d1d7bfc3be442e83b9093 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox1.png?w=1100&maxW=414&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=1fb7023fbf49075ebe9c9613c1dfbc00 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox1.png?w=1650&maxW=414&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=377dd701b9d9a1d9a53da38351f012ea 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox1.png?w=2500&maxW=414&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=047db2e2df13603355a805862f3872fa 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="进入网络设置">
    在设置菜单中向下滚动，找到 **网络设置** 部分。\
    点击 **设置**，打开代理配置窗口。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox2.png?maxW=1571&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ab5318ca9efa623f9a3e290f391d519c" alt="" width="1571" height="867" data-path="images/integrations/firefox2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox2.png?w=280&maxW=1571&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e65ecd9373726bbe210c86f604fc0f66 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox2.png?w=560&maxW=1571&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=3f7a99dce9ad0c0195d721dab8e6e3e7 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox2.png?w=840&maxW=1571&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=3c63b00f2158a58b1114d298784cf8d1 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox2.png?w=1100&maxW=1571&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=72e2a77a60830eadc45e50f27c8f77a1 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox2.png?w=1650&maxW=1571&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f68eccf83287a353b1da1d969a8ebaba 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox2.png?w=2500&maxW=1571&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=70ae4e7bc99541de6845c5d0203fe1eb 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="设置代理配置">
    在代理设置窗口中，按照以下步骤操作：

    1. 选择 **手动代理配置**，启用自定义代理设置。
    2. 输入必要的信息：

    * **HTTP 代理**：输入 `http://brd.superproxy.io/`。
    * **端口**：输入您的 [Bright Data 控制面板](https://brightdata.com/cp/zones) 中显示的端口号。

    3. （可选）启用 **对所有协议使用相同的代理服务器**，以应用相同的代理设置。
    4. 如果使用 SOCKS 代理，选择 **SOCKS v5** 并填写相应的服务器信息。
  </Step>

  <Step title="进行身份验证">
    当您访问某些网站时，Firefox 可能会要求您输入身份验证信息。\
    请输入您的 Bright Data 账户 **用户名** 和 **密码** 进行验证。
  </Step>
</Steps>

就是这么简单！您的 Firefox 浏览器现已成功配置 **Bright Data** 代理，让您的浏览体验更加安全、私密。无论是管理账户、执行重要任务，还是畅游无阻的互联网，您都已准备就绪，享受更快速、安全、可靠的在线旅程。


# 如何使用 FoxyProxy 设置 Bright Data
Source: https://docs.brightdata.com/cn/integrations/foxyproxy

使用 FoxyProxy 轻松提升您的浏览体验！通过集成 Bright Data，您可以安全地管理和切换代理服务器，以实现流畅高效的网页抓取、安全浏览和应用测试。请按照本指南设置 Bright Data 与 FoxyProxy，以优化您的在线操作。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 FoxyProxy？

**FoxyProxy** 是一款适用于 Chrome 和 Firefox 的多功能浏览器扩展，旨在简化代理管理。只需点击几下，您就可以在多个代理服务器之间切换，并利用浏览器的内置代理 API。无论您是进行数据抓取、测试应用程序，还是增强在线隐私，FoxyProxy 都能提供直观高效的代理管理解决方案。

## 如何将 Bright Data 集成到 FoxyProxy

<Steps>
  <Step title="安装 FoxyProxy 扩展程序">
    1. **对于 Chrome**：访问 [Chrome 网上应用店](https://chromewebstore.google.com/detail/foxyproxy/gcknhkkoolaabfmlnjonogaaifnjlfnp)，然后点击 **添加至 Chrome**。
    2. **对于 Firefox**：前往 [Mozilla 附加组件页面](https://addons.mozilla.org/en-US/firefox/addon/foxyproxy-standard/)，然后点击 **添加至 Firefox**。

    安装完成后，您将在浏览器工具栏中看到 FoxyProxy 图标。
  </Step>

  <Step title="打开 FoxyProxy 设置">
    1. 点击工具栏中的 FoxyProxy 图标，并从下拉菜单中选择 **选项**。
    2. 这将打开 FoxyProxy 设置页面，您可以在其中管理代理配置。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy1.png?maxW=317&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=dfcce6a0df97e27236c11a5ecdabf062" alt="" width="317" height="402" data-path="images/integrations/foxyproxy1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy1.png?w=280&maxW=317&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=280cc0bcfd12f960edf5f1a821422732 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy1.png?w=560&maxW=317&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=93f28e373dad9ffa406b3cd3f0ee1e4b 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy1.png?w=840&maxW=317&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9fd3f14756f2e0283a5ca2d01cbe8bdd 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy1.png?w=1100&maxW=317&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=1ac2e09e441c359fa46731f5eeadeb9a 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy1.png?w=1650&maxW=317&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=6109e87c5377620574f2c786ea005e68 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy1.png?w=2500&maxW=317&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=88ce4a85a661fa5bb78fe2da0a8a900b 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="添加新的代理配置">
    1. 在 FoxyProxy 设置菜单中，进入 **代理** 选项卡。
    2. 点击 **添加** 按钮，打开代理配置窗口。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy2.png?maxW=1243&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=dd30eacea344c27deec2be417f01c8bb" alt="" width="1243" height="218" data-path="images/integrations/foxyproxy2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy2.png?w=280&maxW=1243&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=404b7dd7698082b7955989650dd8933c 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy2.png?w=560&maxW=1243&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=327aa9170982b35641b2fd3fd5752e7f 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy2.png?w=840&maxW=1243&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=fbf378f794d9d294f1df7d5aee11c507 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy2.png?w=1100&maxW=1243&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=fdca569d91f7d8f8625bb0e1a90ce4a9 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy2.png?w=1650&maxW=1243&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d79abd8c77095436ba62dc98656a8e28 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy2.png?w=2500&maxW=1243&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9e9681ac142d5eb2ad969e5ed3db1043 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="输入 Bright Data 代理详细信息">
    1. 在代理设置表单中，输入您的 Bright Data 账户信息：
       * **类型**：根据您的代理类型选择 `HTTP`、`HTTPS` 或 `SOCKS5`。
       * **主机名**：输入 `http://brd.superproxy.io/`。
       * **端口**：使用您的 [Bright Data 仪表板](https://brightdata.com/cp/zones/page/plans) 提供的端口号。
       * **用户名**：输入您的 Bright Data 用户名。
       * **密码**：输入您的 Bright Data 密码。

    2. 输入所有详细信息后，点击 **保存** 以存储代理配置。

    <Note>
      如果要使用特定国家的代理，请在用户名后添加国家代码（例如，`your-username-country-US` 表示使用美国代理）。
    </Note>
  </Step>

  <Step title="激活并测试您的代理">
    1. 要启用已配置的代理，请点击工具栏中的 FoxyProxy 图标，并选择您刚刚创建的代理。
    2. 访问 [httpbin.org/ip](http://httpbin.org/ip) 以验证连接。显示的 IP 地址应与您的 Bright Data 代理匹配。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy3.png?maxW=314&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=740220c85ff6cf69281e002d5f7a8c86" alt="" width="314" height="405" data-path="images/integrations/foxyproxy3.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy3.png?w=280&maxW=314&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=929eaddf4928c34e03e591802e054007 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy3.png?w=560&maxW=314&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c715100fb62aa1ec5e7e60ffbbbe2999 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy3.png?w=840&maxW=314&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=af011b198e6e8318428c19f5f71558bf 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy3.png?w=1100&maxW=314&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f56e8e408aad33bd2577c5168fa8d503 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy3.png?w=1650&maxW=314&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=733dff03150965bc21464edfe55cb1bf 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy3.png?w=2500&maxW=314&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=61678235b73b76d6e1348aff0b647185 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>
</Steps>

现在，您已成功配置 FoxyProxy 与 Bright Data，可以享受安全、流畅的浏览体验，并高效地进行网络操作。无论是测试应用、抓取数据，还是增强隐私保护，该设置都能让您的代理管理变得更加轻松便捷。


# 如何在 Geelark 中使用 Bright Data
Source: https://docs.brightdata.com/cn/integrations/geelark

将 Bright Data 与 Geelark 集成，以最大限度地提高您的隐私和效率。本指南将指导您配置 Bright Data 代理，以便在 Geelark 中实现安全匿名浏览。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

<Tip>
  通过在用户名中使用 `-session` 参数，在整个浏览会话中保持一致的 IP 地址。这很重要，因为 Bright Data 代理默认在每次请求时更换 IP。[了解更多](https://docs.brightdata.com/cn/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 />

  新用户应首先使用 ISP 或数据中心代理，因为住宅代理在 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 下与浏览器集成不兼容。<br />

  如果您的使用场景涉及 **账户管理**，请为每个账户使用一致的静态专用 IP。建议使用[专用 ISP 代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction)。
</Tip>

## 什么是 Geelark？

**Geelark** 是一款面向隐私保护用户和专业人士的多功能浏览器配置文件管理工具。它允许您创建独立的浏览环境、管理多个账户，并根据您的需求自定义浏览配置文件。通过 Bright Data，您可以将 Geelark 配置文件提升到新的水平，实现匿名访问、绕过限制并获取特定区域的内容。

## 如何将 Bright Data 集成到 Geelark

<Steps>
  <Step title="先决条件">
    1. **Bright Data 代理凭据**：
       * 登录您的 [Bright Data 仪表板](https://brightdata.com/cp/zones) 获取 **Host**、**Port**、**Username** 和 **Password**。
       * 如果需要特定地区的代理，请使用地理位置特定的用户名（例如 `your-username-country-US`）。

    2. **安装 Geelark**：
       * 从 [geelark.com](https://geelark.com/) 下载并安装 Geelark。
       * 启动 Geelark 并使用您的账户凭据登录。
       * 如果没有账户，请点击 **Sign Up** 进行注册。
  </Step>

  <Step title="创建并配置新配置文件">
    1. 在 Geelark 仪表板上，点击 **New Profile**（新建配置文件）。
    2. 输入 **名称** 并选择该配置文件的目标操作系统。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark1.png?maxW=761&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=fe13042b382c7dc07b6c18789749a00f" alt="" width="761" height="239" data-path="images/integrations/geelark1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark1.png?w=280&maxW=761&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=82b87bbf184ae0a5156578c83d33f2f8 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark1.png?w=560&maxW=761&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a25532494bb89fb12e0ff314672b304d 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark1.png?w=840&maxW=761&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=4f16cc763c47a140f69dbe26f554dd7c 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark1.png?w=1100&maxW=761&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=2dcbe8876f74f0f8644c764350cf8861 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark1.png?w=1650&maxW=761&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=bafb9e78255dcca16faa50a2c705cd90 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark1.png?w=2500&maxW=761&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=3574bad9cf6095cad11d3fa05f3f144a 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="配置代理设置">
    1. 在 **Proxy Settings**（代理设置）部分，选择 **Custom**（自定义）。

    2. 根据您的 Bright Data 配置选择 **代理类型**（HTTP、HTTPS 或 SOCKS5）。

    3. 输入以下 Bright Data 代理信息：
       * **代理主机**：`http://brd.superproxy.io/`。
       * **端口**：使用您的 [Bright Data 仪表板](https://brightdata.com/cp/zones) 提供的端口号。
       * **用户名**：您的 Bright Data `用户名`。
       * **密码**：您的 Bright Data `密码`。

    4. 点击 **Check Proxy**（检查代理）以验证代理设置。在继续之前确保连接成功。
  </Step>

  <Step title="保存并启动配置文件">
    1. 配置代理设置后，点击 **OK** 保存配置文件。
    2. 在 Geelark 仪表板中，找到新创建的配置文件，然后点击 **Start**（启动）以运行它。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark2.png?maxW=1198&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c4f9df13be920994f0aa5a0a9dc7ee1b" alt="" width="1198" height="241" data-path="images/integrations/geelark2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark2.png?w=280&maxW=1198&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a54ead932411bd6706922186f0f0b5ab 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark2.png?w=560&maxW=1198&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=96917a94a49e871c10c310ff061abcd3 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark2.png?w=840&maxW=1198&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=77c8a2331b88c26c33809d9b16bd7d3e 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark2.png?w=1100&maxW=1198&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=80dee206f2526964cf08728272ec8a78 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark2.png?w=1650&maxW=1198&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=910006d55a3247712b9d3c804f834d08 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark2.png?w=2500&maxW=1198&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9a4b7c936c46c69592d776abbd78f3e5 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="测试您的设置">
    1. 在启动的配置文件中，打开 Web 浏览器。
    2. 访问 [httpbin.org/ip](http://httpbin.org/ip) 以验证您的 IP 地址是否反映为 Bright Data，确认设置成功。
  </Step>
</Steps>

将 Bright Data 集成到 Geelark 后，您将获得更强的隐私保护、控制能力和高效的浏览体验。无论您是管理多个浏览器配置文件、访问地理限制内容，还是确保安全连接，Bright Data 都能帮助您轻松实现目标。立即尝试，提升您的 Geelark 体验！


# 如何将 Bright Data 与 GenLogin 结合使用
Source: https://docs.brightdata.com/cn/integrations/genlogin

使用 Bright Data 和 GenLogin 安全管理多个浏览器配置文件。本指南将引导您完成集成 Bright Data 以实现匿名和高效浏览的步骤。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 GenLogin？

<Tip>
  在浏览器会话期间保持一致的 IP 地址，请在用户名中使用 `-session` 参数。这一点至关重要，因为 Bright Data 代理默认会在每次请求时更换 IP。[了解更多](https://docs.brightdata.com/cn/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 />

  新用户应从 ISP 或数据中心代理入手，因为住宅代理与 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 的浏览器集成不兼容。<br />

  针对 **账户管理** 相关的用例，每个管理的账户应使用一致的专用静态 IP。建议使用专用的 [ISP 代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction)。
</Tip>

**GenLogin** 是一款专为需要管理多个账户或项目的专业用户设计的高级浏览器配置管理工具。它可以创建隔离的浏览器环境，确保每个配置文件独立运行并保持安全。通过集成 **Bright Data**，您可以增强 GenLogin 的功能，实现可靠的匿名代理连接。

## 如何将 Bright Data 与 GenLogin 结合使用

<Steps>
  <Step title="下载并打开 GenLogin">
    1. 访问 [GenLogin 官网](https://genlogin.com/)，下载适用于您的操作系统的应用程序。
    2. 按照屏幕提示安装 GenLogin 并启动应用程序。
    3. 登录您的 GenLogin 账户。如果没有账户，请免费注册。
  </Step>

  <Step title="创建或编辑浏览器配置文件">
    1. 在 GenLogin 仪表板中，点击 **创建配置文件** 以创建新配置文件，或选择一个已有配置文件进行编辑。
    2. 在配置文件设置中，在 **名称** 字段中为您的配置文件输入一个独特且易于识别的名称。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin1.png?maxW=1319&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=49b29d553377feef4f19b35aec0600f4" alt="" width="1319" height="285" data-path="images/integrations/genlogin1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin1.png?w=280&maxW=1319&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8694e3a48f79738b387ba10824aaaff9 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin1.png?w=560&maxW=1319&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=3072aa74f4c4c2d689577f429255d0d5 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin1.png?w=840&maxW=1319&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=900af6349beb259a91e499ee5b01216f 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin1.png?w=1100&maxW=1319&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=804635ad6ff50e48f2ecc39a516293cb 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin1.png?w=1650&maxW=1319&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=62ce3c1b5dbb881f0d01851aa10587e3 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin1.png?w=2500&maxW=1319&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8296669b34c96d616c44e229367539d3 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="配置代理设置">
    1. 在配置文件设置中，滚动到 **网络** 部分。

    2. 选择 **自定义代理** 并输入 Bright Data 代理信息：
       * **代理类型**: 选择 HTTP、HTTPS 或 SOCKS5。
       * **代理主机**: 输入 `http://brd.superproxy.io/`。
       * **代理端口**: 使用您的 [Bright Data 仪表板](https://brightdata.com/cp/zones/page/plans) 提供的端口号。
       * **用户名**: 输入您的 Bright Data 用户名。
       * **密码**: 输入您的 Bright Data 密码。

    3. 点击 **检查代理** 确保连接正常。
  </Step>

  <Step title="保存并启动配置文件">
    1. 代理信息验证成功后，点击 **创建配置文件** 以保存设置。
    2. 进入 **配置文件** 部分，找到刚创建的配置文件。
    3. 点击 **启动**，使用已配置的设置打开浏览器。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin2.png?maxW=1900&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8745257ec0e2f52e2168f6626eb9eaf1" alt="" width="1900" height="307" data-path="images/integrations/genlogin2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin2.png?w=280&maxW=1900&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=4e09d04673218a3974035a22eb63a2a4 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin2.png?w=560&maxW=1900&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f3afe32c51cec5f3f30c711187c02c8a 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin2.png?w=840&maxW=1900&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d06087845cc27f9884a38073a75b5336 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin2.png?w=1100&maxW=1900&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=34eefbb26f5577fa43bf82111e0f9538 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin2.png?w=1650&maxW=1900&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ed663b439faee0b8289451344a5fc474 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin2.png?w=2500&maxW=1900&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=505b022a2ba95fe961c8614624c3a270 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="验证代理连接">
    1. 在已启动的浏览器配置文件中，打开浏览器并访问 [httpbin.org/ip](http://httpbin.org/ip)。
    2. 确保显示的 IP 地址与您的 Bright Data 代理匹配，以验证设置是否成功。
  </Step>
</Steps>

将 Bright Data 与 GenLogin 结合使用，能让您更安全、更高效地管理多个账户。Bright Data 的可靠代理结合 GenLogin 强大的浏览器配置管理功能，可以帮助您实现卓越的隐私保护和生产力优化。立即体验 Bright Data 和 GenLogin 的强大组合吧！


# 如何在 Ghost Browser 中设置 Bright Data
Source: https://docs.brightdata.com/cn/integrations/ghost-browser

使用 Bright Data 和 Ghost Browser 简化多账户管理，确保安全匿名浏览，同时提升您的工作效率。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 Ghost Browser？

<Tip>
  通过在用户名中使用 `-session` 参数，可以在整个浏览器会话期间保持一致的 IP。这一点至关重要，因为 Bright Data 代理默认在每次请求时轮换 IP。[了解更多](https://docs.brightdata.com/cn/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 />

  新用户应从 ISP 或数据中心代理入手，因为住宅代理在 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 下不兼容浏览器集成。<br />

  对于 **账户管理** 相关的用例，请为每个账户使用一致的静态专用 IP。应使用专用 [ISP 代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction) 进行此操作。
</Tip>

Ghost Browser 是一款专为需要轻松管理多个在线账户的用户设计的高效网页浏览器。它具有独特的多会话功能，允许您在不同的标签页中运行独立的浏览器会话。这意味着您可以同时登录同一平台的多个账户，而不会发生跨会话干扰。

虽然它并未专注于高级反检测功能，但 Ghost Browser 非常适合希望拥有简洁有序工作流程的用户。对于需要同时管理多个账户或项目的专业人士而言，它是一个理想的工具。

## Ghost Browser 代理集成

以下是将 Bright Data 代理集成到 Ghost Browser 的方法：

<Steps>
  <Step title="安装 Ghost Browser">
    1. 下载并安装 [**Ghost Browser**](https://ghostbrowser.com/download/)。
    2. 安装完成后，登录您的账户以访问主界面。
  </Step>

  <Step title="访问 Ghost Proxy Control">
    1. 点击浏览器右上角的 **Ghost Proxy Control** 图标。
    2. 选择 **添加/编辑代理**。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser1.png?maxW=525&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=7a6c3b1fa27990a81662b047375facfe" alt="" width="525" height="246" data-path="images/integrations/ghostbrowser1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser1.png?w=280&maxW=525&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=fe5bd9e4b21c23075cc96c2038183768 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser1.png?w=560&maxW=525&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9642c1053d876a4eb11439ee89c0978d 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser1.png?w=840&maxW=525&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=488cf52c621f832afcab89c34122ed86 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser1.png?w=1100&maxW=525&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=cc5c00ec580e67066a5872e4f6c8c01f 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser1.png?w=1650&maxW=525&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f996f393994d669bd12430b8afa9a491 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser1.png?w=2500&maxW=525&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c8ec24da9d719fd9dc11e62357566c78 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="添加新代理">
    在 **代理管理器** 中，选择 **添加单个代理** 选项。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser2.png?maxW=970&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=dcac3b9f100ee07833fde3c6a0e0464b" alt="" width="970" height="413" data-path="images/integrations/ghostbrowser2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser2.png?w=280&maxW=970&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9854d2b1e4a2f5095e586b5d36d52218 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser2.png?w=560&maxW=970&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e8f32a4f299f24e9229da434e12e9cbb 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser2.png?w=840&maxW=970&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=388450a166b2110aef8b339e14dd460f 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser2.png?w=1100&maxW=970&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=bd2885ae887a13f55c29912e724ef44e 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser2.png?w=1650&maxW=970&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d37db68bd7334fd4191402f6f8f387d0 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser2.png?w=2500&maxW=970&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d755b250861ab011fc9dfdddbb7c4aa1 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="配置您的 Bright Data 代理">
    在代理设置窗口中，填写您的 Bright Data 代理信息：

    * **名称**：可选 – 为您的代理指定一个描述性名称（例如 "Bright Data"）。
    * **主机**：输入 `http://brd.superproxy.io/`。
    * **端口**：使用 [Bright Data 仪表盘](https://brightdata.com/cp/zones) 提供的端口号。
    * **用户名**：输入您的 Bright Data 代理 `用户名`。
    * **密码**：输入您的 Bright Data 代理 `密码`。

    点击 **添加代理** 以保存您的设置。

    <Info>
      如果需要特定国家的代理，可以输入格式如 `your-username-country-US` 以获取美国出口节点。
    </Info>
  </Step>

  <Step title="在 Ghost Browser 中启用代理">
    1. 返回 **Ghost Proxy Control** 菜单。
    2. 在 **Active Identity** 和 **Active Workspace** 设置下选择您新添加的 Bright Data 代理。
    3. 重新加载您的标签页，以应用选定的代理到您的浏览会话。
  </Step>
</Steps>

**就是这样！** 您的 Bright Data 代理现已集成到 Ghost Browser 中。


# 如何在 GoLogin 中设置 Bright Data
Source: https://docs.brightdata.com/cn/integrations/gologin

通过 GoLogin 和 Bright Data 增强您的网络爬取与多账户管理，实现强大的反检测功能和灵活的代理控制。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 GoLogin？

<Tip>
  通过在用户名中使用 `-session` 参数，可以在整个浏览器会话期间保持一致的 IP。这一点至关重要，因为 Bright Data 代理默认在每次请求时轮换 IP。[了解更多](https://docs.brightdata.com/cn/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 />

  新用户应从 ISP 或数据中心代理入手，因为住宅代理在 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 下不兼容浏览器集成。<br />

  对于 **账户管理** 相关的用例，请为每个账户使用一致的静态专用 IP。应使用专用 [ISP 代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction) 进行此操作。
</Tip>

GoLogin 是一款强大的工具，专为轻松安全地管理多个账户而设计。它允许您创建独立的浏览器配置文件，每个配置文件都具有唯一的指纹、IP 和 Cookie，使其看起来像不同的独立用户。这对于营销人员、电商企业以及任何需要管理多个账户的用户而言，都是理想的解决方案。

使用 GoLogin，您可以集成代理、自动化任务，并无缝切换不同的配置文件，同时保持每个账户的匿名性。它不仅能够确保账户安全，还支持团队协作，使团队成员能够安全地共享配置文件。无论您是专注于数字营销、数据爬取，还是账户安全管理，GoLogin 都是一个出色的选择。

## GoLogin 代理集成

按照以下步骤将 Bright Data 代理集成到 GoLogin：

<Steps>
  <Step title="安装 GoLogin">
    从 [GoLogin 官网](https://gologin.com/) 下载并安装 GoLogin。
  </Step>

  <Step title="创建账户">
    登录 GoLogin，开始设置您的浏览器配置文件。
  </Step>

  <Step title="创建新配置文件">
    点击 **+添加配置文件**，输入您的新浏览器配置文件的基本信息。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin1.png?maxW=1164&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e213c3dcf3bb5b2d021e410b442c8a74" alt="" width="1164" height="126" data-path="images/integrations/gologin1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin1.png?w=280&maxW=1164&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ebef2a93e4e67bbdbab98463e68c28f4 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin1.png?w=560&maxW=1164&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=547736416946f365f360523fd4cfbc8d 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin1.png?w=840&maxW=1164&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=44ade8b10be352c95707fe6766bbcea5 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin1.png?w=1100&maxW=1164&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a5d70e7e915942b1e68d5c5dd20eddef 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin1.png?w=1650&maxW=1164&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a63596d2255d54c2a85734a58e4482da 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin1.png?w=2500&maxW=1164&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=db9059cb180eb7ca6c3f9ba851d04bfa 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="配置代理设置">
    输入您的 Bright Data 代理信息：

    * **代理类型**：选择 `HTTP`、`HTTPS` 或 `SOCKS5`（根据您的代理类型）。
    * **主机**：输入 `http://brd.superproxy.io/`。
    * **端口**：使用 [Bright Data 仪表盘](https://brightdata.com/cp/zones) 提供的端口号。
    * **用户名**：输入您的 Bright Data 代理 `用户名`。
    * **密码**：输入您的 Bright Data 代理 `密码`。

    <Info>
      **您还可以指定代理的国家/地区。例如，输入 `your-username-country-US` 可获取美国出口节点。**
    </Info>

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin2.png?maxW=687&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c49c80a133b4641a0ef22a9c4be75471" alt="" width="687" height="633" data-path="images/integrations/gologin2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin2.png?w=280&maxW=687&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=0707e891ff2490b1518cfc32d651b49e 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin2.png?w=560&maxW=687&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e45593f2d45de0643d048a329606d670 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin2.png?w=840&maxW=687&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=831afc4dc2fac360b5a4e4483b1ebce4 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin2.png?w=1100&maxW=687&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=03c5e75e6ef525a27d990ca869300bc9 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin2.png?w=1650&maxW=687&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=5e965f84aaf69f9ceff597b749afdb4e 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin2.png?w=2500&maxW=687&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ec965940644bb8bcf64baa1fd43f1aae 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="测试代理">
    点击 **检查代理** 以确保一切正常运行。
  </Step>

  <Step title="保存并启动">
    点击 **创建配置文件** 以保存您的设置，然后点击 **运行** 以打开您的新配置文件，享受安全浏览体验。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin3.png?maxW=640&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=7c9305a1bdeae2564f8862e456dab4d3" alt="" width="640" height="109" data-path="images/integrations/gologin3.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin3.png?w=280&maxW=640&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9e24757185d1c705bbac15992ab9315a 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin3.png?w=560&maxW=640&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=5086cd7463d9994ed7048925507195d1 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin3.png?w=840&maxW=640&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=4ec10c2b95cef5a60f44af52cb0c1aa4 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin3.png?w=1100&maxW=640&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=b44dc47f60443fca7bfbd7f6bf4af57f 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin3.png?w=1650&maxW=640&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c4f27c6bfcb19e65e3e9118c1e5c06a3 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin3.png?w=2500&maxW=640&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ae5b8b15f7d4515fd991afb70b9efc7e 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>
</Steps>

**就是这样！** 您现已成功将 Bright Data 代理集成到 GoLogin 中。


# 如何在 Helium Scraper 中设置 Bright Data
Source: https://docs.brightdata.com/cn/integrations/helium-scraper

将 Bright Data 与 Helium Scraper 集成，实现安全、高效和匿名的网页抓取，并灵活管理代理。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 Helium Scraper？

Helium Scraper 是一款直观的桌面网页抓取工具，可帮助您无需任何编码技能即可从网站提取数据。它的可视化界面使数据选择、提取和整理变得简单，非常适合初学者和有经验的用户。

Helium Scraper 适用于中小规模的抓取项目。无论您是自由职业者、营销人员还是商业专业人士，它都能为您提供一种高效、简单的方法来收集和组织网页数据，而无需编程的复杂性。

## Helium Scraper 代理集成

按照以下简单步骤，在 Helium Scraper 中设置 Bright Data 代理：

<Steps>
  <Step title="安装 Helium Scraper">
    1. [下载 Helium Scraper](https://www.heliumscraper.com/eng/download.php) 并安装到您的计算机上。
    2. 安装完成后，启动该工具。
  </Step>

  <Step title="访问代理列表">
    在 Helium Scraper 中，点击 **File > Proxy List** 打开代理配置面板。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper1.png?maxW=200&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a2fb6264e20bc89d80909231bad028f1" alt="" width="200" height="248" data-path="images/integrations/helium-scraper1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper1.png?w=280&maxW=200&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=4c8fcdac736164d2fc506a7dfd85e38e 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper1.png?w=560&maxW=200&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=2c2a83686e9c2bdba35ae268fbefd55d 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper1.png?w=840&maxW=200&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=2779f0da6ae9910bf999559b78c9cfed 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper1.png?w=1100&maxW=200&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=5c3de4bb2ae4359acc086258aa820d87 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper1.png?w=1650&maxW=200&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=6fbcaab8a2ec5cb273d4507985c66833 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper1.png?w=2500&maxW=200&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ff5b465dde2a35e41c6012a48e51c22b 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="配置 Bright Data 代理">
    在提供的字段中输入您的 Bright Data 代理信息：

    * **主机 (Host)**：输入 `http://brd.superproxy.io/`。
    * **端口 (Port)**：使用您的 [Bright Data 控制面板](https://brightdata.com/cp/zones) 提供的端口号。
    * **用户名 (Username)**：输入您的 Bright Data 代理用户名。
    * **密码 (Password)**：输入您的 Bright Data 代理密码。

    点击 **OK** 保存您的代理设置。

    <Info>
      **对于特定国家的代理，您可以输入类似 `your-username-country-US` 的格式，以获取美国出口节点。**
    </Info>
  </Step>

  <Step title="为您的项目启用代理">
    1. 在菜单中点击 **Project > Settings**。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper2.png?maxW=199&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=206ce4bfb680299ed536f03b4e274b24" alt="" width="199" height="104" data-path="images/integrations/helium-scraper2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper2.png?w=280&maxW=199&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=48c5098adb48197aa4bca1b7137e7e63 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper2.png?w=560&maxW=199&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=6096763690a7fbcaffa9958a812c05e4 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper2.png?w=840&maxW=199&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=052a94e8b16fdb0becb6bd823be8d58e 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper2.png?w=1100&maxW=199&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=6e79f96c682976dda59bc4a6d3ccce1a 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper2.png?w=1650&maxW=199&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=0fc2b2a4bb1ff70952990069ae1d5946 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper2.png?w=2500&maxW=199&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=31124a59d3e22793124c9db47250138a 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    2. 在设置窗口中，将 **Enable Proxies** 选项设置为 **True**。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper3.png?maxW=350&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=3bb8b9f6671d9e98d7b94da51f9cd006" alt="" width="350" height="554" data-path="images/integrations/helium-scraper3.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper3.png?w=280&maxW=350&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=94a8f4a656cf55c6386683d41d3cbc32 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper3.png?w=560&maxW=350&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=2b0b50fbe2f8ea456c4c85a02388627a 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper3.png?w=840&maxW=350&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=21efb8fcebadfc60db402de9f0765ab5 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper3.png?w=1100&maxW=350&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f94df6360378f151482b42a9e835fb43 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper3.png?w=1650&maxW=350&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ba9341ad2796d819027a488536316cc9 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper3.png?w=2500&maxW=350&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=808cbb0360404516a18b7e24ae8ba74d 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="验证代理设置">
    1. 使用 Helium Scraper 内置浏览器打开一个显示您 IP 地址的网站。
    2. 检查显示的 IP 是否与 Bright Data 代理设置匹配，以确认代理集成成功。
  </Step>
</Steps>

**就是这样！** 您已成功将 Bright Data 代理集成到 Helium Scraper 中。


# 如何将 Bright Data 与 HideMyAcc 集成
Source: https://docs.brightdata.com/cn/integrations/hidemyacc

使用 Bright Data 和 HideMyAcc 保护并优化您的浏览体验。本指南将指导您如何在 HideMyAcc 中配置 Bright Data，以实现私密、可靠和高效的账户管理。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

<Tip>
  通过在用户名中使用 `-session` 参数，可以在整个浏览会话期间保持一致的 IP 地址。这一点至关重要，因为 Bright Data 代理默认情况下会在每次请求时轮换 IP。[了解更多](https://docs.brightdata.com/cn/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 />

  新用户应优先使用 ISP 或数据中心代理，因为住宅代理在 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 下与浏览器集成不兼容。<br />

  对于**账户管理**相关的使用场景，请为每个账户使用固定的专用静态 IP。建议使用[专用 ISP 代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction)。
</Tip>

## 什么是 HideMyAcc？

**HideMyAcc** 是一款高级防检测浏览器，专为安全管理多个账户而设计。它可帮助用户绕过限制、保持匿名，并通过提供私密的浏览环境避免被检测。集成 Bright Data 可以增强 HideMyAcc 的功能，实现安全的地理定向连接。

## 如何在 HideMyAcc 中集成 Bright Data

<Steps>
  <Step title="下载并安装 HideMyAcc">
    1. 访问 [HideMyAcc 官网](https://hidemyacc.com/)，下载适用于您的操作系统的软件。
    2. 安装应用程序并使用您的账户凭据登录。
  </Step>

  <Step title="创建新配置文件">
    1. 打开 HideMyAcc，导航到 **Profiles**（配置文件）选项卡。
    2. 点击 **Create a new profile**（创建新配置文件）以设置新的浏览实例。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc1.png?maxW=1349&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a5d0e3df251cf74693d1740b002097c4" alt="" width="1349" height="535" data-path="images/integrations/hidemyacc1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc1.png?w=280&maxW=1349&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8adba7e2e9abf25baa997016274e080a 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc1.png?w=560&maxW=1349&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=2d5bde79d79b8a85b599bc2efcde60c3 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc1.png?w=840&maxW=1349&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8263c682e178e2888c3737e7a76dd878 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc1.png?w=1100&maxW=1349&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=20f451b78afeb9cd26ccdc682b72e987 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc1.png?w=1650&maxW=1349&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=cf507686d2b5e2647450e9571eb9f74e 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc1.png?w=2500&maxW=1349&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=fd3bab82d8c5807ab4e2b69157a45f95 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="启用代理配置">
    1. 在配置文件创建页面，找到 **Proxy**（代理）部分。
    2. 在配置文件设置中输入 **Profile Name**（配置文件名称），以便后续识别。
    3. 切换 **Your Proxy**（您的代理）选项以激活配置。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc2.png?maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d26b1eb7167b7a5bf6ec1f35a0abf2bc" alt="" width="1331" height="254" data-path="images/integrations/hidemyacc2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc2.png?w=280&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e5ab4e624a7a47203c6ceb1dc4ddf921 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc2.png?w=560&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d1db0609edf24322ee73dbf0d9cb2be5 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc2.png?w=840&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=287bcd5cfa6716da6048c4f9acc6a4c5 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc2.png?w=1100&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=7ed73d00f9efd143cd48b158b01cad16 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc2.png?w=1650&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e7940dd3b34f2810a52e9083d85d830b 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc2.png?w=2500&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=706a050f357e396629df9add60d83a54 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="添加 Bright Data 代理详情">
    1. 前往 [Bright Data 控制台](https://brightdata.com/cp/zones)，点击要使用的代理区域。
    2. 在 **Overview**（概览）选项卡下，复制 Bright Data 提供的代理访问详细信息，格式为：`host:port:username:password`。
    3. 将此代码粘贴到 HideMyAcc 的 **Quick add**（快速添加）字段中。
    4. 使用 **Check Proxy**（检查代理）选项验证连接是否正常。
    5. 代理配置验证成功后，点击 **Create**（创建）以保存代理设置。

    <Note>
      如果需要使用特定国家的代理，可以使用 `your-username-country-XX`（例如 `your-username-country-US`）格式的用户名，以指定目标地区。
    </Note>
  </Step>

  <Step title="启动配置文件">
    导航到 **Profiles** 选项卡，选择刚创建的配置文件，然后点击 **Run**（运行）以使用 Bright Data 进行安全浏览。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc3.png?maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=5b407cd4b5f76df00b1368d35e022186" alt="" width="1331" height="135" data-path="images/integrations/hidemyacc3.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc3.png?w=280&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=0cadb6b52888b57a45cce80f09a995eb 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc3.png?w=560&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=28ca1c95e2ba786cf9071c364de76012 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc3.png?w=840&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=785ddc9f888b2c8164f381acafb5d2a7 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc3.png?w=1100&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=00340e83b51eab6bc1570236202e4864 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc3.png?w=1650&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=aec8562e8086aa2fcfc921cef6b2c2a3 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc3.png?w=2500&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=825359e63287aa7ec891342689f8c6a5 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>
</Steps>

通过将 **Bright Data** 与 **HideMyAcc** 集成，您可以享受更高的隐私保护和无缝的账户管理体验。无论是管理多个账户，还是执行地理定向任务，此设置都能确保您的浏览体验既安全又高效。立即开始，享受私密、可靠的浏览环境！


# 如何将 Bright Data 与 Incogniton 集成
Source: https://docs.brightdata.com/cn/integrations/incogniton

将 Bright Data 集成到 Incogniton，实现无缝的多账户管理，提供安全、匿名的浏览体验，并增强防检测和防封禁能力。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

<Tip>
  通过在用户名中使用 `-session` 参数，可以在整个浏览会话期间保持一致的 IP 地址。这一点至关重要，因为 Bright Data 代理默认会在每次请求时轮换 IP。[了解更多](https://docs.brightdata.com/cn/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 />

  新用户应优先使用 ISP 或数据中心代理，因为住宅代理在 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 下与浏览器集成不兼容。<br />

  对于**账户管理**相关的使用场景，请为每个账户使用固定的专用静态 IP，建议使用[专用 ISP 代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction)。
</Tip>

## 什么是 Incogniton？

**Incogniton** 是一款专注于隐私保护的浏览器，旨在确保用户在浏览网络时保持匿名。它允许创建和管理多个配置文件，每个配置文件都有独立的 Cookie、本地存储、IP 地址（通过代理）以及其他浏览数据。这意味着您可以放心地上网，而无需担心活动被追踪或个人信息泄露。

Incogniton 适用于隐私保护用户、营销人员以及需要管理多个社交媒体或电商账户的企业。此外，它也适用于网络爬取和测试，能够模拟真实用户的浏览行为，同时确保活动安全且私密。

## Incogniton 代理集成

在 Incogniton 中设置 Bright Data 代理的过程快速且简单。请按照以下步骤进行操作：

<Steps>
  <Step title="下载 Incogniton">
    访问 [**Incogniton 官网**](https://incogniton.com/) 下载并安装该浏览器。
  </Step>

  <Step title="创建新配置文件">
    1. 安装完成后，打开 Incogniton 并进入 **Profile Management**（配置文件管理）部分。
    2. 点击 **New Profile**（新建配置文件）以创建您的第一个配置文件。
  </Step>

  <Step title="配置代理设置">
    在配置文件设置菜单中，点击左侧的 **Proxy**（代理），然后输入您的 Bright Data 代理信息：

    * **代理类型（Proxy Type）**: 选择 `HTTP`、`HTTPS` 或 `SOCKS5`（根据您的代理类型）。
    * **代理主机（Proxy Host）**: 输入 `http://brd.superproxy.io/`。
    * **代理端口（Proxy Port）**: 使用您在 [Bright Data 控制台](https://brightdata.com/cp/zones) 中提供的端口号。
    * **代理用户名（Proxy Username）**: 输入您的 Bright Data 代理 `用户名`。
    * **代理密码（Proxy Password）**: 输入您的 Bright Data 代理 `密码`。

    点击 **Check Proxy**（检查代理）确认代理是否正常工作。

    <Info>
      **如果需要使用特定国家的代理，可以使用 `username-country-US` 格式（例如 `username-country-US` 以获取美国 IP）。**
    </Info>
  </Step>

  <Step title="保存配置文件">
    1. 输入所有必要信息后，点击 **Create Profile**（创建配置文件）以保存设置。
    2. 您现在可以安全浏览了！
  </Step>

  <Step title="开始浏览">
    点击 **Start**（开始）以在安全的无痕浏览窗口中启动您的配置文件，并开始匿名浏览。
  </Step>
</Steps>

就是这样！您已成功将 Bright Data 代理集成到 Incogniton 中。


# 如何在 Insomniac 中设置 Bright Data
Source: https://docs.brightdata.com/cn/integrations/insomniac

使用 Bright Data 代理与 Insomniac 结合可提升您的自动化操作，提供安全、匿名的连接，降低被检测的风险，并确保更顺畅的运行。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 Insomniac？

Insomniac 是一款在线购物工具，允许您通过其多会话浏览器隐藏您的数字足迹。Insomniac 浏览器支持为每个标签页应用不同的代理，并通过为每个打开的标签页分配不同的 IP 地址来隐藏您的在线踪迹。

<Tip>
  通过在用户名中使用 `-session` 参数，在整个浏览器会话中保持一致的 IP 地址。这很重要，因为 Bright Data 代理默认在每次请求时轮换 IP。[了解更多](https://docs.brightdata.com/cn/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 />

  新用户应从 ISP 或数据中心代理开始，因为住宅代理在 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 下与浏览器集成不兼容。<br />

  对于 **账户管理** 相关的使用场景，每个管理的账户应使用一致的静态专用 IP。建议使用 [专用 ISP 代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction)。
</Tip>

## 如何在 Insomniac 中设置 Bright Data 代理：

### Insomniac 浏览器设置

* 下载并安装 Insomniac 浏览器
* 打开 **Insomniac 浏览器**
* 点击 **Insomniac Proxy Per Tab** → **管理代理列表**
* 在扩展程序中，点击 **添加单个代理** 选项卡

<Frame>
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy1.png?maxW=1245&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f9a1daff5813289b9fc7e3bc77fa7d05" alt="insomniac-proxy1.png" width="1245" height="331" data-path="images/integrations/insomniac-proxy1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy1.png?w=280&maxW=1245&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=abcfba6be2ab703f2b30096f3667dee5 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy1.png?w=560&maxW=1245&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=4a2743ca612d535d9c810f1af681294b 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy1.png?w=840&maxW=1245&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=35dc3150ffb7fd79f851e71ab6bfb771 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy1.png?w=1100&maxW=1245&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=fe796e4d616ba4b44161bc9ffc1b424e 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy1.png?w=1650&maxW=1245&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=745e34b2c32bbbf264877ac7b6a489d1 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy1.png?w=2500&maxW=1245&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a48a5acc320ca00362a776ebecfd6e65 2500w" data-optimize="true" data-opv="2" />
</Frame>

## 在 Insomniac 中集成 Bright Data 代理

* 进入 Bright Data 仪表板，点击 **创建 Zone**
* 选择您的 **网络类型**
* 点击 **保存**
* 在 Insomniac Proxy Per Tab 中，点击 **添加单个代理** 选项卡并复制您的代理信息：
  * **主机名**: brd.superproxy.io
  * **端口**: 33335
  * **用户名**: 输入您的 Bright Data Zone 用户名
* 在 Insomniac 中的密码字段输入 Bright Data Zone 设置中的密码
* 点击 **添加代理**

<Frame>
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac_proxy_per_tab.jpg?maxW=988&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e3ecde6e00b6c04b20ea89436fd09e2b" alt="insomniac_proxy_per_tab.jpg" width="988" height="624" data-path="images/integrations/insomniac_proxy_per_tab.jpg" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac_proxy_per_tab.jpg?w=280&maxW=988&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f015f353be573068ff029ae97c642932 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac_proxy_per_tab.jpg?w=560&maxW=988&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=253473ab1f6ed0066a37f3cde004485f 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac_proxy_per_tab.jpg?w=840&maxW=988&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9cd8f79417f7408dde849021c54924a1 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac_proxy_per_tab.jpg?w=1100&maxW=988&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=bde4ca012c66feebecec4870e0ff2828 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac_proxy_per_tab.jpg?w=1650&maxW=988&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=08e42205b044512342af84eacf1e77d3 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac_proxy_per_tab.jpg?w=2500&maxW=988&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=b6f80708d707109987d6f09b12346bac 2500w" data-optimize="true" data-opv="2" />
</Frame>

* 在 **Proxy Per Tab 扩展** 中，选择 **按顺序轮换代理**
* 该选项将按照线性顺序自动选择代理端口，而不是随机顺序

<Frame>
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy3.png?maxW=557&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=3dd0b078796a6c73a58d9e87c3e3fecb" alt="代理扩展设置及轮换方法菜单" width="557" height="552" data-path="images/integrations/insomniac-proxy3.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy3.png?w=280&maxW=557&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=5fcdd231b64af8c53074495f430670c8 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy3.png?w=560&maxW=557&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=467d340af7a4e6e6f9a0413ae8736623 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy3.png?w=840&maxW=557&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=875307e9069294ad015ca9c3dd7fd838 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy3.png?w=1100&maxW=557&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=b2f2b5d1d00ad4d7d49c68faa22688cd 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy3.png?w=1650&maxW=557&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=452825821e5276c33bf4c3be34977996 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy3.png?w=2500&maxW=557&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a4b6bd8ee3b5861528ddfa7ced162053 2500w" data-optimize="true" data-opv="2" />
</Frame>

## 在 Insomniac 中集成多个 Proxy Manager 端口

* 下载 [Proxy Manager](https://brightdata.com/cn/products/proxy-manager)
* 点击 **添加新代理** 以创建新端口
* 选择新端口（24XXX）
* 进入端口设置中的 **常规** 选项卡
* 在 **多个代理端口** 字段中，选择要创建的代理端口数量。这将创建多个具有相同设置的代理端口
* 您的电子表格应包含以下列：
  * **自定义名称**: 为每个代理添加名称
  * **主机**: 127.0.0.1
  * **端口**: 24XXX
  * **用户名、密码和标签**: 留空（Proxy Manager 已经使用 Super Proxy 进行了身份验证）
* 将文件保存为 **CSV** 格式，而不是 XLS 或 XLSX
* 在 Insomniac **Proxy Per Tab** 扩展中，选择 **管理代理列表**，然后选择 **批量添加代理**
* 选择 **导入代理列表** 并上传 CSV 文件

<Frame>
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy2.png?maxW=1018&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=5c5f4d3b44468e6692fca4b8193b8251" alt="insomniac-proxy2.png" width="1018" height="251" data-path="images/integrations/insomniac-proxy2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy2.png?w=280&maxW=1018&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a19d7ddf3d907cd0c3780e86d5a41de9 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy2.png?w=560&maxW=1018&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=da2b74bcb2d0d733b13604308b1dae1c 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy2.png?w=840&maxW=1018&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=58e27571d37083ef2b39892dea626e3b 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy2.png?w=1100&maxW=1018&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=b3396e823f4bc3ca1ace47a93dc34987 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy2.png?w=1650&maxW=1018&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f4649199a83b8f84dde5b51b7630315f 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/insomniac-proxy2.png?w=2500&maxW=1018&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=dd0a59b5e52a159cd5235265b171a035 2500w" data-optimize="true" data-opv="2" />
</Frame>

<Warning>
  **重要提示**:\
  如果您使用 Bright Data 的住宅代理、Unlocker API 或 SERP API，则需要安装 SSL 证书，以启用与目标网站的端到端安全连接。

  这是一个简单的过程，请参阅 [此指南](https://docs.brightdata.com/cn/general/account/ssl-certificate#installation-of-the-ssl-certificate) 获取安装说明。
</Warning>


# 代理集成
Source: https://docs.brightdata.com/cn/integrations/introduction

Bright Data 的代理可与主流第三方软件无缝集成。阅读我们的详细指南，轻松配置并在您的系统、工具或实用程序中使用 Bright Data 代理。 我们支持以下列出的所有工具和实用程序：

## 支持的集成、工具和实用程序列表

1. [AdsPower](/cn/integrations/adspower)
2. [Aezakmi](/cn/integrations/aezakmi)
3. [Android](/cn/integrations/android)
4. [Antik](/cn/integrations/antik)
5. [Apify](/cn/integrations/apify)
6. [BeautifulSoup](/cn/integrations/beautifulsoup)
7. [BitBrowser](/cn/integrations/bitbrowser)
8. [BrowserScan](/cn/integrations/browserscan)
9. [Capsolver](/cn/integrations/capsolver)
10. [ChangeDetection](/cn/integrations/changedetection)
11. [Chrome](/cn/integrations/chrome)
12. [ClonBrowser](/cn/integrations/clonbrowser)
13. [Dolphin (anty)](/cn/integrations/dolphin-anty)
14. [Easync](/cn/integrations/easync)
15. [Firefox](/cn/integrations/firefox)
16. [FoxyProxy](/cn/integrations/foxyproxy)
17. [Geelark](/cn/integrations/geelark)
18. [GenLogin](/cn/integrations/genlogin)
19. [Ghost Browser](/cn/integrations/ghost-browser)
20. [GoLogin](/cn/integrations/gologin)
21. [Helium Scraper](/cn/integrations/helium-scraper)
22. [HideMyAcc](/cn/integrations/hidemyacc)
23. [iOS](/cn/integrations/ios)
24. [Incogniton](/cn/integrations/incogniton)
25. [Insomniac](/cn/integrations/insomniac)
26. [IXBrowser](/cn/integrations/ixbrowser)
27. [Kameleo](/cn/integrations/kameleo)
28. [Lalicat](/cn/integrations/lalicat)
29. [Linux](/cn/integrations/linux)
30. [MacOS](/cn/integrations/macos)
31. [MarketerBrowser](/cn/integrations/marketerbrowser)
32. [Maskfog](/cn/integrations/maskfog)
33. [MoreLogin](/cn/integrations/morelogin)
34. [MuLogin](/cn/integrations/mulogin)
35. [Multilogin](/cn/integrations/multilogin)
36. [Nginx](/cn/integrations/nginx)
37. [Octo Browser](/cn/integrations/octobrowser)
38. [Octoparse](/cn/integrations/octoparse)
39. [OpenBullet](/cn/integrations/openbullet)
40. [ParseHub](/cn/integrations/parsehub)
41. [PhantomBuster](/cn/integrations/phantombuster)
42. [Playwright](/cn/integrations/playwright)
43. [Postern](/cn/integrations/postern)
44. [Postman](/cn/integrations/postman)
45. [Proxifier](/cn/integrations/proxifier)
46. [Puppeteer](/cn/integrations/puppeteer)
47. [SaleFreaks](/cn/integrations/salefreaks)
48. [Scrapy](/cn/integrations/scrapy)
49. [Screaming Frog](/cn/integrations/screaming-frog)
50. [Selenium](/cn/integrations/selenium)
51. [SessionBox](/cn/integrations/sessionbox)
52. [ShadowRocket](/cn/integrations/shadowrocket)
53. [SMLogin](/cn/integrations/smlogin)
54. [Sphere Browser](/cn/integrations/sphere-browser)
55. [StablerSOLO](/cn/integrations/stablersolo)
56. [SwitchyOmega](/cn/integrations/switchyomega)
57. [TexAu](/cn/integrations/texau)
58. [Undetectable](/cn/integrations/undetectable)
59. [VMLogin](/cn/integrations/vmlogin)
60. [WebHarvy](/cn/integrations/webharvy)
61. [Web Scraper](/cn/integrations/webscraper)
62. [Windows](/cn/integrations/windows)
63. [XLogin](/cn/integrations/xlogin)

***

## 不支持的集成

1. [Telegram Messenger](https://telegram.org/)


# 如何在 iOS 上使用 Bright Data
Source: https://docs.brightdata.com/cn/integrations/ios

了解如何在您的 iOS 设备上设置 Bright Data 代理，以享受安全、私密且无限制的浏览体验。本指南将引导您完成整个配置过程，确保连接顺畅可靠。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 为什么在 iOS 上使用 Bright Data？

在 iOS 上设置 Bright Data 代理可以帮助您：

* **保护您的隐私**：隐藏您的真实 IP 地址，更安全地浏览网络。

* **访问受地理限制的内容**：通过不同地区的连接访问各个国家的内容。

* **提高稳定性**：降低被检测的风险，在手机上浏览、购物或管理账户时享受稳定的匿名连接。

## 前置要求

在开始之前，请确保您已经准备好：

1. **Bright Data 代理凭据**：
   * 登录您的 [Bright Data 仪表板](https://brightdata.com/cp/zones) 并找到您的 Host、Port、Username 和 Password。

2. **运行 iOS 10 或更高版本的 iPhone**：
   * 以下步骤适用于大多数较新的 iOS 版本。

## 为 Wi-Fi 网络配置代理

<Steps>
  <Step title="打开 Wi-Fi 设置">
    1. 在 iPhone 主屏幕上打开 **设置**。
    2. 轻点 **Wi-Fi**，然后选择您连接的网络旁的 **i**（信息）图标。

    <Frame as="div" style={{width:"50%", height:"auto"}}>
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone1.png?maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=7ab15eea854f5df65563c6722b007044" alt="" width="1170" height="1049" data-path="images/integrations/iphone1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone1.png?w=280&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=21cb06de6bc35fbd4642ab5bbe1f943e 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone1.png?w=560&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=13d4af6e03ecb3775f88889961a6768c 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone1.png?w=840&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=37bec84e856d447b06e9e3f5bcffbf9a 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone1.png?w=1100&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3a80e9389da5835f221da787786875e9 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone1.png?w=1650&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=299c8791cb4accc3d19a934272d0059c 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone1.png?w=2500&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c6acc07adf058a6fd10e20153fb57924 2500w" data-optimize="true" data-opv="2" />
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone2.png?maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2d308db3186138b8c38eddc8fe307b39" alt="" width="1170" height="569" data-path="images/integrations/iphone2.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone2.png?w=280&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ba3b267b8bc1fa37ce9ddfc6a989524d 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone2.png?w=560&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=e5c506ee9be2a6d8479a9dc98ce9d7a0 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone2.png?w=840&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8f39678e08e5129371dd886946993352 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone2.png?w=1100&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=9706af07688792deea144cc2f77a3c35 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone2.png?w=1650&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=e099bcdbd60cbd3431c974429bed447a 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone2.png?w=2500&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5748504424d700140265f37ab117aea3 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="将代理设置更改为手动">
    1. 向下滚动，找到 **HTTP 代理**。
    2. 从 **关闭** 或 **自动** 切换到 **手动**。
    3. 切换 **身份验证** 为 *开启*。

    <Frame as="div" style={{width:"50%", height:"auto"}}>
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone3.png?maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=19a077c7d00f41119bd0214fc753f98c" alt="" width="1170" height="1043" data-path="images/integrations/iphone3.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone3.png?w=280&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=340d9af5bd1a4b7a6c7f8d111ca30f2b 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone3.png?w=560&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=bdf64545fdfc9ddc35495a96cf31f5e7 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone3.png?w=840&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3afd127e050bb1c8fdd5a917a5bf0809 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone3.png?w=1100&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=20b38f7fdeb27d1a01be4225f44a39b0 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone3.png?w=1650&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=56ee83f8f37ee38358e61d911bcef4c8 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone3.png?w=2500&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=bc78f29f507718b810d09c38c1f54c92 2500w" data-optimize="true" data-opv="2" />
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone4.png?maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=07752577dfc9baa63690de867e553f1b" alt="" width="1170" height="1168" data-path="images/integrations/iphone4.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone4.png?w=280&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d975e4a570cc8795bd994a423f8c69ad 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone4.png?w=560&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4e46887b85094c43dbfb22113886764a 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone4.png?w=840&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b7703ddbf225235a35145f0d3badd3aa 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone4.png?w=1100&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=e11a532cf8df6494d0baed98252ca92a 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone4.png?w=1650&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4a7ca1e6cd0c6fb37dccfdfae7d568d1 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone4.png?w=2500&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=32e02b8308993f59b4c15a9b60062079 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="输入 Bright Data 代理凭据">
    1. **服务器**：输入 `http://brd.superproxy.io/`（或您的指定 Host）。
    2. **端口**：使用您的 [Bright Data 仪表板](https://brightdata.com/cp/zones) 上提供的端口号。
    3. **用户名** 和 **密码**：填写您的 Bright Data 登录凭据。
    4. 确保所有信息正确无误。
    5. 轻点 **保存** 以确认设置。
  </Step>

  <Step title="测试">
    1. 打开 **Safari**，访问 [httpbin.org/ip](http://httpbin.org/ip)。
    2. 检查显示的 IP 是否与 Bright Data 代理 IP 匹配。如果匹配，则说明您的 Wi-Fi 流量现在是安全且私密的。
  </Step>
</Steps>

在 **iOS 设备** 上集成 **Bright Data** 后，您将能够更轻松地访问受地理限制的内容、保护您的身份，并确保更安全、私密的连接。无论您身在何处，都可以享受 Bright Data 提供的自由和安心体验！


# 如何将 Bright Data 与 IXBrowser 集成
Source: https://docs.brightdata.com/cn/integrations/ixbrowser

使用 Bright Data 和 IXBrowser 简化您的账户管理并保护您的浏览安全。按照本指南配置 Bright Data，以实现无缝且匿名的 IXBrowser 体验。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 IXBrowser？

<Tip>
  在您的浏览会话期间保持一致的 IP，请在用户名中使用 `-session` 参数。这一点至关重要，因为 Bright Data 代理默认情况下会在每次请求时更换 IP。[了解更多](https://docs.brightdata.com/cn/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 />

  新用户应从 ISP 或数据中心代理入手，因为住宅代理与 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 的浏览器集成不兼容。<br />

  对于**账户管理**相关的用例，每个账户应使用固定的静态专用 IP。[专用 ISP 代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction) 应用于此场景。
</Tip>

**IXBrowser** 是一款专注于隐私的防检测浏览器，旨在帮助用户管理多个平台上的账户。它提供了高级匿名功能，使用户能够绕过限制并避免检测。将 Bright Data 与 IXBrowser 集成可以进一步增强隐私保护，并实现地理定位浏览。

## 如何将 Bright Data 与 IXBrowser 集成

<Steps>
  <Step title="下载并安装 IXBrowser">
    1. 访问 [IXBrowser 官网](https://ixbrowser.com/) 并下载应用程序。
    2. 安装软件并使用您的账户凭据登录。
  </Step>

  <Step title="创建新配置文件">
    1. 打开 IXBrowser，进入 **浏览器配置** 下的 **配置文件列表** 版块。
    2. 点击 **创建新配置文件** 以开始设置新的浏览器实例。
    3. 在配置文件设置中，在 **配置文件名称** 字段输入一个描述性名称，以便稍后轻松识别您的配置文件。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser1.png?maxW=1364&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ea7f266fc05eedcbe14c5e1ca69e4fff" alt="" width="1364" height="197" data-path="images/integrations/ixbrowser1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser1.png?w=280&maxW=1364&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8c693fb282a2f0c8ba1c4d9961c16db7 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser1.png?w=560&maxW=1364&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=32f4e8b450c73da9c4cbcfa8f22cf14c 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser1.png?w=840&maxW=1364&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4cfd0c91bae7f2f5a55892cdcf6f799e 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser1.png?w=1100&maxW=1364&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=351ead14318286499a64a6a1f357329e 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser1.png?w=1650&maxW=1364&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d34a80347924cd29a4d6cdac13ead10f 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser1.png?w=2500&maxW=1364&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=866aea81c122fd940d036687a14f4cdf 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="配置代理设置">
    1. 在配置文件设置页面，切换到 **代理配置** 选项卡。

    2. 选择 **自定义** 以启用代理设置选项。

    3. 填写从您的 [Bright Data 控制面板](https://brightdata.com/cp/zones) 获取的代理信息：
       * **代理类型**：根据您的代理类型选择 HTTP、HTTPS 或 SOCKS5。
       * **代理主机**：`http://brd.superproxy.io/`
       * **代理端口**：输入 Bright Data 控制面板中的端口号。
       * **代理账号**：使用您的 Bright Data `用户名`。
       * **代理密码**：使用您的 Bright Data `密码`。

    4. 输入完毕后，点击 **创建** 以保存配置。

    <Note>
      若使用地理定位代理，请按照 `your-username-country-XX` 格式设置您的用户名（例如：`your-username-country-US`），以访问特定地区。
    </Note>
  </Step>

  <Step title="启动配置文件">
    1. 返回 **配置文件列表** 版块。
    2. 找到您新创建的配置文件，点击 **打开** 以使用配置的 Bright Data 代理设置启动浏览器。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser2.png?maxW=1353&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f7f34b045103bfc94e9b64165992f19c" alt="" width="1353" height="278" data-path="images/integrations/ixbrowser2.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser2.png?w=280&maxW=1353&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=71b0281d973622114d9b5472573ad7de 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser2.png?w=560&maxW=1353&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=91e5d8d4c707ced53d4dc3919e76a8e2 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser2.png?w=840&maxW=1353&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=229c7c535fb581add51b15b4339cddf9 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser2.png?w=1100&maxW=1353&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=66a80177207f9d65f3e42de85b374fdb 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser2.png?w=1650&maxW=1353&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2dbebdf160bf4d9eedbbcce94883ddef 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser2.png?w=2500&maxW=1353&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=e419ae8b729fc9f1ce67fc3fd6613f91 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>
</Steps>

将 Bright Data 与 IXBrowser 集成可确保私密且可靠的账户管理，同时提升您的在线匿名性。无论您是管理多个账户还是进行地理定位操作，此设置都能为您提供安全无缝的浏览体验。立即开始，享受更高效的操作体验！


# 如何在 Kameleo 中设置 Bright Data
Source: https://docs.brightdata.com/cn/integrations/kameleo

将 Bright Data 与 Kameleo 集成，实现安全浏览和高效管理多个配置文件，提供增强的隐私保护和强大的反检测能力。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 Kameleo？

Kameleo 是一款先进的反检测浏览器，专为需要管理多个在线配置文件而又不希望被检测到的用户设计。无论您是社交媒体经理、联盟营销人员、电商运营者，还是网页爬取者，Kameleo 都能为您提供绕过 IP 封禁、防止设备追踪、避免账户关联的工具。

借助 Kameleo，您可以自定义浏览器指纹（如用户代理、屏幕分辨率和字体），确保每个配置文件看起来都是独立的，从而避免被检测。Kameleo 支持多种代理，包括住宅代理、数据中心代理和 ISP 代理，让您可以为每个配置文件分配不同的 IP 地址和数字身份。这使其非常适合在社交媒体、电商网站等多个平台上管理多个账户，并且可以在单个会话中完成所有操作。

除了强大的反检测功能外，Kameleo 还支持自动化工具，非常适用于批量任务，如自动发帖或数据爬取。无论您是管理少量账户，还是需要扩展规模，Kameleo 都能在优化在线活动的同时，确保您的隐私和安全。

<Tip>
  在浏览器会话期间保持 IP 地址一致，请在用户名中使用 `-session` 参数。这很重要，因为 Bright Data 代理默认会在每次请求时更换 IP 地址。[了解更多](https://docs.brightdata.com/cn/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 />

  新用户建议从 ISP 或数据中心代理开始，因为住宅代理无法在 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 下与浏览器集成。<br />

  如果您的使用场景涉及 **账户管理**，请为每个账户使用一致的专属静态 IP。[ISP 专属代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction) 适用于此类需求。
</Tip>

## Kameleo 代理集成

按照以下步骤，将 Bright Data 代理集成到 Kameleo：

<Steps>
  <Step title="打开 Kameleo">
    启动 [**Kameleo 应用**](https://kameleo.io/downloads/)，并登录您的账户。
  </Step>

  <Step title="创建新配置文件">
    点击左侧导航面板中的 **New Profile**（新建配置文件）选项，开始设置新的浏览器配置文件。
  </Step>

  <Step title="配置您的配置文件偏好">
    选择与您的设备类型、操作系统、浏览器和语言设置匹配的配置文件选项。
  </Step>

  <Step title="配置 Bright Data 代理">
    进入配置文件设置中的 **Connection**（连接）部分，并输入以下信息来配置 Bright Data 代理：

    * **代理类型**：根据您的代理类型，选择 `HTTP`、`HTTPS` 或 `SOCKS5`。
    * **主机地址**：输入 `http://brd.superproxy.io/`。
    * **端口**：使用您在 [Bright Data 控制面板](https://brightdata.com/cp/zones) 中提供的端口号。
  </Step>

  <Step title="启用身份验证">
    点击 **Authentication**（身份验证）按钮，显示 `用户名` 和 `密码` 字段。\
    在此处输入您的 Bright Data 代理凭据。

    为了确保设置正确，点击 **Test Proxy**（测试代理）按钮，运行多个测试来检查代理连接。

    <Info>
      **如果需要特定国家的代理，您可以使用 `your-username-country-US` 这样的格式，以获取美国出口节点。**
    </Info>
  </Step>

  <Step title="保存设置">
    配置完成后，点击 **OK**（确定）保存您的设置。

    或者，点击 **START**（启动），立即使用您的配置文件打开浏览器。
  </Step>
</Steps>

就这样！您已成功将 Bright Data 代理集成到 Kameleo 中。


# 如何在 Lalicat 中设置 Bright Data
Source: https://docs.brightdata.com/cn/integrations/lalicat

将 Bright Data 集成到 Lalicat 可确保安全、匿名的多账户管理，提供灵活的代理解决方案，实现可靠高效的浏览体验。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 Lalicat？

Lalicat 是一款简单的防检测浏览器，旨在帮助您安全、匿名地管理多个账户。它创建独立的浏览器配置文件，并隔离数字指纹（如 IP 地址和设备信息），让您轻松绕过跟踪系统，避免检测。

无论是社交媒体管理、电商运营，还是 Web 数据抓取，Lalicat 都是一个可靠且经济的解决方案，适合注重隐私和效率的专业人士。对于需要同时管理多个账户而不被标记或封禁的用户来说，它是完美的选择。

<Tip>
  在整个浏览器会话期间保持 IP 一致，请在用户名中使用 `-session` 参数。这一点至关重要，因为 Bright Data 代理默认会在每次请求时更换 IP。[了解更多](https://docs.brightdata.com/cn/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 />

  新用户应从 ISP 或数据中心代理入手，因为住宅代理在 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 下无法与浏览器集成。<br />

  针对 **账户管理** 相关的使用场景，请为每个账户使用固定的专属静态 IP。建议使用专属 [ISP 代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction)。
</Tip>

## Lalicat 代理集成

按照以下步骤将 Bright Data 代理集成到 Lalicat：

<Steps>
  <Step title="安装 Lalicat">
    1. [**下载**](https://www.lalicat.com/download)、安装并启动 Lalicat。
    2. 创建账户并登录。
  </Step>

  <Step title="添加浏览器配置文件">
    在主界面点击 **+添加浏览器** 以创建新的浏览器实例。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat1.png?maxW=1534&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b779761f0cb35b4556b46e2def6b9ee1" alt="" width="1534" height="364" data-path="images/integrations/lalicat1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat1.png?w=280&maxW=1534&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8a69d3e6f89cbcdea41957d4bb12358b 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat1.png?w=560&maxW=1534&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f90feadd5c3ea6518f2a0407f21bedef 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat1.png?w=840&maxW=1534&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2098c8043e6d1201558b18db8400fade 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat1.png?w=1100&maxW=1534&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=093a762ec3782de1c0df03175bb5ef40 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat1.png?w=1650&maxW=1534&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ce39fe9e58ad9d9d423e8ce630b8126f 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat1.png?w=2500&maxW=1534&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=cb351b77a55d427a5408694288362882 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="配置基本设置">
    在 **基本配置** 部分，输入 **配置文件名称**，选择模拟的 **操作系统**，并调整其他必要的设置。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat2.png?maxW=715&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4fcb38a67ff675397aca68d7f23e82d8" alt="" width="715" height="611" data-path="images/integrations/lalicat2.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat2.png?w=280&maxW=715&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=252606f7dedc2e2a42963c0d4ea66442 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat2.png?w=560&maxW=715&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3fe77d7534ecf9bec0c357b2f1800176 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat2.png?w=840&maxW=715&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=802706774e1732efbe6c22e40367921f 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat2.png?w=1100&maxW=715&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=897519c4703b0cab21dffe469c174597 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat2.png?w=1650&maxW=715&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=932e1fbf8dc7a414c57ca816f4336b87 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat2.png?w=2500&maxW=715&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=58854bc0a8c8d2710633c7ce881f2358 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="配置 Bright Data 代理">
    滚动至 **代理设置** 部分，并输入以下信息：

    * **代理类型**: 选择 `HTTP`、`HTTPS` 或 `SOCKS5`（根据您的代理类型）。
    * **IP 地址**: 输入 `http://brd.superproxy.io/`。
    * **端口**: 使用您的 [Bright Data 控制面板](https://brightdata.com/cp/zones) 提供的端口号。
    * **登录名**: 输入您的 Bright Data 代理 `用户名`。
    * **密码**: 输入您的 Bright Data 代理 `密码`。

    <Info>
      **针对特定国家/地区的代理，您可以使用格式 `your-username-country-US` 以获得美国出口节点。**
    </Info>
  </Step>

  <Step title="测试代理">
    点击 **检查代理** 以验证连接是否成功。

    如果一切正常，点击 **保存** 完成配置。
  </Step>
</Steps>

**就这样！** 您已成功将 Bright Data 代理集成到 Lalicat。


# 如何在 macOS 上使用 Bright Data
Source: https://docs.brightdata.com/cn/integrations/macos

将 Bright Data 代理集成到 macOS 网络设置中，实现安全、私密和灵活的地理位置浏览。本指南将引导您完成整个配置过程，帮助您高效、安全地上网。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

<Tip>
  在浏览器会话期间保持 IP 地址一致，请在用户名中使用 `-session` 参数。这一点至关重要，因为 Bright Data 代理默认在每次请求时轮换 IP。[了解更多](https://docs.brightdata.com/cn/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 />

  新用户应从 ISP 或数据中心代理入手，因为住宅代理在 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 下无法与浏览器集成。<br />

  对于**账户管理**相关的用例，每个账户应使用专属的静态 IP。建议使用专属 [ISP 代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction) 。
</Tip>

## 为什么在 macOS 上使用 Bright Data？

将 Bright Data 代理添加到 Mac 的网络设置可以提供以下优势：

* **增强隐私**：隐藏真实 IP，使在线活动更安全。
* **灵活的地理访问**：通过不同地区的 IP 访问特定地区的内容。
* **稳定匿名连接**：降低被检测的风险，并在各种应用程序（不仅限于浏览器）中保持可靠的浏览体验。

## 在 macOS 上设置 Bright Data

<Steps>
  <Step title="前提条件" stepNumber="0">
    在开始之前，请确保您具备以下条件：

    1. **Bright Data 代理凭据**：
       * 登录 [Bright Data 控制面板](https://brightdata.com/cp/zones) 获取主机、端口、用户名和密码。
       * 确认您拥有 `HTTP`、`HTTPS` 或 `SOCKS5` 代理。

    2. **运行较新 macOS 版本的 macOS 设备**（以下指南适用于 macOS 10.12 Sierra 及以上版本）。
  </Step>

  <Step title="打开网络偏好设置">
    1. 点击屏幕左上角的 **苹果菜单**。
    2. 选择 **系统设置**（较旧 macOS 版本为 **系统偏好设置**）。

    <Frame as="div" style={{width:"50%", height:"auto"}}>
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos1.png?maxW=252&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d74963a371701110295d7e0464a5ec16" alt="" width="252" height="316" data-path="images/integrations/macos1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos1.png?w=280&maxW=252&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f2e4791fed8f436fd6b4e2e1715bdde3 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos1.png?w=560&maxW=252&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f47452759d5e7b3666bdab500b9429d9 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos1.png?w=840&maxW=252&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=87298d2a7bcb97d20be8d86f7eda7710 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos1.png?w=1100&maxW=252&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5e46413fb8b9e2680379f178c2537a77 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos1.png?w=1650&maxW=252&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=721e5e93981f944e2292743c7619b38e 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos1.png?w=2500&maxW=252&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3d3c48b697ca75c484c541206acf8c0b 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    3. 进入 **网络** 选项，并选择要配置的网络连接（如 **Wi-Fi** 或 **以太网**）。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos2.png?maxW=719&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=9482cebd33e6ca0617ab8840c918d0f5" alt="" width="719" height="309" data-path="images/integrations/macos2.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos2.png?w=280&maxW=719&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c5ba0f1bb701a722e267ccd644962f2f 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos2.png?w=560&maxW=719&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=219242e0eae98475d1765f2af287259a 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos2.png?w=840&maxW=719&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=0967e6f33268d188d3d81a32f15bce27 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos2.png?w=1100&maxW=719&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d43e035145b4b20b445996d196a2a9a7 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos2.png?w=1650&maxW=719&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=0933ba0fbff7cf81c6cb62b987b9cd5f 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos2.png?w=2500&maxW=719&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=10e8cb6d8f03425a4c25502adf6718c5 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="进入高级设置">
    1. 在网络面板右上角点击 **“详情…”** 按钮。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos3.png?maxW=490&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b33df7399db2913edcb6978b8da40df7" alt="" width="490" height="386" data-path="images/integrations/macos3.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos3.png?w=280&maxW=490&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2e3ea686c40f61034c8cb5f1c385ae7c 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos3.png?w=560&maxW=490&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d5af010743408510d3558be0ce8470ab 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos3.png?w=840&maxW=490&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b48d05903d318d8b4f3b0fa36a468a56 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos3.png?w=1100&maxW=490&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8569ce290c8ded5fb929d2f2e5593084 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos3.png?w=1650&maxW=490&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=a4354dbe5ccc922771c79994bf389a48 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos3.png?w=2500&maxW=490&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=30638fbd18b43bbf96f7ae2057a50f31 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    2. 在新窗口中，选择底部的 **代理** 选项卡。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos4.png?maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=9a4cff2baf0b7dc9674cf5402d5e8900" alt="" width="659" height="420" data-path="images/integrations/macos4.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos4.png?w=280&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=485a1ecf781399d591e3d2ff735f7fe5 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos4.png?w=560&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8c85718f6198a030e10ed5d19518864f 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos4.png?w=840&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=910de24511862c3d363772b39758aa3f 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos4.png?w=1100&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=01b1c5b39e442c452e050b05981d2769 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos4.png?w=1650&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3aee15ce58c742c0896723d17f3ed6a5 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos4.png?w=2500&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=42955310991ecc33b4c00d3a8096536f 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="选择代理类型">
    勾选需要配置的代理协议类型。

    对于 Bright Data 的 `HTTP` 或 `HTTPS` 代理，选择 **Web 代理（HTTP）** 或 **安全 Web 代理（HTTPS）**。对于 `SOCKS` 代理，选择 **SOCKS 代理**。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos5.png?maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=39fdb8e407088b4b7b310f2b75855e93" alt="" width="659" height="420" data-path="images/integrations/macos5.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos5.png?w=280&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2cdacf80b32b5777dd2d5235cc24013b 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos5.png?w=560&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=bb2cfecd8e535506501cb4acd2ddfa29 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos5.png?w=840&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b023a529f44007bc7357b168bc7af836 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos5.png?w=1100&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=dd4f33ba07b00a88ce2cce3b6ff7e1fb 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos5.png?w=1650&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=cce2f96e0f8be972e90b0990470eabc5 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos5.png?w=2500&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=05622dee2029490f69b49e3f6f8fd8c2 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="输入 Bright Data 代理详情">
    * **服务器**：输入 Bright Data 主机地址（例如 `http://brd.superproxy.io/`）。
    * **端口**：输入 [Bright Data 控制面板](https://brightdata.com/cp/zones) 提供的端口号。
    * **启用身份验证**：勾选 **“代理服务器需要密码”**（或类似选项）以启用凭据字段。
    * **用户名** 和 **密码**：填写您的 Bright Data 代理凭据。如需特定国家的出口节点，请在用户名后添加 `-country-XX`（例如 `your-username-country-US` 以使用美国代理）。
    * 点击 **确定** 以保存设置。
  </Step>

  <Step title="测试代理连接">
    1. 打开 **Safari**、**Chrome** 或其他浏览器。
    2. 访问 [httpbin.org/ip](http://httpbin.org/ip) 以检查您的 IP 地址。
    3. 确认显示的 IP 与 Bright Data 代理的 IP 相匹配。如果匹配，则您的 Mac 现在已通过 Bright Data 代理进行流量路由。
  </Step>
</Steps>

将 **Bright Data** 代理集成到 **macOS** 网络设置后，您可以在所有应用程序中享受更安全、私密和灵活的浏览体验。访问地理限制内容、保护身份并提升连接稳定性——在 Mac 上，Bright Data 让一切变得更加轻松！


# 如何在 MarketerBrowser 中使用 Bright Data
Source: https://docs.brightdata.com/cn/integrations/marketerbrowser

轻松提升您的浏览器配置文件管理能力，使用 Bright Data 与 MarketerBrowser 集成可确保您的连接安全，管理多个账户，并轻松访问特定地区的内容。按照本指南立即设置 Bright Data 与 MarketerBrowser 的集成。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 MarketerBrowser？

<Tip>
  通过在用户名中使用 `-session` 参数，在整个浏览器会话期间保持一致的 IP 地址。这一点至关重要，因为 Bright Data 代理默认会在每次请求时轮换 IP。[了解更多](https://docs.brightdata.com/cn/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 />

  新用户应首先使用 ISP 或数据中心代理，因为住宅代理在 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 下与浏览器集成不兼容。<br />

  对于 **账户管理** 相关的使用场景，请为每个账户使用一致的专用静态 IP。应该使用专用的 [ISP 代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction) 来实现这一点。
</Tip>

**MarketerBrowser** 是一款专为管理多个账户或营销活动的专业人士设计的浏览器。它允许您创建隔离的浏览器配置文件，确保每个会话的安全性和隐私性。通过集成 **Bright Data**，您可以增强匿名性、访问受地理限制的内容，并降低被检测的风险。

## 如何在 MarketerBrowser 中集成 Bright Data

<Step title="安装并打开 MarketerBrowser">
  1. 从 [官方网站](https://www.marketerbrowser.com/) 下载 MarketerBrowser。
  2. 按照屏幕上的安装说明，在您的设备上完成应用程序的设置。
  3. 打开 MarketerBrowser 并使用您的凭据登录。如果您没有账户，请注册一个。
</Step>

<Step title="创建或编辑浏览器配置文件">
  1. 在 **Profiles**（配置文件）页面，点击 **Create Profile**（创建配置文件）以设置新的浏览器实例，或选择现有配置文件进行编辑。
  2. 在 **Name**（名称）字段中提供一个描述性名称，以便日后轻松识别。

  <Frame as="div">
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/cn/images/integrations/marketerbrowser1.png" alt="" />
  </Frame>
</Step>

<Step title="配置代理设置">
  1. 在配置文件设置菜单中找到 **Proxy**（代理）部分。

  2. 输入您的 Bright Data 代理详细信息：
     * **Type**（类型）：选择 HTTP、HTTPS 或 SOCKS5。
     * **Server**（服务器）：输入 `http://brd.superproxy.io/`。
     * **Port**（端口）：输入您的 [Bright Data 控制面板](https://brightdata.com/cp/zones) 中的端口号。
     * **Username**（用户名）：使用您的 Bright Data `username`。
     * **Password**（密码）：输入您的 Bright Data `password`。

  3. 点击 **Check**（检查）测试代理连接，以确保设置正确。

  4. 输入并测试代理详细信息后，点击 **Create**（创建）保存配置文件设置。
</Step>

<Step title="保存并激活配置文件">
  1. 转到 **Profiles**（配置文件）部分，选择您新配置的配置文件。
  2. 切换 **Launch**（启动）开关至 *On*，以使用 Bright Data 设置激活该配置文件。

  <Frame as="div">
        <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/cn/images/integrations/marketerbrowser2.png" alt="" />
  </Frame>
</Step>

<Step title="验证代理设置">
  1. 在已启动的配置文件中，打开浏览器并导航至 [httpbin.org/ip](http://httpbin.org/ip)。
  2. 确保显示的 IP 地址与您的 Bright Data 代理匹配，以验证设置是否正确。
</Step>

通过将 **Bright Data** 与 **MarketerBrowser** 集成，您可以创建一个无缝且安全的环境，用于管理多个账户、访问特定地区的内容，并保持匿名性。按照这些步骤优化您的工作流程，并使用 Bright Data 和 MarketerBrowser 提高隐私性！


# 如何将 Bright Data 与 Maskfog 集成
Source: https://docs.brightdata.com/cn/integrations/maskfog

了解如何将 Bright Data 与 Maskfog 集成，以增强隐私保护并简化账户管理。按照本指南轻松完成设置。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 Maskfog？

**Maskfog** 是一款反检测浏览器，专为安全匿名地管理多个账户而设计。它提供工具来防止检测、保护数字足迹，并为每个配置文件模拟独特的浏览器环境。将 Bright Data 与 Maskfog 集成，可为地理定位活动增加额外的安全性和灵活性。

<Tip>
  在您的浏览会话期间，使用 `-session` 参数在用户名中保持 IP 地址一致。这一点很重要，因为 Bright Data 代理默认在每次请求时轮换 IP。[了解更多](https://docs.brightdata.com/cn/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 />

  新用户应首先使用 ISP 或数据中心代理，因为住宅代理在 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 下与浏览器集成不兼容。<br />

  **账户管理** 相关的用例应为每个账户使用一致的静态专用 IP。应使用专用的 [ISP 代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction) 进行此操作。
</Tip>

## 如何将 Bright Data 与 Maskfog 集成

<Step title="下载并安装 Maskfog">
  1. 访问 [Maskfog 官网](https://www.maskfog.com/)，下载适用于您的操作系统的应用程序。
  2. 安装软件并使用您的凭据登录。
</Step>

<Step title="创建新配置文件">
  1. 打开 Maskfog，导航到 **代理服务** 部分。
  2. 点击 **配置设备** 以开始设置新的代理。

  <Frame as="div">
        <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/maskfog1.png?maxW=1598&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=49bfc9262c799a170da6facd836d7e8d" alt="" width="1598" height="385" data-path="images/integrations/maskfog1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/maskfog1.png?w=280&maxW=1598&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4aa4ab971905cf9088ee4ac5d3538da2 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/maskfog1.png?w=560&maxW=1598&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=976da16db3e23c8fdce6754ca988964f 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/maskfog1.png?w=840&maxW=1598&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5477c5eef8f4a73852adb6ad11391e2c 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/maskfog1.png?w=1100&maxW=1598&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6c6f672b64f6cec106bf604c194920d7 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/maskfog1.png?w=1650&maxW=1598&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=1b881fedfa8a201dcb303ec5ad6b59ca 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/maskfog1.png?w=2500&maxW=1598&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4461d0a8f2dc029a9aed641520942cec 2500w" data-optimize="true" data-opv="2" />
  </Frame>
</Step>

<Step title="输入代理详情">
  1. 在 **代理名称** 字段中输入一个易于识别的名称，以便后续查找该配置。

  2. 输入从您的 [Bright Data 仪表盘](https://brightdata.com/cp/zones/page/plans) 获取的以下信息：
     * **代理类型**：选择 HTTP、HTTPS 或 SOCKS5。
     * **代理主机**：输入 `http://brd.superproxy.io/`。
     * **代理端口**：使用您的 Bright Data 仪表盘提供的端口号。
     * **代理用户名**：输入您的 Bright Data `username`。
     * **代理密码**：输入您的 Bright Data `password`。

  3. 点击 **检查代理** 以测试代理连接。在继续之前，请确保连接成功。

  4. 验证后，点击 **确定** 以保存配置。

  <Note>
    如果您需要特定国家/地区的代理，请在用户名中包含国家代码。格式如下：
    `your-username-country-XX`（例如，`your-username-country-US`），以选择来自所需国家的代理。
  </Note>
</Step>

完成设置！代理成功配置后，Maskfog 现在已集成 Bright Data，支持安全匿名的连接。尽享增强的隐私保护和无缝浏览体验！


# 如何将 Bright Data 与 MoreLogin 配置
Source: https://docs.brightdata.com/cn/integrations/morelogin

使用 Bright Data 在 MoreLogin 上增强您的多账户管理，实现安全、匿名浏览，并更好地防止检测。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 MoreLogin？

MoreLogin 是一款强大的工具，可帮助您在单个设备上管理多个在线身份。非常适合隐私保护用户、营销人员和社交媒体管理者，MoreLogin 允许您操作多个独立的浏览器配置文件，每个配置文件都有唯一的 IP、Cookie 和设备指纹，从而降低检测和账号封禁的风险。

MoreLogin 具有无缝的代理集成功能，可进一步提升您的匿名性。此外，它支持配置文件共享，非常适用于社交媒体管理、电商和联盟营销。无论是管理多个账户，还是扩大运营规模，MoreLogin 都能助您安全高效地进行操作。

<Tip>
  通过在用户名中使用 `-session` 参数，保持整个浏览会话期间的 IP 地址一致。这很重要，因为 Bright Data 代理默认会在每次请求时轮换 IP。[了解更多](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 />

  新用户建议使用 ISP 代理或数据中心代理，因为住宅代理与 [Immediate-Access 模式](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) 下的浏览器集成不兼容。<br />

  如果您的使用场景涉及 **账户管理**，请为每个管理的账户使用一致的静态专用 IP，并使用专用的 [ISP 代理](https://docs.brightdata.com/proxy-networks/isp/introduction)。
</Tip>

## MoreLogin 代理集成

以下是如何轻松将 Bright Data 代理与 MoreLogin 集成的方法：

<Steps>
  <Step title="安装 MoreLogin">
    访问 [MoreLogin 官网](https://www.morelogin.com/)，下载并安装应用程序。
  </Step>

  <Step title="创建账户">
    登录并开始进行设置。
  </Step>

  <Step title="创建新配置文件">
    点击 **+New profile** 按钮，填写您的配置文件信息。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin1.png?maxW=1440&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6f6d66ddb1237c83af76942c1c72d6b0" alt="" width="1440" height="698" data-path="images/integrations/morelogin1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin1.png?w=280&maxW=1440&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=097110ba463d6123b4aa1cd3dfd9001f 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin1.png?w=560&maxW=1440&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=650e60a85af532b243875fdf3449cee1 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin1.png?w=840&maxW=1440&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3be2149b91dfc1721e702bda48eed221 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin1.png?w=1100&maxW=1440&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=36178e45d138f079ad19705184d0969a 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin1.png?w=1650&maxW=1440&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=dbbfcbb18475a72d5ee99fa5e3205807 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin1.png?w=2500&maxW=1440&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c893a35ec96ff30db672a3311c8cf6ad 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="设置初始配置文件">
    输入配置文件名称，选择您需要的浏览器指纹，并点击 **Advanced Create** 进入高级设置。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin2.png?maxW=560&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=07e83f635a0c7e7943b3873cb4e8ae91" alt="" width="560" height="383" data-path="images/integrations/morelogin2.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin2.png?w=280&maxW=560&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2143b39e487161bc2d4490a0e9d792a0 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin2.png?w=560&maxW=560&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d57195e385b9b0e834cbeebb5063b370 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin2.png?w=840&maxW=560&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=cd17e416a7701b7b68e54f77fd247566 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin2.png?w=1100&maxW=560&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=fca6b134031765a5e391099080f3812b 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin2.png?w=1650&maxW=560&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ba1329b54a291cb43d9bc69e092f5735 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin2.png?w=2500&maxW=560&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=69be15277828d6fb8469ffc73a9df6c9 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="配置代理设置">
    滚动到 **Proxies** 部分，输入您的 Bright Data 代理信息：

    * **代理类型**：选择 `HTTP`、`HTTPS` 或 `SOCKS5`（根据您的代理类型）。
    * **代理服务器**：输入 `http://brd.superproxy.io/`。
    * **代理端口**：使用您在 [Bright Data 控制面板](https://brightdata.com/cp/zones) 中提供的端口号。
    * **代理账号**：输入您的 Bright Data 代理 `用户名`。
    * **代理密码**：输入您的 Bright Data 代理 `密码`。

    <Info>
      **您还可以为代理指定国家/地区。例如，输入 `your-username-country-US` 将为您提供美国的出口节点。**
    </Info>

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin3.png?maxW=876&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=9567c547de59275d41c3b1dc7f1d3ddb" alt="" width="876" height="815" data-path="images/integrations/morelogin3.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin3.png?w=280&maxW=876&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ffc70b3906d662f82252095ab1d9083d 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin3.png?w=560&maxW=876&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2de74db8b0c37f5e8188cb79a5367998 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin3.png?w=840&maxW=876&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=434e7098db804cf4cf9ecf9f384de1ae 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin3.png?w=1100&maxW=876&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=694c3c9fdef8a5b8208183c5fb1c7300 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin3.png?w=1650&maxW=876&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=29343d4068d3c7849ee87771411d4f6a 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin3.png?w=2500&maxW=876&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=84befe592302754be49a20033b6d9a53 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="测试代理">
    点击 **Check Proxy** 确保代理连接正常。
  </Step>

  <Step title="保存并启动">
    点击 **Confirm** 保存设置，然后点击 **Start**，在安全的浏览环境中启动您的配置文件。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin4.png?maxW=771&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=7d2daba39f9fbe5b2f8afb2a5776f60a" alt="" width="771" height="131" data-path="images/integrations/morelogin4.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin4.png?w=280&maxW=771&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d03e71debc0da16b6179e727ba22b43d 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin4.png?w=560&maxW=771&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8ac40907a54fd0e134c69bbfce49534f 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin4.png?w=840&maxW=771&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8afdfb62b4b1fced9eec452beccb216a 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin4.png?w=1100&maxW=771&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=7b1a700c2b494a301021df0a09c0166c 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin4.png?w=1650&maxW=771&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4a39b189ce0ae1a4004e06d31ef7ebfd 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin4.png?w=2500&maxW=771&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=28d56d1a6914e35c4616dc2b8baf5188 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>
</Steps>

完成！您已成功将 Bright Data 代理集成到 MoreLogin 中。


# 如何在 MuLogin 中使用 Bright Data
Source: https://docs.brightdata.com/cn/integrations/mulogin

通过集成 Bright Data 代理增强您的 MuLogin 体验。本指南将向您展示如何设置安全、匿名的连接，以实现更好的自动化、数据收集和账户管理。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 MuLogin？

MuLogin 是一个多账号浏览器管理工具，帮助您在多个在线账户之间进行隔离管理，避免相互干扰。它旨在保护您的隐私、防止检测，并简化您的数字运营。使用 MuLogin，您可以无缝管理多个会话，非常适合电商运营、社交媒体管理以及其他在线项目。

<Tip>
  通过在用户名中使用 `-session` 参数，确保整个浏览会话的 IP 地址保持一致。这一点非常重要，因为 Bright Data 代理默认会在每个请求时更换 IP。[了解更多](https://docs.brightdata.com/cn/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 />

  新用户建议使用 ISP 代理或数据中心代理，因为住宅代理不兼容浏览器集成的 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 。<br />

  **对于账户管理相关的使用场景**，建议为每个账户使用固定的静态专属 IP，推荐使用 [ISP 专属代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction)。
</Tip>

## 为什么要在 MuLogin 中集成 Bright Data？

通过在 MuLogin 中使用 Bright Data 代理，您可以：

* **保护您的身份**：隐藏真实 IP，在安全匿名的代理后面进行操作。
* **降低被检测的风险**：分散您的活动，使用多个 IP 地址，减少被封禁的可能性。
* **提高稳定性**：访问特定地区的内容，并在多个会话之间保持稳定连接。

## 如何在 MuLogin 中配置 Bright Data 代理

按照以下步骤在 MuLogin 中设置 Bright Data 代理：

<Step title="访问 MuLogin 仪表盘">
  1. 访问 [MuLogin](https://www.mulogin.com/) 并登录您的账户。
  2. 登录后，您将看到仪表盘，其中列出了已有的浏览器配置文件（如果有的话）。
</Step>

<Step title="创建或编辑浏览器配置文件">
  1. 如果需要新建配置文件，点击 **“快速创建”** 按钮。

  <Frame as="div">
        <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin1.png?maxW=1385&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=483ad01a257d547823b1a2bbffbf3d28" alt="" width="1385" height="375" data-path="images/integrations/mulogin1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin1.png?w=280&maxW=1385&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=1a655b7db1cbda87150816196f7c901a 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin1.png?w=560&maxW=1385&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=1cb87434bb0a06375f6791a9088cf594 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin1.png?w=840&maxW=1385&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=62921b4440384687b959c2f96de9be2b 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin1.png?w=1100&maxW=1385&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5ffe2861d1035636f72b6cce76a53d3f 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin1.png?w=1650&maxW=1385&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=a117165fe56d4e46ebeb4af5ac801311 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin1.png?w=2500&maxW=1385&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=696b3ba790f9edac30cf60b66da58bb7 2500w" data-optimize="true" data-opv="2" />
  </Frame>

  2. 如果想修改已有配置文件，选择对应文件，然后点击 **“编辑”**、**“设置”** 或 **齿轮图标**（不同版本 UI 可能略有不同）。

  <Frame as="div">
        <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin2.png?maxW=1612&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=149651ca867ab8ed0a8557be3fe281a3" alt="" width="1612" height="242" data-path="images/integrations/mulogin2.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin2.png?w=280&maxW=1612&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c685526f91f4165a66a3e85af65f5576 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin2.png?w=560&maxW=1612&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=71de3c86ea5a135d8517ec0e6b0ad0ff 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin2.png?w=840&maxW=1612&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4daaa286cdda0acd6fa54b14edde5a1c 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin2.png?w=1100&maxW=1612&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=56f1285080e256c88dade1010ad73d51 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin2.png?w=1650&maxW=1612&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=fb51c42cbfd7953125ccef9f90a30de6 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin2.png?w=2500&maxW=1612&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=7e62aee16fd02d5ad034db345f557434 2500w" data-optimize="true" data-opv="2" />
  </Frame>
</Step>

<Step title="输入名称并进入代理设置">
  1. 在 **“基本配置”** 页面，找到 **“显示名称”** 字段。
  2. 输入一个便于识别的名称，以便日后管理。

  <Frame as="div">
        <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin3.png?maxW=803&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8d15a3d1bd5e4ab45521a34673985e4a" alt="" width="803" height="623" data-path="images/integrations/mulogin3.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin3.png?w=280&maxW=803&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=29742b285749ec78b4a3632e516369b8 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin3.png?w=560&maxW=803&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=21a036b7fd2fb7c41f4128c1fd94915d 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin3.png?w=840&maxW=803&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=0476622960c78e39466665f1afaad3d2 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin3.png?w=1100&maxW=803&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=eab637331f8f027996df9d408362924c 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin3.png?w=1650&maxW=803&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6e8c147f0dee4d817fb31c72f55b2746 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin3.png?w=2500&maxW=803&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=e0fe30fbfd2f003a103d6c65878c032e 2500w" data-optimize="true" data-opv="2" />
  </Frame>

  3. 向下滚动，找到 **“代理设置”** 选项，并点击进入代理配置界面。

  <Frame as="div">
        <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin4.png?maxW=807&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3b679eca9b7df73f1bde0936dfdc9e51" alt="" width="807" height="621" data-path="images/integrations/mulogin4.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin4.png?w=280&maxW=807&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=283e12082ac8fce17fcf99ac686380c5 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin4.png?w=560&maxW=807&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6ce4053ffa9d80f54ccb88f54924cca5 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin4.png?w=840&maxW=807&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=98e74bd754347f0f4d25aaccf708aff9 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin4.png?w=1100&maxW=807&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4d158c3fd7528f5598921870dfb5b9d3 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin4.png?w=1650&maxW=807&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=852f6b6ebf3e6b8a33230328b3ad5c8b 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin4.png?w=2500&maxW=807&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=88cde43b94b55c184cc120298b6c4433 2500w" data-optimize="true" data-opv="2" />
  </Frame>
</Step>

<Step title="输入 Bright Data 代理信息">
  1. 进入代理设置界面后，填写以下信息：

     * **协议/类型**：选择 `HTTP`、`HTTPS` 或 `SOCKS5`（根据您在 Bright Data 购买的代理类型）。
       <Frame as="div">
           <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin5.png?maxW=791&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c77e700aac6d8150bd9f4d90f27fc440" alt="" width="791" height="246" data-path="images/integrations/mulogin5.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin5.png?w=280&maxW=791&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=dbff15002f33bcfeedb806aa62b7e903 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin5.png?w=560&maxW=791&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4c4c0da4ff468e8d26769a1f7a0ee845 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin5.png?w=840&maxW=791&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ded73440586a99857e4f82ae319c812d 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin5.png?w=1100&maxW=791&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b7dffce6a33e934995abff7b4bc0adfb 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin5.png?w=1650&maxW=791&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=0c7c37e116f9044247e23616b2eaf58b 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin5.png?w=2500&maxW=791&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=02e3a2b2f86bf626759597a65a43edbd 2500w" data-optimize="true" data-opv="2" />
       </Frame>

     * **代理地址**：输入 `http://brd.superproxy.io/` 或 Bright Data 提供的地址。

     * **端口号**：填写您在 [Bright Data 仪表盘](https://brightdata.com/cp/zones) 获取的端口号。

     * **用户名 & 密码**：输入您的 Bright Data 账户信息。

     <Note>如果需要使用特定国家的代理出口，请在用户名中添加 `your-username-country-US`（示例为美国）。</Note>

  2. 输入 Bright Data 代理信息后，点击 **“测试代理”** 或 **“检查网络”** 以确保代理连接正常。

  3. 如果测试通过，点击 **“保存”** 确认设置。
</Step>

<Step title="启动浏览器配置文件并验证">
  1. 保存设置后，在 MuLogin 仪表盘中启动该浏览器配置文件。
  2. 进入浏览器后，访问 [httpbin.org/ip](http://httpbin.org/ip) 以确认您的 IP 地址是否已变更为 Bright Data 代理的 IP。
  3. 如果 IP 地址正确匹配，则表示 MuLogin 已成功集成 Bright Data 代理。
</Step>

至此，您已成功在 **MuLogin** 中配置 **Bright Data** 代理。这将大幅提升您的在线操作能力，让您能够更安全地管理多个账户，减少被检测的风险，并保持流畅、稳定的工作流。


# 如何在 Multilogin 中设置 Bright Data
Source: https://docs.brightdata.com/cn/integrations/multilogin

将 Bright Data 集成到 Multilogin 可增强您的多账户管理，提供安全、不可检测的浏览体验，提高隐私性并降低账户被封的风险。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 Multilogin？

Multilogin 是一款强大的浏览器工具，可用于管理多个在线账户，而不会被检测或封禁。它是市场营销人员、电商专业人士、联盟营销人员和增长黑客的热门选择，能够绕过检测相同 IP 地址或设备的限制。

Multilogin 通过创建隔离的、独特的浏览配置文件来模拟不同的设备。每个配置文件看起来都像是从不同的位置或设备访问的，使平台无法关联账户。这确保了更安全、更隐蔽的浏览体验，让您可以放心管理多个账户。

<Tip>
  通过在用户名中使用 `-session` 参数，在整个浏览会话中保持一致的 IP。这一点很重要，因为 Bright Data 代理默认会在每次请求时轮换 IP。[了解更多](https://docs.brightdata.com/cn/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 />

  新用户应从 ISP 代理或数据中心代理开始，因为住宅代理不支持浏览器集成的 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 。<br />

  **账户管理** 相关的用例需要为每个账户分配固定的专用 IP，应使用专用 [ISP 代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction)。
</Tip>

## Multilogin 代理集成

按照以下简单步骤在 Multilogin 中设置 Bright Data 代理：

<Steps>
  <Step title="打开 Multilogin">
    启动 [**Multilogin 应用**](https://multilogin.com/) 并登录您的账户。
  </Step>

  <Step title="创建新配置文件">
    点击 **“新建配置文件”** 并输入以下信息：

    * **配置文件名称**：选择一个易识别的名称（如 *Bright Data*）。
    * **操作系统**：选择与您的原始设置匹配的操作系统（macOS、Windows 或 Linux），以避免指纹不匹配。
    * **存储类型**：如果需要在团队中协作或在多个设备上使用该配置文件，请选择 **云存储**。
    * **浏览器类型**：选择 **Mimic**（基于 Chrome）或 **Stealthfox**（基于 Firefox），它们都具有强大的防检测功能。
  </Step>

  <Step title="添加代理">
    在配置文件设置中，找到 **代理** 选项并选择 **自定义**。
  </Step>

  <Step title="配置 Bright Data 代理">
    按照以下步骤输入您的 Bright Data 代理信息：

    * **代理类型**：选择 `HTTP`、`HTTPS` 或 `SOCKS5`（根据您的 Bright Data 代理类型）。
    * **地址**：输入 `http://brd.superproxy.io/`。
    * **端口**：使用您的 [Bright Data 仪表盘](https://brightdata.com/cp/zones) 提供的端口号。
    * **登录名**：输入您的 Bright Data 代理 `用户名`。
    * **密码**：输入您的 Bright Data 代理 `密码`。

    点击 **检查代理** 以验证连接。

    <Info>
      **如需特定国家/地区的代理，可使用 `your-username-country-US` 格式，以获得美国出口节点。**
    </Info>
  </Step>

  <Step title="保存设置">
    输入完所有代理信息后，点击 **创建配置文件** 以保存设置。
  </Step>
</Steps>

就是这样！您已成功将 Bright Data 代理集成到 Multilogin。


# 如何在 NGINX 中设置 Bright Data
Source: https://docs.brightdata.com/cn/integrations/nginx

将 Bright Data 与 NGINX 集成，可高效地路由流量、隐藏域名，并安全地管理连接。按照本指南配置 NGINX 以使用 Bright Data 代理，提升性能和灵活性。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 NGINX？

**NGINX** 是一个高性能的 Web 服务器和反向代理，常用于负载均衡、缓存和安全连接管理。通过将 NGINX 与 **Bright Data** 集成，您可以隐藏代理域名、无缝路由流量，并优化基础设施以提高性能。

## 如何在 NGINX 中设置 Bright Data

<Steps>
  <Step title="安装 NGINX">
    1. 根据 [官方安装指南](https://nginx.org/en/download.html) 在您的服务器上安装 **NGINX**。
    2. 确保您的版本为 **1.15.10 或更高**。
    3. 确保您的服务器 IP **未** 被添加到 Bright Data 代理白名单，以避免冲突。
  </Step>

  <Step title="配置 NGINX 核心设置">
    1. 打开主 NGINX 配置文件：

    ```bash
    sudo nano /etc/nginx/nginx.conf
    ```

    2. 更新以下参数：
       * **将 `worker_processes`** 设为 `auto`，以实现动态优化。
       * **将 `worker_connections`** 设为 `200`（或更多，具体取决于所需的端口数量）。

    3. 在 `http` 部分的末尾添加：

    ```nginx
    include /etc/nginx/sites-enabled/*;
    ```

    4. 保存更改并退出编辑器。
    5. 更新后的 `nginx.conf` 应如下所示：

    ```nginx
    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="创建代理配置文件">
    1. 创建自定义配置目录：

    ```bash
    sudo mkdir -p /etc/nginx/sites-enabled
    ```

    2. 创建新配置文件：

    ```bash
    sudo nano /etc/nginx/sites-enabled/brightdata.conf
    ```

    3. 添加以下配置，根据需要调整端口范围：

    ```nginx
    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;
        }
    }
    ```

    4. 保存并关闭文件。
  </Step>

  <Step title="重启 NGINX">
    1. 通过以下命令应用更改并重启 NGINX：

    ```bash
    sudo service nginx restart
    ```
  </Step>

  <Step title="测试代理配置">
    1. 运行以下命令验证代理连接，将 `10.0.2.15` 替换为您的服务器 IP：

    ```bash
    curl --proxy http://10.0.2.15:24000 "http://lumtest.com/myip.json" -v
    ```

    2. 确保响应包含预期的代理 IP 和位置信息。

       **预期输出：**

       ```json
       {
         "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="监控 NGINX 流量">
    1. 确保流量通过 NGINX 路由，监控代理管理日志。
    2. 确保 "sent from" IP 与您的 NGINX 服务器 IP 匹配。
  </Step>
</Steps>

您的 **Bright Data** 现已成功集成到 **NGINX**，提供安全、高效的流量路由和域名隐藏功能。此设置非常适合优化网页抓取、负载均衡和安全代理管理。享受更顺畅的操作体验吧！


# 如何在 Octo Browser 中设置 Bright Data
Source: https://docs.brightdata.com/cn/integrations/octobrowser

将 Bright Data 集成到 Octo Browser，以增强您的多账户管理和网页抓取能力，同时提供强大的防检测功能和安全的浏览体验。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 Octo Browser？

Octo Browser 是一款智能工具，可帮助您管理多个在线账户，而不会被检测或封禁。它非常适合营销人员、电商卖家和网页抓取者，让您可以安全地操作多个账户。

Octo Browser 通过创建独立的配置文件，每个文件都有自己独特的设置，如 IP 地址和设备信息，从而确保账户之间不会关联。它支持 HTTP、HTTPS 和 SOCKS5 代理，并提供自动化和团队协作等功能，是一款强大且易于使用的安全高效在线工具。

<Tip>
  在浏览器会话期间保持一致的 IP 地址，需在用户名中使用 `-session` 参数。这很重要，因为 Bright Data 代理默认在每次请求时轮换 IP。[了解更多](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 />

  新用户应从 ISP 或数据中心代理入手，因为住宅代理与 [即时访问模式](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) 的浏览器集成不兼容。<br />

  **账户管理** 相关场景应为每个账户使用一致的专用静态 IP，建议使用专用 [ISP 代理](https://docs.brightdata.com/proxy-networks/isp/introduction)。
</Tip>

## Octo Browser 代理集成

以下是将 Bright Data 代理集成到 Octo Browser 的方法：

<Steps>
  <Step title="安装 Octo Browser">
    下载并安装 [**Octo Browser**](https://octobrowser.net/download/)，然后登录您的账户。
  </Step>

  <Step title="创建配置文件">
    1. 进入 **Profiles**（配置文件）页面，点击 **Create Profile**（创建配置文件）。
    2. 为您的配置文件命名，并设置所需的参数。
  </Step>

  <Step title="添加代理">
    1. 在配置文件设置中，进入 **Connection**（连接）选项卡，并点击 **Proxy**（代理）字段。
    2. 点击 **+ Set a new proxy**（+ 设置新代理）以打开代理配置窗口。
  </Step>

  <Step title="配置 Bright Data 代理">
    在弹出窗口中，输入您的 Bright Data 代理信息：

    * **Host**: 输入 `http://brd.superproxy.io/`。
    * **Port**: 使用您在 [Bright Data 控制面板](https://brightdata.com/cp/zones) 中提供的端口号。
    * **Login**: 输入您的 Bright Data 代理 `username`。
    * **Password**: 输入您的 Bright Data 代理 `password`。

    <Info>
      **如果需要使用特定国家的代理，可以使用格式 `your-username-country-US` 以获取美国出口节点。**
    </Info>
  </Step>

  <Step title="测试代理">
    1. 点击 **Check Proxy**（检查代理）以确保连接正常。
    2. 确认无误后，点击 **Confirm**（确认）以保存代理设置到配置文件。
  </Step>

  <Step title="保存并启动配置文件">
    1. 点击 **Create Profile**（创建配置文件）以保存您的设置。
    2. 在 **Profiles**（配置文件）页面，点击 **Start**（启动）即可运行您配置好的浏览器环境。
  </Step>
</Steps>

就这样！您已成功将 Bright Data 代理集成到 Octo Browser。


# 如何在 Octoparse 中设置 Bright Data
Source: https://docs.brightdata.com/cn/integrations/octoparse

通过将 Bright Data 集成到 Octoparse，提高您的网页抓取效率，确保数据提取的安全性和匿名性，同时降低 IP 封锁风险。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 Octoparse？

Octoparse 是一款用户友好的网页抓取工具，无需任何编程知识即可从网站收集数据。它提供简单的点选界面，使您能够从复杂的网站提取信息。Octoparse 允许自定义、自动化和定时执行抓取任务，并支持将提取的数据保存为 CSV 或 Excel 等格式。无论是市场调研、价格监测，还是潜在客户获取，Octoparse 都能让数据收集变得快速、简单、高效！

## Octoparse 代理集成

按照以下步骤，将 Bright Data 代理集成到 Octoparse：

<Steps>
  <Step title="安装 Octoparse">
    访问 [Octoparse 官网](https://www.octoparse.com/download) 下载并安装该工具。
  </Step>

  <Step title="创建新任务">
    点击左上角的 **+New** 按钮，然后选择 **Custom Task**（自定义任务）。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse1.png?maxW=226&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=1bfc3460f56af977205c51a01f56e145" alt="" width="226" height="175" data-path="images/integrations/octoparse1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse1.png?w=280&maxW=226&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b54988089aaefb6de704da2b14828382 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse1.png?w=560&maxW=226&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3e1327edf072b913f7bca8168da6d295 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse1.png?w=840&maxW=226&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=02a5262205ad205cd92a63579981b898 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse1.png?w=1100&maxW=226&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f9696e7057fc8e3fcf2965d44ce22032 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse1.png?w=1650&maxW=226&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=43db2eac4bb4f64b7d6ee78d10058822 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse1.png?w=2500&maxW=226&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=16109a49718b27371edc19feac9dc0ea 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="输入目标 URL">
    在 **URL Input**（URL 输入）字段中输入要抓取的网站地址，然后点击 **Save**（保存）。
  </Step>

  <Step title="进入代理设置">
    网页加载完成后，进入 **Task Settings > Anti-blocking**（任务设置 > 反封锁）。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse2.png?maxW=468&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=02d68931c5c03da5ec7f62562e33b229" alt="" width="468" height="67" data-path="images/integrations/octoparse2.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse2.png?w=280&maxW=468&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=713b812b71d9be640672df2165cf7847 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse2.png?w=560&maxW=468&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=7622add29b282bc58242dc771fbb8cab 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse2.png?w=840&maxW=468&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=92196f888a7ee239f67be92b49f56349 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse2.png?w=1100&maxW=468&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=7c7d832ed83c7d648d54d93f0c7f9136 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse2.png?w=1650&maxW=468&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b35e36ae75213742371503a02313d390 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse2.png?w=2500&maxW=468&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6fc6c429624d02dd964b273bfb372122 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="启用代理">
    勾选 **Access websites via proxies**（通过代理访问网站），然后选择 **Use my own proxies**（使用自定义代理）。点击 **Configure**（配置）。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse3.png?maxW=796&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8b3799f68618ac7ee5e52e36172f4807" alt="" width="796" height="544" data-path="images/integrations/octoparse3.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse3.png?w=280&maxW=796&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=074728779f7f689ba918b16f86c2da52 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse3.png?w=560&maxW=796&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=0f5ff0473d8755a8ae5e5050ee727379 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse3.png?w=840&maxW=796&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4bb6610b9cddecd6be2f00e46b1c6915 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse3.png?w=1100&maxW=796&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=38248cac3a2fbc1e11496e48616b5297 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse3.png?w=1650&maxW=796&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=495e298ef1e83606faaca8ece76aa32f 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse3.png?w=2500&maxW=796&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f979206ad705ddb4bcd1f2a5179bb982 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="配置 Bright Data 代理">
    在弹出的窗口中，按以下格式输入您的 Bright Data 代理信息：

    ```sh
    IP/host:port:username:password
    ```

    * **IP/host**: 输入 `http://brd.superproxy.io/`。
    * **Port**: 使用您在 [Bright Data 控制面板](https://brightdata.com/cp/zones/page/plans) 中提供的端口号。
    * **Username**: 输入您的 Bright Data 代理 `username`。
    * **Password**: 输入您的 Bright Data 代理 `password`。

    <Info>
      如果需要使用特定国家的代理，可以使用格式 `your-username-country-US` 以获取美国出口节点。
    </Info>

    如果您使用的是轮换代理，可以在 **Switch interval**（切换间隔）中设置 IP 轮换的频率。对于保持会话的代理，请根据需要调整会话时长。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse4.png?maxW=793&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=212abd89c14cc5b93e24026046869137" alt="" width="793" height="543" data-path="images/integrations/octoparse4.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse4.png?w=280&maxW=793&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ef145e1f8c1eeacbc84b6673337d4477 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse4.png?w=560&maxW=793&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=24cb396867fb3922bd3111e793144a48 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse4.png?w=840&maxW=793&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d47a6ec93c66c4f77d3d8c2908c777d0 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse4.png?w=1100&maxW=793&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=0f14ef0b1afd865c34b0b2e79e70524e 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse4.png?w=1650&maxW=793&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c110c36e7c20cfdbce0d6565fee23c46 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse4.png?w=2500&maxW=793&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=238755a9a3124ac8eccf6efd632dcaa1 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="保存设置">
    点击 **Confirm**（确认）以应用更改，然后点击 **Save**（保存）。
  </Step>
</Steps>

就这样！您已成功将 Bright Data 代理集成到 Octoparse。


# 如何在 OpenBullet 中设置 Bright Data
Source: https://docs.brightdata.com/cn/integrations/openbullet

在 OpenBullet 上集成 Bright Data，增强您的自动化工作流程。本指南将帮助您配置 Bright Data，以实现安全高效的操作。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 OpenBullet？

**OpenBullet** 是一款功能强大的自动化和测试工具，通常用于管理和测试 HTTP 请求、抓取数据以及执行自动化工作流程。通过集成 **Bright Data**，您可以确保安全、私密和可靠的连接，同时最大程度地降低被检测或封禁的风险。

## 如何在 OpenBullet 中设置 Bright Data

按照以下步骤，将 **Bright Data** 集成到 OpenBullet：

<Steps>
  <Step title="安装 OpenBullet">
    1. 访问 [OpenBullet GitHub 页面](https://github.com/openbullet/OpenBullet2) 并下载最新版本。
    2. 解压下载的文件，并在您的系统上运行应用程序。
  </Step>

  <Step title="创建代理组">
    1. 在 OpenBullet 仪表板中，进入 **Proxies**（代理）选项卡。
    2. 点击 **Add Group**（添加组）以创建新的代理组。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet1.png?maxW=800&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2dcc6c6dc82a89ed28d6114fd222b92f" alt="" width="800" height="178" data-path="images/integrations/openbullet1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet1.png?w=280&maxW=800&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3ee2915a007fb8be95f24e3548a7efe7 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet1.png?w=560&maxW=800&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5c1ecfbfd98d56e2b8f4052ef9e14680 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet1.png?w=840&maxW=800&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=a7d82346fddcd079fe95da0f5c136990 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet1.png?w=1100&maxW=800&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6cca8208c584024bce60943ee2c608b4 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet1.png?w=1650&maxW=800&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3f0b60e8a5ad34e96171b3cecf096ee7 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet1.png?w=2500&maxW=800&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=60552b63910acbb2f0d54d9d2b10d41e 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    3. 在 **Name**（名称）字段中输入一个描述性名称，以便日后管理和识别。
    4. 点击 **Accept**（接受）以确认并保存代理组。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet2.png?maxW=265&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b1c3a6636aa6f7b11551dcf8093fa6a0" alt="" width="265" height="129" data-path="images/integrations/openbullet2.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet2.png?w=280&maxW=265&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=afe2382849597ddd74a664e8227dc2cf 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet2.png?w=560&maxW=265&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=55f8c2bcebe12c9893b09ee92aa666e0 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet2.png?w=840&maxW=265&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=09633d5b8378cdf3b83899b97dc77814 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet2.png?w=1100&maxW=265&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=797c85594198cc710ea966bb3a9592f1 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet2.png?w=1650&maxW=265&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=63cbba26d2c119c28461ba902e729294 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet2.png?w=2500&maxW=265&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d7d0df30487160b4a3c76b00b8cdfc61 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="添加 Bright Data 代理">
    1. 从代理组列表中选择刚刚创建的组。
    2. 点击 **Import**（导入）以打开代理配置面板。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet3.png?maxW=728&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=7e68c5be07949e8f6254d01601f2493c" alt="" width="728" height="182" data-path="images/integrations/openbullet3.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet3.png?w=280&maxW=728&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=69f654dd36ae26027103654e78e07f7e 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet3.png?w=560&maxW=728&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5edc60b740fbf1f688644e56a5fb5e10 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet3.png?w=840&maxW=728&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=248745ba2001a5c5a33f749567197950 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet3.png?w=1100&maxW=728&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=dbb624285a56b705178974803ef302c9 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet3.png?w=1650&maxW=728&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ef1e111220f0e706d403895266cd5112 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet3.png?w=2500&maxW=728&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5604e7551bd45f343e193d33e089693e 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    3. 在 **Import proxies**（导入代理）窗口：
       * 切换到 **Paste**（粘贴）选项卡。
       * 按以下格式粘贴您的 Bright Data 代理信息：\
         `[HOST]:[PORT]:[USERNAME]:[PASSWORD]`
       * 点击 **Accept**（接受）以保存您的代理设置。

    <Note>
      如果需要特定国家的代理，请调整用户名格式为 `your-username-country-XX`（例如 `your-username-country-US`），以使用特定的出口节点。
    </Note>
  </Step>
</Steps>

通过在 **OpenBullet** 中集成 **Bright Data**，您可以使用安全匿名的连接来增强自动化任务、测试应用程序或抓取数据。Bright Data 可确保稳定的性能和隐私保护。


# 如何设置 Bright Data 与 ParseHub
Source: https://docs.brightdata.com/cn/integrations/parsehub

将 Bright Data 代理与 ParseHub 集成，可增强您的网页抓取能力，提供安全匿名访问，并降低被检测和 IP 封禁的风险。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 ParseHub？

ParseHub 是一款用户友好且功能强大的网页抓取工具，彻底改变了从网络中提取数据的方式。其直观的设计使用户能够轻松与复杂网站交互，处理 AJAX 和 JavaScript 元素，并浏览表单和无限滚动页面，而无需编写任何代码。\
通过将 Bright Data 代理与 ParseHub 集成，用户可获得无与伦比的优势，轻松应对最具挑战性的数据抓取任务。这一组合不仅能确保高效的数据抓取，还能提供高度的隐私和安全性，是专业人士寻求全面数据收集能力的理想解决方案。

## Bright Data 代理：助力您的 ParseHub 体验

将 Bright Data [代理](https://brightdata.com/proxy-types) 与 ParseHub 集成，可彻底改变您的网页抓取能力，为数据提取任务带来更高的效率和可靠性。以下是 Bright Data 代理解决方案为何是 ParseHub 强大抓取功能的理想搭配：

**广泛的代理网络**

* **全球覆盖**：访问 72,000,000+ IP 地址，遍布各个地区，确保您可以抓取任何地理位置的数据。
* **多样化的代理类型**：提供住宅代理、数据中心代理、静态住宅代理和移动代理，以满足不同抓取项目的需求。

**增强的匿名性与安全性**

* **强大隐私保护**：防止抓取活动被检测和拦截，确保操作匿名性。
* **安全数据收集**：借助 Bright Data 的高级安全措施，放心抓取敏感数据。

**高性能与高可靠性**

* **极速与高效**：即使面对复杂、依赖 JavaScript 的网站，也能实现快速高效的数据抓取。
* **稳定的连接性**：凭借 Bright Data 稳定的代理基础设施，减少中断，保持一致的抓取性能。

**多功能且可扩展的解决方案**

* **适用于多种使用场景**：无论是市场调研、网页抓取、SEO 分析，还是竞争情报收集，Bright Data 代理均能满足各种抓取需求。
* **可扩展性**：轻松扩展抓取操作，处理大规模数据，而不会影响速度或准确性。

**用户友好的集成方式**

* **简单的设置**：无论您的技术水平如何，都可轻松将 Bright Data 代理集成到 ParseHub。
* **全面的支持**：Bright Data 提供详尽的文档和客户支持，确保顺利完成集成过程。

## 如何集成 ParseHub 代理：

<Steps>
  <Step title="注册 Bright Data">
    1. 注册后，进入 Bright Data 仪表板
    2. 导航至“**代理和抓取基础设施**”部分
    3. **添加** 一个新的专用 **Zone** 以供代理使用。

    <Frame caption="代理管理界面，显示活动代理和添加按钮">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-add-zone-2.png?maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=e865d5347223966db43a431c475554d2" alt="ph-add-zone-2.png" width="1000" height="324" data-path="images/integrations/ph-add-zone-2.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-add-zone-2.png?w=280&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=72c6a2160f1e78e280ea1a6e9912d31f 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-add-zone-2.png?w=560&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=9248b3af7be976888de90df24ff2a34b 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-add-zone-2.png?w=840&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=1adf8843946853a910ae2c1cd72cb302 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-add-zone-2.png?w=1100&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d2ea222f862d144b901a5429a6cc830a 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-add-zone-2.png?w=1650&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6f6132f3e8b4fa1fa63d9569bfc9937d 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-add-zone-2.png?w=2500&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f128947235c80f94b06f7e7f5f91966a 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="选择代理类型">
    在本示例中，我们将演示如何设置 ISP 代理。

    <Frame caption="代理和抓取基础设施仪表板，显示各种选项">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-types.png?maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=7dca81f5312f83907ad43dd368883e2c" alt="ph-proxy-types.png" width="500" height="257" data-path="images/integrations/ph-proxy-types.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-types.png?w=280&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=0fc57f3b53b8cb06fd086727d9dccd86 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-types.png?w=560&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=80bf74af73757d43248d18616de16b9e 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-types.png?w=840&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=9303b3ed0947784c24be746cab9f62e5 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-types.png?w=1100&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=10cd3f0043aaf8d2e3f5e9762f6c879a 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-types.png?w=1650&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f1c82c3b8a7c92a400ba3fc93c2c6fb8 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-types.png?w=2500&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=6389d5eee629d869aca4dc238d6d704f 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="命名代理解决方案">
    <Frame caption="选择 IP 类型的表单，显示已选择专用选项">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-select-ip-type.png?maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=46b4e1e1ce7fe6a1fdd57290700a340e" alt="ph-select-ip-type.png" width="1000" height="333" data-path="images/integrations/ph-select-ip-type.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-select-ip-type.png?w=280&maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=43b19590b3f49ef08acd80917fc5b67a 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-select-ip-type.png?w=560&maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=4198f37c09067caaf9159b1efc388b50 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-select-ip-type.png?w=840&maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=83f0c8e7bb38394cb976b7cf69afd7cf 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-select-ip-type.png?w=1100&maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=3b63d8447683f45007abe8de6fce4e7c 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-select-ip-type.png?w=1650&maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f4c74b52facd41312116a4cfa9a9e82a 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-select-ip-type.png?w=2500&maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=d51537fb6cd44530d673cec42d4e04a4 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="选择 IP 数量">
    填写所需的 IP 数量。

    <Frame>
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-number-of-ips-1.png?maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f0c036e720da6d625b1bda23cebbd790" alt="ph-number-of-ips-1.png" width="1000" height="164" data-path="images/integrations/ph-number-of-ips-1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-number-of-ips-1.png?w=280&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4d4f626ae1d2524527f96f77203a0be0 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-number-of-ips-1.png?w=560&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2d6a7a26d3ab926eb47dc44108f6cb17 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-number-of-ips-1.png?w=840&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=99a44275b1e1550c8df2339c02b4f572 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-number-of-ips-1.png?w=1100&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6b5fb03ed0d5ca9966eb0739fc1007bf 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-number-of-ips-1.png?w=1650&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4178de681e64fdd154c388211ce27d84 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-number-of-ips-1.png?w=2500&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6c3c0aec63318ff7de8cf1af20a55f66 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="国家和城市选择">
    选择所需的 IP 位置的国家和城市。

    <Frame caption="针对美国和纽约市的地理定位选项">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-city-ip.png?maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c149141b955856b7fe6087c9df32684b" alt="ph-city-ip.png" width="1000" height="197" data-path="images/integrations/ph-city-ip.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-city-ip.png?w=280&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4b05ea0fd42f3e3aba6eaad6e9e8fae5 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-city-ip.png?w=560&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6bbee0ebfb0b6e1a9c8fc36a11d22752 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-city-ip.png?w=840&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ab1efe2db4313e373ece9461aa093c42 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-city-ip.png?w=1100&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=7e06daeee9d42c2c8c78ee22549edff2 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-city-ip.png?w=1650&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=efbc23993271e10874e5dfcbd8a6bab8 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-city-ip.png?w=2500&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=9934bf090af78fce1dbeb23fd9ef999d 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="选择域名">
    使用特定域名，或选择“所有域名”以便一个 IP 可用于访问多个网站。

    <Frame>
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-domains.png?maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=18f9e64b5b0017a645cb84bbc54b59ee" alt="ph-domains.png" width="1000" height="178" data-path="images/integrations/ph-domains.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-domains.png?w=280&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ff3f5f2f683ce380b63f15a1b93febc9 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-domains.png?w=560&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=37c8fbeb8a6ed0cdfb3e7cfb2b66e077 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-domains.png?w=840&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5a383c550b1176a228b8ca9a9961eeb3 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-domains.png?w=1100&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=503484a1f9ff30ab9609814f5ede38da 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-domains.png?w=1650&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b1cbf188029e85c72f58ce94e991931d 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-domains.png?w=2500&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=db46e9c512778daf64c665743f1ca3fe 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="添加 Zone">
    点击“**添加**”按钮以创建 Zone。

    <Frame>
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-click-add.png?maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=03cd2d1885ebf785e9bcb89e1a83f18e" alt="ph-click-add.png" width="1000" height="288" data-path="images/integrations/ph-click-add.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-click-add.png?w=280&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=355b8965a287f5270f16a7a4a697f06e 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-click-add.png?w=560&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=38a3cef105cc55fa248b9294bebf5a8b 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-click-add.png?w=840&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c9d6ff125f1aaed720b0a8d3cb46be7d 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-click-add.png?w=1100&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=a84265f70f84fde3452afd422daf6ee2 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-click-add.png?w=1650&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=9e03174918fefa5003ddc26ae2508c9e 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-click-add.png?w=2500&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d21d8926a37ab17be1009b10ec42d724 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="访问参数">
    点击您的 Zone 名称，导航到“访问参数”选项卡，并记录代理凭据：

    <Frame caption="代理服务访问参数界面，显示主机和用户名">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-parameters.png?maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ccb8c0133be1731d42667dcea8e3c36c" alt="ph-access-parameters.png" width="1000" height="625" data-path="images/integrations/ph-access-parameters.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-parameters.png?w=280&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=084a1563e1c6533cdd7b3ec62153780b 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-parameters.png?w=560&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=96831236660bc9116c42351a327ef193 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-parameters.png?w=840&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=eb63f6f07b46338211359499ac8b671f 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-parameters.png?w=1100&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c52dcda3674bb84c7a45d5ce5c782ec7 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-parameters.png?w=1650&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=35ca51db05d3fd3c0dfa7318137e3e2e 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-parameters.png?w=2500&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=cb6e0763c1df099fe8dd693635cf0e58 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    1. host: brd.superproxy.io
    2. port: 33335
    3. username: `your-zone-username`
    4. password: `your-zone-password`
  </Step>

  <Step title="下载并安装 ParseHub">
    <Frame caption="ParseHub 下载选项：Mac、Windows、Linux">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-parsehub.png?maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=11b9881a3dc14aed4f37e10196da73d6" alt="ph-parsehub.png" width="512" height="320" data-path="images/integrations/ph-parsehub.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-parsehub.png?w=280&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=9e3e36146d9bf9bbad4496e861c069ed 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-parsehub.png?w=560&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=eb486294d04f7888fc41ed79e67ca3c8 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-parsehub.png?w=840&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=668c02242a6364fcc565c7051b81a03e 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-parsehub.png?w=1100&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=81eaea561320394d5a691a2c19ae6c81 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-parsehub.png?w=1650&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=2c78c16bde042145e3a7a06977fb09f8 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-parsehub.png?w=2500&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=cde498112d5e7ff65a988317f6b15921 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    * 访问 ParseHub 官方网站，下载并安装适用于您的操作系统的 ParseHub 应用程序。
    * 启动 ParseHub，并创建新账户或登录现有账户。
  </Step>

  <Step title="创建新项目">
    点击 ParseHub 主页上的“+ 新项目”按钮。

    <Frame caption="仪表板，显示项目创建和教程界面">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-create-a-new-project.png?maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c9162e6f709c5234936ed43d00626402" alt="ph-create-a-new-project.png" width="512" height="280" data-path="images/integrations/ph-create-a-new-project.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-create-a-new-project.png?w=280&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=a24fcb6a2f12c1408918926f3dcc2ce3 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-create-a-new-project.png?w=560&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2e10c6c1397d66fccdce7fb4c36f7bb4 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-create-a-new-project.png?w=840&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=dff442a7c3be3158dab4fffde1b7ae66 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-create-a-new-project.png?w=1100&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=bfbbd8177c4b2010323833630bd50345 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-create-a-new-project.png?w=1650&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=a963f9af99a60fe2a41792e16579d9e1 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-create-a-new-project.png?w=2500&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ea316f62eedf64cb1fbcf460a6063181 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="使用 URL 启动新项目">
    输入您想要抓取数据的网址（例如 instagram.com），然后点击“在此 URL 上启动项目”。

    <Frame caption="网页抓取工具界面，显示教程和说明">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-start-new-project.png?maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=b330e93a2137d7c68634436d9fd3016e" alt="ph-start-new-project.png" width="512" height="280" data-path="images/integrations/ph-start-new-project.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-start-new-project.png?w=280&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=55ca046cdd6086a53a1b4acd6625f250 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-start-new-project.png?w=560&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8a00b920e16043be391b45a76a07a8e2 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-start-new-project.png?w=840&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=0234833894a868994e5e75a2aac819b3 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-start-new-project.png?w=1100&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f8ef0c34edb334036db7b4771b6e004d 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-start-new-project.png?w=1650&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=da3173688c2bd366d93bb9e8efee8c6b 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-start-new-project.png?w=2500&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=7356f93338f5553944ed02d7eb392286 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="导航到 ParseHub 代理配置">
    切换到浏览器模式，滑块变绿表示已启用浏览模式。

    <Frame caption="Instagram 登录页面，显示图片预览">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-broswer-mode.png?maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=aa588e32c516dd48f2cf823e441fc6c2" alt="ph-broswer-mode.png" width="512" height="280" data-path="images/integrations/ph-broswer-mode.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-broswer-mode.png?w=280&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=02404458d7928ab32dd9c66fa7b0ce4b 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-broswer-mode.png?w=560&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=cef322e7cc9e8c7c95098572d7c453f0 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-broswer-mode.png?w=840&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5348bd9cd30c8294f603fbf6a403ea18 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-broswer-mode.png?w=1100&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=89c90a42e8d55da315a5748222279978 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-broswer-mode.png?w=1650&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=a3a0e7a33fd3c16a0a2e3d86b1db9da2 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-broswer-mode.png?w=2500&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=eb4468264424d2f7dc1d70bf41f6a7f5 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="设置">
    打开浏览器界面右上角的设置，然后点击“选项”。

    <Frame caption="Instagram 网页，显示手机屏幕模拟工具">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-open-settings.png?maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=355ebefafb2cc9dab985729b2a9ed182" alt="ph-open-settings.png" width="512" height="280" data-path="images/integrations/ph-open-settings.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-open-settings.png?w=280&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=551b469cfeae540327e70fdd3d7a55a9 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-open-settings.png?w=560&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8aff1c454560a0f67ccfa56fad9cad78 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-open-settings.png?w=840&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=5260f87283fa52228b7b043243328b4e 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-open-settings.png?w=1100&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=76bac72b5d8104d168fb44fb552d3c65 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-open-settings.png?w=1650&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=cf433383bdfb217eb5d1bf840b3eab94 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-open-settings.png?w=2500&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=e6d6e239d0f2f91e2a3366e0c66b0863 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="访问高级网络设置">
    选择“高级”选项卡。

    <Frame>
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-advanced-network-settings.png?maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=eb4af16d32a5176dbdafcce5fe21db27" alt="ph-advanced-network-settings.png" width="512" height="280" data-path="images/integrations/ph-advanced-network-settings.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-advanced-network-settings.png?w=280&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=e88b0b5f43e7da21d459c3a9cee296eb 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-advanced-network-settings.png?w=560&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=9a004734ec38828e9e3d1c2bda776506 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-advanced-network-settings.png?w=840&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=39439cd7887c3b9a6ebdcfa53868fcec 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-advanced-network-settings.png?w=1100&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=a2d790d39bbfcbbf9ea0b188c9205292 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-advanced-network-settings.png?w=1650&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8a20c8ea968f7aac2bef352f3612624a 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-advanced-network-settings.png?w=2500&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=db36177930c1714615299288c0bdd5e1 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="点击“网络”选项卡">
    在“连接”部分选择“设置”。

    <Frame caption="浏览器设置和错误消息界面">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-connection-settings.png?maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ab1a9bd238201f92798760ef4318c1cd" alt="ph-connection-settings.png" width="512" height="280" data-path="images/integrations/ph-connection-settings.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-connection-settings.png?w=280&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=0caecea82919b2ee5c00bfa0f3e37052 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-connection-settings.png?w=560&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=1bb8880950d5715ace7c7b24a7cf6029 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-connection-settings.png?w=840&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5515bac98068f0a4086edda11b094208 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-connection-settings.png?w=1100&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=1301bbfdd3406d491e71637d8d7efc34 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-connection-settings.png?w=1650&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=65b9a3e5c2a39d716a7e3a0f24fc5e43 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-connection-settings.png?w=2500&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6b2214ef564a47a403437ed20c309a2c 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="配置手动代理设置">
    在网络设置中，选择“手动代理配置”。

    <Frame caption="在浏览器选项中配置手动代理设置">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-configure-manual-settings.png?maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b90bdeac34f3931759373ff64cf27745" alt="ph-configure-manual-settings.png" width="512" height="280" data-path="images/integrations/ph-configure-manual-settings.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-configure-manual-settings.png?w=280&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=aef3a7af5c9317142c73ef8e9febfe45 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-configure-manual-settings.png?w=560&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ba30f02fad74c8ed9202ba3e02679f60 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-configure-manual-settings.png?w=840&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=15674a55f2329d66621602858eb0396b 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-configure-manual-settings.png?w=1100&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8d4b3cb882c28c444fa42679631b4450 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-configure-manual-settings.png?w=1650&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=108a6d938a3d601bfbfe81207d463f23 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-configure-manual-settings.png?w=2500&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b8b8bf44acd17b738ef7a3c1801ffbee 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="代理设置">
    在 HTTP 代理字段中输入 Bright Data 代理 URL **brd.superproxy.io**，端口设为 **33335**。

    <Frame caption="浏览器窗口中的代理配置设置截图">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-and-port.png?maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=ecd83aff8ceadd658221856fd38bd30d" alt="ph-proxy-and-port.png" width="512" height="280" data-path="images/integrations/ph-proxy-and-port.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-and-port.png?w=280&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=80b288264ee7ce25c765803feed36ca6 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-and-port.png?w=560&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=66d17953565e789270cdffd7881a9b83 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-and-port.png?w=840&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=555ff3d765da1504edf9b76c62d6612f 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-and-port.png?w=1100&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8e2b091625f62c9b7550e18fad2b19f0 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-and-port.png?w=1650&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=c055e5016fa96efb99f3e45c7d8a9fca 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-and-port.png?w=2500&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=65182a62d6f7e8d69769cbbeb1a799e9 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="切换到 SOCKS v4 并点击 OK">
    切换到 SOCKS v4 后，点击“OK”按钮。

    <Frame caption="浏览器选项窗口中配置代理设置">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-switch-to-socks.png?maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=42ad62ba3fcd311c8dad5505e04fc18a" alt="ph-switch-to-socks.png" width="512" height="280" data-path="images/integrations/ph-switch-to-socks.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-switch-to-socks.png?w=280&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=d0d9f4bdc2f66ee6806111976373cc53 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-switch-to-socks.png?w=560&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=59c8bfa015c4b87488c656fc1645a142 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-switch-to-socks.png?w=840&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=19027b0bdec6efc1c0725093d9a399b4 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-switch-to-socks.png?w=1100&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=ba9da3d46d2208fc90953f92e6e3e5c2 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-switch-to-socks.png?w=1650&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=20040404b7161a091c1bbaeccf3def46 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-switch-to-socks.png?w=2500&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=ef6356ae248a1ff83df6fc62f2a6e94b 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="代理 Zone 凭据">
    输入您的代理 Zone 凭据，这些信息可以在您的代理 Zone 访问参数中找到。

    <Frame caption="计算机屏幕上的密码身份验证弹出窗口">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-param-parsehub.png?maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c65c26905c8f562c33f1ac5193b0a046" alt="ph-access-param-parsehub.png" width="512" height="274" data-path="images/integrations/ph-access-param-parsehub.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-param-parsehub.png?w=280&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4ca6a1b3d94851c238ef23a28183d64b 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-param-parsehub.png?w=560&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=03a9454c8809e06c11ee92a2183436e4 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-param-parsehub.png?w=840&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f1a08ed03dc03d9f27243c1483e5b026 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-param-parsehub.png?w=1100&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b0f41e83478094d69b45d613410da2a7 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-param-parsehub.png?w=1650&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=51ba33e6f48ec21b7966c94c710772ad 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-param-parsehub.png?w=2500&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=43acca334e608abe0085d8fd6d32d972 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="格式化代理配置">
    * 按以下格式填写您的代理信息：IPAddress:Port:Username:Password:Realm。
    * 对于 Bright Data 代理，格式如下：\
      `brd.superproxy.io:33335:brd-customer-hl_******-zone-isp_proxy6:b1s*****:Luminati`

    应用已配置的代理到 ParseHub 项目：

    * 导航至 ParseHub 项目设置。

    <Frame caption="Instagram 网页，显示设置菜单">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-project-settings.png?maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=75ab9a57fe2642e2c29e8758da4f46ed" alt="ph-project-settings.png" width="512" height="280" data-path="images/integrations/ph-project-settings.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-project-settings.png?w=280&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=bbb7702c34b28c6991ec28d1f7b6af7f 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-project-settings.png?w=560&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=6e69cc49243890b56b981db72bc00483 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-project-settings.png?w=840&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=cbf89b2916ce5829047ba1ccbbedbc00 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-project-settings.png?w=1100&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=756153f807c31d43b716bfe379d47806 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-project-settings.png?w=1650&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=746fdab9aa36f8898acb4d836f2c2712 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-project-settings.png?w=2500&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=a6930f9db76b6755814c99ef40547479 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="启用自定义代理">
    勾选“轮换 IP 地址”以启用“自定义代理”文本框。

    <Frame caption="Instagram 抓取工具界面，显示数据提取">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies.png?maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=a0732c1c58e5482c241003cff60dcd57" alt="ph-custom-proxies.png" width="512" height="280" data-path="images/integrations/ph-custom-proxies.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies.png?w=280&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=63045677140b2533e742421515575d08 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies.png?w=560&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f8330e65f13db643dbd9491ac39dac20 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies.png?w=840&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d3782bf2ea050d44b15b8256a67e4b05 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies.png?w=1100&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=73766e62a83e734e452ee93a7ead3e25 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies.png?w=1650&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3ae6395ba7f1a9af79dbb11a5fb5756b 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies.png?w=2500&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6497605fd376daff5af9f57d9da697d8 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="自定义代理字段">
    将格式化后的代理粘贴到“自定义代理”字段中。对于多个代理，每行输入一个。

    <Frame caption="Instagram 界面，显示用户对话和登录页面">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies-field.png?maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=aa9441b332c503202854380702133e08" alt="ph-custom-proxies-field.png" width="512" height="280" data-path="images/integrations/ph-custom-proxies-field.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies-field.png?w=280&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=46633c11acf3eb0972dc84b62f0b1624 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies-field.png?w=560&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d0ffb87cc964ce0b1721dcdb4348abd6 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies-field.png?w=840&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=00bc0f27860e42386c9645e80ef9987c 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies-field.png?w=1100&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=9fb836aa43264e8213cf0142204cc8e5 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies-field.png?w=1650&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f972a437832132123f750f18438cc941 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies-field.png?w=2500&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=1c96a67b498ded9953f37184f23ec219 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="保存您的项目设置">
    保存后，使用 Bright Data 代理运行项目。

    <Frame caption="Instagram 登录页面，显示手机消息界面">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-save-project.png?maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=26695c85722f965971a97dc7a6f0831e" alt="ph-save-project.png" width="512" height="280" data-path="images/integrations/ph-save-project.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-save-project.png?w=280&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=118c43e2b37cf2f7820d26c8fdcae11c 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-save-project.png?w=560&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=e4b69bf8d95a29c44ed547578d1f8b80 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-save-project.png?w=840&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=dd66d04eb0ae09cc61bf43ed5ef12393 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-save-project.png?w=1100&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=6578d94569e13b8d1d74dd42c1da88ab 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-save-project.png?w=1650&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=3ceb8e1d37ac563862281dc294537fc3 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-save-project.png?w=2500&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=4d23ac963999241b9d8463e05827168c 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>
</Steps>

<Warning>
  **重要提示**：

  如果您使用 Bright Data 的住宅代理、Unlocker API 或 SERP API，则需要安装 SSL 证书，以启用与目标网站的端到端安全连接。

  这个过程很简单，请参阅[本指南](/cn/general/account/ssl-certificate#installation-of-the-ssl-certificate)了解安装说明。
</Warning>


# 如何在 PhantomBuster 中设置 Bright Data
Source: https://docs.brightdata.com/cn/integrations/phantombuster

准备好提升您的自动化工作流程了吗？将 Bright Data 连接到 PhantomBuster，以实现更流畅、更安全、更高效的数据采集体验。在隐藏在线足迹并提升性能的同时，您可以专注于获取有价值的见解，而无需处理技术难题。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 PhantomBuster？

PhantomBuster 是一个基于云的平台，可将繁琐的在线任务转化为高效的自动化流程。无需手动处理重复任务或费力获取所需数据，它会在后台完成繁重的工作，让您专注于探索机会、触达新受众并推动可衡量的成果。

<Tip>
  在浏览器会话期间保持一致的 IP，方法是在用户名中使用 `-session` 参数。这一点很重要，因为 Bright Data 代理默认情况下会在每次请求时更换 IP。[了解更多](https://docs.brightdata.com/cn/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 />

  新用户应从 ISP 或数据中心代理开始，因为住宅代理在 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 下无法与浏览器集成。<br />

  **账户管理** 相关的使用场景应为每个账户使用专属的静态 IP。应使用专属的 [ISP 代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction) 进行管理。
</Tip>

## 如何将 Bright Data 与 PhantomBuster 集成

将 Bright Data 代理集成到 PhantomBuster 中有助于保持匿名性、降低封锁风险并优化整个操作流程。只需按照以下步骤操作：

<Steps>
  <Step title="打开代理设置">
    登录您的 [PhantomBuster 账户](https://phantombuster.com/) 后，进入 **Proxies**（代理）设置页面。在这里，您可以配置连接，以确保自动化任务的安全性和隐私性。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster1.png?maxW=187&auto=format&n=lafG1dG0XmKZiP70&q=85&s=be681b19bdc29590bd7fd21bfc82a1e3" alt="" width="187" height="381" data-path="images/integrations/phantombuster1.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster1.png?w=280&maxW=187&auto=format&n=lafG1dG0XmKZiP70&q=85&s=28096c47fb38aaf70b9ccdd208b8ae36 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster1.png?w=560&maxW=187&auto=format&n=lafG1dG0XmKZiP70&q=85&s=37fc99a2e1c47d6856018b889664dadf 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster1.png?w=840&maxW=187&auto=format&n=lafG1dG0XmKZiP70&q=85&s=6a34a266f0c56cd6afabd99504b01f67 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster1.png?w=1100&maxW=187&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8eb6b10ac8c939c696e9e0213df9f5f6 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster1.png?w=1650&maxW=187&auto=format&n=lafG1dG0XmKZiP70&q=85&s=42bfb2eaeedded391c5edb0bf42aea54 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster1.png?w=2500&maxW=187&auto=format&n=lafG1dG0XmKZiP70&q=85&s=261f9455a2ec42019405d803cd53f23a 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="创建新的代理池">
    点击 **"New proxy pool"**（新建代理池），创建一个专门存储 Bright Data 代理的集合。将其视为管理代理资源的安全存储库。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster2.png?maxW=926&auto=format&n=lafG1dG0XmKZiP70&q=85&s=50e7d8dec4d46af3140b99a282533800" alt="" width="926" height="569" data-path="images/integrations/phantombuster2.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster2.png?w=280&maxW=926&auto=format&n=lafG1dG0XmKZiP70&q=85&s=fe3fd59642161a782d7e5e6b2086d739 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster2.png?w=560&maxW=926&auto=format&n=lafG1dG0XmKZiP70&q=85&s=cbf36ff5711635172f13bd2a8f94c92a 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster2.png?w=840&maxW=926&auto=format&n=lafG1dG0XmKZiP70&q=85&s=300a9859743475dd1194afa88762acd6 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster2.png?w=1100&maxW=926&auto=format&n=lafG1dG0XmKZiP70&q=85&s=bcf454585088285aa5efe29814ddd334 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster2.png?w=1650&maxW=926&auto=format&n=lafG1dG0XmKZiP70&q=85&s=99afca12ce2a9a67f5520f36575a71a3 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster2.png?w=2500&maxW=926&auto=format&n=lafG1dG0XmKZiP70&q=85&s=18fd85ea12ad455b387c24acb254d692 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="命名您的代理池">
    为您的代理池设置一个清晰且易记的名称。当您处理多个项目或任务时，可以迅速识别适用于特定情况的代理池。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster3.png?maxW=532&auto=format&n=lafG1dG0XmKZiP70&q=85&s=dcf77dbd6a3d42ead44d4ee0811138f6" alt="" width="532" height="246" data-path="images/integrations/phantombuster3.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster3.png?w=280&maxW=532&auto=format&n=lafG1dG0XmKZiP70&q=85&s=ec98c5370cbb534f3df41bb1c88fe7b1 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster3.png?w=560&maxW=532&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8d4466904bc0b27e726f113b478fa882 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster3.png?w=840&maxW=532&auto=format&n=lafG1dG0XmKZiP70&q=85&s=27d2689c3468be9a02b4cad0a4adefc3 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster3.png?w=1100&maxW=532&auto=format&n=lafG1dG0XmKZiP70&q=85&s=50451891dd14d6085dab36343a039456 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster3.png?w=1650&maxW=532&auto=format&n=lafG1dG0XmKZiP70&q=85&s=e422469eaeb2458c20c3190b6b8b771d 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster3.png?w=2500&maxW=532&auto=format&n=lafG1dG0XmKZiP70&q=85&s=0431694aa29768eb5ef11b0198e0f61f 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="添加 Bright Data 代理详情">
    按照以下格式输入您的 Bright Data 代理凭据：
    `host:port:username:password`

    您可以在 [Bright Data 仪表板](https://brightdata.com/cp/zones/page/plans) 中找到这些详细信息。
    输入后，点击 **"Add proxy"**（添加代理）完成操作。您的新代理池现在已准备好作为您的数字防护盾。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster4.png?maxW=1583&auto=format&n=lafG1dG0XmKZiP70&q=85&s=c60be40bd19f4c0263a06ff7283bba96" alt="" width="1583" height="373" data-path="images/integrations/phantombuster4.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster4.png?w=280&maxW=1583&auto=format&n=lafG1dG0XmKZiP70&q=85&s=a0cac4de477e8fd12c668be9785a6eb0 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster4.png?w=560&maxW=1583&auto=format&n=lafG1dG0XmKZiP70&q=85&s=0057bc6ba14f6b44fece599a3ddff849 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster4.png?w=840&maxW=1583&auto=format&n=lafG1dG0XmKZiP70&q=85&s=bc3f3b1b13f144ad7da7dc9e967121ae 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster4.png?w=1100&maxW=1583&auto=format&n=lafG1dG0XmKZiP70&q=85&s=6ab2c626fd8764ca3e79ca2a7e15bc5f 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster4.png?w=1650&maxW=1583&auto=format&n=lafG1dG0XmKZiP70&q=85&s=53bba5679fadb3cd4231c5af195de542 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster4.png?w=2500&maxW=1583&auto=format&n=lafG1dG0XmKZiP70&q=85&s=a5ad3123d83729c238c1fe9f5ef55ea8 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="在 Phantom 的高级设置中调整配置">
    在设置 Phantom（PhantomBuster 工作流）时，打开 **Advanced settings**（高级设置），选择您创建的代理池。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster5.png?maxW=442&auto=format&n=lafG1dG0XmKZiP70&q=85&s=2cf7be7e4dc6cd158939b9be607d2b19" alt="" width="442" height="303" data-path="images/integrations/phantombuster5.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster5.png?w=280&maxW=442&auto=format&n=lafG1dG0XmKZiP70&q=85&s=b1fe2bd5c0e272f2566182df5964841b 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster5.png?w=560&maxW=442&auto=format&n=lafG1dG0XmKZiP70&q=85&s=2cd07aa39d456641a8f948e994df1293 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster5.png?w=840&maxW=442&auto=format&n=lafG1dG0XmKZiP70&q=85&s=e48fd90540df6d0d610cf883c1927ab4 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster5.png?w=1100&maxW=442&auto=format&n=lafG1dG0XmKZiP70&q=85&s=108071b363b766579a4340427555cf19 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster5.png?w=1650&maxW=442&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8344314b47ec77040ddb36792b6b6cd5 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster5.png?w=2500&maxW=442&auto=format&n=lafG1dG0XmKZiP70&q=85&s=b2b5b6257f54a2d06b198ee79a2c196c 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="应用代理池">
    在 **Advanced settings**（高级设置）中，选择您刚刚配置的代理池。
    点击 **"Save settings"**（保存设置）以确认更改。
    从现在开始，您的 Phantom 任务将在 Bright Data 代理的保护下安全运行。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster6.png?maxW=742&auto=format&n=lafG1dG0XmKZiP70&q=85&s=d0b04c7f17fda1f2c43aac458f1174ad" alt="" width="742" height="530" data-path="images/integrations/phantombuster6.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster6.png?w=280&maxW=742&auto=format&n=lafG1dG0XmKZiP70&q=85&s=c641f4c2bc64138f06fdc545c668809d 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster6.png?w=560&maxW=742&auto=format&n=lafG1dG0XmKZiP70&q=85&s=45cadf135a4244ff690ae2e83c226716 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster6.png?w=840&maxW=742&auto=format&n=lafG1dG0XmKZiP70&q=85&s=4419e6534c2b653f8c604a96a57f49bc 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster6.png?w=1100&maxW=742&auto=format&n=lafG1dG0XmKZiP70&q=85&s=88bf28a594fe98a07903488dc53dc37b 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster6.png?w=1650&maxW=742&auto=format&n=lafG1dG0XmKZiP70&q=85&s=3e9733c1c844e6f676f6dad49424c12e 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster6.png?w=2500&maxW=742&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8cba1b5cda08d18c1271c7d743e87c02 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>
</Steps>

**恭喜！您的 Bright Data 代理已成功集成到 PhantomBuster！**\
这意味着您可以更安心地运行自动化任务：您的身份保持隐藏，封锁风险降低，数据采集更加高效。尽情探索、创新，并取得成果，而无需纠结于技术难题。


# 如何在 Playwright 中设置 Bright Data
Source: https://docs.brightdata.com/cn/integrations/playwright

使用 Bright Data 和 Playwright 简化您的网页自动化流程。本指南将向您展示如何配置安全、匿名的代理，以降低检测风险并确保任务顺利运行。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 Playwright？

Playwright 是一个强大的 Node.js 工具包，可用于一次性自动化多个主流浏览器。无论您是在抓取数据、测试应用程序，还是构建无缝的自动化流程，Playwright 的统一接口和强大功能都能帮助您在不影响质量的情况下更快完成任务。

<Tip>
  通过在用户名中使用 `-session` 参数，确保整个浏览器会话保持相同的 IP 地址。这一点很重要，因为 Bright Data 代理默认会在每个请求之间更换 IP。[了解更多](https://docs.brightdata.com/cn/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session)

  新用户应从 ISP 或数据中心代理入手，因为住宅代理在 [即时访问模式](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#immediate-access) 下不兼容浏览器集成。

  对于 **账户管理** 相关的用例，应为每个账户使用一致的专用静态 IP。建议使用 [ISP 专用代理](https://docs.brightdata.com/cn/proxy-networks/isp/introduction)。
</Tip>

## 如何集成 Bright Data 与 Playwright

### 前提条件

1. **Node.js**：从 [nodejs.org](https://nodejs.org/) 下载并安装最新版本。

2. **Playwright 包**：在您的项目中添加 Playwright：

```bash
npm install playwright
```

### 获取您的 Bright Data 凭据

登录您的 [Bright Data 控制面板](https://brightdata.com/cp/zones/page/plans)，并获取以下信息：

* **主机 (Host)**：`http://brd.superproxy.io/`
* **端口 (Port)**：`33335`
* **用户名 (Username)**：输入您的 Bright Data `username`。
* **密码 (Password)**：输入您的 Bright Data `password`。

您需要这些信息进行代理身份验证。

### 配置 Playwright 以使用 Bright Data

1. **设置代理服务器**：在浏览器启动选项中包含您的 Bright Data 主机和端口。格式为 `host:port`。

2. **添加身份验证**：提供您的 Bright Data **`username`** 和 **`password`** 以确保安全访问。

### 示例代码

使用以下示例代码开始：

```javascript
const { chromium } = require('playwright');

(async () => {
  // 使用代理设置启动浏览器
  const browser = await chromium.launch({
    headless: false,  // 设置为 true 以启用无头模式
    proxy: {
      server: 'http://[HOST]:[PORT]',  // 替换为您的代理主机和端口
      username: '[USERNAME]',        // 替换为您的代理 `username`
      password: '[PASSWORD]'         // 替换为您的代理 `password`
    }
  });

  const context = await browser.newContext();
  const page = await context.newPage();

  // 访问 IP 验证网站以测试代理
  await page.goto('http://httpbin.org/ip');
  // 截取屏幕截图以验证设置
  await page.screenshot({ path: 'example.png' });

  await browser.close();
})();
```

通过将 **Bright Data** 集成到 **Playwright**，您的自动化流程将更加安全且隐蔽。享受更快的工作流、降低检测风险，并在抓取、测试和自动化任务时更加安心。


# 如何使用 Postern 设置 Bright Data
Source: https://docs.brightdata.com/cn/integrations/postern

将 Bright Data 与 Postern 集成，以轻松管理您的代理配置。按照本指南安全配置代理，实现高效、无缝的浏览体验。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 Postern？

Postern 是一款 Android 代理管理工具，允许用户通过代理路由应用流量，实现安全和私密的连接。它支持 HTTP、HTTPS 和 SOCKS5 代理，是管理网络连接和优化工作流程的多功能工具。

## 如何使用 Postern 设置 Bright Data

<Steps>
  <Step title="下载并安装 Postern">
    1. 在 Google Play 商店中搜索 Postern，并在您的 Android 设备上安装该应用。
    2. 打开应用并允许所有必需的权限。
  </Step>

  <Step title="配置代理设置">
    1. 打开 Postern，点击 **Add Proxy** 以开始配置新代理。

    <Frame as="div" style={{width:"50%", height:"auto"}}>
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern1.jpg?maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=9da3305fbefc6c9841eec2d6e9416d24" alt="" width="1080" height="583" data-path="images/integrations/postern1.jpg" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern1.jpg?w=280&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=06057deeb2a9ff44ccdd22cb2d38a84e 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern1.jpg?w=560&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f549e9278d3a17aecccc494660866e56 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern1.jpg?w=840&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=739a32d81097f02b8d7ff06c155cb09b 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern1.jpg?w=1100&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=9ef39dd2bd91caf5ba0b571e2f9a300c 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern1.jpg?w=1650&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f5eaebdeea159a93a253f906e2f8a7a0 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern1.jpg?w=2500&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=35304ff767d296934b8ebdd114e89d91 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    2. 填写您的 Bright Data 代理详细信息：
       * **服务器名称**：输入一个描述性名称（例如 "Bright Data Proxy"）。
       * **服务器地址**：`http://brd.superproxy.io/`。
       * **服务器端口**：使用您的 [Bright Data 控制面板](https://brightdata.com/cn/cp/zones/page/plans) 中提供的端口号。
       * **服务器类型**：根据您的代理类型选择 HTTP、HTTPS 或 SOCKS5。
       * **用户名**：输入您的 Bright Data `username`。
       * **密码**：输入您的 Bright Data `password`。

    3. 点击 **Save** 保存代理配置。
  </Step>

  <Step title="配置规则以启用代理">
    1. 进入应用菜单，导航到 **Rules**。

    <Frame as="div" style={{width:"50%", height:"auto"}}>
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern2.jpg?maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=c5d2d14c1976605b9c31c55b79bd8a5c" alt="" width="1080" height="1378" data-path="images/integrations/postern2.jpg" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern2.jpg?w=280&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=2da1a7525f1a1087b1a6639f4e1d62fb 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern2.jpg?w=560&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=1dd179718fb944d723de086488ead579 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern2.jpg?w=840&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=73ceb1c37b0b157730a22ece208f598e 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern2.jpg?w=1100&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=14a46899e9bb0bd2c8e698f815409bf7 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern2.jpg?w=1650&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=ec28857db82fbe80b06883ff9084beb5 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern2.jpg?w=2500&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=464ec3d5c7b89f68726acf1fbff5ccd0 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    2. 点击 **Add Rule** 以创建新的代理规则。

    <Frame as="div" style={{width:"50%", height:"auto"}}>
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern3.jpg?maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=57cc8035c96ed8a527c9bf203e9c8588" alt="" width="1080" height="735" data-path="images/integrations/postern3.jpg" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern3.jpg?w=280&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=da16d8d68ab8154f6b1a534b32baab36 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern3.jpg?w=560&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=28535dc328ee5b01f1e45434e54f16fa 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern3.jpg?w=840&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=a363ee0b6428367b9425ac97901a034f 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern3.jpg?w=1100&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=910abba5062ebae5c8fd1b49066ae615 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern3.jpg?w=1650&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8fa46bd7c9ee6342cde65fcc1c4fc03a 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern3.jpg?w=2500&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=6e3619690cc30f30453dd92b915b0c4a 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    3. 进行以下设置：

    * **匹配方法**：选择 **Match All** 以将所有流量路由至代理。
    * **规则类型**：选择 **Proxy/Tunnel**。
    * **代理/代理组**：确保已选择您配置的代理（例如 `http://brd.superproxy.io/:port`）。

    4. 点击 **Save** 以完成规则配置。
  </Step>

  <Step title="激活代理">
    1. 打开应用菜单，切换 **VPN Off** 以启用连接。
    2. 启用后，所有流量将通过您的 Bright Data 代理进行路由。

    <Frame as="div" style={{width:"50%", height:"auto"}}>
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern4.jpg?maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=ba7b0c0e62bbebdc7448aa66dd610cee" alt="" width="1080" height="1412" data-path="images/integrations/postern4.jpg" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern4.jpg?w=280&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=148058fd40a0caade30aa4faab87d3f4 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern4.jpg?w=560&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=4b82bb87df567fea63ba48463844be25 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern4.jpg?w=840&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=e9b046b33f3d8acd3f46fb33c849a4d3 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern4.jpg?w=1100&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=978ccf1363668523b27e937de509ab25 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern4.jpg?w=1650&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=57e69c9225a02aaaecda2dab7a875ac6 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern4.jpg?w=2500&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=1bb80c268f11476f428fc657ecdb27fe 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    <Note>
      对于地理定位代理，请更新您的用户名格式以包含国家代码（例如 `your-username-country-US`），以便路由至特定位置。
    </Note>
  </Step>
</Steps>

现在，Bright Data 已成功配置到 Postern，您的应用流量将安全、匿名地传输。无论是个人使用还是业务场景，这种设置都能确保隐私和无缝连接。


# 如何在 Postman 中使用 Bright Data
Source: https://docs.brightdata.com/cn/integrations/postman

在 Postman 中使用 Bright Data 以优化 API 测试。本指南将向您展示如何配置代理，以实现安全、匿名和地理定位的 API 请求。

<Accordion title="展开以获取您的 Bright Data 代理访问信息">
  ### 您的代理访问信息

  Bright Data 代理按“代理区域”（Proxy zones）进行分组。每个区域包含其对应的代理配置。&#x20;

  要获取代理区域的访问权限：&#x20;

  1. 登录 Bright Data 控制面板
  2. 选择现有代理区域或新建一个代理区域
  3. 点击新的区域名称，并选择 **概览（Overview）** 选项卡
  4. 在概览选项卡中，找到 **访问详情（Access details）**，并单击复制图标将代理访问信息复制到剪贴板&#x20;
  5. 您需要以下信息：代理主机（Proxy Host）、代理端口（Proxy Port）、代理区域用户名（Proxy Zone username）和代理区域密码（Proxy Zone password）
  6. 点击复制图标，将文本复制到剪贴板，并粘贴到您的工具的代理配置中&#x20;

  ### 访问详情示例

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/image.png" alt="" />

  ### 住宅代理访问

  要使用 Bright Data 的 **住宅代理（Residential Proxies）**，您需要通过合规团队的验证或安装证书。[了解更多...](https://docs.brightdata.com/proxy-networks/residential/network-access)

  ### 目标是搜索引擎？

  如果您的目标是 Google、Bing 或 Yandex 等搜索引擎，则需要使用专门的搜索引擎结果页（**SERP**）代理 API。请使用 Bright Data SERP API 来访问搜索引擎。\
  [点击此处了解 Bright Data SERP 代理 API。](https://docs.brightdata.com/scraping-automation/serp-api/introduction)

  ### 避免工具中的 `PROXY ERROR`

  一些工具会使用搜索引擎作为代理测试目标：如果您的代理测试失败，这可能就是原因。请确保您的测试目标域名不是搜索引擎（此设置在工具配置中，而非 Bright Data 代理的控制范围内）。
</Accordion>

## 什么是 Postman？

Postman 是一个广泛使用的 API 平台，可以简化 API 的测试、开发和管理。它允许开发者发送请求、监控响应，并高效地组织工作流。将 Bright Data 与 Postman 集成可以确保匿名性、安全性，并支持在不同地理位置测试 API。

## 为什么在 Postman 中使用 Bright Data？

* **增强隐私**：隐藏您的 IP 地址，使 API 测试保持匿名。

* **地理特定测试**：使用 Bright Data 代理模拟来自不同国家的 API 请求。

* **提高安全性**：通过安全私密的连接保护您的 API 请求。

## 如何将 Bright Data 集成到 Postman

<Steps>
  <Step title="前提条件" stepNumber="0">
    1. **下载 Postman**：安装最新版本的 [Postman](https://www.postman.com/downloads/)。安装完成后，启动应用并登录您的账户。
    2. **获取 Bright Data 代理凭据**：
       * 登录您的 [Bright Data 控制面板](https://brightdata.com/cn/cp/zones/page/plans) 以获取 **主机 (Host)**、**端口 (Port)**、**用户名 (Username)** 和 **密码 (Password)**。
       * 若需要地理定位代理，请修改用户名格式为 `your-username-country-XX`（例如 `your-username-country-US`）。
  </Step>

  <Step title="访问代理设置">
    1. 在 Postman 界面中，点击右上角的 **齿轮图标** 进入 **设置** 菜单。

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postman1.png?maxW=1920&auto=format&n=lafG1dG0XmKZiP70&q=85&s=c6d25624f548517665d9e91264ba0b38" alt="" width="1920" height="1020" data-path="images/integrations/postman1.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postman1.png?w=280&maxW=1920&auto=format&n=lafG1dG0XmKZiP70&q=85&s=010260d82e0f3abc51b36e1afb753079 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postman1.png?w=560&maxW=1920&auto=format&n=lafG1dG0XmKZiP70&q=85&s=c67435f8ed36851987905b91221a3491 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postman1.png?w=840&maxW=1920&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8afff3450ebcfaa554164303a7e05ce3 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postman1.png?w=1100&maxW=1920&auto=format&n=lafG1dG0XmKZiP70&q=85&s=0fd950a3f8b2cd1267d86658dc2e333f 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postman1.png?w=1650&maxW=1920&auto=format&n=lafG1dG0XmKZiP70&q=85&s=30847d3a98921c7c4b13b7b998a94a80 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postman1.png?w=2500&maxW=1920&auto=format&n=lafG1dG0XmKZiP70&q=85&s=30aa6a16efeab442c9b52b5e4670b5f6 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="配置 Bright Data 代理">
    1. 在左侧菜单中导航到 **Proxy** 选项卡。
    2. 如果 "**Use custom proxy configuration**" 尚未启用，请切换为 *On*。
    3. 输入您的 Bright Data 代理详细信息：
       * **类型 (Type)**：根据 Bright Data 配置选择 HTTP 或 HTTPS。
       * **主机 (Host)**：输入 `http://brd.superproxy.io/`。
       * **端口 (Port)**：使用 [Bright Data 控制面板](https://brightdata.com/cn/cp/zones/page/plans) 提供的端口号。
       * **用户名 (Username)**：输入您的 Bright Data `username`。
       * **密码 (Password)**：输入您的 Bright Data `password`。
  </Step>

  <Step title="测试代理配置">
    1. 在 Postman 中创建一个新的请求，并将方法设置为 **GET**。
    2. 输入以下 URL 以测试代理：[https://httpbin.org/ip](https://httpbin.org/ip)。
    3. 点击 **Send** 以执行请求。

    如果响应中显示的是 Bright Data 代理的 IP 地址，则说明配置成功。
  </Step>
</Steps>

通过在 Postman 中集成 Bright Data 代理，您可以增强 API 测试工作流的隐私性和可靠性。无论是调试、开发还是扩展 API 任务，Bright Data 代理都能提供安全且匿名的连接。立即尝试，优化您的 API 项目！


# 欢迎访问 Scraping Cloud
Source: https://docs.brightdata.com/cn/introduction

Bright Data 提供一系列代理和抓取基础架构解决方案，满足各种使用场景的需求，您可专注进行数据采集，其余工作交由我们的技术人员处理即可。

<div align="center">
  <h2 align="center"> 您想了解什么内容？ </h2>
</div>

<Card>
  <CardGroup cols={2}>
    <Card title="使用代理网络" href="/proxy-networks" icon="globe">
      通过广泛的 IP 池、各种地理位置、弹性 API 等访问网络
    </Card>

    <Card title="自动抓取" href="/scraping-automation" icon="bolt">
      使用 Bright Data 验证码解算器、浏览器、指纹识别技术等提高抓取成功率
    </Card>

    <Card title="获取数据" href="/datasets" icon="table">
      使用预制或定制的数据集查询和分析所需数据
    </Card>

    <Card title="管理账户" href="/general/" icon="wrench">
      自定义和自动化您的 Bright Data 账户操作
    </Card>
  </CardGroup>

  <Card title="网络状态" icon="circle-check" href="https://brightdata.com/network-status">
    查看当前网络状态。
  </Card>
</Card>


# 了解我们的代理产品
Source: https://docs.brightdata.com/cn/know-our-products



Bright Data 为每个用例提供一系列代理和抓取自动化解决方案，使您可以专注于数据收集，其余工作交由我们的技术负责。

请在下方查看我们的代理产品，了解如何精确地集成业界最先进的代理产品和基础架构，以满足您的需求。

## 产品 #1: 解锁抓取解决方案

让我们为您管理完整的代理和解锁基础架构。

<Card>
  **单步抓取** - 您将 URL 传递给我们，而我们负责全面的解锁、验证码、指纹识别等，并返回给您一个干净的页面(HTML、JSON 等):

  <CardGroup>
    <Card title="Unlocker API" icon="unlock" href="https://docs.brightdata.com/scraping-automation/web-unlocker/introduction">
      在不被屏蔽的情况下使用 HTTP/s 请求从任何网站抓取数据
    </Card>

    <Card title="SERP API" icon="magnifying-glass" href="https://docs.brightdata.com/scraping-automation/serp-api/introduction">
      F便于搜索引擎抓取。支持 Google、Bing、雅虎、DuckDuckGo、Yandex、百度和 Naver 搜索 API
    </Card>
  </CardGroup>

  <br />

  **多步抓取** - 通过我们的 API 启动无限制的云托管浏览器会话，同时我们会为您处理完整的解锁基础架构，包括代理、验证码、重试和指纹识别:

  <Card title="Browser API" icon="window-restore" href="https://docs.brightdata.com/scraping-automation/scraping-browser/introduction">
    通过创建浏览器会话并导航到所需的确切数据，从任何网站抓取数据。支持 `puppeteer`、`playwright` 和 `selenium`.
  </Card>
</Card>

## 产品 #2: 代理网络

我们完整的代理网络随时为您服务。

<Card>
  使用来自世界各国的 Bright Data 代理绕过任何位置限制，同时您负责解锁逻辑（验证码解决、指纹识别等）和代理流量管理（使用哪个代理以及何时使用）：

  <CardGroup>
    <Card title="Datacenter" icon="server" href="https://docs.brightdata.com/proxy-networks/data-center/introduction">
      一流的性能和企业级扩展（超过77万个 IP）
    </Card>

    <Card title="ISP" icon="wifi" href="https://docs.brightdata.com/proxy-networks/isp/introduction">
      完全兼容的静态住宅 IP (70万个以上)
    </Card>

    <Card title="Residential" icon="house" href="https://docs.brightdata.com/proxy-networks/residential/introduction">
      通过最大的全球代理 IP 网络（7200万个以上）定位任何国家/地区、城市、邮政编码、运营商或 ASN
    </Card>

    <Card title="Mobile" icon="mobile" href="https://docs.brightdata.com/proxy-networks/mobile/introduction">
      使用最大和最快的 3G/4G/5G 移动代理网络（700万个以上），从真实移动用户的视角看待网络
    </Card>
  </CardGroup>
</Card>

<Note>
  如果您正在寻找来自电子商务或社交媒体网站的完整即用型[Dataset](https://docs.brightdata.com/datasets/introduction)，或者想使用我们的 [Web Scraper IDE](https://docs.brightdata.com/scraping-automation/web-scraper-ide/introduction)，请查看我们的[网络数据](https://docs.brightdata.com/datasets/introduction)产品。
</Note>

## Bright Data 代理工具

帮助您管理和使用我们的代理产品

<Card>
  <CardGroup>
    <Card title="Proxy Manager" icon="circle-nodes" href="https://docs.brightdata.com/proxy-networks/proxy-manager/introduction">
      管理所有代理操作，让您完全控制用户访问、IP 白名单/黑名单建立、国家/地区定位、内置自动规则等。支持免费的本地开源应用程序和我们的集成云端应用程序。
    </Card>
  </CardGroup>
</Card>

## 为您的业务找到合适的代理产品

请在下方查看 Bright Data 的哪种代理产品最适合您的自定义业务需求。

如果您正在寻找完整的即用型数据集，请查看我们的[网络数据](https://docs.brightdata.com/datasets/introduction)产品。

<table>
  <tbody>
    <tr>
      <td><strong>产品</strong></td>

      <td>
        <p><strong>类型</strong></p>
      </td>

      <td><strong>最适合</strong></td>
    </tr>

    <tr>
      <td>
        <p><a href="https://docs.brightdata.com/scraping-automation/web-unlocker/introduction">Unlocker API</a></p>
      </td>

      <td>代理解锁解决方案</td>

      <td>
        <p>在不被屏蔽的情况下通过 HTTP 请求抓取网站<br /><br />
        \--- <br /><br />
        <span>✔️</span> 自主管理 IP 轮换、请求重试、标头、用户代理、指纹、验证码解决等<br />
        <span>✔️</span> 只为成功的请求付费 </p>
      </td>
    </tr>

    <tr>
      <td>
        <p><a href="https://docs.brightdata.com/scraping-automation/serp-api/introduction">SERP API</a></p>
      </td>

      <td>代理解锁解决方案</td>

      <td>
        <p> 专用于定位和抓取搜索引擎<br /><br />
        \--- <br /><br />
        <span>✔️</span> 包含上述所有网络解锁器技术<br />
        <span>✔️</span> 支持 Google、Bing、DuckDuckGo、Yandex、百度、雅虎和 Naver 搜索 API</p>
      </td>
    </tr>

    <tr>
      <td>
        <a href="https://docs.brightdata.com/scraping-automation/scraping-browser/introduction">Browser API</a>
      </td>

      <td>代理解锁解决方案</td>

      <td>
        <p> 在不被屏蔽的情况下通过浏览器会话抓取数据<br /><br />
        \--- <br /><br />
        <span>✔️</span> Puppeteer/Playwright/Selenium 集成<br />
        <span>✔️</span> 浏览网站、点击按钮、滚动以加载整页、悬停等</p>
      </td>
    </tr>

    <tr>
      <td>
        <a href="https://docs.brightdata.com/proxy-networks/data-center/introduction">Datacenter</a>
      </td>

      <td>代理网络</td>

      <td>
        <p> Web Scraper 机器人、社交媒体监控、黄牛机器人、管理多个在线账户<br /><br />
        \--- <br /><br />
        <span>✔️</span> 77万个数据中心 IP<br />
        <span>✔️</span> 99.99%的网络正常运行时间和最佳性能</p>
      </td>
    </tr>

    <tr>
      <td>
        <a href="https://docs.brightdata.com/proxy-networks/isp/introduction">ISP</a>
      </td>

      <td>代理网络</td>

      <td>
        <p> 与数据中心类似，但对于具有挑战性的站点的成功率更高<br /><br />
        \--- <br /><br />
        <span>✔️</span> 70万个静态住宅（互联网服务提供商） 代理 IP<br />
        <span>✔️</span> 高速且终身保留 IP </p>
      </td>
    </tr>

    <tr>
      <td>
        <p><a href="https://docs.brightdata.com/proxy-networks/residential/introduction">Residential</a></p>
      </td>

      <td>代理网络</td>

      <td>
        <p> 大量数据、评论监控、广告验证、竞争市场分析、商业智能等<br /><br />
        \--- <br /><br />
        <span>✔️</span> 7200万个住宅 IP<br />
        <span>✔️</span> 定位任何国家/地区、城市、运营商和 ASN<br />
        <span>✔️</span> 对于具有挑战性的站点成功率最高 </p>
      </td>
    </tr>

    <tr>
      <td>
        <p><a href="https://docs.brightdata.com/proxy-networks/mobile/introduction">Mobile</a></p>
      </td>

      <td>代理网络</td>
      <td> 以移动用户身份查看网站、验证广告、价格、运营商和地理位置信息、3G/4G 上的网站性能/延迟等<br /><br />
      \--- <br /><br />
      <span>✔️</span> 700万个移动住宅 IP<br />
      <span>✔️</span> 自动 IP 轮换、国家/地区、城市、运营商和 ASN 定位</td>
    </tr>
  </tbody>
</table>

<Note>
  **仍不确定哪个适合您？**

  欢迎立即联系我们的销售团队 ，他们很乐意为您提供帮助！
</Note>


# 代理配置选项
Source: https://docs.brightdata.com/cn/proxy-networks/config-options



## 代理网络访问

有两种方式可以访问Bright Data的代理网络：本机和通过REST API。详细阅读本文以决定哪种方式最适合您：代理API身份验证: [https://docs.brightdata.com/api-reference/authentication](https://docs.brightdata.com/api-reference/authentication)

### 通过代理用户名和密码进行本机访问

创建Bright Data代理区域（包含产品及其配置设置）后，您将收到代理用户名和密码。

代理用户名包含您的账户ID、区域名称和可选参数。

代理用户名结构为：

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

<Warning>
  请注意，区域名称创建后就无法更改。如果需要更改区域名称，请创建一个新区域（您可以将代理在同类型的区域之间转移）。
</Warning>

本页面介绍通过添加可选参数和修改用户名，您如何可以利用代码以非常精细的方式控制Bright Data系统。下表列出了开发者可以在代理用户名中使用的所有选项。 详细列表可参见我们的API参考文档:

[代理API文档](https://docs.brightdata.com/api-reference/proxy/)。

### 使用API令牌访问

API令牌可用于访问代理网络。 有些用户可能会发现API令牌使用起来更方便。 API令牌让您可以：

1. 使用一个令牌控制访问，不需要结合使用两个令牌

2. 令牌与用户名绑定，增强了可追溯性

3. 访问所有区域的令牌

4. 更容易迁移到适用于难访问域的高级抓取解决方案

5. 完全符合REST API

#### 创建API令牌

请参阅我们的API令牌及其使用方法: [https://docs.brightdata.com/cn/general/account/api-token](https://docs.brightdata.com/cn/general/account/api-token)

## 与第三方和工具集成

您可以使用控制面板上的代理集成示例页面来创建不同的请求。

[Proxy Integration Examples](https://brightdata.com/cp/zones/proxy_examples)

## 代理定位选项

这些设置让您可以轻松地为特定国家/地区、州、城市、邮政编码和ASN配置代理。

| 参数                | 描述                                                                                                                                           | 用户名示例                                                                      |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| -country-xx       | 通过双字母代码选择一个国家/地区，或者选择eu代表欧盟的任意国家/地区。国家/地区代码列表位于此处 [here](https://docs.brightdata.com/general/faqs#where-can-i-see-the-list-of-country-codes) | `brd-customer-<customer_id>-zone-<zone_name>-country-us`                   |
|                   |                                                                                                                                              |                                                                            |
| -state-xxxxx      | 通过双字母代码定位美国境内的一个州。 必须包含国家名称US。                                                                                                               | `brd-customer-<customer_id>-zone-<zone_name>-country-us-state-ny`          |
| -city-xxxxx       | 定位城市。 必须包含国家/地区（例如username-country-fr-city-paris）。 不要使用空格（例如-city-sanfrancisco）                                                              | `brd-customer-<customer_id>-zone-<zone_name>-country-us-city-sanfrancisco` |
| -zip-xxxxx        | 定位美国邮政编码。 使用5位数的邮政编码                                                                                                                         | `brd-customer-<customer_id>-zone-<zone_name>-city-memphis-zip-37501`       |
| -asn-xxxxx        | 定位列表中的一个ASN [the list](https://bgp.potaroo.net/cidr/autnums.html)                                                                            | `brd-customer-<customer_id>-zone-<zone_name>-asn-56386`                    |
| -os-xxxxx         | 仅适用于住宅代理。 允许针对 `Windows`、`MacOS` 或 `android`                                                                                                 | `brd-customer-<customer_id>-zone-<zone_name>-os-windows`                   |
| -carrier-os-xxxxx | 仅适用于移动代理，您可以选择使用此列表中的特定运营商 [this list](https://docs.brightdata.com/api-reference/proxy/carrier_specific_proxy_peer_ip_mobile_only_)          | `brd-customer-<customer_id>-zone-<zone_name>-carrier-dt`                   |

## 控制代理' DNS

The following option allows you to set how DNS resolution is performed.&#x20;

| 功能        | 参数                        | 描述                                                                                                                                                                                                                                   | 用户名示例                                                   |
| --------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------- |
| 选择DNS解析位置 | -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](https://docs.brightdata.com/api-reference/proxy/configuring_dns_resolution) | `brd-customer-<customer_id>-zone-<zone_name>-dns-local` |

## 控制代理 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](https://docs.brightdata.com/api-reference/proxy/rotate_ips)

| 功能                | 参数              | 描述                                                                                 | 用户名示例                                                                    |
| ----------------- | --------------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| 为多个请求保持相同的IP或轮换IP | -session-xxxxxx | 每个唯一的会话ID都会获得一个唯一的IP，可以用于反复定位同一个IP，也可以强制轮换。 建议实施有计划的IP轮换。                          | `brd-customer-<customer_id>-zone-<zone_name>-session-mystring12345`      |
| 选择特定IP            | -ip-x.x.x.x     | 仅适用于已分配专用IP的区域                                                                     | `brd-customer-<customer_id>-zone-<zone_name>-ip-1.2.3.4`                 |
| 选择特定IP组（gIP）      | -gip-xxxxxx     | 仅适用于专用的住宅或移动代理。                                                                    | `brd-customer-<customer_id>-zone-<zone_name>-gip-us_7922_fl_hollywood_0` |
| 跟踪单个响应            | -c\_tag-xxxxxx  | 在请求中包含一个唯一的 `c_tag` 标记。响应时，企业会在标头中回显相同的标记。 这种无缝交换可确保每个响应都与相应的请求绑定，从而消除混乱，并简化了数据管理。 | `brd-customer-<customer_id>-zone-<zone_name>-c_tag-<C_TAG_VALUE>`        |
| 在会话中绑定到对等节点       | -const          | 使用同一个对等节点进行会话。如果对等节点不可用，则将返回502错误：“无可用的对等节点”                                       | `brd-customer-<customer_id>-zone-<zone_name>-const`                      |

## 控制“超级代理”

超级代理是负责将您的请求路由到实际代理（这些代理可以是数据中心、ISP或住宅代理）的主服务器。 注意：这些参数很少需要修改！

| 功能             | 参数             | 描述                                                                                                                                 | 用户名示例                                                                                        |     |
| -------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | --- |
| 直接从超级代理发送请求    | -direct        | 为多个请求保持相同的IP。 每个唯一的会话ID都会获得一个唯一的IP。                                                                                                | `brd-customer-<customer_id>-zone-<zone_name>-direct`                                         |     |
| 选择特定国家/地区的超级代理 | session-xxxxxx | 仅适用于选择超级代理（很少需要进行此操作）。 More details [here](https://docs.brightdata.com/api-reference/proxy/select_super_proxy_in_specific_country) | [示例](https://docs.brightdata.com/api-reference/proxy/select_super_proxy_in_specific_country) |     |
| 选择特定IP组（gIP）   | gip-xxxxxx     | 仅适用于专用的住宅或移动代理。                                                                                                                    | `brd-customer-<customer_id>-zone-<zone_name>-gip-us_7922_fl_hollywood_0`                     | 您好， |
|                |                |                                                                                                                                    |                                                                                              |     |
|                |                |                                                                                                                                    |                                                                                              |     |


# 如何配置您的数据中心代理
Source: https://docs.brightdata.com/cn/proxy-networks/data-center/configure-your-proxy



<Accordion title="首先：导航到“配置”选项卡">
  创建代理后，您可以导航到配置选项卡来配置代理设置。

  <Frame>
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ff04df5ed07ae21a35e2f03c28d721e3" alt="配置" width="530" height="729" data-path="images/proxy-networks/data-center/configuraton_tab.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?w=280&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=c2d7f954a17ab45861fd960a57bbb650 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?w=560&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=dc67626f65dd27cfdc9726bb800e8f43 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?w=840&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=bbac3a18561aa4eb91d96e9d21ab568b 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?w=1100&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=36facc9a41dadcedf37c0bedf2e7bb73 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?w=1650&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=81e1b8bbe479373fee9a0c66a48fdfd2 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?w=2500&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9d3d0af0d96ea93b791efd757a3f20ff 2500w" data-optimize="true" data-opv="2" />
  </Frame>
</Accordion>

## IP 类型

**为您的代理区域选择两种 IP 类型之一：**

<CardGroup cols={2}>
  <Card title="共享（按 IP 付费）" href="/proxy-networks/faqs#what-are-ip-types-for-datacenter" icon="square-1">
    <Tip>选择 IP 数量和国家/地区。 按 IP 和使用量付费。</Tip>
    当您需要具有成本效益的选项，并且不需要 IP 专用权时。
    <Note>多个用户共享 IP</Note>
  </Card>

  <Card title="共享（按使用量付费）" href="/proxy-networks/faqs#what-are-ip-types-for-datacenter" icon="square-2">
    <Tip>拥有来自所有国家/地区的 1 万个 IP 的固定资源池。IP 免费。 按使用量付费。</Tip>
    当您需要具有成本效益的选项，并且不需要 IP 独占权时。These proxies will rotate so every request you can get a new IP address ("Rotating proxies").

    <Note>多个用户共享 IP</Note>
  </Card>

  <Card title="专用" href="/proxy-networks/faqs#what-are-ip-types-for-datacenter" icon="square-3">
    当您需要使用专用 IP 地址访问网站时。
    <Note>IP 仅供您使用。</Note>
  </Card>

  <Card title="高级 IP" href="/proxy-networks/faqs#what-are-ip-types-for-datacenter" icon="square-4">
    ~~电子商务、旅游和社交媒体域名等领域最知名的 IP。~~
    <Note> 已弃用： 我们不再提供高级 IP</Note>
  </Card>
</CardGroup>

***

## IP 数量

作为可用 IP 资源池分配的 IP 数量。
<Warning>请注意，增加数量会增加额外成本。</Warning>

## 分配的 IP

您可以查看或下载分配给您的 IP。

<Frame>
  <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=7a4b0863cdbcd3dac920a163878881ac" alt="地理位置定位" width="561" height="84" data-path="images/proxy-networks/data-center/allocated-ips.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?w=280&maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=2e74f5bcbaff8a7c147b93e51de4c4ea 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?w=560&maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=6af09e6bb9fa638a42f59bf328138b44 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?w=840&maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=f9c6146a358b4ac10263c7877d062b84 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?w=1100&maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=335ad91e25acfd9bb72b7b49ce5ace70 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?w=1650&maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=cba076ab6d22c916398f7ade1650039a 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?w=2500&maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=88974428fc9d8a77f6a98576f758169c 2500w" data-optimize="true" data-opv="2" />
</Frame>

***

## 地理位置定位

<Tip>
  Common setup is to create a zone per each location, this way you can control your requests target on the zone level.

  For example: dcshared-uk, dcshared-us, dcshared-de.
</Tip>

### 专用 and Pay per IP proxies

地理位置定位允许您定位特定的国家/地区。
从下拉菜单中选择首选国家/地区。

If you select multiple countries, we assign proxies distributed  evenly across the countries you selected.

<Frame>
  <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d307c894cda3101699ba450988554136" alt="地理位置定位" width="572" height="358" data-path="images/proxy-networks/data-center/geotargeting.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=280&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=67026a086654981fcd2439025d93033d 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=560&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=341cf0c6a4d403bdb158cc49a0f23ebf 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=840&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=895a1fd7f97db50b0571cfb2db31fb05 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=1100&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=dc5caddedc4dcc33fb7169cb5c6bc9d8 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=1650&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9d153ef8bfb872cb54758141256a6d5d 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=2500&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=39e92809ce18ca858e9ac907ed504a9a 2500w" data-optimize="true" data-opv="2" />
</Frame>

### Shared proxy

In Datacenter Shared proxies, you have access to 40,000 proxies around the globe. To target specific country, 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?](https://docs.brightdata.com/cn/general/faqs#where-can-i-see-the-list-of-country-codes)

***

## 缓存代理

Bright Data 的缓存代理是一项旨在减少目标站点不必要负载的功能，一方面允许客户缓存成功结果，另一方面，在可能的情况下根据请求接收缓存结果。

<AccordionGroup>
  <Accordion title="更健康的生态系统">
    从技术上讲，通过消耗网站资源并在数据收集领域造成性能问题可能使网站过载。 Bright Data 除了安装系统以避免目标站点过载之外，还提供缓存代理功能，以避免在我们从另一位客户提出的相同请求中获得最新缓存记录的情况下，向目标站点提出冗余请求。
  </Accordion>

  <Accordion title="提高了性能">
    从我们的缓存中收到的响应速度大约快了 20 倍！
    这意味着随着我们的缓存使用量的增长，性能将不断提高。
  </Accordion>

  <Accordion title="经济利益">
    为了促进我们维护健康生态系统的目标，对于通过选择使用缓存代理的代理区域中的任何使用量，我们将提供使用折扣。

    虽然我们将提供的缓存记录可能只占代理区域总使用量的一小部分，但折扣将充分适用于代理区域。
  </Accordion>
</AccordionGroup>

### 启用缓存代理

只需切换缓存代理开关

<Frame>
  <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3f0e8addd47eb5d1ea5013ac6acff62a" alt="缓存代理" width="580" height="79" data-path="images/proxy-networks/residential/cache_proxy.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=280&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=1ac56d7882de8d1d4e5a7e0bd077173c 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=560&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3ab022814cdedb7f66195c9961a82c9a 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=840&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=034f9eee12112ff7ce3863fb218a9323 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=1100&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b29cbd844b0f4f879e931dc5de261e55 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=1650&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a5c234e956773621691de0ae609e765f 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=2500&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=cdd4e80279b979106bb8ce70840039c9 2500w" data-optimize="true" data-opv="2" />
</Frame>

开启后，我们将引导您完成缓存代理工作所需的一些说明。

**您有两个选项可供选择：**

<AccordionGroup>
  <Accordion title="安装证书">
    <Frame>
      <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b725dbfcbd11e988cca2d5afe9a61643" alt="安装证书" width="519" height="391" data-path="images/proxy-networks/residential/install_certificate.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=280&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=133152ca0cee8ec9d109814f39236c4c 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=560&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=689d21e5d99577cba7c287dadf074bf0 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=840&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6bb1481446931a99bf65b2844c26af4b 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=1100&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=89bcbb6caca76c665e36a3941ecf912c 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=1650&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=938bb88309b7577d3800dd499a05aaff 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=2500&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b5604353a301432e74d9e0ea0aeecc10 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>
</AccordionGroup>

***

## 高级选项：

### 100% 正常运行时间 / 自动故障转移

100% 正常运行时间（或自动故障转移）通过免费提供 100% 的连接和持续的高性能水平带来立竿见影的价值。 P此外，您无需对代码/工作流程进行任何更改。
如果我们的系统检测到问题，例如连接问题或某个 IP 其中的 GEO 与您在购买该 IP 时要求的不完全相同，我们将自动通过与原始 IP 完全相同的其他 IP 处理您的路由请求。

<Accordion title="无缝集成">
  为了向我们的客户提供无缝体验，会产生一些例外情况：

  * 如果您在请求中指定了 IP，我们不会分配回退 IP
  * 100% 正常运行时间不会中断实时连接。 如果需要回退，它将在建立下一个连接后继续参与
</Accordion>

### 启用 100% 正常运行时间 / 自动故障转移

只需将开关切换到“开启”

<Frame>
  <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=79315c765e1023270051ccdc90600c72" alt="100% 正常运行时间" width="546" height="87" data-path="images/proxy-networks/data-center/100uptime.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?w=280&maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=1068b06b5b432d07c5cc5be16ab0ac9a 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?w=560&maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=1c311316a449774797ea119611a99fc9 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?w=840&maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=de25d43fe747a859413a41f7036b18ee 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?w=1100&maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ebb7c2b05a9acd093508ebcd8e2181a7 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?w=1650&maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=7a91cc6b2e5761dc6a41c0712f5ac69e 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?w=2500&maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=e3f530fd9e67f924ec18123345786654 2500w" data-optimize="true" data-opv="2" />
</Frame>

<Tip>您还可以通过 API 开启/关闭 100% 正常运行时间功能。</Tip>

### 无限带宽

您可以通过在区域详情中选择“无限带宽”来设置区域无限带宽。

<Warning>启用无限带宽会增加额外成本。</Warning>

<Accordion title="可接受无限带宽使用 / 合理使用">
  数据中心 IP 无限带宽的可接受使用（或合理使用）定义为每个 IP 每月最多100GB。
  传输量是跨 IP 累积的，因此要用 100GB 乘以 IP 的数量。
  例如：您有两个 IP，因此 200GB 可以用于任何 IP。
  当您每月每个 IP 超过 100GB 时，将按每 GB 收取超额费用。
</Accordion>

<Warning>超出合理使用范围会增加超额收费成本。</Warning>

<Frame>
  <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/unlimited-bandwidth.png?maxW=540&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=94f9543fc0bc76710814319ffc6a5a78" alt="无限带宽" width="540" height="76" data-path="images/proxy-networks/data-center/unlimited-bandwidth.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/unlimited-bandwidth.png?w=280&maxW=540&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=13889a1b91f534628aa0f3a4a7947572 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/unlimited-bandwidth.png?w=560&maxW=540&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=5c248e8ac48e7400aaacae045944b109 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/unlimited-bandwidth.png?w=840&maxW=540&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=52b07635a9da5bc5970bebf5d3e23494 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/unlimited-bandwidth.png?w=1100&maxW=540&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=c1c72c2dd683a7fc2424ca2a71c5319c 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/unlimited-bandwidth.png?w=1650&maxW=540&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=24c1f88c219dbbf1935a6aa5666d54c7 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/unlimited-bandwidth.png?w=2500&maxW=540&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ce9a691030cbb91f37faa84bdcedf735 2500w" data-optimize="true" data-opv="2" />
</Frame>

### 端口

默认情况下，端口 80 和 443 可用，支持 HTTP 和 HTTPS 协议。
下表按端口显示了支持的协议：

| 端口    | 协议             |
| ----- | -------------- |
| `80`  | HTTP 和 HTTP 连接 |
| `443` | HTTPS          |

<Accordion title="请求其他端口">
  Bright Data 可以根据要求支持其他端口。 每一项支持新端口的请求将遵循专门的额外合规流程，由 Bright Data 的合规团队执行。
  如果您需要额外的端口权限，可以联系 Bright Data 支持团队。
  激活前需要 Bright Data 合规性审查的端口示例：

  | 端口     | 协议    |
  | ------ | ----- |
  | `8443` | HTTP  |
  | `8243` | HTTPS |
</Accordion>

***


# 数据中心代理常见问题解答
Source: https://docs.brightdata.com/cn/proxy-networks/data-center/faqs



<AccordionGroup>
  <Accordion title="数据中心的 IP 类型是什么？">
    我们在[数据中心](https://brightdata.com/proxy-types/datacenter-proxies)代理网络中提供四种类型的 IP：

    1. 共享（按使用量付费）
    2. 共享（按 IP 付费）
    3. 专用

    <Tabs>
      <Tab title="共享">
        共享 IP 由多个用户共享。 我们在 互联网服务提供商（ISP） 代理网络中的共享 IP 有 2 个等级：

        <Tabs>
          <Tab title="按使用量付费">
            <Tip>您只需按使用量付费。</Tip>

            将您连接到由 4 万个 IP 组成的资源池，该资源池由来自各个可用国家/地区固定分配的 IP 范围组成。
            这些 IP 可以根据需要在 4 万个资源池中持续轮换（特定国家/地区可以在 chrome、代理管理器或 API 中选择）

            ### 功能

            * 地理位置定位 - 使用“共享” IP（按使用量付费），您可以在发送请求时使用 -country 标志来控制您的地理位置定位。针对美国的定位请求，简单示例如下所示

              ```sh 示例
              curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us:<zone_password> "http://lumtest.com/myip.json"
              ```

            访问我们的代理集成示例页面了解有关定位不同国家/地区定位选项的更多信息
          </Tab>

          <Tab title="按 IP 付费">
            Purchase individual IPs for your use (with unlimited BW or cost per GB) in the country of your choosing. You will be charged per IP and usage, or switch to unlimited bandwidth.

            ## 功能

            * **Geolocation targeting** - The IP allocated to your zone will be from the selected country.
              <Frame>
                  <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=112ecae8ddb56c1ebb813f9b2422866f" alt="add-country.png" width="514" height="112" data-path="images/proxy-networks/faqs/add-country.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=280&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=64a1b2980ff6a5888b94d2c5c46e9a79 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=560&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=df276075373b92ca3bb12dbb66479bbe 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=840&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9da95587a1b49839713cff7c34e8333f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1100&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b4650734643e0979a398a7bda8a41576 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1650&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fe32545646ad097427f40f33403d0fb8 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=2500&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=93c75cd9a1a7fbed4c3aff1ebd125d65 2500w" data-optimize="true" data-opv="2" />
              </Frame>

            <Tip>
              For geolocation, if you choose an IP type where your IPs are automatically allocated (按 IP 付费 or 专用), it is recommended to set up a separate 互联网服务提供商（ISP） proxy zone, for each geolocation you wish to target.
            </Tip>
          </Tab>
        </Tabs>
      </Tab>

      <Tab title="专用">
        [专用 IPs](https://brightdata.com/solutions/dedicated-proxies) are set aside for your use only. This IP type is more lucrative and you can control the allocation of the IPs based on the following features:

        ### 功能

        * **Geolocation targeting** - The dedicated IP allocated to your zone will be from your selected country
          <Frame>
              <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=112ecae8ddb56c1ebb813f9b2422866f" alt="add-country.png" width="514" height="112" data-path="images/proxy-networks/faqs/add-country.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=280&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=64a1b2980ff6a5888b94d2c5c46e9a79 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=560&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=df276075373b92ca3bb12dbb66479bbe 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=840&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9da95587a1b49839713cff7c34e8333f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1100&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b4650734643e0979a398a7bda8a41576 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1650&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fe32545646ad097427f40f33403d0fb8 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=2500&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=93c75cd9a1a7fbed4c3aff1ebd125d65 2500w" data-optimize="true" data-opv="2" />
          </Frame>
        * **Domains** - Define the domains you'd like your IPs to be exclusive to. 请求 to all other domains will be sent from our super proxies.

          <Frame>
              <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6a4de57e233019ed0f30522817c01d7b" alt="add-domains.png" width="528" height="134" data-path="images/proxy-networks/faqs/add-domains.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=280&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fc93cd504b61d61b4eaf086dcccef602 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=560&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=896c83e3e9b2ded9fb48199421e0c221 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=840&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=facb857392cc2909e13029b24f151212 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=1100&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2c652b524fe7f2a8cff08fb1dba06496 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=1650&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=bf5f81409686ad12cbf5e26a7f84e2e6 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=2500&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ade906f28f183329a7ea046ab20b224a 2500w" data-optimize="true" data-opv="2" />
          </Frame>

          <Note>You may check 'All domains' for full exclusivity over the IPs, and in this case, they will only be used by you.</Note>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="互联网服务提供商（ISP） 的 IP 类型是什么？">
    我们在 ISP 代理网络中提供三种类型的 IP：

    1. 共享（按使用量付费）
    2. 共享（按 IP 付费）
    3. 专用

    <Tabs>
      <Tab title="共享">
        共享 IP 由多个用户共享。 我们在 互联网服务提供商（ISP） 代理网络中的共享 IP 有 2 个等级：

        <Tabs>
          <Tab title="按使用量付费">
            <Tip>您只需按使用量付费。</Tip>

            将您连接到由 1 万个 IP 组成的资源池，该资源池由来自各个可用国家/地区固定分配的 IP 范围组成。
            这些 IP 可以根据需要在 1 万个资源池中持续轮换（特定国家/地区可以在 chrome、代理管理器或 API 中选择）

            ### 功能

            * 地理位置定位 - 使用“共享” IP（按使用量付费），您可以在发送请求时使用 -country 标志来控制您的地理位置定位。针对美国的定位请求，简单示例如下所示

              ```sh 示例
              curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us:<zone_password> "http://lumtest.com/myip.json"
              ```

            访问我们的代理集成示例页面了解有关定位不同国家/地区定位选项的更多信息
          </Tab>

          <Tab title="按 IP 付费">
            Purchase individual IPs for your use (with unlimited BW or cost per GB) in the country of your choosing. You will be charged per IP and usage, or switch to unlimited bandwidth.

            ## 功能

            * **Geolocation targeting** - The IP allocated to your zone will be from the selected country.
              <Frame>
                  <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=112ecae8ddb56c1ebb813f9b2422866f" alt="add-country.png" width="514" height="112" data-path="images/proxy-networks/faqs/add-country.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=280&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=64a1b2980ff6a5888b94d2c5c46e9a79 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=560&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=df276075373b92ca3bb12dbb66479bbe 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=840&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9da95587a1b49839713cff7c34e8333f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1100&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b4650734643e0979a398a7bda8a41576 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1650&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fe32545646ad097427f40f33403d0fb8 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=2500&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=93c75cd9a1a7fbed4c3aff1ebd125d65 2500w" data-optimize="true" data-opv="2" />
              </Frame>

            <Tip>
              For geolocation, if you choose an IP type where your IPs are automatically allocated (按 IP 付费 or 专用), it is recommended to set up a separate 互联网服务提供商（ISP） proxy zone, for each geolocation you wish to target.
            </Tip>
          </Tab>
        </Tabs>
      </Tab>

      <Tab title="专用">
        专用 IPs are set aside for your use only. This IP type is more lucrative and you can control the allocation of the IPs based on the following features:

        ### 功能

        * **Geolocation targeting** - The dedicated IP allocated to your zone will be from your selected country
          <Frame>
              <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=112ecae8ddb56c1ebb813f9b2422866f" alt="add-country.png" width="514" height="112" data-path="images/proxy-networks/faqs/add-country.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=280&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=64a1b2980ff6a5888b94d2c5c46e9a79 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=560&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=df276075373b92ca3bb12dbb66479bbe 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=840&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9da95587a1b49839713cff7c34e8333f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1100&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b4650734643e0979a398a7bda8a41576 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1650&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fe32545646ad097427f40f33403d0fb8 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=2500&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=93c75cd9a1a7fbed4c3aff1ebd125d65 2500w" data-optimize="true" data-opv="2" />
          </Frame>
        * **Domains** - Define the domains you'd like your IPs to be exclusive to. 请求 to all other domains will be sent from our super proxies.

          <Frame>
              <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6a4de57e233019ed0f30522817c01d7b" alt="add-domains.png" width="528" height="134" data-path="images/proxy-networks/faqs/add-domains.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=280&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fc93cd504b61d61b4eaf086dcccef602 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=560&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=896c83e3e9b2ded9fb48199421e0c221 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=840&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=facb857392cc2909e13029b24f151212 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=1100&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2c652b524fe7f2a8cff08fb1dba06496 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=1650&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=bf5f81409686ad12cbf5e26a7f84e2e6 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=2500&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ade906f28f183329a7ea046ab20b224a 2500w" data-optimize="true" data-opv="2" />
          </Frame>

          <Note>You may check 'All domains' for full exclusivity over the IPs, and in this case, they will only be used by you.</Note>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="如何将新的代理集成到您的代码中？">
    要将代理集成到您的代码中，请访问 API 示例页面，该页面可通过您所在区域的设置访问，位于“访问参数”下：
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8865e37db6b85ba4c7b10554f96b5152" alt="integrate-new-proxy.gif" width="1828" height="978" data-path="images/proxy-networks/faqs/integrate-new-proxy.gif" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=280&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=af6967b98840c378451f71789844683c 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=560&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c8a668490c5e77e52cfaaa33e9611f92 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=840&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d8bc15aa37a36943e130b755bef3760c 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=1100&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f48c0c165a1ca706da431cb105685adb 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=1650&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e3a7b54c9cf2cd04dcfb7cbceb39b55b 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=2500&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e2e00c6be0bb7ce6e8c8b666071aff96 2500w" data-optimize="true" data-opv="2" />

    在此页面上，您可以选择大多数现代编码语言的集成示例，只需选择集成类型、代理区域、编码语言等，该页面就会生成一个可供您立即使用的代码片段。
  </Accordion>

  <Accordion title="如何将代理集成到第三方软件中？">
    在上文提到的 API 示例页面中查看一些示例（只需在“语言”下拉菜单中选择“其他软件”），或者查看我们的集成页面，其中提供了将代理集成到当今业内最热门工具中的具体指南。

    **重要说明**：如果您使用 Bright Data 的网络解锁器、住宅代理或 SERP API，则可能需要使用我们的 SSL 证书来启用端到端的安全连接。
  </Accordion>

  <Accordion title="如何定位特定国家？">
    发送请求时，在请求中您所在区域的名称后添加 -country 标志，然后加上该国家/地区 2 个字母的 ISO 代码。

    在以下示例中：我们在请求中添加了 -country-us ，因此我们将发送来自美国（“us”）的请求。

    ```sh
    curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us: <zone_password>
    ```
  </Accordion>

  <Accordion title="如何定位特定城市？">
    要定位特定城市，您需要使用共享（按 IP 付费）或专用代理网络。

    配置代理区域时，选择首选国家/地区后，您可以添加城市，以进一步指定您的地理定位

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ca7361e14082b55128dfeaecf1222f9a" alt="add-city.png" width="664" height="376" data-path="images/proxy-networks/faqs/add-city.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=280&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=04a0e4f99086ed0b3ffa814a0d6d8901 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=560&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e783c970a46a962b796015a72bf16acd 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=840&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3cac3ce62610ee6ae080145996ebb746 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=1100&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f66bf044a4bf60204463610aebca401a 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=1650&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c1478268f631d03401ac9e3c3ae0cdc2 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=2500&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fda8142825643a46c283f3bc55793d84 2500w" data-optimize="true" data-opv="2" />

    点击“添加城市”后，您将看到所选国家/地区的可用定位城市。为了检查特定地理位置的可用 IP 数量。

    配置完成后，您将能够使用以下语法发送来自所选城市的请求

    ```sh
    curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-<country>-city-<city>: <zone_password>
    ```

    <Note>
      选择包含两个单词的城市名称时，将合并写成一个单词。

      例如，当以布宜诺斯艾利斯（Buenos Aires）为定位时，请求的语法将是：

      `-country ar-city-buenosaires`
    </Note>

    [要查看更多地理定位示例，您可能需要查看我们的代理集成示例页面。](https://brightdata.com/cp/zones/proxy_examples)
  </Accordion>

  <Accordion title="Bright Data 的代理分布在哪些地方？">
    Bright Data 在全球各个国家/地区提供代理，以下国家除外：

    * 伊朗
    * 伊拉克
    * 叙利亚
    * 黎巴嫩
    * 巴勒斯坦
    * 朝鲜
    * 古巴
    * 苏丹
    * 俄罗斯克里米亚地区

    遗憾的是，如果您需要来自这些国家/地区的代理，Bright Data 将无法为您提供帮助。
  </Accordion>

  <Accordion title="如何查看代理事件日志？">
    事件日志将向您（最多）显示您的账户中最近在任何区域发出的 200 次请求。

    位于您的 Bright Data 控制面板的代理页面中： [https://brightdata.com/cp/zones](https://brightdata.com/cp/zones)

    转到“事件日志”选项卡：

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e58931c902b2aa2b9cb71157e98e2ab9" alt="event-log.png" width="1833" height="977" data-path="images/proxy-networks/faqs/event-log.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=280&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3ca0f70abbd76e232d8bbe117f4350aa 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=560&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b08adc7e24153bf24ee8e4e36e79bf25 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=840&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=58efc19a1f43403f4cc6b896de99bc5e 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=1100&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2c9e851671051303d96f000a7e23bcfd 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=1650&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2f30a688c191fe1392e473e86826ee46 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=2500&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f7ee65bd5eabe6ae149263a8f9464acc 2500w" data-optimize="true" data-opv="2" />

    显示的数据包括：

    * **日期**：请求的时间和日期
    * **区域**：请求使用了哪个区域
    * **来源 IP**：请求来自哪个 IP
    * **URL**：请求的定位站点
    * **结果**：请求成功或失败

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f2905127ebde0e5876295cb21ed341ce" alt="event-log-headers.png" width="1833" height="977" data-path="images/proxy-networks/faqs/event-log-headers.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=280&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7b9dd50469ff007397a1e8c93a030795 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=560&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=564c5cbb33cf376f1a4697557c98d724 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=840&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=888b55dcce504a411741144fed9ec49a 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=1100&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=22d813089ee901fe3d7ef46fd2dfbfda 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=1650&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=611238c6c04383d5b659d5d4fadf56af 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=2500&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6c16fdf908195d513b49f3577770876e 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="如何启用自动 IP 回退？（100% 正常运行时间）">
    <Info>适用于数据中心和互联网服务提供商（ISP）</Info>

    100% 正常运行时间旨在防止任何“外部”事件影响用户。这一理念很简单，与上述两个问题的运作方式相同——如果我们的系统检测到问题，例如连接问题或某个 IP 其中的 GEO 与您在购买该 IP 时要求的不完全相同，我们将自动通过与原始 IP 完全相同的其他 IP 处理您的路由请求。

    同时，我们希望确保必须使用特定 IP 的客户不会受到影响，因此我们列出了一些例外情况：

    * 如果您的请求中以特定 IP 为定位，我们不会为其分配回退 IP
    * 100% 的正常运行时间不会中断实时连接。 如果需要回退，它将在建立下一个连接后继续参与

    100% 的正常运行时间通过提供 100% 的连接和持续的高性能水平带来立竿见影的价值，免费使用，且无需对代码或工作方式进行任何更改。

    <Note>
      可以通过 [API](/cn/api-reference/account-management-api/Switch_100_uptime_ON_OFF_in_a_Static_zone) 开启或关闭 100% 正常运行时间功能。
    </Note>
  </Accordion>

  <Accordion title="如何为代理启用自动故障转移？">
    导航到您的代理配置设置，然后在高级设置下启用“100% 正常运行时间”

        <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/faqs/100-uptime.gif?maxW=1600&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=fc8e08dd28008175d1c688a0b4caf0df" alt="100-uptime.gif" width="1600" height="734" data-path="images/proxy-networks/faqs/100-uptime.gif" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/faqs/100-uptime.gif?w=280&maxW=1600&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=7a88ff82116e48bbaaac298231529afa 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/faqs/100-uptime.gif?w=560&maxW=1600&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=10d8c2369b2fef82d54ae6e9704fafe6 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/faqs/100-uptime.gif?w=840&maxW=1600&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=114e93971c5a37b34adbd28ce8d73171 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/faqs/100-uptime.gif?w=1100&maxW=1600&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=87c43a879aaa98bcb79db4001eacd1a5 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/faqs/100-uptime.gif?w=1650&maxW=1600&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9459bf3b07e0e65808bed1187557c029 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/faqs/100-uptime.gif?w=2500&maxW=1600&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=efa1866e0798cf5f769b2a1ad3499a0c 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="如何在多个请求中继续使用同一个 IP？">
    * 这可以通过在代理用户名中添加会话标志来完成：

    ```sh
    brd.superproxy.io:33335 br-customer-<customer_id>-zone-<zone_name>-session-rand39484
    ```

    在线程启动时生成随机数，如果要更改为线程连接分配的代理对等点（Proxy Peer），则对其进行更改。

    * 会话 ID 可以是任何随机字符串/计数器：具有相同会话字符串的请求将使用相同的（尽可能长的）代理对等点；具有不同会话字符串的请求将被分配不同的代理对等点。
    * 要强制更改 IP，只需修改会话 ID 即可
    * 如果分配的代理对等点（退出节点 IP）不可用，则超级代理将在第一个请求中返回错误 “502 - 无对等点可用”，然后在第二个请求中，即使您没有更改会话 ID，超级代理也会分配一个新的对等点。
    * 会话 IP 最多可保持 1 分钟的闲置时间。 一分钟后，如果没有请求，IP 将释放回资源池。\
      要延长此会话/IP 的使用时间，请每 30 秒发送一个小的 keep-alive 请求，以防止该会话闲置一分钟以上。
      这个请求可以是任何小的请求，比如 /favicon.ico，甚至是返回 404 的请求（只要 Web 服务器不会因为这一请求而断开插座连接）。
    * 如果您有多个客户端，并且想忽略您的客户端源 IP（与您的会话 ID 一起使用来创建会话），那么您想使用全局会话，然后添加 `glob_` 作为会话前缀：

    ```sh
    brd-customer-<customer_id>-zone-<zone_name>-session-glob_rand39484
    ```

    完整请求示例：

    ```sh
    brd-customer-cxxxxx-zone-zone_x-session-glob_rand39484
    ```

    在线程启动时生成随机数，如果要更改为线程连接分配的代理对等点，则对其进行更改。
  </Accordion>

  <Accordion title="如何将 IP 和域名列入白名单/黑名单？">
    要将 IP 添加到区域的黑名单/白名单，有两种方法：

    * 通过控制面板：

      * 进入您区域的任何设置，然后点击“访问参数”选项卡。
      * 向下滚动到 “IP” 和“定位主机”部分，因为它们分别负责将 IP 和域名列入白名单/黑名单：

      <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d438296191d4567832ffc1428804bf2e" alt="whitelist-blacklist.png" width="557" height="490" data-path="images/proxy-networks/faqs/whitelist-blacklist.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=280&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=363f6c345e5393a22de1c06867bf6d0d 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=560&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a3aae6a92643ae783a957a726c662310 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=840&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a98a1d5655cc162f1378621db15aa53c 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=1100&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=bb65479ef65304ad7f8b3fdf0bc1ea31 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=1650&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9aca6308d18a97a6d7c9281068888f0c 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=2500&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a2866c8436989541f0510a76667fffa5 2500w" data-optimize="true" data-opv="2" />

      使用代理区域添加所有允许访问的相关 IP 和域名。

    * **通过 API 终端节点：**
      * [将 IP 添加到区域白名单](/cn/api-reference/account-management-api/allowlist-ip)
      * [从区域白名单中移除 IP](/cn/api-reference/account-management-api/remove-ip-from-zone-allowlist)
      * [将 IP 添加到区域黑名单](/cn/api-reference/account-management-api/denylist-ip)
      * [从区域黑名单中移除 IP](/cn/api-reference/account-management-api/remove-ip-from-zone-denylist)
      * [从区域白名单/黑名单中移除域名](/cn/api-reference/account-management-api/remove-domain-from-zone-allowlist-or-denylist)
      * [将域名添加到区域白名单/黑名单](/cn/api-reference/account-management-api/allowlist-or-denylist-domains)

    * **有关白名单的重要提示：**
      * 应列入白名单的 IP 是您发送请求时使用的您的计算机 IP，而不是区域中的代理 IP。
      * 我们强烈建议尽可能将您的 IP 列入白名单，因为当白名单为空时，如果我们的自动安全封禁系统检测到任何异常活动，您未列入白名单的 IP 可能会暂时封禁。[视频链接](https://brightdata.com/static/video/howto/blacklist_system_explanation.mp4?md5=153602994-22bce32a\&hver=2)
      * 对于您添加多少个 IP/域名到白名单， 不设限制 ，我们还支持 IP 范围。
      添加域名的示例：
      <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c7dfe555b41399d5e9a309475aa224c5" alt="domain-add-example.png" width="376" height="112" data-path="images/proxy-networks/faqs/domain-add-example.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?w=280&maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c655c57674c2f27a0aca0a226c7576df 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?w=560&maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3ac470b45bdd7da35b4497e885cc0e99 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?w=840&maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9a5c1fd6b95f3e925a0f4218cabf376e 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?w=1100&maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b64cbde9c4199b6bcff1db31ff74d95b 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?w=1650&maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c43e175ee5ae7c1ede504b2a4e5dc6d5 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?w=2500&maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ff1b81e4092a8378def814864f0d5ac8 2500w" data-optimize="true" data-opv="2" />
      * 添加 IP 的示例：
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d0d9cde18e32305b3b725a6319c55651" alt="ip-add-example.png" width="222" height="82" data-path="images/proxy-networks/faqs/ip-add-example.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?w=280&maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=cb92c7bb958479d9870506a316f6760c 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?w=560&maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0fd611195ad49f67af68339ebf8699c3 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?w=840&maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4867ab10946eea6b0779af10da4e8465 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?w=1100&maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c5b6bbc36978e629b16f96dcfcce3419 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?w=1650&maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3f796d5f2ca9e9a2875b15632d6ba91c 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?w=2500&maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=484261c0c5a589cb25d61e8f6e12db3a 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="How to see supported 端口s & 协议s?">
    默认情况下，所有区域都提供端口 80 和 443，支持 HTTP 和 HTTPS 协议。

    在数据中心或 互联网服务提供商（ISP） 类型的代理区域中，默认情况下支持所有高于 1024 的端口。

    在住宅或移动类型的代理区域中，默认情况下以下端口可用：8080、8443、5678、1962、2000、4443、4433、4430、44444 和 1969。

    Bright Data 可以根据要求支持其他端口。 每一项支持新端口的请求将遵循专门的额外合规流程，由 Bright Data 的合规团队执行。

    激活前需要 Bright Data 合规性审查的端口示例：

    | 端口   | 协议    |
    | ---- | ----- |
    | 8443 | HTTP  |
    | 8243 | HTTPS |

    要请求向您的区域添加端口权限，请执行以下操作：

    * 进入您区域的设置（默认情况下它将在“配置”选项卡上打开，如果没有，请点击）
    * 向下滚动到“高级选项”，然后点击
    * 启用“端口”
    * 输入您想获得批准的端口号
    * 填写表格，等待我们的合规团队与您联系并批准申请

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8f7a07929b754153ea7bcdb5cd694a96" alt="add-ports.gif" width="1828" height="978" data-path="images/proxy-networks/faqs/add-ports.gif" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=280&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4cdebdc4fc77c5c7ec627ed72bb3711e 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=560&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=621bba8c5764779d6a593bfa7dff671c 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=840&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8bd6dda3e631778f028bed40a55944ef 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=1100&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9a525823504d24e8b675244fef786c66 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=1650&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=016680c4f990848121b7137bc8e8e470 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=2500&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c5a061323e37be5b0f7b459f02d8f236 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="如何定位特定的操作系统？">
    Bright Data 允许定位以下操作系统：

    <CodeGroup>
      ```sh Windows
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-windows:<zone_password> --proxy brd.superproxy.io:33335 "<target_site>"
      ```

      ```sh macOS
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-osx:<zone_password> --proxy brd.superproxy.io:33335 "<target_site>"
      ```

      ```sh Android
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-android:<zone_password> --proxy brd.superproxy.io:33335 "<target_site>"
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="如何刷新分配给您的区域 IP？">
    如果您在区域配置中选择了“按 IP 付费”的共享地址或专用 IP 类型，则系统将为您分配一个固定 IP 地址。根据您的用例，您可能需要不时刷新这些 IP 地址。

    要刷新分配给您的区域 IP，请导航到所选区域，在“已分配的 IP”下点击 “显示已分配的 IP”， 选中您要刷新的 IP 或 gIP 的复选框 ，然后点击“刷新”

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9a072edcc7d8329a525f4b0e3ec89849" alt="refresh-ips.gif" width="1892" height="868" data-path="images/proxy-networks/faqs/refresh-ips.gif" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=280&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3e069c1d9efdc57fa3028e437ed053fa 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=560&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b685c6696ece105061da5680ba285314 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=840&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3351c3aee8a4784c020acf6077cbb962 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=1100&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c78525f268a2e266fdcffc8f2d7bcac4 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=1650&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e168df26bb68ac033290abe45eb60d9e 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=2500&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=dd549db272ead649e10cc291b39c5340 2500w" data-optimize="true" data-opv="2" />

    <Note>刷新 IP 或 gIP 将产生额外费用。</Note>

    或者，您可以使用 API 刷新您的专用住宅 IP 或 数据中心/ISP IP
  </Accordion>

  <Accordion title="如何使用特定 IP？">
    使用 Bright Data 的住宅代理网络时，您可能会发现需要使用分配给您的区域的特定 IP。

    1. 发送添加了 “—verbose” 或 “-v” 选项的测试请求 （这将开启详细日志记录）

    ```sh
    curl "https://lumtest.com/myip.json" --verbose --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
    ```

    2. 找到 x-brd-ip 响应标头并复制其值

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ae57da3518779f40a958f78a00ecfedf" alt="x-brd-ip.png" width="423" height="23" data-path="images/proxy-networks/faqs/x-brd-ip.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=280&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4578ce7b27745497ae8123a53a852500 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=560&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=eea20a9293172fd0a758c50ab8438dca 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=840&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7549acd6febbfb9404217c4337ae4713 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=1100&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f2376a4f21caa18b90f3501d109f1c2e 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=1650&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=79eece5f221dab3bf68b12a7611e0a84 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=2500&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8d41955b988378d12e7838ad4e5a3b15 2500w" data-optimize="true" data-opv="2" />

    3. 在请求中区域名称后面添加 -ip-标志，并使用在上一步中复制的哈希 IP 值

    4. 发送测试请求，然后查看响应

    ```sh
    curl "https://lumtest.com/myip.json" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-<hashed-ip>:<zone_password>
    ```

    我们建议使用 [https://lumtest.com/myip.json](https://lumtest.com/myip.json) 作为定位域名进行测试，并查看您的 IP 凭证。
  </Accordion>

  <Accordion title="How to target an ASN specific IP?">
    可以通过在“地理位置定位”下将 ASN 参数添加到您的区域配置中来启用此功能。

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=382d3e5f40fd938e5a84ae2849fd0c3e" alt="asn-targeting.png" width="583" height="931" data-path="images/proxy-networks/faqs/asn-targeting.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=280&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=77b6b1aa38626011a34ca6486219d353 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=560&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e6630c50ab7413f6837e8d326ba00b3f 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=840&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6e220de756396a15aaba32b6c5da186f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=1100&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=da2df73c5b2c0d5d37cbe06ee086f73b 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=1650&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5664f5ee339248026f6350324c0adcbf 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=2500&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6df52c82ff5d02aeb05a43655e73736c 2500w" data-optimize="true" data-opv="2" />

    保存配置后，可以将 ASN 标志添加到区域的凭据中，并在使用住宅代理时将其集成。

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-asn-<asn-number>:<zone_password> "<target_site>"
    ```

    **注意**：ASN 编号的值可在此处找到: [https://bgp.potaroo.net/cidr/autnums.html](https://bgp.potaroo.net/cidr/autnums.html)
  </Accordion>

  <Accordion title="如何定位住宅 IP 群组 (gIP)？">
    可以通过 gIP 的形式选择专用住宅 IP。可以通过选择“专用” IP 类型并选择 gIP 数量，在区域的配置页面下对其进行分配。还需要定位特定的域名。

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c6271c5594fac3f6861969bd7af27f1e" alt="number-of-dedicated-gIPs.png" width="645" height="909" data-path="images/proxy-networks/faqs/number-of-dedicated-gIPs.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=280&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5dbdca062126def5cb6056cefbb9b7dd 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=560&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9bcacda84b73566eae2020e039b2e38b 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=840&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0d9c62f26e4bd3d36d89ee278440d204 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=1100&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=42f6b5b50b0e87f20029e4a89df13c2b 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=1650&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=655cc189fd49c7ffeb9b739f59a23ebd 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=2500&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=15972b33cfafd930e2d7b90d18768248 2500w" data-optimize="true" data-opv="2" />

    保存配置后，选择“显示分配的专用住宅 IP” 将提供一个代表群组 IP 的哈希值列表。
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=75d1f6c97b99b54c4bb1f4e6ac222b09" alt="show-allocated-dedicated-ips.png" width="583" height="393" data-path="images/proxy-networks/faqs/show-allocated-dedicated-ips.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=280&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2d56759505ae73cd244f0a59e673516d 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=560&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6ff579ae3da9b8a1fb08048c5cd40f42 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=840&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e9e229a90011d93f9128b7a67e47b47a 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=1100&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d26dd0084f0f82302519b8c73013a03c 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=1650&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=1936faef05312195dd9c83c8960bed3a 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=2500&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fd1c5fca0c04634e370f8b82cd451fb1 2500w" data-optimize="true" data-opv="2" />

    这些值可用于定位特定的 gIP。 例如：

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-gip-<gip_hash_value>:<zone_password> "<target_site>"
    ```
  </Accordion>

  <Accordion title="如何启用长会话对等点">
    长会话对等点使您能够在很长一段时间内保持稳定的 IP 地址，从而确保顺畅一致的抓取操作。 与常规住宅 IP 不同，如果对等点意外断开连接，IP 可以随时轮换，而长会话对等点则提供连续会话。

    **启用长会话对等点**

    很简单，只需前往现有的住宅区或打开一个新的住宅区域，然后打开“长时间会话对等点”功能即可。 现在，您未来的请求将仅通过已知的长期对等点方路由。\
    **注意**： 启用此功能后，确实会增加该区域的额外费用

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ceae664decd0148cb282001dd123898c" alt="long-session-peers.png" width="567" height="286" data-path="images/proxy-networks/faqs/long-session-peers.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?w=280&maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e8d1fd864c37a05db277361552f03f39 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?w=560&maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=96a200c7e795df0996b2446266395b85 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?w=840&maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e414da5c55131589268b1fd5d526b336 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?w=1100&maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b26c67e46f8139650350b404747aebe4 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?w=1650&maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fe7d9da5ecdefd978a2f3c05c0ef69da 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?w=2500&maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=efdade17ab582f8edfa18810e28216a7 2500w" data-optimize="true" data-opv="2" />

    **这些对等点来自哪里？**

    我们的住宅对等点资源池由来自全球各地选择使用我们产品的真实用户组成。作为使用选择的一部分，我们将这些真实用户在“停机”期间的 IP 作为我们符合道德标准的住宅网络的一部分。通过启用长会话对等点，您可以确保通过已知长时间保持活跃状态的对等点进行路由，并且与普通住宅对等点相比，可以将单个 IP 地址保留更长时间

    **长会话对等点的优势**

    持续的抓取操作：这种稳定性最大限度地减少了因 IP 变更而造成的中断，并最大限度地提高了抓取任务的效率。 您可以长期依赖同一 IP 地址，从而可以进行长时间的抓取操作。 此功能对于需要连续数据提取或监控的项目特别有用。
  </Accordion>

  <Accordion title="如何使用中国住宅 IP 浏览中文网站">
    **在中国境外时**

    定位中国住宅 IP 对等点即可：

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-cn:<zone_password> "<target_site>"
    ```

    在中国境内除了定位中国住宅 IP 对等点之外，还需要定位我们的中国超级代理。

    * 使用 API 命令时，代理 DNS 服务器为 servercountry-cn.brd.superproxy.io

    ```sh
    curl --proxy servercountry-cn.brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-cn:<zone_password> "<target_site>"
    ```

    * 使用代理管理器时：
      * 只需点击端口即可选择相关的端口设置\
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=60c9b798eabd855e54f15c9ed30532c2" alt="port-row.png" width="1490" height="231" data-path="images/proxy-networks/faqs/port-row.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=280&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=1faa89a7b9389f25ce2f2df9ae193acb 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=560&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=efb6903924f8bd83b6dcb191861c4ff2 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=840&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d1de11eb98f22e136fd84756eab9be3c 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=1100&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=abd917c6d5a4876eedaab8df719ca48d 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=1650&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=279bcb4f18934e70b834c32766d4dcba 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=2500&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7074af21c015ff4464baacf4e6ff8cc7 2500w" data-optimize="true" data-opv="2" />
      * 选择定位并将中国设置为定位国家\
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4e9d4ff832de3da6c12d54b8e7117f87" alt="target-china.png" width="1848" height="459" data-path="images/proxy-networks/faqs/target-china.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=280&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7e8a54f7f5fef55ea745a2bcecc2b134 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=560&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0b6da7728c8d55330dedee5688064a58 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=840&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6a1153555ae45d3e58cb2b55bb5080a7 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=1100&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=35475a8710d937c48354ee0706a6b9ff 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=1650&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9e78a53887ad4d63f83c1da8e89e6d86 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=2500&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4a583a62f471c4fc8ef963a9d0890a64 2500w" data-optimize="true" data-opv="2" />
      * "选择 IP 控制：将超级代理位置设置为“中国”。
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=79fc7dda8eb2f7f223ccb1e7229dfec4" alt="super-proxy-china.png" width="1838" height="566" data-path="images/proxy-networks/faqs/super-proxy-china.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=280&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=dd62f53444546238099ce3daf1d86320 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=560&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6de9045b2c50ee90605f0da550a87d7e 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=840&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9f6435bff0c6d7dcc194a1466059bafe 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=1100&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2364095b48753d17748d25742385971b 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=1650&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d2d9cba66d209296757cfdd139679ebe 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=2500&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5eef24fd9763e130b83ee9e9f7bde87f 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="运营商专属代理对等点 IP">
    * 您可以选择使用以下列表中的特定运营商：

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

    * 例如

    <CodeGroup>
      ```sh Deutsche Telekom
      brd-customer-<customer_id>-zone-<zone_name>-carrier-dt
      ```

      ```sh Sprint
      brd-customer-<customer_id>-zone-<zone_name>-carrier-sprint
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="关于地理位置数据库，以及如何检查代理 IP 信息？">
    互联网网站使用地理位置数据库 (GeoDB) 来查询有关用户所使用的 IP 地址的信息。 Bright Data 监控并维护当今使用的 4 个主要 GeoDB 的准确记录：Maxmind、ip2location、db-ip 和 Google。

    还有许多其他较小的 GeoDB，其中大多数使用的是过时的记录或有缺陷的测试方法，因此所提供的信息不够准确，或者只是为了吸引浏览者从他们那里购买 VPN 或代理产品而提供。 因此，我们强烈建议在测试您的 IP 时使用上述 GeoDB。

    要查看我们有关您正在使用的代理 IP 的信息，请浏览以下内容之一：

    * [https://lumtest.com/echo.json](https://lumtest.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="哪些 Bright Data 产品最适合抓取搜索引擎结果页面 (SERP)？">
    #### 对于单步抓取：

    SERP API 是定位搜索引擎结果页面 (SERP) 的理想产品，因为它通过主动解锁，可以保证成功率（仅按成功付费），自动选择最佳代理，自定义标题，指纹识别，解析验证码等。

    #### 对于多步抓取（playwright/puppeteer/selenium）：

    抓取浏览器是一款理想产品，因为它作为我们完全云托管的浏览器，旨在帮助您轻松地专注于多步数据收集，同时我们会为您处理完整的代理和解锁基础架构，包括验证码求解。
  </Accordion>

  <Accordion title="我能否可以从住宅、数据中心或 互联网服务提供商（ISP） 代理网络定位 Google SERP？">
    **住宅 Proxy** - No, 但是， SERP API 是定位搜索引擎结果页面的理想产品，因为它通过主动解锁、自动选择最佳代理、自定义标题、指纹识别、解析验证码等功能保证成功率（仅按成功付费）。Targeting Google SERPs from the 住宅 network will result in Super-proxy bypass, which will casue the request to be sent from our servers instead of the peer.

    \*\*数据中心和 ISP 代理 - 不可以。当您尝试通过这两个代理网络专门定位 Google 时，您的请求将被拒绝，并且您将在响应标题中收到以下错误消息：

    ```
    HTTP/1.1 403 搜索 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. 您可以联系您的账户经理或开立支持工单以寻求帮助
    ```
  </Accordion>

  <Accordion title="我能否评估任何特定国家/地区的可用 IP 数量？">
    可以，您可以通过该交互式图表评估各个国家/地区可用的 IP 数量: [https://brightdata.com/cp/ips\_availability](https://brightdata.com/cp/ips_availability)

    首先，从下拉菜单中选择国家/地区。 该国家/地区的可用 IP 数量如下所示。

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/available-ips.gif?maxW=1884&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=21340f974b8d68942e8d3e1f9d550375" alt="available-ips.gif" width="1884" height="850" data-path="images/proxy-networks/faqs/available-ips.gif" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/available-ips.gif?w=280&maxW=1884&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b8a2adbfe2c445cb9eab0d67539e7540 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/available-ips.gif?w=560&maxW=1884&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=52a5130cbe7f944eb727ad3980b4fccf 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/available-ips.gif?w=840&maxW=1884&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a01c46fc9f5bf342be409301f2250d2b 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/available-ips.gif?w=1100&maxW=1884&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=267225033e1a032aa78150e31c16fe01 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/available-ips.gif?w=1650&maxW=1884&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c38bdd2fcc84291011e66812a15b5ccb 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/available-ips.gif?w=2500&maxW=1884&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=70ff5e723017dafebc2ef363428df723 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="我可以向 IP 发送请求而不是向域名发送请求吗？">
    不可以 - 使用 Bright 数据时，禁止直接向主机服务器而不是向域名发送请求。\
    使用 URL 格式（如 1.1.1. 1:443）的请求将使用超级代理服务器执行，而不是使用代理对等点 IP。

    使用超级代理的请求示例：

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8e6dbf5d13a5a505ee83311e5423848c" alt="x-luminati-ip.png" width="1431" height="891" data-path="images/proxy-networks/faqs/x-luminati-ip.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=280&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e16c6daf292290c6ab018be163c94542 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=560&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ae65c3d709a142b5df4e6ac680a139b4 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=840&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fad48d3ca58086816807cc0483223f44 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=1100&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e691672a4db29bfcad1c420f69c30608 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=1650&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=30238efbb97cfebaa172def9f97d0f5a 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=2500&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d0c10e74aa99a4b9ef5b172266a00659 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="我可以使用端口 25 或任何其他 SMTP 端口，或者使用代理 IP 发送电子邮件吗？">
    由于 BrightData 十分看重我们的社区和对等点的质量，因此可用于发送垃圾邮件的 SMTP 请求会被屏蔽。 请注意，邮件域名也禁止访问，对邮件域名的请求将从超级代理服务器而不是对等点 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="Bright Data 支持 Socks5 协议吗？?">
    是的。 Bright data supports `SOCKS5` protocol, with a default port 22228 assigned for SOCKS5 communication.

    See here for [full SOCKS5 configuration instructions](https://docs.brightdata.com/cn/proxy-networks/socks5)
  </Accordion>

  <Accordion title="如何控制请求的执行地点？">
    * 您可以选择直接执行来自超级代理的请求，而不是对等点 IP。 在这种情况下，请求的 IP 将是超级代理的 IP。 您需要在请求授权字符串中添加 '-direct' 。
      `brd-customer-<customer_id>-zone-<zone_name>-direct`
  </Accordion>

  <Accordion title="如何刷新会话 (IP)？">
    长时间使用相同的 IP 可以使目标网站更容易将 IP 标记为代理，并且可以使目标网站检测到您的请求。 刷新您的 IP 将导致从 Bright Data 分配新的 IP，而不是资源池中的现有 IP，从而使您可以控制资源池并获得更高的成功率。
  </Accordion>

  <Accordion title="如何使用中国住宅 IP 浏览中文网站？">
    <Tabs>
      <Tab title="如果您在中国">
        您必须使用我们的中文超级代理：

        * 使用代理管理器时：位于“端口设置” > “IP 控制”：将超级代理的位置设置为“中国”。
        * 使用 API 命令时，使用 servercountry-cn.brd.superproxy.io

        示例：

        ```sh Shell
        curl "https://target-chinese-网站.com" --proxy servercountry-cn.brd.superproxy.io:33335 --proxy-user brd-customer-<custormer_name>-zone-<zone_name>-country-cn:<zone_password>
        ```
      </Tab>

      <Tab title="如果您不在中国">
        No special settings required.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="如何在单个会话中长时间使用特定的住宅 IP？">
    <Note>
      住宅/移动 IP 是真实用户设备的 IP，因此只能在用户的设备处于闲置状态（即设备已连接到互联网、有足够的电池电量且用户当前未使用）时才能使用。
    </Note>

    如果该 IP 不可用，我们的系统将自动为您分配另一个与您使用相同类型和地理位置的可用住宅 IP。
  </Accordion>

  <Accordion title="什么是错误代码 502？">
    HTTP 错误代码 502 表示“网关错误”。当您向 URL 发送请求，但该 URL 的服务器收到来自另一台服务器的无效响应且依赖该服务器来完成请求时，就会出现此错误。

    **可能原因**

    * 我们目前没有匹配您的区域配置的对等点，因为它们可能已经在其他客户端上使用，或者由于其他原因不可用。
    * 由于没有活动，连接已超时。
    * 主机（目标 URL）端已关闭连接

    **示例错误 502 响应**

    ```
    Request URL: SAMPLE_URL Request method: GET ***Status code: 502***  
    Super proxy IP: IP  
    Username: brd-customer-customer_id-zone-zone_name-country  
    Password: zone_password  
    Sent from: 127.0.0.1  
    Response headers  
    connection: keep-alive  
    date: Tue, 14 Feb 2023 08:49:16 GMT  
    keep-alive: timeout=5  
    transfer-encoding: chunked  
    x-lpm-port: 24000  
    x-luminati-error: waiting for selector ".price-container" failed: timeout 90000ms exceeded  
    ***x-luminati-error-code: expect_element***  
    x-request-id2: REQUEST_ID  
    Request headers  
    user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36(KHTML, like Gecko) Chrome/110.0.0.0 Safari/537.36  
    host: SAMPLE_HOST  
    accept-encoding: gzip, deflate  
    Connection: keep-alive
    ```
  </Accordion>

  <Accordion title="什么是错误代码 403？">
    HTTP 403 响应代码表示禁止您访问有效的网址。

    服务器可以理解请求，但由于客户端的问题，无法完成请求。

    **可能原因**

    * 您的机器 IP 未列入白名单。 要了解如何将 IP 列入白名单，请查阅以下文章。
      [https://docs.brightdata.com/cn/api-reference/proxy-manager/allowlist-ips](https://docs.brightdata.com/cn/api-reference/proxy-manager/allowlist-ips)
    * 您尝试访问的域名被 Bright Data 屏蔽 。
    * 您的用例中未指定您尝试访问的域名。
    * 验证码响应失败（与 Web 解锁器和 SERP API 相关）。
    * 您尝试访问的域名已被您区域的目标主机设置禁止（请检查代理区域的访问参数）

    **示例错误 403 响应**

    ```
    < HTTP/1.1 403 response status was rejected  
    < x-debug-req-id: SAMPLE_ID  
    < X-Luminati-Error: response status was rejected: 403 Forbidden  
    < X-Luminati-Error-Code: http_status  
    < Date: Wed, 22 Feb 2023 11:11:23 GMT  
    < Connection: keep-alive  
    < Keep-Alive: timeout=5  
    < Transfer-Encoding: chunked
    ```

    403 X-luminati-error（禁止）表明您的目标域名是 Bright Data 不允许的域名 

    这个问题可以通过联系 Bright 数据合规团队获得批准来解决。
    当 Bright 数据合规团队审查您的用例并确认时，您将被告知访问权限已添加。
    为了更好地处理，建议将您的账户经理添加到工单中，并明确告知他您的要求 

    出现错误消息时：

    ```
    您试图定位<host>，但被屏蔽了
    ```

    如果出现这种情况，请联系 Bright 数据合规团队 ([compliance@brightdata.com](mailto:compliance@brightdata.com)) 或通过工单系统联系 

    我们的合规团队将审查您获得特定域名访问权限的请求
  </Accordion>
</AccordionGroup>


# 数据中心代理简介
Source: https://docs.brightdata.com/cn/proxy-networks/data-center/introduction

Bright Data的数据中心代理网络提供160多万个IP（来自超过98个国家/地区），为您带来速度最快、最具成本效益的代理解决方案，欢迎探索。

Bright Data的数据中心代理网络是我们的代理网络解决方案之一，具有160多万个IP（来自超过98个国家/地区）。

数据中心代理是由数据中心服务器分配的IP，您的流量会通过这些IP进行路由，这可以帮助您访问世界各地的IP和位置。 数据中心代理的路径更短、架构简化，所以是速度最快的代理类型，也是最具成本效益的选项。

## 最适用于

* 访问没有使用复杂屏蔽方法的网站
* 当您需要最具成本效益的代理网络时
* 当您需要速度最快的代理网络时
* 管理多个在线个人资料档案

<Tip>
  如果您需要更复杂、成功率更高的代理网络，可以考虑使用我们的ISP或住宅代理网络。要获得更高级、完全托管的代理解锁解决方案，建议您尝试我们的Unlocker API，或浏览我们的其他 代理解决方案。
  要获得更高级、完全托管的代理解锁解决方案，建议您尝试我们的Unlocker API，或浏览我们的其他 代理解决方案。
</Tip>


# 如何开始使用数据中心代理
Source: https://docs.brightdata.com/cn/proxy-networks/data-center/quickstart



<Tip>
  如果您尚未注册 Bright Data，则可以免费注册，添加付款方式时，您将 获得价值 \$5 的积分以开启服务！\
  [https://brightdata.com/](https://brightdata.com/)
</Tip>

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">登录</a>} />

  <Step title="导航到“我的区域”">
    <Accordion title="在“我的区域”页面的“数据中心代理”下，点击“开始”">
      <Warning>
        如果您已经有活跃代理，只需选择右上角的“添加”
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/get_started.png?maxW=1157&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=3ca96e786eacec63397440db8d11f38f" alt="开始" width="1157" height="888" data-path="images/proxy-networks/data-center/get_started.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/get_started.png?w=280&maxW=1157&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=6e45c907b9672da2db515697d565ba2f 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/get_started.png?w=560&maxW=1157&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=5674ae7eb8f2f138522aeeb98382dd9f 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/get_started.png?w=840&maxW=1157&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=644b02ab995ff95049398cd409d97050 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/get_started.png?w=1100&maxW=1157&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=6491975d1dd1cd046979a9cce9582adf 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/get_started.png?w=1650&maxW=1157&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d8002fd66d490d7f8a6499ca343c1d43 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/get_started.png?w=2500&maxW=1157&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=72a6afe3b9c1f1cd749cd9de09c2e3c6 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="选择您的代理名称">
    <Accordion title="输入新数据中心代理的代理名称">
      <Warning>
        请选择一个有意义的名称，因为区域名称一旦创建就无法更改。
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/add_a_new_proxy.png?maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=8972eea15de1a8f79f765e4676913036" alt="开始" width="530" height="729" data-path="images/proxy-networks/data-center/add_a_new_proxy.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/add_a_new_proxy.png?w=280&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=5dbe052bce248cf990e85fc396204c2e 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/add_a_new_proxy.png?w=560&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=100f777124c7af6068e8a59b79f3c707 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/add_a_new_proxy.png?w=840&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9d0fcf7fb7d25d1b78d6f740630cb09c 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/add_a_new_proxy.png?w=1100&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9ac21929d83d18c18a3f4376aabafb4e 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/add_a_new_proxy.png?w=1650&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=3e8982b497d8cc2a7ac4fee61428c677 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/add_a_new_proxy.png?w=2500&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=696c54eb203c5a70ded3646a573c91ad 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="点击“添加代理”" />
</Steps>

<Accordion title="在继续操作之前，请验证您的账户">
  如果您尚未添加付款方式，此时系统会提示您添加付款方式以验证您的账户。 如果您是第一次使用 Bright Data，您还将获得价值 \$5 的奖励积分以帮助您开启服务！

  <Tip>
    此时不会向您收取任何费用，这仅用于验证目的
  </Tip>
</Accordion>

<Note>
  别担心，我们将在下一节“配置您的代理”中介绍所有配置:\
  [https://docs.brightdata.com/cn/proxy-networks/data-center/configure-your-proxy](https://docs.brightdata.com/cn/proxy-networks/data-center/configure-your-proxy)
</Note>


# 发送您的第一个请求
Source: https://docs.brightdata.com/cn/proxy-networks/data-center/send-your-first-request

通过多种编程语言易于理解的代码示例，了解如何使用 Bright Data 的代理产品发送您的第一个请求。

<Accordion title="本指南适用于所有代理产品" icon="check">
  1. 住宅代理
  2. 移动代理
  3. 互联网服务提供商（ISP） 代理
  4. 数据中心代理
  5. SERP API
  6. 抓取浏览器
  7. 网络解锁器
</Accordion>

要开始使用，您需要代理凭证、用户名和密码以及主机名。您可以在代理产品的访问参数或概述选项卡中找到这些凭据。

## 代码示例

获得代理凭证后，使用以下代码发送您的第一个请求：

<CodeGroup>
  ```sh cURL
  curl "http://lumtest.com/myip.json" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```javascript Node.js
  #!/usr/bin/env node

  require('request-promise')({
      url: 'http://lumtest.com/myip.json',
      proxy: 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:33335',
    })
    .then(function (data) {
        console.log(data);
      },
      function (err) {
        console.error(err);
      });
  ```

  ```python Python
  import pprint
  import requests


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

  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://lumtest.com/myip.json"
  response = requests.get(url, proxies=proxies)
  pprint.pprint(response.json())

  ```

  ```php PHP

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

  ```

  ```ruby Ruby
  #!/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://lumtest.com/myip.json')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 33335, '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#
  using System;
  using System.Net;

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

  ```java Java
  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", 33335);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("http://lumtest.com/myip.json").viaProxy(proxy))
              .returnContent().asString();
          System.out.println(res);
      }
  }
  ```

  ```perl Perl
  #!/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:33335");
  print $agent->get('http://lumtest.com/myip.json')->content();
  ```

  ```vb VBA
  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:33335")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("http://lumtest.com/myip.json"))
      End Sub
  End Module
  ```
</CodeGroup>

上面的代码使用住宅代理向 [http://lumtest.com/myip.json发送请求。](http://lumtest.com/myip.json发送请求。) 它以 JSON 格式返回您的 IP 信息：

```json 输出
{
  "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"
  }
}
```

现在，将 “[https://lumtest.com/myip.json”](https://lumtest.com/myip.json”) 替换为您选择的网站，然后...

**就是这样！**


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

浏览Bright Data HTTP错误目录，包括错误代码、描述和解决常见代理问题的操作。

# Bright Data HTTP错误

## HTTP标头字段

HTTP或HTTPS请求将返回以下字段：

| 字段               | 描述                   | 示例                                                                                                                         |
| ---------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `HTTP错误`         | 协议错误编号               | `404` or `502`                                                                                                             |
| `x-brd-err-code` | Bright Data模块和错误代码编号 | `client_10001`                                                                                                             |
| `x-brd-error`    | Bright data主错误消息     | 验证失败                                                                                                                       |
| `x-brd-err-msg`  | Bright Data详细消息和操作建议 | 验证失败。 请到 [https://brightdata.com/cp/settings/billing\`检查您的凭据或账户状态](https://brightdata.com/cp/settings/billing`检查您的凭据或账户状态) |

### 获取HTTP标头字段

#### 从命令行进行测试

要查看和测试您的设置或解决问题，您可以在shell提示符下运行curl命令，并添加选项标志-v 。此标志将以详细模式运行curl并打印出标头字段，包括自定义错误代码和消息。

```
curl-v [其他curl命令选项]
```

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

```
curl -i [rest of curl command options]
```

或者，您可以使用nc命令将字段打印到屏幕上：

```
echo "[tcp nc inputs]" | nc -C -v brd.superproxy.io 33335
```

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

#### 通过编程语言访问

Bright Data HTTP标头字段就像任何其他HTTP标头字段一样，可以通过您的编程语言访问。

## 错误目录

### HTTP错误 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.

| x-brd-err-code | x-brd-error                                              | x-brd-err-msg                                                                                                                                     |
| -------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `client_10060` | Proxy Error: 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 |

### HTTP错误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.

| x-brd-err-code | x-brd-error                                                                             | x-brd-err-msg                                                                                                 |
| -------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `client_10000` | 验证失败                                                                                    | 验证无效：检查凭据并重试. Bright Data credentials include your account ID, zone name and password                         |
| `client_10001` | 验证无效                                                                                    | 验证无效：检查凭据并重试                                                                                                  |
| `client_10010` | 需要代理验证                                                                                  | 未提供代理凭据。 请添加凭据，然后重试。                                                                                          |
| `client_10020` | 账户已被暂停。 请登录brightdata.com/cp/setting/billing激活您的账户                                      | 账户已被暂停。 请登录[https://brightdata.com/cp/setting/billing激活您的账户](https://brightdata.com/cp/setting/billing激活您的账户) |
| `client_10030` | 验证失败                                                                                    | 您无法通过此IP访问我们的API。 请检查您的设置，或将此IP列入白名单。                                                                         |
| `client_10040` | 需要 KYC。 请访问[http://brighdata.com/cp/kyc并确保您已通过验证](http://brighdata.com/cp/kyc并确保您已通过验证) | 需要 KYC。 请访问[http://brighdata.com/cp/kyc并确保您已通过验证](http://brighdata.com/cp/kyc并确保您已通过验证)                       |

### HTTP错误401

| x-brd-err-code | x-brd-error         | x-brd-err-msg                                                                                                                        |
| -------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `client_10050` | 验证失败：IP被列入黑名单 \[IP] | 验证失败，IP被列入黑名单 \[IP] 请查看[https://brightdata.com/faq#remove-blacklist\_ips以解决问题](https://brightdata.com/faq#remove-blacklist_ips以解决问题) |

### HTTP错误403

| x-brd-err-code | x-brd-error                                                                                                                                                                                                                                                                                                           | x-brd-err-msg                                                                                                                                                                                                                                                                                                         |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `client_10070` | 没有协议                                                                                                                                                                                                                                                                                                                  | 原始请求中缺少协议。 请添加HTTP或HTTPS，然后重试。                                                                                                                                                                                                                                                                                        |
| `client_10080` | 没有目标主机                                                                                                                                                                                                                                                                                                                | 没有目标主机。 目标主机缺失或不正确。 请检查您的请求参数，然后重试                                                                                                                                                                                                                                                                                    |
| `client_10090` | 您正在尝试将Browser API区域用作常规代理                                                                                                                                                                                                                                                                                             | 您正在尝试将Browser API区域用作常规代理。 此区域应通过浏览器访问。详见 请参阅[https://docs.brightdata.com/cn/scraping-automation/scraping-browser/introduction，了解如何访问您的Browser](https://docs.brightdata.com/cn/scraping-automation/scraping-browser/introduction，了解如何访问您的Browser) API区域。                                                              |
| `policy_20010` | 协议错误                                                                                                                                                                                                                                                                                                                  | 您使用的协议不受支持。 Bright data supports HTTP, HTTPS & SOCKS5 upon special approval. 请纠正您的协议，然后重试                                                                                                                                                                                                                             |
| `policy_20020` | 端口错误                                                                                                                                                                                                                                                                                                                  | 使用了错误的端口。 我们支持的端口：[https://docs.brightdata.com/cn/proxy-networks/faqs#how-to-see-supported-ports-and-protocols](https://docs.brightdata.com/cn/proxy-networks/faqs#how-to-see-supported-ports-and-protocols)                                                                                                          |
| `policy_20130` | 住宅 Failed (bad\_endpoint) - Requested site is not available for immediate residential (no KYC) access mode due to the fact that %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) | 住宅 Failed (bad\_endpoint) - Requested site is not available for immediate residential (no KYC) access mode due to the fact that %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` | 住宅 Failed (bad\_endpoint) - Requested site is not available for immediate residential (no KYC) access mode in accordance with robots.txt. To get full residential access for targeting this site, Fill in the KYC form: [https://brightdata.com/cp/kyc](https://brightdata.com/cp/kyc)                                | 住宅 Failed (bad\_endpoint) - Requested site is not available for immediate residential (no KYC) access mode in accordance with robots.txt. To get full residential access for targeting this site, Fill in the KYC form: [https://brightdata.com/cp/kyc](https://brightdata.com/cp/kyc)                                |

### HTTP错误 429

| x-brd-err-code | x-brd-error                                                                                                                                                | x-brd-err-msg                                                                                                                                              |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `client_10110` | Your limited trial mode account exceeded the allowed rate limits. Add payment method to receive \$5 credit and remove rate limits. You will not be charged | Your limited trial mode account exceeded the allowed rate limits. Add payment method to receive \$5 credit and remove rate limits. You will not be charged |

***


# 代理产品常见问题解答
Source: https://docs.brightdata.com/cn/proxy-networks/faqs

Find answers to common questions about integrating, configuring, and using Bright Data's proxy products, including IP types, geotargeting, and error codes.

<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 描述 to the zone, and you can change that 描述 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](https://docs.brightdata.com/cn/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="与第三方工具集成">
    Bright Data可以轻松集成到许多第三方工具中。 通常，只需使用您的Bright Data产品凭据来配置HTTP/HTTPS代理即可。 If you are using residential proxies, Unlocker API or SERP API don't forget to [use the SSL certificate](https://docs.brightdata.com/cn/general/account/ssl-certificate) to ensure and to end encrypted connections.

    我们为最常用的工具准备了详细的指南。 您可以在以下的列表中找到指南的链接：

    BrowserScan 	[https://docs.brightdata.com/integrations/browserscan](https://docs.brightdata.com/integrations/browserscan)

    XLogin 		[https://docs.brightdata.com/integrations/xlogin](https://docs.brightdata.com/integrations/xlogin)

    GeeLark 	[https://docs.brightdata.com/integrations/geelark](https://docs.brightdata.com/integrations/geelark)

    Puppeteer 	[https://docs.brightdata.com/integrations/puppeteer](https://docs.brightdata.com/integrations/puppeteer)

    Playwright 	[https://docs.brightdata.com/integrations/playwright](https://docs.brightdata.com/integrations/playwright)

    Selenium 	[https://docs.brightdata.com/integrations/selenium](https://docs.brightdata.com/integrations/selenium)

    AdsPower 	[https://docs.brightdata.com/integrations/adspower](https://docs.brightdata.com/integrations/adspower)

    Dolphin Anty 	[https://docs.brightdata.com/integrations/dolphin-anty](https://docs.brightdata.com/integrations/dolphin-anty)

    Incogniton 	[https://docs.brightdata.com/integrations/incogniton](https://docs.brightdata.com/integrations/incogniton)

    Marketerbrowser [https://docs.brightdata.com/integrations/marketerbrowser](https://docs.brightdata.com/integrations/marketerbrowser)

    SMLOGIN 	[https://docs.brightdata.com/integrations/smlogin](https://docs.brightdata.com/integrations/smlogin)

    Hidemyacc 	[https://docs.brightdata.com/integrations/hidemyacc](https://docs.brightdata.com/integrations/hidemyacc)

    OpenBullet	[https://docs.brightdata.com/integrations/openbullet](https://docs.brightdata.com/integrations/openbullet)

    Switchyomega 	[https://docs.brightdata.com/integrations/switchyomega](https://docs.brightdata.com/integrations/switchyomega)

    PhantomBuster 	[https://docs.brightdata.com/integrations/phantombuster](https://docs.brightdata.com/integrations/phantombuster)

    BitBrowser 	[https://docs.brightdata.com/integrations/bitbrowser](https://docs.brightdata.com/integrations/bitbrowser)

    Maskfog 	[https://docs.brightdata.com/integrations/maskfog](https://docs.brightdata.com/integrations/maskfog)

    Ghost Browser 	[https://docs.brightdata.com/integrations/ghost-browser](https://docs.brightdata.com/integrations/ghost-browser)

    Postman 	[https://docs.brightdata.com/integrations/postman](https://docs.brightdata.com/integrations/postman)

    NGINX 		[https://docs.brightdata.com/integrations/nginx](https://docs.brightdata.com/integrations/nginx)

    StablerSOLO 	[https://docs.brightdata.com/integrations/stablersolo](https://docs.brightdata.com/integrations/stablersolo)

    VMLogin 	[https://docs.brightdata.com/integrations/vmlogin](https://docs.brightdata.com/integrations/vmlogin)

    GoLogin 	[https://docs.brightdata.com/integrations/gologin](https://docs.brightdata.com/integrations/gologin)

    Windows 	[https://docs.brightdata.com/integrations/windows](https://docs.brightdata.com/integrations/windows)

    Scrapy 		[https://docs.brightdata.com/integrations/scrapy](https://docs.brightdata.com/integrations/scrapy)

    AEZAKMI 	[https://docs.brightdata.com/integrations/aezakmi](https://docs.brightdata.com/integrations/aezakmi)

    Beautifulsoup 	[https://docs.brightdata.com/integrations/beautifulsoup](https://docs.brightdata.com/integrations/beautifulsoup)

    WebHarvy 	[https://docs.brightdata.com/integrations/webharvy](https://docs.brightdata.com/integrations/webharvy)

    Ubuntu 		[https://docs.brightdata.com/integrations/ubuntu](https://docs.brightdata.com/integrations/ubuntu)

    Lalicat 	[https://docs.brightdata.com/integrations/lalicat](https://docs.brightdata.com/integrations/lalicat)

    Multilogin 	[https://docs.brightdata.com/integrations/multilogin](https://docs.brightdata.com/integrations/multilogin)

    Undetectable 	[https://docs.brightdata.com/integrations/undetectable](https://docs.brightdata.com/integrations/undetectable)

    Apify 		[https://docs.brightdata.com/integrations/apify](https://docs.brightdata.com/integrations/apify)

    iPhone 		[https://docs.brightdata.com/integrations/ios](https://docs.brightdata.com/integrations/ios)

    MuLogin 	[https://docs.brightdata.com/integrations/mulogin](https://docs.brightdata.com/integrations/mulogin)

    Changedetection [https://docs.brightdata.com/integrations/changedetection](https://docs.brightdata.com/integrations/changedetection)

    Morelogin 	[https://docs.brightdata.com/integrations/morelogin](https://docs.brightdata.com/integrations/morelogin)

    Proxifier 	[https://docs.brightdata.com/integrations/proxifier](https://docs.brightdata.com/integrations/proxifier)

    Texau 		[https://docs.brightdata.com/integrations/texau](https://docs.brightdata.com/integrations/texau)

    Android 	[https://docs.brightdata.com/integrations/android](https://docs.brightdata.com/integrations/android)

    Kameleo 	[https://docs.brightdata.com/integrations/kameleo](https://docs.brightdata.com/integrations/kameleo)

    Screaming Frog 	[https://docs.brightdata.com/integrations/screaming-frog](https://docs.brightdata.com/integrations/screaming-frog)

    Foxy		[https://docs.brightdata.com/integrations/foxyproxy](https://docs.brightdata.com/integrations/foxyproxy)

    SessionBox 	[https://docs.brightdata.com/integrations/sessionbox](https://docs.brightdata.com/integrations/sessionbox)

    Insomniac 	[https://docs.brightdata.com/integrations/insomniac](https://docs.brightdata.com/integrations/insomniac)

    Helium Scraper 	[https://docs.brightdata.com/integrations/helium-scraper](https://docs.brightdata.com/integrations/helium-scraper)

    SaleFreaks 	[https://docs.brightdata.com/integrations/salefreaks](https://docs.brightdata.com/integrations/salefreaks)

    Postern 	[https://docs.brightdata.com/integrations/postern](https://docs.brightdata.com/integrations/postern)

    Antik 		[https://docs.brightdata.com/integrations/antik](https://docs.brightdata.com/integrations/antik)

    Easync 		[https://docs.brightdata.com/integrations/easync](https://docs.brightdata.com/integrations/easync)

    ParseHub 	[https://docs.brightdata.com/integrations/parsehub](https://docs.brightdata.com/integrations/parsehub)

    Sphere Browser 	[https://docs.brightdata.com/integrations/sphere-browser](https://docs.brightdata.com/integrations/sphere-browser)

    Octoparse 	[https://docs.brightdata.com/integrations/octoparse](https://docs.brightdata.com/integrations/octoparse)

    ixBrowser 	[https://docs.brightdata.com/integrations/ixbrowser](https://docs.brightdata.com/integrations/ixbrowser)

    Shadowrocket 	[https://docs.brightdata.com/integrations/shadowrocket](https://docs.brightdata.com/integrations/shadowrocket)

    Firefox 	[https://docs.brightdata.com/integrations/firefox](https://docs.brightdata.com/integrations/firefox)

    Chrome 		[https://docs.brightdata.com/integrations/chrome](https://docs.brightdata.com/integrations/chrome)

    MacOS 		[https://docs.brightdata.com/integrations/macos](https://docs.brightdata.com/integrations/macos)

    ClonBrowser 	[https://docs.brightdata.com/integrations/clonbrowser](https://docs.brightdata.com/integrations/clonbrowser)

    Octo Browser 	[https://docs.brightdata.com/integrations/octobrowser](https://docs.brightdata.com/integrations/octobrowser)

    Genlogin 	[https://docs.brightdata.com/integrations/genlogin](https://docs.brightdata.com/integrations/genlogin)

    Web Scraper 	[https://docs.brightdata.com/integrations/webscraper](https://docs.brightdata.com/integrations/webscraper)

    如果您使用的工具没有出现在列表中，而您又希望获得该工具的指南，请联系我们！
  </Accordion>

  <Accordion title="住宅和移动代理的IP类型有哪些？">
    我们的住宅和移动代理提供两种类型的IP：

    <Tabs>
      <Tab title="共享IP">
        由多个用户共享的IP。连接到我们由超过7200万个住宅IP组成的整个网络。使用Proxy Manager、扩展程序或原始API 命令，在国家、城市和ASN之间轮换。

        费用是根据您的月费计划，按GB的消耗量来计算。

        ## 地理位置定位

        分配给您区域的IP，是来自所选的国家、城市、ASN或邮政编码。 从下拉菜单中选择所需的参数。

                <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/geolocation-targeting-dropdown.png?maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d7e9e441e88447b417742c98760b2b09" alt="geolocation-targeting-dropdown.png" width="536" height="178" data-path="images/proxy-networks/faqs/geolocation-targeting-dropdown.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/geolocation-targeting-dropdown.png?w=280&maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=aac30f83fad6bf93e1a2260916a4e2d2 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/geolocation-targeting-dropdown.png?w=560&maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b222fa0047340339979893717fc98191 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/geolocation-targeting-dropdown.png?w=840&maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6d13e3056ad7f67cc91eca698e31de85 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/geolocation-targeting-dropdown.png?w=1100&maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=78e5c81670c0755b75d44297cf3ec155 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/geolocation-targeting-dropdown.png?w=1650&maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=56bd34470b25fec5f69d0464efb8e7f5 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/geolocation-targeting-dropdown.png?w=2500&maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8f1254e5c3ab1944506f2e284e5b3f09 2500w" data-optimize="true" data-opv="2" />

        ## 发送包含地理定位的请求：

        * 使用“共享”IP，您可以在发送请求时控制地理位置定位。

        * 要以特定国家/地区为目标，请在您的请求中添加 -country标志，

        例如，如果您想从美国（`us`）发送请求，使用共享IP的请求将如下所示

        ```sh
        curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us: <zone_password>  
        ```
      </Tab>

      <Tab title="专用IP">
        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.

        ## 专用IP 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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/dedicated-ip-groups.png?maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c270120cff39350ccb3d8bfe88a8b352" alt="dedicated-ip-groups.png" width="526" height="124" data-path="images/proxy-networks/faqs/dedicated-ip-groups.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/dedicated-ip-groups.png?w=280&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ce8c17b758d7a8c9c36ddf04aa97da1f 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/dedicated-ip-groups.png?w=560&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ecf4569c0c287f5f6b62a7a6a3dc905f 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/dedicated-ip-groups.png?w=840&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0bd5d9b1c00c793eadb2fb06ab2516fd 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/dedicated-ip-groups.png?w=1100&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c20b13032342acd984f33ce29f1bd529 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/dedicated-ip-groups.png?w=1650&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6c24972c9d3ce7b57bca355aed1118c4 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/dedicated-ip-groups.png?w=2500&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d7bca1a45e11fe78121e3ca78fa3a473 2500w" data-optimize="true" data-opv="2" />

        ## 地理位置定位

        The IP allocated to your zone will be from the selected country
                <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=112ecae8ddb56c1ebb813f9b2422866f" alt="add-country.png" width="514" height="112" data-path="images/proxy-networks/faqs/add-country.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=280&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=64a1b2980ff6a5888b94d2c5c46e9a79 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=560&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=df276075373b92ca3bb12dbb66479bbe 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=840&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9da95587a1b49839713cff7c34e8333f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1100&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b4650734643e0979a398a7bda8a41576 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1650&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fe32545646ad097427f40f33403d0fb8 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=2500&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=93c75cd9a1a7fbed4c3aff1ebd125d65 2500w" data-optimize="true" data-opv="2" />

        ## Domains

        Define the domains you'd like your IPs to be exclusive to. 请求 to **any other** domain will be bypassed and sent from our servers .\
                <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6a4de57e233019ed0f30522817c01d7b" alt="add-domains.png" width="528" height="134" data-path="images/proxy-networks/faqs/add-domains.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=280&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fc93cd504b61d61b4eaf086dcccef602 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=560&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=896c83e3e9b2ded9fb48199421e0c221 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=840&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=facb857392cc2909e13029b24f151212 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=1100&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2c652b524fe7f2a8cff08fb1dba06496 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=1650&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=bf5f81409686ad12cbf5e26a7f84e2e6 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=2500&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ade906f28f183329a7ea046ab20b224a 2500w" data-optimize="true" data-opv="2" />

        <Note>
          There is **no** option to add "All domains". 请求 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>

        ## 发送包含地理定位的请求：

        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 '地理位置定位' 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
        curl "http://target.site" --proxy brd.superproxy.io:33335 --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
    curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-route_err-block:<zone_password>
    ```
  </Accordion>

  <Accordion title="数据中心代理的IP类型有哪些？">
    There are four types of IPs that we offer within our [Datacenter Proxy Network](https://brightdata.com/proxy-types/datacenter-proxies):

    1. 共享IP（按使用量付费）

    2. 共享IP（按IP付费）

    3. 专用IP

    4. 高级IP **(Note: no longer offered)**

    <Tabs>
      <Tab title="共享IP">
        共享IP由多个用户共享。 我们在ISP代理网络中的共享IP分为2个等级：

        <Tabs>
          <Tab title="按使用量付费">
            <Tip>您只需为用了的量付费。</Tip>

            Connects you to a pool of 40,000 IPs that consist of a fixed allocated range of IPs from every country available.
            这些IP可以根据需要在含有2万个IP的池中不断轮换（可以在Chrome、Proxy Manager或通过API选择特定国家）

            ### 功能

            * **地理位置定位** - With a '共享IP' IP (pay-per-usage), you'll be able to control your geolocation targeting when you send a request, with the `-country` flag. 以美国为目标的简单请求示例如下

              ```sh 示例
              curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us:<zone_password> "http://lumtest.com/myip.json"
              ```

            Learn more about targeting different country targeting options from our [Proxy integration examples](https://brightdata.com/cp/zones/proxy_examples) page
          </Tab>

          <Tab title="按IP付费">
            Purchase individual IPs for your use (with unlimited BW or cost per GB) in the country of your choosing. You will be charged per IP and usage, or switch to unlimited bandwidth.

            ## 功能

            * **地理位置定位** - The IP allocated to your zone will be from the selected country.

              <Frame>
                  <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=112ecae8ddb56c1ebb813f9b2422866f" alt="add-country.png" width="514" height="112" data-path="images/proxy-networks/faqs/add-country.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=280&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=64a1b2980ff6a5888b94d2c5c46e9a79 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=560&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=df276075373b92ca3bb12dbb66479bbe 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=840&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9da95587a1b49839713cff7c34e8333f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1100&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b4650734643e0979a398a7bda8a41576 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1650&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fe32545646ad097427f40f33403d0fb8 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=2500&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=93c75cd9a1a7fbed4c3aff1ebd125d65 2500w" data-optimize="true" data-opv="2" />
              </Frame>

            <Tip>
              For geolocation, if you choose an IP type where your IPs are automatically allocated (按IP付费 or 专用IP), it is recommended to set up a separate ISP proxy zone, for each geolocation you wish to target.
            </Tip>
          </Tab>
        </Tabs>
      </Tab>

      <Tab title="专用IP">
        [专用IP IPs](https://brightdata.com/solutions/dedicated-proxies) are set aside for your use only. This IP type is more lucrative and you can control the allocation of the IPs based on the following features:

        ### 功能

        * **地理位置定位** - The dedicated IP allocated to your zone will be from your selected country

          <Frame>
              <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=112ecae8ddb56c1ebb813f9b2422866f" alt="add-country.png" width="514" height="112" data-path="images/proxy-networks/faqs/add-country.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=280&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=64a1b2980ff6a5888b94d2c5c46e9a79 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=560&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=df276075373b92ca3bb12dbb66479bbe 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=840&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9da95587a1b49839713cff7c34e8333f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1100&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b4650734643e0979a398a7bda8a41576 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1650&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fe32545646ad097427f40f33403d0fb8 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=2500&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=93c75cd9a1a7fbed4c3aff1ebd125d65 2500w" data-optimize="true" data-opv="2" />
          </Frame>

        * **Domains** - Define the domains you'd like your IPs to be exclusive to. 请求 to all other domains will be sent from our super proxies.

          <Frame>
              <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6a4de57e233019ed0f30522817c01d7b" alt="add-domains.png" width="528" height="134" data-path="images/proxy-networks/faqs/add-domains.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=280&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fc93cd504b61d61b4eaf086dcccef602 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=560&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=896c83e3e9b2ded9fb48199421e0c221 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=840&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=facb857392cc2909e13029b24f151212 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=1100&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2c652b524fe7f2a8cff08fb1dba06496 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=1650&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=bf5f81409686ad12cbf5e26a7f84e2e6 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=2500&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ade906f28f183329a7ea046ab20b224a 2500w" data-optimize="true" data-opv="2" />
          </Frame>

          <Note>You may check 'All domains' for full exclusivity over the IPs, and in this case, they will only be used by you.</Note>
      </Tab>

      <Tab title="高级IP">
        <Note> **Deprecated:** we no longer offer 高级IP</Note>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="ISP代理的IP类型有哪些？">
    There are three types of IPs that we offer within our [ISP Proxy Network](https://brightdata.com/proxy-types/isp-proxies):

    1. 共享IP（按使用量付费）

    2. 共享IP（按IP付费）

    3. 专用IP

    <Tabs>
      <Tab title="共享IP">
        共享IP由多个用户共享。 我们在ISP代理网络中的共享IP分为2个等级：

        <Tabs>
          <Tab title="按使用量付费">
            <Tip>您只需为用了的量付费。</Tip>

            将您连接到由1万个IP组成的IP池，这些IP来自每个可用国家的固定分配范围。
            这些IP可以根据需要在含有1万个IP的池中不断轮换（可以在Chrome、Proxy Manager或通过API选择特定国家）

            ### 功能

            * **地理位置定位** - With a '共享IP' IP (pay-per-usage), you'll be able to control your geolocation targeting when you send a request, with the `-country` flag. 以美国为目标的简单请求示例如下

              ```sh 示例
              curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us:<zone_password> "http://lumtest.com/myip.json"
              ```

            Learn more about targeting different country targeting options from our [Proxy integration examples](https://brightdata.com/cp/zones/proxy_examples) page
          </Tab>

          <Tab title="按IP付费">
            Purchase individual IPs for your use (with unlimited BW or cost per GB) in the country of your choosing. You will be charged per IP and usage, or switch to unlimited bandwidth.

            ## 功能

            * **地理位置定位** - The IP allocated to your zone will be from the selected country.

              <Frame>
                  <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=112ecae8ddb56c1ebb813f9b2422866f" alt="add-country.png" width="514" height="112" data-path="images/proxy-networks/faqs/add-country.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=280&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=64a1b2980ff6a5888b94d2c5c46e9a79 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=560&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=df276075373b92ca3bb12dbb66479bbe 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=840&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9da95587a1b49839713cff7c34e8333f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1100&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b4650734643e0979a398a7bda8a41576 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1650&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fe32545646ad097427f40f33403d0fb8 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=2500&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=93c75cd9a1a7fbed4c3aff1ebd125d65 2500w" data-optimize="true" data-opv="2" />
              </Frame>

            <Tip>
              For geolocation, if you choose an IP type where your IPs are automatically allocated (按IP付费 or 专用IP), it is recommended to set up a separate ISP proxy zone, for each geolocation you wish to target.
            </Tip>
          </Tab>
        </Tabs>
      </Tab>

      <Tab title="专用IP">
        专用IP IPs are set aside for your use only. This IP type is more lucrative and you can control the allocation of the IPs based on the following features:

        ### 功能

        * **地理位置定位** - The dedicated IP allocated to your zone will be from your selected country

          <Frame>
              <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=112ecae8ddb56c1ebb813f9b2422866f" alt="add-country.png" width="514" height="112" data-path="images/proxy-networks/faqs/add-country.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=280&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=64a1b2980ff6a5888b94d2c5c46e9a79 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=560&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=df276075373b92ca3bb12dbb66479bbe 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=840&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9da95587a1b49839713cff7c34e8333f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1100&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b4650734643e0979a398a7bda8a41576 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1650&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fe32545646ad097427f40f33403d0fb8 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=2500&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=93c75cd9a1a7fbed4c3aff1ebd125d65 2500w" data-optimize="true" data-opv="2" />
          </Frame>

        * **Domains** - Define the domains you'd like your IPs to be exclusive to. 请求 to all other domains will be sent from our super proxies.

          <Frame>
              <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6a4de57e233019ed0f30522817c01d7b" alt="add-domains.png" width="528" height="134" data-path="images/proxy-networks/faqs/add-domains.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=280&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fc93cd504b61d61b4eaf086dcccef602 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=560&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=896c83e3e9b2ded9fb48199421e0c221 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=840&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=facb857392cc2909e13029b24f151212 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=1100&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2c652b524fe7f2a8cff08fb1dba06496 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=1650&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=bf5f81409686ad12cbf5e26a7f84e2e6 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=2500&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ade906f28f183329a7ea046ab20b224a 2500w" data-optimize="true" data-opv="2" />
          </Frame>

          <Note>You may check 'All domains' for full exclusivity over the IPs, and in this case, they will only be used by you.</Note>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="How to 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.
  </Accordion>

  <Accordion title="如何将新代理集成到代码中？">
    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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8865e37db6b85ba4c7b10554f96b5152" alt="integrate-new-proxy.gif" width="1828" height="978" data-path="images/proxy-networks/faqs/integrate-new-proxy.gif" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=280&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=af6967b98840c378451f71789844683c 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=560&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c8a668490c5e77e52cfaaa33e9611f92 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=840&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d8bc15aa37a36943e130b755bef3760c 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=1100&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f48c0c165a1ca706da431cb105685adb 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=1650&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e3a7b54c9cf2cd04dcfb7cbceb39b55b 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=2500&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e2e00c6be0bb7ce6e8c8b666071aff96 2500w" data-optimize="true" data-opv="2" />

    在该页面上，您可以选择大多数现代编码语言的集成示例，只需选择集成类型、代理区域、编码语言等，该页面就会生成可以立即使用的代码片段。
  </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="如何将代理集成到第三方软件中？">
    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](https://docs.brightdata.com/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 Unlocker API, 住宅 Proxies or the SERP API you probably need to use our SSL certificate to enable end-to-end secure connections. See [instructions here](https://dashboard.mintlify.com/editor#how-to-integrate-a-proxy-into-3rd-party-software).
  </Accordion>

  <Accordion title="How do I configure proxy in a specific country?">
    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
    curl "http://target.site" --proxy brd.superproxy.io:33335 --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](https://docs.brightdata.com/cn/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 住宅 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="如何以欧盟地区为目标">
    <Note>欧盟国家的分配是随机的。</Note>

    <Info>适用于数据中心、ISP和Unlocker/SERP API</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

    请求 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:

    * 数据中心 / ISP - 共享IP - Pay per proxy

    * 数据中心 / ISP - 专用IP
  </Accordion>

  <Accordion title="如何以特定城市为目标？">
    In order to target a specific city you will need to use a [共享IP (pay-per-IP)](/cn/proxy-networks/data-center/configure-your-proxy#ip-type) or [专用IP](/cn/proxy-networks/data-center/configure-your-proxy#ip-type) proxy network.

    配置代理区域时，选择首选国家/地区后，您可以添加城市，以进一步指定您的地理定位

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ca7361e14082b55128dfeaecf1222f9a" alt="add-city.png" width="664" height="376" data-path="images/proxy-networks/faqs/add-city.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=280&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=04a0e4f99086ed0b3ffa814a0d6d8901 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=560&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e783c970a46a962b796015a72bf16acd 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=840&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3cac3ce62610ee6ae080145996ebb746 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=1100&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f66bf044a4bf60204463610aebca401a 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=1650&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c1478268f631d03401ac9e3c3ae0cdc2 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=2500&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fda8142825643a46c283f3bc55793d84 2500w" data-optimize="true" data-opv="2" />

    Once you click on **'Add city'** you will be displayed the available cities to target, for the selected country.

    Once configured, you'll be able to send requests from the selected city, using the following syntax

    ```sh
    curl "http://target.site" --proxy brd.superproxy.io:33335 --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.

      例如，当以布宜诺斯艾利斯为目标时，请求的语法将是：

      `-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="Bright Data的代理分布在哪些地方？">
    Bright Data在全球每个国家/地区都有代理，以下国家除外：

    * 伊朗

    * 伊拉克

    * 叙利亚

    * 黎巴嫩

    * 巴勒斯坦

    * 朝鲜

    * 古巴

    * 苏丹

    * 俄罗斯克里米亚地区

    如果您需要来自这些国家/地区的代理，很遗憾，Bright Data无法为您提供帮助。
  </Accordion>

  <Accordion title="如何查看代理事件日志？">
    事件日志将显示您账户中的最近200个（最多）请求（任何区域）。

    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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e58931c902b2aa2b9cb71157e98e2ab9" alt="event-log.png" width="1833" height="977" data-path="images/proxy-networks/faqs/event-log.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=280&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3ca0f70abbd76e232d8bbe117f4350aa 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=560&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b08adc7e24153bf24ee8e4e36e79bf25 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=840&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=58efc19a1f43403f4cc6b896de99bc5e 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=1100&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2c9e851671051303d96f000a7e23bcfd 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=1650&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2f30a688c191fe1392e473e86826ee46 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=2500&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f7ee65bd5eabe6ae149263a8f9464acc 2500w" data-optimize="true" data-opv="2" />

    展示的数据包括：

    * **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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f2905127ebde0e5876295cb21ed341ce" alt="event-log-headers.png" width="1833" height="977" data-path="images/proxy-networks/faqs/event-log-headers.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=280&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7b9dd50469ff007397a1e8c93a030795 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=560&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=564c5cbb33cf376f1a4697557c98d724 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=840&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=888b55dcce504a411741144fed9ec49a 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=1100&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=22d813089ee901fe3d7ef46fd2dfbfda 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=1650&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=611238c6c04383d5b659d5d4fadf56af 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=2500&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6c16fdf908195d513b49f3577770876e 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="如何启用自动IP回退？（100%正常运行时间）">
    <Info>Applicable for Datacenter & ISP</Info>

    The **100% uptime** was built to prevent any ‘external’ events from affecting the user. 此功能的原理非常简单，与上述两个问题的运作方式相同──如果我们的系统检测到问题（例如连接问题或IP的地理位置与您购买时的要求不符），我们会自动将您的请求路由到与原始IP完全相同的其他IP。

    同时，我们希望确保必须使用特定IP的客户不会受到影响，因此我们设置了一些例外：

    * 如果您的请求中指定了特定的IP，我们不会为其分配回退IP。

    * 100%正常运行时间不会断开实时连接。 如果需要回退，回退将在下一个连接建立后启动

    The **100% uptime** 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>
      100% uptime feature can be turned on or off, [via API](/cn/api-reference/account-management-api/Switch_100_uptime_ON_OFF_in_a_Static_zone).
    </Note>
  </Accordion>

  <Accordion title="如何启用代理自动故障转移功能？">
    Navigate to your proxy configuration settings, and under **Advanced settings** enable **‘100% uptime’**

        <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/faqs/100-uptime.gif?maxW=1600&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=fc8e08dd28008175d1c688a0b4caf0df" alt="100-uptime.gif" width="1600" height="734" data-path="images/proxy-networks/faqs/100-uptime.gif" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/faqs/100-uptime.gif?w=280&maxW=1600&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=7a88ff82116e48bbaaac298231529afa 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/faqs/100-uptime.gif?w=560&maxW=1600&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=10d8c2369b2fef82d54ae6e9704fafe6 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/faqs/100-uptime.gif?w=840&maxW=1600&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=114e93971c5a37b34adbd28ce8d73171 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/faqs/100-uptime.gif?w=1100&maxW=1600&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=87c43a879aaa98bcb79db4001eacd1a5 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/faqs/100-uptime.gif?w=1650&maxW=1600&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9459bf3b07e0e65808bed1187557c029 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/faqs/100-uptime.gif?w=2500&maxW=1600&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=efa1866e0798cf5f769b2a1ad3499a0c 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="如何在多个请求中使用同一个 IP？">
    * 这可以通过在代理用户名中添加会话标志来完成：

    ```sh
    brd.superproxy.io:33335 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.

    * 会话ID可以是任何随机字符串/计数器：具有相同会话字符串的请求将尽可能长时间使用相同的代理对等点；对于使用不同会话字符串的请求，将分配不同的代理对等节点。

    * 要强制更改IP，只需修改会话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.

    * 会话IP最多可在1分钟的闲置时间内保持不变。 一分钟后，如果仍没有请求，IP将被释放回池中。\
      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
    brd-customer-<customer_id>-zone-<zone_name>-session-glob_rand39484
    ```

    完整请求示例：

    ```sh
    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="如何将IP和域名列入白名单/黑名单？">
    Allowlisting your IP is a good way to keep your account secure, as it prevents others from accessing your proxy 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. Note that any IP can connect to the configuration dashboard itself.

    Remember, the fact that you allowlist an IP does not mean you can access your Bright data product from that IP without your username and password. You always need to use your username and password when accessing your Bright data product.

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

    * 通过控制面板：

      * 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:

      <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d438296191d4567832ffc1428804bf2e" alt="whitelist-blacklist.png" width="557" height="490" data-path="images/proxy-networks/faqs/whitelist-blacklist.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=280&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=363f6c345e5393a22de1c06867bf6d0d 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=560&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a3aae6a92643ae783a957a726c662310 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=840&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a98a1d5655cc162f1378621db15aa53c 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=1100&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=bb65479ef65304ad7f8b3fdf0bc1ea31 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=1650&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9aca6308d18a97a6d7c9281068888f0c 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=2500&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a2866c8436989541f0510a76667fffa5 2500w" data-optimize="true" data-opv="2" />

      Add all the relevant IPs and domains you'll allow access to with your proxy zone.

    * **通过API端点：**

      * [将IP添加到区域白名单](/cn/api-reference/account-management-api/allowlist-ip)

      * [将IP从区域白名单中移除](/cn/api-reference/account-management-api/remove-ip-from-zone-allowlist)

      * [将IP添加到区域黑名单](/cn/api-reference/account-management-api/denylist-ip)

      * [将IP从区域黑名单中移除](/cn/api-reference/account-management-api/remove-ip-from-zone-denylist)

      * [将域名从区域白名单/黑名单中移除](/cn/api-reference/account-management-api/remove-domain-from-zone-allowlist-or-denylist)

      * [将域名添加到区域白名单/黑名单](/cn/api-reference/account-management-api/allowlist-or-denylist-domains)

    * **关于白名单的重要提示：**

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

      示例 for adding domains:
      <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c7dfe555b41399d5e9a309475aa224c5" alt="domain-add-example.png" width="376" height="112" data-path="images/proxy-networks/faqs/domain-add-example.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?w=280&maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c655c57674c2f27a0aca0a226c7576df 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?w=560&maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3ac470b45bdd7da35b4497e885cc0e99 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?w=840&maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9a5c1fd6b95f3e925a0f4218cabf376e 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?w=1100&maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b64cbde9c4199b6bcff1db31ff74d95b 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?w=1650&maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c43e175ee5ae7c1ede504b2a4e5dc6d5 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?w=2500&maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ff1b81e4092a8378def814864f0d5ac8 2500w" data-optimize="true" data-opv="2" />

      * 添加IP的示例：
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d0d9cde18e32305b3b725a6319c55651" alt="ip-add-example.png" width="222" height="82" data-path="images/proxy-networks/faqs/ip-add-example.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?w=280&maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=cb92c7bb958479d9870506a316f6760c 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?w=560&maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0fd611195ad49f67af68339ebf8699c3 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?w=840&maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4867ab10946eea6b0779af10da4e8465 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?w=1100&maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c5b6bbc36978e629b16f96dcfcce3419 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?w=1650&maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3f796d5f2ca9e9a2875b15632d6ba91c 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?w=2500&maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=484261c0c5a589cb25d61e8f6e12db3a 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="How to see supported 端口 & Protocols?">
    #### HTTP和HTTPS协议

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

    #### SOCKS5协议

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

    SOCKS5 is supported for Datacenter and ISP networks.

    See here for [full SOCKS5 configuration instructions](https://docs.brightdata.com/cn/proxy-networks/socks5)

    Note: If you need to use SOCKS5 on the 住宅 proxy network, please obtain approval by our compliance department. Compliance approval is *not needed* for Datacenter and ISP networks.

    #### 端口

    默认情况下，所有区域都提供端口80和443，可用于HTTP和HTTPS协议。

    在数据中心或ISP类型的代理区域中，默认支持所有高于1024的端口。

    在住宅或移动类型的代理区域中，默认可用的端口为：8080、8443、5678、1962、2000、4443、4433、4430、44444和1969。

    Bright Data可以应要求支持其他端口。 Bright Data合规团队将会为每个要求支持新端口的请求启动专属的额外合规流程。\
    示例s of ports that require Bright Data compliance review before activation:

    要请求向您的区域添加端口权限，请按照以下步骤操作：

    * 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"

    * 输入您想获得批准的端口号

    * 填写表格，等待我们的合规团队与您联系并批准请求

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8f7a07929b754153ea7bcdb5cd694a96" alt="add-ports.gif" width="1828" height="978" data-path="images/proxy-networks/faqs/add-ports.gif" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=280&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4cdebdc4fc77c5c7ec627ed72bb3711e 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=560&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=621bba8c5764779d6a593bfa7dff671c 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=840&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8bd6dda3e631778f028bed40a55944ef 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=1100&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9a525823504d24e8b675244fef786c66 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=1650&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=016680c4f990848121b7137bc8e8e470 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=2500&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c5a061323e37be5b0f7b459f02d8f236 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="如何针对特定的操作系统？">
    Bright Data allows targeting the following **Operating Systems**:

    <CodeGroup>
      ```sh Windows
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-windows:<zone_password> --proxy brd.superproxy.io:33335 "<target_site>"
      ```

      ```sh macOS
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-osx:<zone_password> --proxy brd.superproxy.io:33335 "<target_site>"
      ```

      ```sh Android
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-android:<zone_password> --proxy brd.superproxy.io:33335 "<target_site>"
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="如何刷新分配给您的区域的IP？">
    If you've selected '按IP付费' shared, or a dedicated IP type in your zone configuration, you'll be allocated a fixed IP address. 您可能需要不时刷新这些IP地址，这取决于您的使用情况。

    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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9a072edcc7d8329a525f4b0e3ec89849" alt="refresh-ips.gif" width="1892" height="868" data-path="images/proxy-networks/faqs/refresh-ips.gif" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=280&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3e069c1d9efdc57fa3028e437ed053fa 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=560&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b685c6696ece105061da5680ba285314 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=840&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3351c3aee8a4784c020acf6077cbb962 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=1100&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c78525f268a2e266fdcffc8f2d7bcac4 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=1650&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e168df26bb68ac033290abe45eb60d9e 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=2500&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=dd549db272ead649e10cc291b39c5340 2500w" data-optimize="true" data-opv="2" />

    <Note>刷新IP或GiP将产生额外费用。</Note>

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

  <Accordion title="如何使用特定IP？">
    When using Bright Data's 住宅 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
    curl "https://lumtest.com/myip.json" --verbose --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
    ```

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

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ae57da3518779f40a958f78a00ecfedf" alt="x-brd-ip.png" width="423" height="23" data-path="images/proxy-networks/faqs/x-brd-ip.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=280&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4578ce7b27745497ae8123a53a852500 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=560&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=eea20a9293172fd0a758c50ab8438dca 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=840&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7549acd6febbfb9404217c4337ae4713 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=1100&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f2376a4f21caa18b90f3501d109f1c2e 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=1650&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=79eece5f221dab3bf68b12a7611e0a84 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=2500&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8d41955b988378d12e7838ad4e5a3b15 2500w" data-optimize="true" data-opv="2" />

    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
    curl "https://lumtest.com/myip.json" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-<hashed-ip>:<zone_password>
    ```

    测试时，我们建议使用[https://lumtest.com/myip.json作为目标域名，并用于查看您的IP凭据。](https://lumtest.com/myip.json作为目标域名，并用于查看您的IP凭据。)
  </Accordion>

  <Accordion title="如何针对特定的ASN IP？">
    This feature can be enabled by adding the ASN parameter to your Zone configuration, under **Geolocation Targeting**.

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=382d3e5f40fd938e5a84ae2849fd0c3e" alt="asn-targeting.png" width="583" height="931" data-path="images/proxy-networks/faqs/asn-targeting.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=280&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=77b6b1aa38626011a34ca6486219d353 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=560&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e6630c50ab7413f6837e8d326ba00b3f 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=840&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6e220de756396a15aaba32b6c5da186f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=1100&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=da2df73c5b2c0d5d37cbe06ee086f73b 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=1650&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5664f5ee339248026f6350324c0adcbf 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=2500&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6df52c82ff5d02aeb05a43655e73736c 2500w" data-optimize="true" data-opv="2" />

    Once the configuration is saved, the ASN flag can be added to the Zone's credentials\
    and be integrated when using the 住宅 proxies. 例如：

    ```sh
    curl --proxy brd.superproxy.io:33335 --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="如何针对住宅IP组（gIP）？">
    专用IP 住宅 IPs can be selected in the form of [gIPs](/cn/proxy-networks/residential/configure-your-proxy#ip-groups-gips). They can be allocated under the zone's configuration page by selecting a "专用IP" IP type and choosing a number of gips. 此外，还需要针对特定域名。

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c6271c5594fac3f6861969bd7af27f1e" alt="number-of-dedicated-gIPs.png" width="645" height="909" data-path="images/proxy-networks/faqs/number-of-dedicated-gIPs.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=280&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5dbdca062126def5cb6056cefbb9b7dd 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=560&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9bcacda84b73566eae2020e039b2e38b 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=840&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0d9c62f26e4bd3d36d89ee278440d204 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=1100&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=42f6b5b50b0e87f20029e4a89df13c2b 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=1650&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=655cc189fd49c7ffeb9b739f59a23ebd 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=2500&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=15972b33cfafd930e2d7b90d18768248 2500w" data-optimize="true" data-opv="2" />

    Once the configuration is saved, selecting "Show allocated 专用IP residential IPs" will provide\
    a list of hash values that represent group IPs.\
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=75d1f6c97b99b54c4bb1f4e6ac222b09" alt="show-allocated-dedicated-ips.png" width="583" height="393" data-path="images/proxy-networks/faqs/show-allocated-dedicated-ips.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=280&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2d56759505ae73cd244f0a59e673516d 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=560&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6ff579ae3da9b8a1fb08048c5cd40f42 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=840&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e9e229a90011d93f9128b7a67e47b47a 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=1100&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d26dd0084f0f82302519b8c73013a03c 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=1650&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=1936faef05312195dd9c83c8960bed3a 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=2500&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fd1c5fca0c04634e370f8b82cd451fb1 2500w" data-optimize="true" data-opv="2" />

    这些值可用于针对特定的 gip。 例如：

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-gip-<gip_hash_value>:<zone_password> "<target_site>"
    ```
  </Accordion>

  <Accordion title="如何启用长会话对等点">
    长会话对等点让您能够在一段长时间内保持稳定的IP地址，以确保抓取操作顺畅和一致。 如果普通住宅IP的对等点意外断开连接，IP可以随时轮换，长会话对等点则不同，能提供连续会话。

    **启用长会话对等点**

    只需进入一个现有的住宅区域或创建一个新的住宅区域，然后打开“长会话对等点”功能即可。  现在，您今后的请求仅会通过已知的长期对等点进行路由。\
    **Note:** This feature does add an extra cost for the zone when enabled

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ceae664decd0148cb282001dd123898c" alt="long-session-peers.png" width="567" height="286" data-path="images/proxy-networks/faqs/long-session-peers.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?w=280&maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e8d1fd864c37a05db277361552f03f39 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?w=560&maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=96a200c7e795df0996b2446266395b85 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?w=840&maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e414da5c55131589268b1fd5d526b336 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?w=1100&maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b26c67e46f8139650350b404747aebe4 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?w=1650&maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fe7d9da5ecdefd978a2f3c05c0ef69da 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?w=2500&maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=efdade17ab582f8edfa18810e28216a7 2500w" data-optimize="true" data-opv="2" />

    **这些对等点来自哪里？**

    Our 住宅 peers' pool consists of real users around the world who opt-in to use our product. As part of the opt-in, we utilize the IPs of these real users during their "down" periods as part of our ethical residential network. 启用长会话对等点后，您可以确保路由是通过已知能够长时间保持活跃状态的对等点进行；与普通住宅对等点相比，长会话对等点可以保持同一个IP地址更长时间。

    **长会话对等点的优势**

    持续的抓取操作：具有稳定性，能够最大限度地减少因IP变更而造成的中断，并最大限度地提高抓取任务的效率。 您可以在一段长时间内使用同一个IP地址，这让您可以进行长时间的抓取操作。 This feature is particularly useful for projects that require **continuous data extraction or monitoring**.
  </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="如何使用中国住宅IP浏览中国网站">
    **When outside of China**\
    Targeting Chinese 住宅 IP peers is enough:

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-cn:<zone_password> "<target_site>"
    ```

    **When inside China**In addition to Targeting Chinese 住宅s IP peers, targeting our Chinese super-proxy is also required.

    * When using API commands, the proxy DNS server is**servercountry-cn**.brd.superproxy.io

    ```sh
    curl --proxy servercountry-cn.brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-cn:<zone_password> "<target_site>"
    ```

    * 使用代理管理器时：

      * Select relevant Port settings by simply clicking on the port\
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=60c9b798eabd855e54f15c9ed30532c2" alt="port-row.png" width="1490" height="231" data-path="images/proxy-networks/faqs/port-row.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=280&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=1faa89a7b9389f25ce2f2df9ae193acb 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=560&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=efb6903924f8bd83b6dcb191861c4ff2 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=840&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d1de11eb98f22e136fd84756eab9be3c 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=1100&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=abd917c6d5a4876eedaab8df719ca48d 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=1650&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=279bcb4f18934e70b834c32766d4dcba 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=2500&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7074af21c015ff4464baacf4e6ff8cc7 2500w" data-optimize="true" data-opv="2" />

      * Select Targeting and set China as the country\
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4e9d4ff832de3da6c12d54b8e7117f87" alt="target-china.png" width="1848" height="459" data-path="images/proxy-networks/faqs/target-china.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=280&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7e8a54f7f5fef55ea745a2bcecc2b134 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=560&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0b6da7728c8d55330dedee5688064a58 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=840&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6a1153555ae45d3e58cb2b55bb5080a7 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=1100&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=35475a8710d937c48354ee0706a6b9ff 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=1650&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9e78a53887ad4d63f83c1da8e89e6d86 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=2500&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4a583a62f471c4fc8ef963a9d0890a64 2500w" data-optimize="true" data-opv="2" />

      * Select IP control: set Super Proxy location to "China".
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=79fc7dda8eb2f7f223ccb1e7229dfec4" alt="super-proxy-china.png" width="1838" height="566" data-path="images/proxy-networks/faqs/super-proxy-china.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=280&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=dd62f53444546238099ce3daf1d86320 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=560&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6de9045b2c50ee90605f0da550a87d7e 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=840&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9f6435bff0c6d7dcc194a1466059bafe 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=1100&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2364095b48753d17748d25742385971b 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=1650&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d2d9cba66d209296757cfdd139679ebe 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=2500&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5eef24fd9763e130b83ee9e9f7bde87f 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="特定于运营商的代理对等点IP">
    * 您可以选择使用以下列表中的特定运营商：

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

    * 例如

    <CodeGroup>
      ```sh Deutsche Telekom
      brd-customer-<customer_id>-zone-<zone_name>-carrier-dt
      ```

      ```sh Sprint
      brd-customer-<customer_id>-zone-<zone_name>-carrier-sprint
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="关于地理位置数据库，以及如何检查代理IP信息？">
    互联网网站使用地理位置数据库（GeoDB）来查询用户所使用的IP地址的信息。 Bright Data监控并维护现今4个主要GeoDB的正确记录：Maxmind、ip2location、db-ip和Google。

    还有许多其他较小的GeoDB，其中大多数使用的是过时的记录或有缺陷的测试方法，因此所提供的信息并不准确，或者只是用来吸引浏览者向其购买VPN或代理产品。 因此，在测试IP时，我们强烈建议您使用上述的GeoDB。

    要查看您使用的代理IP的信息，请浏览以下其中一个网址：

    * [https://lumtest.com/echo.json](https://lumtest.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="哪些Bright Data产品最适合用来抓取搜索引擎（SERP）？">
    #### 用于单步抓取：

    [SERP API](https://docs.brightdata.com/cn/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.

    #### 用于多步抓取（playwright/puppeteer/selenium）：

    [Browser API](https://docs.brightdata.com/cn/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="我能否使用住宅、数据中心或ISP代理网络来针对Google SERP进行抓取？">
    **住宅 Proxy** - No, [SERP API](https://docs.brightdata.com/cn/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 住宅 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:

    ```
    HTTP/1.1 403 搜索 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. 您可以联系您的账户经理或开立支持工单，以寻求帮助
    ```
  </Accordion>

  <Accordion title="住宅 & 移动 networks">
    通过住宅网络或移动网络针对搜索引擎时，请求不会通过住宅或移动对等点发送，而是直接通过我们的超级代理发送。 这样做的原因是为了支持住宅网络和移动网络与浏览器的集成，因为浏览器可能需要从目标网站加载搜索引擎资源端点。

    **如果您使用住宅或移动网络针对搜索引擎域，则请求将直接通过超级代理传递，以下响应标头将用作指示：**

    ```sh
    x-luminati-ip: superproxy bypass
    ```
  </Accordion>

  <Accordion title="可以向IP发送请求而不是向域名发送请求吗？">
    不可以──在使用Bright Data时，禁止直接向主机服务器而不是向域名发送请求。\
    请求 using URL format such as 1.1.1.1:443 will be executed using the super proxy server, not the proxy peer IP.

    使用超级代理的请求示例：

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8e6dbf5d13a5a505ee83311e5423848c" alt="x-luminati-ip.png" width="1431" height="891" data-path="images/proxy-networks/faqs/x-luminati-ip.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=280&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e16c6daf292290c6ab018be163c94542 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=560&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ae65c3d709a142b5df4e6ac680a139b4 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=840&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fad48d3ca58086816807cc0483223f44 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=1100&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e691672a4db29bfcad1c420f69c30608 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=1650&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=30238efbb97cfebaa172def9f97d0f5a 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=2500&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d0c10e74aa99a4b9ef5b172266a00659 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="我可以使用端口25或任何其他SMTP端口，或者使用代理IP发送电子邮件吗？">
    由于Bright Data非常重視我们的社区和对等点的质量，可用于发送垃圾邮件的SMTP请求会被屏蔽。 请注意，邮件域也禁止访问，对邮件域的请求将从超级代理服务器发送，而不是从对等点IP发送。
  </Accordion>

  <Accordion title="Bright Data是否支持Socks5协议？">
    是的。 Bright data supports `SOCKS5` protocol, with a default port 22228 assigned for SOCKS5 communication.

    See here for [full SOCKS5 configuration instructions](https://docs.brightdata.com/cn/proxy-networks/socks5)
  </Accordion>

  <Accordion title="如何控制请求的执行地点？">
    * 您可以选择直接通过超级代理执行请求，而不是通过对等点IP执行。 在这种情况下，请求的IP将是超级代理的IP。 You will need to add **'-direct'** to your request authorization string. `brd-customer-<customer_id>-zone-<zone_name>-direct`
  </Accordion>

  <Accordion title="如何在不创建多个端口的情况下使用多个国家/地区的IP？">
    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 title="如何刷新会话 (IP)？">
    长时间使用同一IP，目标网站会更容易将该IP标记为代理，并可能导致您的请求被目标网站检测到。 刷新IP将可获得Bright Data分配新IP，而不是使用您池中的现有 IP，这可以让您更好地控制IP池，并提高成功率。
  </Accordion>

  <Accordion title="如何使用中国住宅IP浏览中国网站？">
    <Tabs>
      <Tab title="如果您在中国">
        This section is relevant ONLY if you are in China. 您必须使用我们的中国超级代理：

        * When using Proxy Manager: on Port settings > IP control: set Super Proxy location to "China".

        * When using API commands, use **servercountry-cn**.brd.superproxy.io

        示例：

        ```sh Shell
        curl "https://target-chinese-website.com" --proxy servercountry-cn.brd.superproxy.io:33335 --proxy-user brd-customer-<custormer_name>-zone-<zone_name>-country-cn:<zone_password>
        ```
      </Tab>

      <Tab title="如果您不在中国">
        No special settings required.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="如何在单个会话中长时间使用特定的住宅IP？">
    <Note>
      A residential/mobile IP 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).
    </Note>

    如果IP变得不可用，我们的系统将自动为您分配另一个相同类型和相同地理位置的可用住宅IP。
  </Accordion>

  <Accordion title="错误代码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.

    **可能的原因**

    * We currently do have not matching peers for your zone's configuration, as they might already be in use with a different client, or unavailable for other reasons.

    * 由于没有活动，连接已超时。

    * 主机（目标URL）端已关闭连接

    **错误502响应示例**

    ```
    Request URL: SAMPLE_URL Request method: GET ***Status code: 502***  
    Super proxy IP: IP  
    Username: brd-customer-customer_id-zone-zone_name-country  
    Password: zone_password  
    Sent from: 127.0.0.1  
    Response headers  
    connection: keep-alive  
    date: Tue, 14 Feb 2023 08:49:16 GMT  
    keep-alive: timeout=5  
    transfer-encoding: chunked  
    x-lpm-port: 24000  
    x-luminati-error: waiting for selector ".price-container" failed: timeout 90000ms exceeded  
    ***x-luminati-error-code: expect_element***  
    x-request-id2: REQUEST_ID  
    Request headers  
    user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36(KHTML, like Gecko) Chrome/110.0.0.0 Safari/537.36  
    host: SAMPLE_HOST  
    accept-encoding: gzip, deflate  
    Connection: keep-alive
    ```
  </Accordion>

  <Accordion title="错误代码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.

    **可能的原因**

    * 您的机器IP未列入白名单。 In order to learn how to allowlist an IP, please review the [following article.](/cn/api-reference/proxy-manager/allowlist-ips)

    * The domain you try to access is blocked by Bright Data for compliance reasons.

    * 您尝试访问的域未在您的用例中指定。

    * 验证码响应失败（与Unlocker API和SERP API相关）。

    * The domain you tried to access is blocked by the Target host settings of your zone (check your proxy zone's credentials)

    **错误403响应示例**

    ```
    < HTTP/1.1 403 response status was rejected  
    < x-debug-req-id: SAMPLE_ID  
    < X-Luminati-Error: response status was rejected: 403 Forbidden  
    < X-Luminati-Error-Code: http_status  
    < Date: Wed, 22 Feb 2023 11:11:23 GMT  
    < Connection: keep-alive  
    < Keep-Alive: timeout=5  
    < Transfer-Encoding: chunked
    ```

    The 403 X-luminati-error (Forbidden) indicates you are targeting a domain that is not allowed by Bright Data \
    This can be resolved by contacting the Bright data compliance team for approval.\
    As the Bright data compliance team reviews your use case and confirms - you will be informed that access is been added.\
    For better handling, it is advised to add your account manager to the ticket and inform him as well for your requirement 

    当出现以下错误消息时：

    ```
    You tried to target <host> but got blocked
    ```

    Appears, contact the Bright data compliance team ([compliance@brightdata.com](mailto:compliance@brightdata.com)) or from the ticketing system 

    我们的合规团队将会审查您要求访问该特定域名的请求
  </Accordion>
</AccordionGroup>


# Bright Data 的代理网络
Source: https://docs.brightdata.com/cn/proxy-networks/introduction

使用分布在超过 195 个国家/地区的业内最可靠的代理基础设施大规模采集数据

<Card>
  <CardGroup>
    <Card title="固定" href="/proxy-networks/residential/introduction" icon="house">
      以真实用户身份访问任何网站内容，同时无缝避开网络封锁
    </Card>

    <Card title="数据中心" href="/proxy-networks/data-center/introduction" icon="server">
      使用共享或专属 IP 池中的数据中心代理网络更快地检索数据
    </Card>

    <Card title="ISP" href="/proxy-networks/isp/introduction" icon="wifi">
      使用具有保证长会话对等体和静态地址的租用 IP
    </Card>

    <Card title="移动" href="/proxy-networks/mobile/introduction" icon="mobile">
      通过 3G/4G IP 网络，像全球任何真正的移动用户一样查看网页
    </Card>
  </CardGroup>

  <Card title="代理管理器" href="/proxy-networks/proxy-manager/introduction" icon="circle-nodes">
    使用单一的开源接口管理和监控任何代理网络
  </Card>
</Card>


# 如何配置您的 互联网服务提供商 (互联网服务提供商 (ISP)) 代理
Source: https://docs.brightdata.com/cn/proxy-networks/isp/configure-your-proxy



<Accordion title="首先：导航到“配置”选项卡">
  创建代理后，您可以导航到配置选项卡来配置代理设置。

  <Frame>
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ff04df5ed07ae21a35e2f03c28d721e3" alt="配置" width="530" height="729" data-path="images/proxy-networks/data-center/configuraton_tab.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?w=280&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=c2d7f954a17ab45861fd960a57bbb650 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?w=560&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=dc67626f65dd27cfdc9726bb800e8f43 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?w=840&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=bbac3a18561aa4eb91d96e9d21ab568b 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?w=1100&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=36facc9a41dadcedf37c0bedf2e7bb73 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?w=1650&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=81e1b8bbe479373fee9a0c66a48fdfd2 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?w=2500&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9d3d0af0d96ea93b791efd757a3f20ff 2500w" data-optimize="true" data-opv="2" />
  </Frame>
</Accordion>

## IP 类型

**为您的代理区域选择三种 IP 类型之一：**

<CardGroup cols={2}>
  <Card title="共享（按 IP 付费）" href="/proxy-networks/faqs#what-are-ip-types-for-isp" icon="square-1">
    <Tip>选择 IP 数量和国家/地区。 按 IP 和使用量付费。</Tip>
    当您需要具有成本效益的选项，并且不需要 IP 专用权时。
    <Note>多个用户共享 IP</Note>
  </Card>

  <Card title="共享（按使用量付费）" href="/proxy-networks/faqs#what-are-ip-types-for-isp" icon="square-2">
    <Tip>拥有来自所有国家/地区的 1 万个 IP 的固定资源池。 IP 免费。 按使用量付费。</Tip>
    当您需要具有成本效益的选项，并且不需要 IP 专用权时。These proxies will rotate so every request you can get a new IP address ("Rotating proxies").

    <Note>多个用户共享 IP</Note>
  </Card>

  <Card title="专用" href="/proxy-networks/faqs#what-are-ip-types-for-isp" icon="square-3">
    当您需要使用专用 IP 地址访问网站时。
    <Note>IP 仅供您使用。</Note>
  </Card>
</CardGroup>

***

## IP 数量

作为可用 IP 资源池分配的 IP 数量。
<Warning>请注意，增加数量会增加额外成本。</Warning>

## 分配的 IP

您可以查看或下载分配给您的 IP。

<Frame>
  <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=7a4b0863cdbcd3dac920a163878881ac" alt="地理位置定位" width="561" height="84" data-path="images/proxy-networks/data-center/allocated-ips.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?w=280&maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=2e74f5bcbaff8a7c147b93e51de4c4ea 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?w=560&maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=6af09e6bb9fa638a42f59bf328138b44 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?w=840&maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=f9c6146a358b4ac10263c7877d062b84 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?w=1100&maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=335ad91e25acfd9bb72b7b49ce5ace70 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?w=1650&maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=cba076ab6d22c916398f7ade1650039a 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?w=2500&maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=88974428fc9d8a77f6a98576f758169c 2500w" data-optimize="true" data-opv="2" />
</Frame>

***

## 地理位置定位

<Tip>
  Common setup is to create a zone per each location, this way you can control your requests target on the zone level.

  For example: `ispshared-uk`, `ispshared-us`, `ispshared-de`.
</Tip>

### 专用 and Pay per IP proxies

地理位置定位允许您定位特定的国家/地区。
从下拉菜单中选择首选国家/地区。

If you select multiple countries, we assign proxies distributed  evenly across the countries you selected.

<Frame>
  <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d307c894cda3101699ba450988554136" alt="地理位置定位" width="572" height="358" data-path="images/proxy-networks/data-center/geotargeting.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=280&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=67026a086654981fcd2439025d93033d 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=560&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=341cf0c6a4d403bdb158cc49a0f23ebf 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=840&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=895a1fd7f97db50b0571cfb2db31fb05 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=1100&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=dc5caddedc4dcc33fb7169cb5c6bc9d8 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=1650&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9d153ef8bfb872cb54758141256a6d5d 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=2500&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=39e92809ce18ca858e9ac907ed504a9a 2500w" data-optimize="true" data-opv="2" />
</Frame>

### Shared proxy

In 互联网服务提供商 (互联网服务提供商 (ISP)) Shared proxies, you have access to 20,000 proxies around the globe. To target specific country, 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?](https://docs.brightdata.com/cn/general/faqs#where-can-i-see-the-list-of-country-codes)

***

## 缓存代理

Bright Data 的缓存代理是一项旨在减少目标站点不必要负载的功能，一方面允许客户缓存成功结果，另一方面，在可能的情况下根据请求接收缓存结果。

<AccordionGroup>
  <Accordion title="更健康的生态系统">
    从技术上讲，通过消耗网站资源并在数据收集领域造成性能问题可能使网站过载。 Bright Data 除了安装系统以避免目标站点过载之外，还提供缓存代理功能，以避免在我们从另一位客户提出的相同请求中获得最新缓存记录的情况下，向目标站点提出冗余请求。
  </Accordion>

  <Accordion title="提高了性能">
    从我们的缓存中收到的响应速度大约快了 20 倍！
    This means that as our cache usage grows, performance will keep increasing.
  </Accordion>

  <Accordion title="经济利益">
    为了促进我们维护健康生态系统的目标，对于通过选择使用缓存代理的代理区域中的任何使用量，我们将提供使用折扣。

    虽然我们将提供的缓存记录可能只占代理区域总使用量的一小部分，但折扣将充分适用于代理区域。
  </Accordion>
</AccordionGroup>

### 启用缓存代理

只需切换缓存代理开关

<Frame>
  <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3f0e8addd47eb5d1ea5013ac6acff62a" alt="缓存代理" width="580" height="79" data-path="images/proxy-networks/residential/cache_proxy.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=280&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=1ac56d7882de8d1d4e5a7e0bd077173c 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=560&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3ab022814cdedb7f66195c9961a82c9a 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=840&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=034f9eee12112ff7ce3863fb218a9323 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=1100&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b29cbd844b0f4f879e931dc5de261e55 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=1650&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a5c234e956773621691de0ae609e765f 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=2500&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=cdd4e80279b979106bb8ce70840039c9 2500w" data-optimize="true" data-opv="2" />
</Frame>

开启后，我们将引导您完成缓存代理工作所需的一些说明。

**您有两个选项可供选择：**

<AccordionGroup>
  <Accordion title="安装证书">
    <Frame>
      <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b725dbfcbd11e988cca2d5afe9a61643" alt="安装证书" width="519" height="391" data-path="images/proxy-networks/residential/install_certificate.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=280&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=133152ca0cee8ec9d109814f39236c4c 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=560&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=689d21e5d99577cba7c287dadf074bf0 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=840&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6bb1481446931a99bf65b2844c26af4b 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=1100&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=89bcbb6caca76c665e36a3941ecf912c 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=1650&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=938bb88309b7577d3800dd499a05aaff 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=2500&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b5604353a301432e74d9e0ea0aeecc10 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>
</AccordionGroup>

***

## 高级选项：

### 100% 正常运行时间

100% 的正常运行时间通过免费提供 100% 的连接和持续的高性能水平带来立竿见影的价值。 此外，您无需对代码/工作流程进行任何更改。

如果我们的系统检测到问题，例如连接问题或某个 IP 其中的 GEO 与您在购买该 IP 时要求的不完全相同，我们将自动通过与原始 IP 完全相同的其他 IP 处理您的路由请求。

<Accordion title="无缝集成">
  为了向我们的客户提供无缝体验，会产生一些例外情况：

  * 如果您在请求中指定了 IP，我们不会分配回退 IP
  * 100% 正常运行时间不会中断实时连接。 如果需要回退，它将在建立下一个连接后继续参与
</Accordion>

### 启用 100% 的正常运行时间

只需切换 100% 正常运行时间开关

<Frame>
  <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=79315c765e1023270051ccdc90600c72" alt="100% 正常运行时间" width="546" height="87" data-path="images/proxy-networks/data-center/100uptime.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?w=280&maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=1068b06b5b432d07c5cc5be16ab0ac9a 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?w=560&maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=1c311316a449774797ea119611a99fc9 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?w=840&maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=de25d43fe747a859413a41f7036b18ee 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?w=1100&maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ebb7c2b05a9acd093508ebcd8e2181a7 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?w=1650&maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=7a91cc6b2e5761dc6a41c0712f5ac69e 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?w=2500&maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=e3f530fd9e67f924ec18123345786654 2500w" data-optimize="true" data-opv="2" />
</Frame>

<Tip>您还可以通过 API开启/关闭 100% 正常运行时间功能。</Tip>

### 端口

默认情况下，端口 80 和 443 可用，支持 HTTP 和 HTTPS 协议。
下表按端口显示了支持的协议：

| 端口    | 协议             |
| ----- | -------------- |
| `80`  | HTTP 和 HTTP 连接 |
| `443` | HTTPS          |

<Accordion title="请求其他端口">
  Bright Data 可以根据要求支持其他端口。 每一项支持新端口的请求将遵循专门的额外合规流程，由 Bright Data 的合规团队执行。
  如果您需要额外的端口权限，可以联系 Bright Data 支持团队。
  激活前需要 Bright Data 合规性审查的端口示例：

  | 端口     | 协议    |
  | ------ | ----- |
  | `8443` | HTTP  |
  | `8243` | HTTPS |
</Accordion>

***


# ISP代理常见问题解答
Source: https://docs.brightdata.com/cn/proxy-networks/isp/faqs

了解Bright Data的虚拟ISP代理如何运作，包括安全措施、用户隐私和ISP政策合规性等方面。获取最紧迫问题的答案。

<AccordionGroup>
  <Accordion title="虚拟ISP是如何工作的？">
    <不te>本“常见问题解答”详细而透明地提出并解答了所有这些复杂的问题。</不te>

    虚拟ISP从全球数以千计的ISP提供商那里收集数百万个物理IP，将其组成一个虚拟ISP网络。

    这是用于大规模公共网络数据收集的完整共享访问网络；您贵为Bright Data的客户，可以为了私人用途，通过单个IP访问此网络。 或者，您可以使用Bright Data的数据收集平台，让平台为您完成所有工作，并以您要求的格式提供您所需的公共网络数据。
  </Accordion>
</AccordionGroup>


# ISP代理简介
Source: https://docs.brightdata.com/cn/proxy-networks/isp/introduction

了解Bright Data的ISP代理网络如何利用住宅IP实现高速、可靠的数据访问；此网络是用于广告验证、质量保证和克服数据中心代理屏蔽的理想之选。

Bright Data的ISP代理网络是我们的代理网络解决方案之一，由从互联网服务提供商（ISP）购买或租用的住宅IP构建而成，用于商业用途，非供私人住宅使用。

这比我们的数据中心网络更具优势，因为目标网站会将ISP的IP视为与住宅IP类似，尽管实际上它们是托管在服务器上的。这使您可以像真实用户一样访问网站和收集数据，并同时享有高速服务器IP的高速和可靠等特点。 

## 最适用于

* 以类似于真实用户的方式访问难以接触的网站
* 浏览内容、进行广告验证、质量保证、营销等
* 在使用我们的数据中心代理网络时成功率低或被完全屏蔽，而又希望继续享有快速服务器和低成本的好处

<Note>
  如果您需要一个更不可能被网站检测到、更复杂的代理网络，您可以考虑使用我们的 住宅代理。
</Note>

<Tip>
  要获得更高级的代理解锁解决方案以应对更多屏蔽挑战（如特定于网站的标头、Cookie、CAPTCHA验证码等），请尝试我们的 Unlocker API，或查看我们的其他代理产品。
</Tip>


# 如何开始使用 互联网服务提供商 (互联网服务提供商 (ISP)) 代理
Source: https://docs.brightdata.com/cn/proxy-networks/isp/quickstart

从设置账户到创建和命名代理区域，通过简单易学的步骤，了解如何开始使用 Bright Data 的 ISP 代理。

<Tip>
  如果您尚未注册 Bright Data，则可以免费注册，添加付款方式时， 您将获得价值 \$5 的积分以开启服务！
</Tip>

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">登录</a>} />

  <Step title="导航到“我的区域”">
    <Accordion title="在“我的区域”页面的 “互联网服务提供商 (互联网服务提供商 (ISP)) 代理”下，点击“开始”">
      <Warning>
        如果您已经有活跃代理，只需选择右上角的“添加”
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/get_started.png?maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b2babb702918308c826f3747e9b855a5" alt="开始" width="1157" height="888" data-path="images/proxy-networks/isp/quick-start/get_started.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/get_started.png?w=280&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f117b6843b9cbe067a7a546a3337db15 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/get_started.png?w=560&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c68fb721cc2eebd513f89ec252118d20 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/get_started.png?w=840&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9eb11a43b12b98e09bfdc3c6793ae4ac 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/get_started.png?w=1100&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=93107fc609c525d8f6504f05245f12a5 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/get_started.png?w=1650&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7235a12c876c723f67f5a56717736c12 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/get_started.png?w=2500&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=87e1825a81098f5672c354145e2a9a72 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="选择您的代理名称">
    <Accordion title="输入新 互联网服务提供商 (互联网服务提供商 (ISP)) 代理的代理名称">
      <Warning>
        请选择一个有意义的名称，因为区域名称一旦创建就无法更改。
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/proxy_name.png?maxW=556&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fcf1635ca4915b4dd17ea565a08a59f2" alt="代理名称" width="556" height="557" data-path="images/proxy-networks/isp/quick-start/proxy_name.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/proxy_name.png?w=280&maxW=556&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ffea5ed6b6c93f2124c9addb83927022 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/proxy_name.png?w=560&maxW=556&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b082dc3c9528e6aafab74029484765a5 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/proxy_name.png?w=840&maxW=556&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2555c49bb09d508757621d0839144d77 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/proxy_name.png?w=1100&maxW=556&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9e3c3625830707760f61b4ec9364bd36 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/proxy_name.png?w=1650&maxW=556&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=71947ab11d596cc885af8ba6042d3af8 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/proxy_name.png?w=2500&maxW=556&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4b61201b7e9b7b83fcfd449c32049a98 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="点击“添加代理”" />
</Steps>

<Accordion title="在继续操作之前，请验证您的账户">
  如果您尚未添加付款方式，此时系统会提示您添加付款方式，以验证您的账户。 如果您是第一次使用 Bright Data，您还将获得价值 \$5 的奖励积分以帮助您开启服务！

  <Tip>
    此时不会向您收取任何费用，这仅用于验证目的
  </Tip>
</Accordion>

<Note>
  别担心，我们将在下一节“配置您的代理”中介绍所有配置:\
  [https://docs.brightdata.com/cn/proxy-networks/isp/configure-your-proxy](https://docs.brightdata.com/cn/proxy-networks/isp/configure-your-proxy)
</Note>


# 发送第一个请求
Source: https://docs.brightdata.com/cn/proxy-networks/isp/send-your-first-request

我们以多种编程语言提供易于理解的代码示例，以便您了解如何使用Bright Data的代理产品发送第一个请求。

<Accordion title="本指南适用于所有代理产品" icon="check">
  1. 住宅代理
  2. 移动代理
  3. ISP代理
  4. 数据中心代理
  5. SERP API
  6. Browser API
  7. Unlocker API
</Accordion>

首先，请准备好代理凭据、用户名、密码以及主机名称。您可以在代理产品的访问参数或概述选项卡中找到这些凭据。

## 代码示例

准备好代理凭据后，请使用以下代码发送您的第一个请求：

<CodeGroup>
  ```sh cURL
  curl "http://lumtest.com/myip.json" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```javascript Node.js
  #!/usr/bin/env node

  require('request-promise')({
      url: 'http://lumtest.com/myip.json',
      proxy: 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:33335',
    })
    .then(function (data) {
        console.log(data);
      },
      function (err) {
        console.error(err);
      });
  ```

  ```python Python
  import pprint
  import requests


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

  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://lumtest.com/myip.json"
  response = requests.get(url, proxies=proxies)
  pprint.pprint(response.json())

  ```

  ```php PHP

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

  ```

  ```ruby Ruby
  #!/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://lumtest.com/myip.json')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 33335, '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#
  using System;
  using System.Net;

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

  ```java Java
  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", 33335);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("http://lumtest.com/myip.json").viaProxy(proxy))
              .returnContent().asString();
          System.out.println(res);
      }
  }
  ```

  ```perl Perl
  #!/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:33335");
  print $agent->get('http://lumtest.com/myip.json')->content();
  ```

  ```vb VBA
  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:33335")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("http://lumtest.com/myip.json"))
      End Sub
  End Module
  ```
</CodeGroup>

上面的代码是使用住宅代理向[http://lumtest.com/myip.json发送请求。](http://lumtest.com/myip.json发送请求。) 它会以JSON格式返回您的IP信息：

```json 输出
{
  "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"
  }
}
```

现在，将“[https://lumtest.com/myip.json”替换为您选择的网站，然后](https://lumtest.com/myip.json”替换为您选择的网站，然后)...

完成了！


# How to 配置 Your 互联网服务提供商 (ISP) 代理
Source: https://docs.brightdata.com/cn/proxy-networks/mobile/configure-your-proxy

了解如何配置 Bright Data 移动代理设置，包括 IP 类型、地理位置定位、缓存代理和高级选项，以实现最佳性能。

<Accordion title="首先：导航到“配置”选项卡">
  创建代理后，您可以导航到配置选项卡来配置代理设置。

  <Frame>
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ff04df5ed07ae21a35e2f03c28d721e3" alt="配置" width="530" height="729" data-path="images/proxy-networks/data-center/configuraton_tab.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?w=280&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=c2d7f954a17ab45861fd960a57bbb650 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?w=560&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=dc67626f65dd27cfdc9726bb800e8f43 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?w=840&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=bbac3a18561aa4eb91d96e9d21ab568b 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?w=1100&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=36facc9a41dadcedf37c0bedf2e7bb73 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?w=1650&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=81e1b8bbe479373fee9a0c66a48fdfd2 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configuraton_tab.png?w=2500&maxW=530&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9d3d0af0d96ea93b791efd757a3f20ff 2500w" data-optimize="true" data-opv="2" />
  </Frame>
</Accordion>

## IP 类型

**Choose one of three IP 类型s for your proxy zone:**

<CardGroup cols={2}>
  <Card title="共享 (Pay per IP)" href="/proxy-networks/faqs#what-are-ip-types-for-isp" icon="square-1">
    <Tip>Select the number of IPs and country. Pay for IPs and usage.</Tip>
    当您需要具有成本效益的选项，并且不需要 IP 专用权时。
    <Note>多个用户共享 IP</Note>
  </Card>

  <Card title="共享 (Pay per Usage)" href="/proxy-networks/faqs#what-are-ip-types-for-isp" icon="square-2">
    <Tip>Fixed pool of 10,000 IPs from all countries. IPs are free. Pay for use.</Tip>
    当您需要具有成本效益的选项，并且不需要 IP 专用权时。 These proxies will rotate so every request you can get a new IP address ("Rotating proxies").

    <Note>IPs shared across **multiple** users</Note>
  </Card>

  <Card title="Dedicated" href="/proxy-networks/faqs#what-are-ip-types-for-isp" icon="square-3">
    当您需要使用专用 IP 地址访问网站时。
    <Note>IPs are **for your use only**.</Note>
  </Card>
</CardGroup>

***

## Number of IPs

Number of IPs to be allocated as your pool of available IPs.
<Warning>Be aware increasing the number adds additional cost.</Warning>

## Allocated IPs

You can view or download the IPs allocated to you.

<Frame>
  <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=7a4b0863cdbcd3dac920a163878881ac" alt="地理位置定位" width="561" height="84" data-path="images/proxy-networks/data-center/allocated-ips.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?w=280&maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=2e74f5bcbaff8a7c147b93e51de4c4ea 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?w=560&maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=6af09e6bb9fa638a42f59bf328138b44 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?w=840&maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=f9c6146a358b4ac10263c7877d062b84 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?w=1100&maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=335ad91e25acfd9bb72b7b49ce5ace70 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?w=1650&maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=cba076ab6d22c916398f7ade1650039a 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/allocated-ips.png?w=2500&maxW=561&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=88974428fc9d8a77f6a98576f758169c 2500w" data-optimize="true" data-opv="2" />
</Frame>

***

## 地理位置定位

<Tip>
  Common setup is to create a zone per each location, this way you can control your requests target on the zone level.

  For example: ispshared-uk, ispshared-us, ispshared-de.
</Tip>

### Dedicated and Pay per IP proxies

地理位置定位 allows you to target specific `Country`.
Select the prefered countries from the drop-down menu.

If you select multiple countries, we assign proxies distributed  evenly across the countries you selected.

<Frame>
  <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d307c894cda3101699ba450988554136" alt="地理位置定位" width="572" height="358" data-path="images/proxy-networks/data-center/geotargeting.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=280&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=67026a086654981fcd2439025d93033d 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=560&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=341cf0c6a4d403bdb158cc49a0f23ebf 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=840&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=895a1fd7f97db50b0571cfb2db31fb05 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=1100&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=dc5caddedc4dcc33fb7169cb5c6bc9d8 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=1650&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9d153ef8bfb872cb54758141256a6d5d 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=2500&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=39e92809ce18ca858e9ac907ed504a9a 2500w" data-optimize="true" data-opv="2" />
</Frame>

### 共享 proxy

In 互联网服务提供商 (ISP) 共享 proxies, you have access to 20,000 proxies around the globe. To target specific country, 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?](https://docs.brightdata.com/cn/general/faqs#where-can-i-see-the-list-of-country-codes)

***

## 缓存代理

Bright Data's cache proxy is a feature that aims to reduce the unneeded load from target sites by allowing customers to have their successful results cached on the one hand and, on the other hand, to receive cached results to their requests when possible.

<AccordionGroup>
  <Accordion title="更健康的生态系统">
    从技术上讲，通过消耗网站资源并在数据收集领域造成性能问题可能使网站过载。 Bright Data 除了安装系统以避免目标站点过载之外，还提供缓存代理功能，以避免在我们从另一位客户提出的相同请求中获得最新缓存记录的情况下，向目标站点提出冗余请求。
  </Accordion>

  <Accordion title="提高了性能">
    从我们的缓存中收到的响应速度大约快了 20 倍！
    This means that as our cache usage grows, performance will keep increasing.
  </Accordion>

  <Accordion title="经济利益">
    为了促进我们维护健康生态系统的目标，对于通过选择使用缓存代理的代理区域中的任何使用量，我们将提供使用折扣。

    虽然我们将提供的缓存记录可能只占代理区域总使用量的一小部分，但折扣将充分适用于代理区域。
  </Accordion>
</AccordionGroup>

### 启用缓存代理

只需切换缓存代理开关

<Frame>
  <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3f0e8addd47eb5d1ea5013ac6acff62a" alt="缓存代理" width="580" height="79" data-path="images/proxy-networks/residential/cache_proxy.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=280&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=1ac56d7882de8d1d4e5a7e0bd077173c 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=560&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3ab022814cdedb7f66195c9961a82c9a 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=840&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=034f9eee12112ff7ce3863fb218a9323 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=1100&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b29cbd844b0f4f879e931dc5de261e55 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=1650&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a5c234e956773621691de0ae609e765f 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=2500&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=cdd4e80279b979106bb8ce70840039c9 2500w" data-optimize="true" data-opv="2" />
</Frame>

开启后，我们将引导您完成缓存代理工作所需的一些说明。

**您有两个选项可供选择：**

<AccordionGroup>
  <Accordion title="安装证书">
    <Frame>
      <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b725dbfcbd11e988cca2d5afe9a61643" alt="安装证书" width="519" height="391" data-path="images/proxy-networks/residential/install_certificate.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=280&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=133152ca0cee8ec9d109814f39236c4c 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=560&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=689d21e5d99577cba7c287dadf074bf0 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=840&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6bb1481446931a99bf65b2844c26af4b 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=1100&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=89bcbb6caca76c665e36a3941ecf912c 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=1650&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=938bb88309b7577d3800dd499a05aaff 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=2500&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b5604353a301432e74d9e0ea0aeecc10 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>
</AccordionGroup>

***

## 高级选项：

### 100% uptime

The 100% uptime brings immediate value by providing 100% connectivity and continuous high-performance level, free of charge. Plus you don't have to make any changes in your code/workflow.

If our system 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.

<Accordion title="Seamless integration">
  To provide our customers a seamless experience, so we made some exceptions:

  * We will not assign a fallback IP if you have specified an IP in your request
  * 100% uptime will not interrupt a live connection. If the fallback is needed, it will play in once the next connection is established
</Accordion>

### Enable 100% uptime

Simply toggle the 100% uptime switch

<Frame>
  <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=79315c765e1023270051ccdc90600c72" alt="100% uptime" width="546" height="87" data-path="images/proxy-networks/data-center/100uptime.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?w=280&maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=1068b06b5b432d07c5cc5be16ab0ac9a 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?w=560&maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=1c311316a449774797ea119611a99fc9 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?w=840&maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=de25d43fe747a859413a41f7036b18ee 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?w=1100&maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ebb7c2b05a9acd093508ebcd8e2181a7 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?w=1650&maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=7a91cc6b2e5761dc6a41c0712f5ac69e 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/100uptime.png?w=2500&maxW=546&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=e3f530fd9e67f924ec18123345786654 2500w" data-optimize="true" data-opv="2" />
</Frame>

<Tip>You can also turn on/off 100% uptime feature via the API.</Tip>

### 端口

端口 `80` and `443` are available by default, supporting HTTP and HTTPS protocols.
The below table shows supported protocols by port:

| Port  | Protocol              |
| ----- | --------------------- |
| `80`  | HTTP and HTTP CONNECT |
| `443` | HTTPS                 |

<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 |
  | ------ | -------- |
  | `8443` | HTTP     |
  | `8243` | HTTPS    |
</Accordion>

***


# 移动代理常见问题解答
Source: https://docs.brightdata.com/cn/proxy-networks/mobile/faqs

查找有关集成、配置和使用 Bright Data 移动代理产品的常见问题解答（包括IP类型、地理定位和错误代码）。

<AccordionGroup>
  <Accordion title="Bright Data 的代理分布在哪些地方？">
    Bright Data在全球每个国家/地区都有代理，以下国家除外：

    * 伊朗
    * 伊拉克
    * 叙利亚
    * 黎巴嫩
    * 巴勒斯坦
    * 朝鲜
    * 古巴
    * 苏丹
    * 俄罗斯克里米亚地区

    如果您需要来自这些国家/地区的代理，很遗憾， Bright Data 无法为您提供帮助。
  </Accordion>

  <Accordion title="如何使用中国住宅IP浏览中国网站">
    **在中国境外时**\
    只需定位中国住宅IP对等节点即可：

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-cn:<zone_password> "<target_site>"
    ```

    在中国境内时除了定位中国住宅IP对等节点之外，还需要定位我们的中国超级代理。

    * 使用 API 命令时，代理 DNS 服务器为 `servercountry-cn.brd.superproxy.io`

    ```sh
    curl --proxy servercountry-cn.brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-cn:<zone_password> "<target_site>"
    ```

    * 使用代理管理器时：

      * 只需点击端口，即可选择相关的端口设置\
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=60c9b798eabd855e54f15c9ed30532c2" alt="port-row.png" width="1490" height="231" data-path="images/proxy-networks/faqs/port-row.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=280&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=1faa89a7b9389f25ce2f2df9ae193acb 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=560&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=efb6903924f8bd83b6dcb191861c4ff2 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=840&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d1de11eb98f22e136fd84756eab9be3c 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=1100&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=abd917c6d5a4876eedaab8df719ca48d 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=1650&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=279bcb4f18934e70b834c32766d4dcba 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=2500&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7074af21c015ff4464baacf4e6ff8cc7 2500w" data-optimize="true" data-opv="2" />

      * 选择定位，并将中国设置为目标国家\
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4e9d4ff832de3da6c12d54b8e7117f87" alt="target-china.png" width="1848" height="459" data-path="images/proxy-networks/faqs/target-china.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=280&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7e8a54f7f5fef55ea745a2bcecc2b134 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=560&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0b6da7728c8d55330dedee5688064a58 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=840&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6a1153555ae45d3e58cb2b55bb5080a7 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=1100&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=35475a8710d937c48354ee0706a6b9ff 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=1650&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9e78a53887ad4d63f83c1da8e89e6d86 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=2500&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4a583a62f471c4fc8ef963a9d0890a64 2500w" data-optimize="true" data-opv="2" />

      * 选择IP控制：将超级代理位置设置为“中国”。
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=79fc7dda8eb2f7f223ccb1e7229dfec4" alt="super-proxy-china.png" width="1838" height="566" data-path="images/proxy-networks/faqs/super-proxy-china.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=280&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=dd62f53444546238099ce3daf1d86320 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=560&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6de9045b2c50ee90605f0da550a87d7e 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=840&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9f6435bff0c6d7dcc194a1466059bafe 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=1100&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2364095b48753d17748d25742385971b 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=1650&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d2d9cba66d209296757cfdd139679ebe 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=2500&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5eef24fd9763e130b83ee9e9f7bde87f 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="特定于运营商的代理对等节点IP">
    * 您可以选择使用以下列表中的特定运营商：

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

    * 例如

    <CodeGroup>
      ```sh Deutsche Telekom
      brd-customer-<customer_id>-zone-<zone_name>-carrier-dt
      ```

      ```sh Sprint
      brd-customer-<customer_id>-zone-<zone_name>-carrier-sprint
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="关于地理位置数据库，以及如何检查代理IP信息？">
    互联网网站使用地理位置数据库（GeoDB）来查询用户所使用的IP地址的信息。Bright Data 监控并维护现今4个主要 GeoDB 的正确记录：Maxmind、ip2location、db-ip 和 Google。

    还有许多其他较小的GeoDB，其中大多数使用的是过时的记录或有缺陷的测试方法，因此所提供的信息并不准确，或者只是用来吸引浏览者向其购买VPN或代理产品。因此，在测试IP时，我们强烈建议您使用上述的GeoDB。

    要查看您使用的代理IP的信息，请浏览以下其中一个：

    * [https://lumtest.com/echo.json](https://lumtest.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="哪些 Bright Data 产品最适合用来抓取搜索引擎 (SERP)?">
    #### 用于单步抓取：

    [SERP API](https://docs.brightdata.com/scraping-automation/serp-api/introduction) 是针对 SERP 进行抓取的理想产品，因其具有主动解锁、自动选择最佳代理、自定义标头、规避指纹识别、CAPTCHA验证码破解等功能，可以保证成功率（不成功不收费）。

    #### 用于多步抓取 (playwright/puppeteer/selenium):

    [Browser API](https://docs.brightdata.com/scraping-automation/scraping-browser/introduction) 是理想的产品，是我们完全托管在云上的浏览器，旨在由我们为您全面处理代理工作和基础设施解锁（包括 CAPTCHA 验证码破解），以帮助您轻松专注于多步骤数据收集。
  </Accordion>

  <Accordion title="我能否使用住宅、数据中心或ISP代理网络来针对 Google SERP 进行抓取？">
    **住宅代理** - 不可以, [SERP API](https://docs.brightdata.com/scraping-automation/serp-api/introduction)是针对 SERP 进行抓取的理想产品，因其具有主动解锁、自动选择最佳代理、自定义标头、规避指纹识别、验证码破解等功能，可以保证成功率（不成功不收费）。通过住宅网络定位 Google SERP 将导致绕过超级代理，从而造成请求从我们的服务器而不是对等节点发送。

    **数据中心和ISP代理** - 不可以。当您试图通过这两个代理网络的其中一个来针对 Google 进行抓取时，请求将被拒绝，您将在响应标头中收到以下错误消息：

    ```
    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. 您可以联系您的账户经理或创建支持工单，以寻求帮助
    ```
  </Accordion>

  <Accordion title="Bright Data 是否支持 SOCKS5 协议？">
    是的。Bright Data 支持 `SOCKS5` 协议，为 `SOCKS5` 通信分配的默认端口为 `22228`。

    请参阅此处了解完整的 SOCKS5 配置说明或访问 SOCKS5 代理页面。

    [full SOCKS5 configuration instructions](https://docs.brightdata.com/proxy-networks/socks5), [SOCKS5 proxies page](https://brightdata.com/solutions/socks5-proxies).
  </Accordion>

  <Accordion title="错误代码 502 是什么？">
    HTTP错误代码502表示“网关错误”。当您向URL发送请求，但URL的服务器从另一个用于完成请求的服务器接收到无效响应时，就会出现此错误。

    **可能的原因**

    * 我们目前没有与您的区域配置相匹配的对等节点，因为那些对等节点可能已被不同的客户端使用，或由于其他原因而不可用。

    * 由于没有活动，连接已超时。

    * 主机（目标URL）端已关闭连接

    **错误 502 响应示例**

    ```
    Request URL: SAMPLE_URL Request method: GET ***Status code: 502***  
    Super proxy IP: IP  
    Username: brd-customer-customer_id-zone-zone_name-country  
    Password: zone_password  
    Sent from: 127.0.0.1  
    Response headers  
    connection: keep-alive  
    date: Tue, 14 Feb 2023 08:49:16 GMT  
    keep-alive: timeout=5  
    transfer-encoding: chunked  
    x-lpm-port: 24000  
    x-luminati-error: waiting for selector ".price-container" failed: timeout 90000ms exceeded  
    ***x-luminati-error-code: expect_element***  
    x-request-id2: REQUEST_ID  
    Request headers  
    user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36(KHTML, like Gecko) Chrome/110.0.0.0 Safari/537.36  
    host: SAMPLE_HOST  
    accept-encoding: gzip, deflate  
    Connection: keep-alive
    ```
  </Accordion>

  <Accordion title="错误代码 403 是什么？">
    HTTP 403响应代码表示禁止您访问一个有效的URL。

    服务器理解请求，但由于客户端的问题而无法完成请求。

    **可能的原因**

    * 您的机器IP未列入白名单。要了解如何将IP列入白名单，请参阅以下文章: [https://docs.brightdata.com/api-reference/proxy-manager/allowlist-ips](https://docs.brightdata.com/api-reference/proxy-manager/allowlist-ips)

    * 您尝试访问的域被 Bright Data 屏蔽 。

    * 您尝试访问的域未在您的用例中指定。

    * 验证码响应失败（与Unlocker API和SERP API相关）。

    * 您尝试访问的域被您区域的目标主机设置禁止访问（请检查您的代理区域访问参数）

    **错误403响应示例**

    ```
    < HTTP/1.1 403 response status was rejected  
    < x-debug-req-id: SAMPLE_ID  
    < X-Luminati-Error: response status was rejected: 403 Forbidden  
    < X-Luminati-Error-Code: http_status  
    < Date: Wed, 22 Feb 2023 11:11:23 GMT  
    < Connection: keep-alive  
    < Keep-Alive: timeout=5  
    < Transfer-Encoding: chunked
    ```

    403 `X-luminati-error` (Forbidden) 表示您的目标域是Bright Data不允许的域。  \
    要解决此问题，请联系Bright Data合规团队，获取批准。  \
    当 Bright Data 合规团队审查您的用例并确认后，将通知您已添加访问权限。  \
    要获得更好的处理，建议您将客户经理添加到支持工单中，并将您的要求告知客户经理。

    当出现以下错误消息时：

    ```
    You tried to target <host> but got blocked
    ```

    请联系Bright data合规团队（[compliance@brightdata.com](mailto:compliance@brightdata.com)），或通过工单系统联系我们

    我们的合规团队将会审查您要求访问特定域的请求
  </Accordion>

  <Accordion title="移动代理有哪些设备和网络？" defaultOpen={false}>
    BrightData移动代理是连接到真实移动网络（而非个人或公共wifi）的真实移动设备。.

    发出请求时，在响应标头中，我们通过gIP或使用的代理（我们用来区分代理并保护对等节点的真实IP地址的掩码哈希值）填充字段x-brd-ip。对于移动代理，此字段将以字母“m”作为前缀。
  </Accordion>
</AccordionGroup>


# 移动代理简介
Source: https://docs.brightdata.com/cn/proxy-networks/mobile/introduction

Bright Data 的移动代理网络在全球拥有 700 万个移动IP，是用于获取商业情报、竞争对手分析和广告验证的理想之选，欢迎探索。

Bright Data的移动代理网络由700万个移动IP组成，这些IP是由世界各地的人们提供的。这些移动住宅IP由ISP分发，供人们的移动设备使用，这些真实的用户选择加入我们，与我们的住宅移动网络分享其IP。

这样，您就可以使用3G/4G移动连接，连接到世界任何国家和城市的真实移动网络，像任何真实的移动用户那样访问互联网。 我们的网络具备ASN、运营商和移动网络定位功能。

### 最适用于

* 以真实用户使用手机浏览的方式浏览复杂的目标网站。
* 获取商业情报、竞争对手分析、广告验证、应用程序质量保证等
* 需要我们[住宅](https://docs.brightdata.com/proxy-networks/residential/introduction)网络功能（侧重于 移动设备）的团队

<Tip>
  如果您在寻找另一种代理解决方案以应对不同的挑战，请查看我们的其他代理产品。

  [check out our other proxy products](https://brightdata.com/proxy-types).
</Tip>


# 如何开始使用移动代理
Source: https://docs.brightdata.com/cn/proxy-networks/mobile/quickstart



<Tip>
  如果您尚未注册 Bright Data，则可以免费注册，添加付款方式时，您将获得价值 \$5 的积分以开启服务！\
  [https://brightdata.com/](https://brightdata.com/)
</Tip>

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">登录</a>} />

  <Step title="导航到“我的区域”">
    <Accordion title="在“我的区域”页面的“移动代理”下，点击“开始”">
      <Warning>
        如果您已经有活跃代理，只需选择右上角的“添加”
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/get_started.png?maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=57f4108c40c71779a7b7e31a50379a3e" alt="开始" width="1157" height="888" data-path="images/proxy-networks/mobile/quick-start/get_started.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/get_started.png?w=280&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=64eca1de59a3655d033f3bdff1bfca65 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/get_started.png?w=560&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=51e82aa530c4fdde697f56d71f19f6f8 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/get_started.png?w=840&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=42fcaf8dd0461269315a41221f7bebbc 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/get_started.png?w=1100&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=bc2d775654dd79da0a151e2567eb30b1 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/get_started.png?w=1650&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=de0c2130589632dcda358edf6a4988be 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/get_started.png?w=2500&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=580a864c00748dded11783af1ab9cdd2 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="选择您的代理名称">
    <Accordion title="为新移动代理的代理名称">
      <Warning>
        请选择一个有意义的名称，因为区域名称一旦创建就无法更改。
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/proxy_name.png?maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ea22e8c3f85e567cf93fcad0fe4cc81b" alt="开始" width="536" height="544" data-path="images/proxy-networks/mobile/quick-start/proxy_name.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/proxy_name.png?w=280&maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2bf0a17bc7119b661ae3c930b0c6012f 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/proxy_name.png?w=560&maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=be33a59fb37b63f34eab13e7f2db1e6f 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/proxy_name.png?w=840&maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2ef1af72bd166e99d38aa9ef4af2c589 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/proxy_name.png?w=1100&maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e2404ec569e480cddfde746f21c73384 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/proxy_name.png?w=1650&maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=93ce05634fba4bcaaf55e21d09fa392c 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/proxy_name.png?w=2500&maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f061921a98207d9fb1b02b8d416383ca 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="点击“添加代理”" />
</Steps>

<Accordion title="在继续操作之前，请验证您的账户">
  如果您尚未添加付款方式，此时系统会提示您添加付款方式以验证您的账户。 如果您是第一次使用 Bright Data，您还将获得价值 \$5 的奖励积分以帮助您开启服务！

  <Tip>
    此时不会向您收取任何费用，这仅用于验证目的
  </Tip>
</Accordion>

<Note>
  别担心，我们将在下一节“配置您的代理”中介绍所有配置:\
  [https://docs.brightdata.com/cn/proxy-networks/mobile/configure-your-proxy](https://docs.brightdata.com/cn/proxy-networks/mobile/configure-your-proxy)
</Note>


# 发送第一个请求
Source: https://docs.brightdata.com/cn/proxy-networks/mobile/send-your-first-request

我们以多种编程语言提供易于理解的代码示例，以便您了解如何使用Bright Data的代理产品发送第一个请求。

<Accordion title="本指南适用于所有代理产品" icon="check">
  1. 住宅代理

  2. 移动代理

  3. ISP代理

  4. 数据中心代理

  5. SERP API

  6. Browser API

  7. Unlocker API
</Accordion>

首先，请准备好代理凭据、用户名、密码以及主机名称。您可以在代理产品的访问参数或概述选项卡中找到这些凭据。

## 代码示例

准备好代理凭据后，请使用以下代码发送您的第一个请求：

<CodeGroup>
  ```sh cURL
  curl "http://lumtest.com/myip.json" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```javascript Node.js
  #!/usr/bin/env node

  require('request-promise')({
      url: 'http://lumtest.com/myip.json',
      proxy: 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:33335',
    })
    .then(function (data) {
        console.log(data);
      },
      function (err) {
        console.error(err);
      });
  ```

  ```python Python
  import pprint
  import requests


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

  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://lumtest.com/myip.json"
  response = requests.get(url, proxies=proxies)
  pprint.pprint(response.json())

  ```

  ```php PHP

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

  ```

  ```ruby Ruby
  #!/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://lumtest.com/myip.json')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 33335, '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#
  using System;
  using System.Net;

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

  ```java Java
  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", 33335);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("http://lumtest.com/myip.json").viaProxy(proxy))
              .returnContent().asString();
          System.out.println(res);
      }
  }
  ```

  ```perl Perl
  #!/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:33335");
  print $agent->get('http://lumtest.com/myip.json')->content();
  ```

  ```vb VBA
  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:33335")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("http://lumtest.com/myip.json"))
      End Sub
  End Module
  ```
</CodeGroup>

上面的代码是使用住宅代理向 [http://lumtest.com/myip.json](http://lumtest.com/myip.json) 发送请求。它会以JSON格式返回您的IP信息：

```json 输出
{
  "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"
  }
}
```

现在，将 [https://lumtest.com/myip.json](https://lumtest.com/myip.json) 替换为您选择的网站，然后 ...

**完成了！**


# 如何配置代理管理器
Source: https://docs.brightdata.com/cn/proxy-networks/proxy-manager/configuration

详细了解代理管理器的功能、如何根据您的需求定制它以及如何实现流行的最佳化工作流程。

{/*tags:pmgr*/}

## 安装

***

我们的代理管理器易于在您的本地机器或远程服务器上安装和维护，但建议使用我们的云服务器来完全访问代理管理器所提供的所有内容。

### Bright Data 云托管

在本地托管代理管理器需要负载平衡和维护解决方案——我们可以为您托管！

我们提供具有单一用户界面的多实例云来控制您的代理管理器的操作。

* 要启用此选项，请在您的账户的代理管理器页面上选择“激活”，系统将自动提供实例: [https://brightdata.com/cp/lpm](https://brightdata.com/cp/lpm)

### 本地/远程安装

要通过本地/远程方式将它安装在特定的操作系统上，最低要求是：

* 2GB 内存
* 1个 CPU
* 3GB 硬盘

相应操作系统的安装方法：

<Tabs>
  <Tab title="Windows">
    从我们的 GitHub 版本中下载安装程序文件: [https://github.com/luminati-io/luminati-proxy/tags](https://github.com/luminati-io/luminati-proxy/tags)
    <Tip>确保下载最新版本。</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
          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 代理管理器 by running from a terminal one of the following commands:

    ```sh
    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 安装 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
    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 33335 replacing port 22225 deprecated on Sep 2026, click to read more">[`33335`](https://docs.brightdata.com/cn/general/faqs#which-port-shall-i-use-22225-or-33335) </Tooltip> for dropin and 24000-24... for all the ports that you'll create.
    * To run docker with cli option see the below example:

    ```sh
    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>

***

## 预设

***

<Tabs>
  <Tab title="长单一会话（IP）">
    如果您需要加载整页，请使用此预设。 手动从浏览器（例如 Chrome/Firefox）或以编程方式（例如 Puppeteer/Selenium）进行连接。 所有请求均共享相同的 IP。 您可以控制何时从用户界面或 API 刷新 IP。
  </Tab>

  <Tab title="轮换">
    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="自定义">
    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>

## 规则和标头

***

导航到“规则”，并开始根基于以下触发器构建自己的规则，例如：

* URL 后缀
* 状态码
* 在响应主体中找到的字符串值
* 请求延迟

您可以分别选择对每个触发器采取的操作。

例如，通过使媒体 URL 的输出无效来实施节省带宽的规则。

此外，您可以在“规则”部分下提前实现所需的标头。

例如，在 i686 CPU 上添加 Linux 桌面的用户代理标头（有关用户代理的更多信息可在此处找到）
[https://developers.whatismybrowser.com/useragents/explore/](https://developers.whatismybrowser.com/useragents/explore/)

## 端口定位

***

Bright Data 代理管理器允许使用 IP:PORT 格式来定位代理。 例如，在本地安装代理管理器时，定位索引为24000的端口：

```sh
curl --proxy 127.0.0.1:24000 "https://target.site"
```

<Note>
  如果是远程安装，只需将127.0.0.1与远程服务器 IP 地址切换。 （而不是 IP:PORT USERNAME:PASSWORD）
</Note>

```sh
curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> "https://target.site"
```

这可以实现：

* 从请求中移除 username:password 部分。
* 与仅接受 IP:Port 格式的第三方软件集成
* 整洁的代码。 可以预先为端口配置所有必要的标头和规则，而无需调整命令/请求本身。 More information is available [here](https://docs.brightdata.com/cn/api-reference/proxy-manager/update_a_proxy_port)

## 添加外部代理

***

Bright Data 代理管理器支持来自其他供应商的外部代理。 连接外部代理将允许您在一处优化和管理所有代理。

* 登录您的代理管理器
* 设置新端口。
* Select 'External'
* 以下一种格式添加代理

```js
[
    '<proxy_peer_IP>', '<username>:<password>@<proxyprovider_server>:<port>'
]
```

* 点击“保存”，您将获得外部代理作为代理管理器的端口之一

<Frame>
    <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/configuration/external-sources.png?maxW=612&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a9aad1cb4e38a447e9a238369759099f" alt="" width="612" height="431" data-path="images/proxy-networks/proxy-manager/configuration/external-sources.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/configuration/external-sources.png?w=280&maxW=612&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fcf3a9792fbe38c7ad70341a602897f0 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/configuration/external-sources.png?w=560&maxW=612&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=63f3bd91abf01f263a4405ad16d1b5fa 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/configuration/external-sources.png?w=840&maxW=612&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=85d611b743dd43130bbb36a5b90a55e3 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/configuration/external-sources.png?w=1100&maxW=612&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0b163d31cb15c339318b948f365b51c4 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/configuration/external-sources.png?w=1650&maxW=612&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=df1b7ff81eb5050be520d63ea1545969 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/configuration/external-sources.png?w=2500&maxW=612&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=1de73146d83d312f5772168d9ad5c8b8 2500w" data-optimize="true" data-opv="2" />
</Frame>

## 流量计算差异

***

代理管理器是请求发起者和我们的超级代理服务器之间的中间人。 代理管理器统计信息可以在此处查看，超级代理统计信息可以在此处查看。因此，您发送到代理管理器的每个请求最终都会到达超级代理。但是流量计算可能会有所不同，原因如下：

* 代理管理器在发送请求时计算传入的请求，但是在请求到达代理管理器后，会附加额外的标头，以便请求的响应将包含有关请求流的更多信息（时间线、代理 IP 等）
* 从代理管理器到达超级代理服务器的请求会带有这些附加参数；这就是为什么超级代理计算的请求比最初到达代理管理器时略大的原因
* 代理管理器有时会添加标头以呈现更好的日志视图，但是账单中没有计算这些数据

综上所述，流量统计数据的主要来源应该是区域的页面，因为它代表超级代理编制的统计数据。

通常，Bright Data 使用区域的页面进行计算，并作为一个事实来源

发票和账单事件将根据区域计算触发

{/*tags:pmgr*/}


# Proxy Manager常见问题解答
Source: https://docs.brightdata.com/cn/proxy-networks/proxy-manager/faqs

查找Proxy Manager常见问题的详细解答，包括访问限制、端口倍增、IP定位等。

{/*tags:pmgr*/}

<AccordionGroup>
  <Accordion title="可以限制对本地Proxy Manager的远程访问吗？">
    为了保护您的账户并防止对Proxy Manager的未经授权访问，有3种主要工作流程可以使用：

    1. 将IP列入白名单
    2. 使用令牌进行的验证
    3. 使用Bright Data扩展程序，通过电子邮件授予权限
  </Accordion>

  <Accordion title="如何通过HTTPS连接到超级代理？">
    Proxy Manager可以使用HTTP或HTTPS与Bright Data主基础设施连接。

    <Note>
      请勿混淆：这不是连接到目标URL的连接类型。
      要确保连接安全，只需将与超级代理的连接保持为默认值（HTTP）即可，因为HTTPS请求无论如何都会与目标网站建立端到端加密连接。
    </Note>

    在大多数情况下，您甚至不需要碰这个配置。但是，当从一些被禁訪问某些域的地区进行连接时，这个配置可能会很有用。 在这些情况下，您需要将其设置为HTTPS ，以防止全局防火墙看到您的代理流量的内容，并根据目标域将其过滤掉。
  </Accordion>

  <Accordion title="如何倍增端口？">
    转到“一般信息”选项卡，然后在“倍增代理端口”下拉列表中选择端口要增加的倍数

    设置所需的倍增端口数量后，Proxy Manager就会生成与您配置的端口相同的顺序端口。

    这是非常强大的功能，当您需要创建多个具有相同设置的端口时，只需设置一次即可。
  </Accordion>

  <Accordion title="如何获取特定位置的IP？">
    使用Bright Data，您可以指定用于发送流量的IP的地理位置和其他参数。 在Proxy Manager中，这特别简单，只需点击几下即可。

    您可以只请求特定国家的IP（如果您使用住宅或数据中心网络），或者请求额外的特定运营商IP（如果您使用移动网络）IP，这取决于您使用的区域。

    **如何在Proxy Manager中设置定位？**

    要获取特定位置的IP，请按照以下步骤操作：

    * 点击您要使用特定位置IP的代理端口
    * 转到定位选项卡
    * 选择国家、州、城市，以选择特定地理位置的对等点
    * 选择ASN或运营商名称（仅适用于移动对等点）

    <Note>
      每个定位选项都需要在您的区域中获得适当的权限。
    </Note>

    <Accordion title="如何在不创建多个端口的情况下使用多个国家/地区的IP？">
      如果您想使用多个国家/地区的IP，但又不想为每个国家/地区创建单独的代理端口，也可以动态控制定位。
    </Accordion>
  </Accordion>

  <Accordion title="如何动态控制定位？">
    您无需提前在用户界面中使用定位选项卡指定国家、州或城市定位。在请求时，可以同时动态（“即时”）传递额外的定位选项。

    ```sh
    curl -x lum-country-br@127.0.0.1:24001 http://lumtest.com/myip.json
    ```

    请求的结构如下：

    ```sh
    curl -x lum-country-<country_iso_code>@<ip>:<port> <destination_url>
    ```

    动态控制定位的另一种选项是添加特殊标头。

    ```sh
    "x-lpm-country: <country_code>"
    ```

    请求示例如下：

    ```sh
    curl --proxy http://127.0.0.1:24000 -H "x-lpm-country: us" http://lumtest.com/myip.json
    ```

    您还可以使用标头来控制州和城市：

    * 州: `x-lpm-state: <state>`
    * 城市: `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
    curl --proxy [LPM_DOMAIN]:[PORT] -H "x-lpm-country: il" "http://lumtest.com/myip.json"
    ```
  </Accordion>

  <Accordion title="如何设置自动跟随重定向？">
    跟随重定向是Proxy Manager中的一项重要功能，可以增强您对30X（重定向）错误处理的控制。 此功能位于端口设置中的一般信息选项卡里。 此功能让您在遇到30X错误时可以自动发送新请求，新请求的目标URL源自位置响应标头。 本文档会指导您启用和使用此功能。

    **访问跟随重定向：**

    1. 打开要激活跟随重定向功能的端口
    2. 转到一般信息选项卡：在端口设置中，点击一般信息选项卡。在这里，您可以找到有关代理如何处理请求和响应的各种设置。
    3. 切换跟随重定向功能：在一般信息选项卡中，可以看到跟随重定向功能。此功能以切换按钮的形态呈现，您可以根据需要将其启用或禁用。

    **跟随重定向如何工作：**

    * 跟随重定向功能启用后，将会指示Proxy Manager在遇到30X错误时自动发送新的请求。
    * 新请求的URL是根据在30X错误响应中收到的位置响应标头确定的。
    * 这可让您的代理无缝地跟随重定向，确保将请求发送到位置标头指定的正确目的地。

    **跟随重定向的好处：**

    在不支持或不希望进行自动重定向的环境中，您可以完全控制跟随重定向功能。
  </Accordion>

  <Accordion title="如何使用会话标头控制会话一致性？">
    您可以使用Proxy Manager发送x-lpm-session标头，以控制会话。

    * 添加带有任意随机会话ID“x-lpm-session: random\_session”的标头
    * 当使用相同的会话时，Proxy Manager将尝试连接到相同的出口节点（对等点/IP）
    * 当您更改会话值时，Proxy Manager将连接到不同的出口节点（新的对等点/IP）
    * 要使一节会话保持活动状态，必须至少每60秒发送一次请求。
    * 请注意，要将其用于HTTPS请求，您需要启用SSL分析并安装证书

    示例如下：

    ```sh
    curl --proxy http://127.0.0.1:24000 -H "x-lpm-session: rand123" http://lumtest.com/myip
    ```
  </Accordion>

  <Accordion title="如何在云Proxy Manager上刷新会话？">
    您可以使用以下curl请求，在云Proxy Manager上刷新会话：

    ```sh
    curl -X POST "https://pmgr-customer-<customer_id>.brd.superproxy.io:22999/api/refresh_sessions/<port>"
    ```
  </Accordion>

  <Accordion title="如何从Proxy Manager导出日志？">
    在Proxy Manager中，我们为用户提供了一系列的选项，用于将日志导出到外部存储和日志监控系统。 这些导出选项让您可以高效地集中和分析日志。 在本文档文章中，我们将概述可用的日志导出选项，并指导您如何通过Proxy Manager设置进行配置。

    **日志导出选项：**

    Proxy Manager提供以下日志导出选项：

    **Logz.io**

    在Proxy Manager设置中指定Logz.io 令牌、主机和其他必需的参数，以配置Logz.io集成。

    **AWS S3:**

    要将日志导出到AWS S3，请在Proxy Manager设置中设置S3集成。 您需要指定AWS访问密钥、密钥、S3存储桶名称和其他相关详细信息。

    **Webhook:**

    要开始通过webhook导出日志，请在Proxy Manager设置中配置webhook端点以及所需的验证详细信息和URL。

    **Datadog:**

    要将日志导出到Datadog，请提供您的Datadog API密钥和其他相关信息，在Proxy Manager设置中设置 Datadog 集成。

    **配置日志导出：**

    要在Proxy Manager中配置日志导出，请按照以下一般步骤操作：

    1. 访问Proxy Manager设置：
    2. 导航到设置或配置部分。
    3. 选择启用请求日志中的日志设置选项
    4. 开启使用远程日志聚合器
    5. 选择所需的日志导出选项（Webhook、Datadog、Logz.io或AWS S3）。
    6. 提供配置详细信息：您通常需要为所选的导出选项提供特定的配置详细信息。 这可能包括端点URL、API 密钥、验证凭据和存储设置。
    7. 点击测试以检查配置
    8. 点击确定并保存更改

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/logs-settings.png?maxW=1029&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8f9b5940d6f3a62a0bc86613aaa0cb1a" alt="logs-settings.png" width="1029" height="644" data-path="images/proxy-networks/proxy-manager/faqs/logs-settings.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/logs-settings.png?w=280&maxW=1029&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2eabae97956bf35527bea9caed6c99f7 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/logs-settings.png?w=560&maxW=1029&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=09a7ca7433b49fbb8bfa6688d8cdd529 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/logs-settings.png?w=840&maxW=1029&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=940875860ee0b2c66e9de27ef4f5b623 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/logs-settings.png?w=1100&maxW=1029&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=72dc72bb316b7e319ab06b2d08ca4b22 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/logs-settings.png?w=1650&maxW=1029&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=18cc7306924eece99caaa2741a02ef78 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/logs-settings.png?w=2500&maxW=1029&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e218cdf3e0074654f44a44d3b2870553 2500w" data-optimize="true" data-opv="2" />

    按照这些步骤操作，就可以有效地配置Proxy Manager，以将日志导出到所选的外部存储或监控系统，从而增强有效监控和管理网络及应用程序的能力。
  </Accordion>

  <Accordion title="如何解锁错误代码？">
    要使错误代码响应能够根据Proxy Manager规则触发IP刷新或尝试使用新 IP，請按照以下步骤操作：

    * 在Proxy Manager的规则选项卡中添加新规则
    * 选择“状态码”作为规则类型
    * 选择要扫描的相关状态码（如501、402、301等），以触发规则
    * 选择所需的结果，例如“刷新IP” 或“尝试使用新IP”

    观看视频：错误代码解锁: [https://brightdata.com/video/unblock\_error\_codes](https://brightdata.com/video/unblock_error_codes)
  </Accordion>

  <Accordion title="如何在HTTPS上运行用户界面（控制面板）">
    **需要什么？**

    要使用HTTPS协议访问用户界面（控制面板），您需要向Proxy Manager提供域的SSL证书和私钥。

    证书和私钥应专为您的域而生成，并已安装在服务器上。 这通常是通过服务器和域提供商完成的

    **如何操作？**

    运行Proxy Manager，并设置指向相应证书文件的环境变量（SSL\_CERT和SSL\_KEY ）。在终端中运行的命令示例：

    ```sh
    SSL_CERT=/path/to/ca.crt SSL_KEY=/path/to/ca.key pmgr
    ```

    启动后，您就可以使用[https://your-domain.com:22999/访问用户界面](https://your-domain.com:22999/访问用户界面)
  </Accordion>

  <Accordion title="如何保存请求/响应历史记录？">
    只需启用--history标志即可。启用历史记录模式后，请求和响应标头都会被保存到本地数据库中。 可以在“代理”部分中查阅这些信息。历史记录选项还可以跟踪HTTPS，只需启用“—ssl”标志即可。请参阅Bright Data Proxy Manager GitHub页面，了解详情: [https://github.com/luminati-io/luminati-proxy#installation](https://github.com/luminati-io/luminati-proxy#installation)

    另一个方法是转到Proxy Manager控制面版，在一般设置部分中启用日志请求历史记录，并启用SSL嗅探。
  </Accordion>

  <Accordion title="How to use SOCKS5 with Bright Data's Proxy Manager">
    SOCKS 服务器是一种代理服务器，适用于任何类型的网络协议，可通过任何端口为用户与服务器建立连接，然后在用户与服务器之间传输流量。

    为什么要在 Bright Data 中使用 SOCKS5？

    当您在Bright Data中使用SOCKS5时，Proxy Manager会将发送到80或443端口的任何请求转换为HTTP和HTTPS请求，因此您无需为目标网站接受哪种格式而担心。如为其他端口，流量会按原样在用户和主机之间传输。

    SOCKS5使用指南：

    * 打开Proxy Manager
    * 点击端口，然后点击“编辑代理”
    * 在“一般信息”下添加SOCKS端口号
    * 转到“性能” - 设置反向解析：DNS
    * 添加解析文件
      * 在程序代码中添加 “—resolve PATH”
      * 遵循主机文件格式: [https://en.wikipedia.org/wiki/Hosts\_(file)](https://en.wikipedia.org/wiki/Hosts_\(file\))
      * 列出您要使用的域名及其IP
      * "在Proxy Manager的“工具”页面中使用解析文件编辑器添加域名和 IP
      <Note> 要允许SOCKS5连接，您需要完成此链接中所示的KYC流程： [https://brightdata.com/cp/kyc](https://brightdata.com/cp/kyc) ，并向我们的合规部门申请批准。 如果您需要有关此程序的帮助，请联系您的客户经理。 </Note>
  </Accordion>

  <Accordion title="在Proxy Manager中使用SOCKS5协议时，如何定义代理IP国家？">
    <Warning>此选项仅对启用了 dropin 端口的客户开放。</Warning>

    SOCKS5协议使用加密的base64字符串进行验证。

    因此，在使用SOCKS5时，如果您需要定义代理IP国家（-country-\<COUNTRY\_CODE>），则必须将您的基本验证信息转换为base64令牌：

    * 浏览 [https://www.base64encode.org](https://www.base64encode.org)
      将brd-customer-\<customer\_id>-zone-\<zone\_name>-country-\<COUNTRY>:\<zone\_password>转换为Base64格式的令牌
    * 将 `brd-customer-<customer_id>-zone-<zone_name>-country-<COUNTRY>:<zone_password>` 转换为Base64 格式的令牌
    * 在发送到Proxy Manager端口的SOCKS5请求中，使用您生成的“基本授权令牌”标头：

    ```sh
    curl -v "http://lumtest.com/myip.json" --socks5 127.0.0.1:24000 -H "Proxy-Authorization: API_KEY"
    ```
  </Accordion>

  <Accordion title="如何从API切换到Proxy Manager">
    使用Proxy Manager，可以获得在API中无法提供的高级功能。 只需在Proxy Manager中点击一个按钮，就能完成尽可能长时间地保留IP或在每次请求后轮换IP等任务，无需手动编写机制代码。

    从API切换到Proxy Manager的指南：

    1. 在此处安装Proxy Manager: [https://github.com/luminati-io/luminati-proxy#installation/](https://github.com/luminati-io/luminati-proxy#installation/)
    2. <Tooltip tip="Port 33335 replacing port 22225 deprecated on Sep 2026, click to read more">[`33335`](https://docs.brightdata.com/cn/general/faqs#which-port-shall-i-use-22225-or-33335) </Tooltip>
    3. 通过Proxy Manager控制面板配置自定义代理和区域的设置。 无需在请求中发送用户参数（brd-customer-customer\_name-zone-zone\_name…），因为所有必要的数据都包含在手动代理配置中。
  </Accordion>

  <Accordion title="如何模拟真人用户？">
    将所有标头和cookie行为包含在内。 参见使用Bright Data Proxy Manager的bash示例：

    ```sh
    curl -v "http://lumtest.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>
      使用Unlocker API时，默认禁用附加标头，要附加标头，请联系支持部门要求批准。
    </Note>
  </Accordion>

  <Accordion title="如何将Proxy Manager设置为系统服务？">
    <Steps>
      <Step title="Sign in as 'root' to the remote server (running Ubuntu)" />

      <Step title="创建服务">
        在以下位置创建新的服务文件：

        ```sh
        /etc/systemd/system/pmgr.service
        ```

        ```sh
        [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="重新加载服务文件">
        ```sh
        systemctl daemon-reload
        ```
      </Step>

      <Step title="启动Proxy Manager服务">
        ```sh
        systemctl start pmgr
        ```
      </Step>

      <Step title="检查状态：">
        ```sh
        systemctl status pmgr.service
        ```
      </Step>

      <Step title="完成！">
        您已将Proxy Manager设置为服务。 您现在可以控制您的新服务：

        ```sh
        service pmgr [stop|start|restart]
        ```
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="如何查看请求详情？">
    在“一般设置”中启用“请求详情”，即可添加以下的响应标头，让您可以获得更详尽、更具体的请求视图。此功能与使用-debug标志的功能相同。

    * `x-luminati-ip-destination` - 目标主机的IP
    * `x-luminati-ip` - 分配给请求的IP。
    * `x-luminati-timeline` - 分配给请求的IP。

    <Note>
      - 在云proxy manager中默认关闭此功能，如有需要，请确保将其启用。
      - 要在规则中执行“封禁IP” 操作，必须启用“请求详情”。
    </Note>

    要查看这些标头，可以通过以下其中一种（或多种）方法

    <Tabs>
      <Tab title="通过详细标志（-v）">
        使用-v标志，以详细模式发送请求
      </Tab>

      <Tab title="查看您的Proxy Manager日志">
        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="如何减少响应中的数据量？">
    * 转到“一般信息”选项卡=
    * 在“SSL分析”中选择“开启”
    * 转到“规则”选项卡
    * 在“规则类型”下拉列表中选择“URL”
    * 选择任何文件类型来应用正则表达式
    * 在“操作类型”下拉列表中选择“空响应”

    在以下示例中，Proxy Manager将为所有以.jpg|.png|.gif等任何文件类型结尾的请求返回空响应（0kb，状态码仍为200）。

    当您想减少在响应中获得的数据量时，请使用此选项。
  </Accordion>

  <Accordion title="如何提高我的网页抓取速度？">
    如果您通过单个IP发送的请求数量高于目标网站允许的数量，则目标网站将会识别您的IP，并将其屏蔽，或使用虚假信息误导您。 这意味着您的信息收集速度可能比平时慢得多。

    **我能做些什么？**

    假设您正在使用1000个数据中心IP运行1000万个请求，即每个IP每秒1个请求，您的操作可能需要大约3个小时。如果使用1000万个住宅 IP，则您的操作可能只需要1秒钟。

    通过Bright Data的住宅网络轮换多个并行会话的指南：

    1. 打开Proxy Manager
    2. 转到“概览”菜单
    3. 点击您的住宅区域的端口
    4. 在端口设置中将“预设”编辑为“轮换（IP）”
    5. 将您的请求发送到127.0.0.1:\<portnum>，其中的portnum是住宅区域的端口
  </Accordion>

  <Accordion title="我怎么知道自己是否被伪装欺骗？">
    被伪装欺骗意味着您从正在抓取的网站上获得是误导性信息。

    示例：如果您正在收集竞争价格比较信息以供自动定价算法使用，目标网站可能会向您的请求返回人为压低的价格，以对您的定价和利润产生不利的影响。

    **我能做些什么？**

    使用传统代理网络（基于数据中心的IP）时，您的目标网站可能会很容易识别您的活动，并对您的请求做出伪装欺骗。 因此，要确保您不会被伪装欺骗的唯一方法，就是通过住宅IP轮流发送请求。

    通过数百万个住宅IP轮流发送请求的指南：

    1. 打开Proxy Manager
    2. 转到“概览”选项卡
    3. 点击您的住宅区域的端口
    4. 在端口设置中将“预设”编辑为“轮换（IP）”
    5. 将您的请求发送到`127.0.0.1:<portnum>` 其中的`portnum`是住宅区域的端口
  </Accordion>

  <Accordion title="使用Proxy Manager时如何设置长时间单会话">
    在端口设置下拉列表中选择“长时间单会话”，工具就会自动ping IP，以保持会话处于活动状态：

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/long-single-session.png?maxW=913&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ccccd09d1c9670f70e1c53160e69e0ba" alt="long-single-session.png" width="913" height="321" data-path="images/proxy-networks/proxy-manager/faqs/long-single-session.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/long-single-session.png?w=280&maxW=913&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c331d2ed0d6f6a6531f2e18e9ee255eb 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/long-single-session.png?w=560&maxW=913&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=27e6d15ea265cd8e18953a323be7fbb6 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/long-single-session.png?w=840&maxW=913&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=489b609a17b3665ca88c7ffe5d3c478b 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/long-single-session.png?w=1100&maxW=913&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b77d0b7654e0a619db24fcb242eddb70 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/long-single-session.png?w=1650&maxW=913&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b93b970a924195b5f6abc026267a215b 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/long-single-session.png?w=2500&maxW=913&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f8816373d4877eddc1635b4ef79981cd 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="如何使用远程DNS？">
    远程DNS为您提供与代理对等点（代理IP的来源）类似的DNS解析服务器。这使您的请求看起来更可信，因为解析服务器通常位于靠近IP的地理位置，而如果不使用远程DNS，解析服务器将是Bright Data的超级代理之一，可能位于另一个国家/地区。使用远程DNS的方法：

    <Tabs>
      <Tab title="通过Proxy Manager">
        转到编辑端口 > IP控制 > 将“DNS查询”设置为“远程 - 由对等点解析”
      </Tab>

      <Tab title="通过API">
        Simply add it to your username string.

        For example:

        ```sh Shell
        brd-customer-<customer_id>-zone-<zone_name>-dns-remote
        ```
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="如何使用多个并行Proxy Manager实例来实现高性能？">
    如果不想让一个Proxy Manager处理过多请求，您可以在不同的服务器上创建多个Proxy Manager实例。

    最好的方法是按照以下步骤操作：

    * 在本地安装Proxy Manager，并根据需要设置所有端口
    * 保存配置文件
    * 开启同步配置，让所有更改都自动同步到所有机器
    * 在要使用的服务器上安装Proxy Manager
    * 将配置文件导入到服务器的proxy\_manager目录中

    将您的流量分配到不同的服务器

    ```js
    request 1 -> {FIRST SERVER IP}:24000
    request 2 -> {SECOND SERVER IP}:24000
    ```

    以此方法使用Proxy Manager，可以确保不会有Proxy Manager实例超载，并且可以帮助您在所有实例上保持相同的配置。

    这意味着您可以在每个实例上从相同端口同时发送来自相同国家/地区的请求。

    如果您在自己设置负载平衡时遇到问题，您可以使用我们已实施负载平衡功能的云服务 。您只需要使用1个用户界面，使用共享配置控制所有实例，然后针对相同的URL即可，我们会负责整个负载平衡过程。
  </Accordion>

  <Accordion title="我无法登录本地Proxy Manager">
    如果您无法登录您的Proxy Manager（PM），请按以下步骤操作：

    * 确保运行PM的计算机没有使用VPN。\
      <Note>请注意，在运行PM时使用VPN，可能会导致登录问题，还会减慢与代理的连接速度</Note>
    * 关闭PM（运行PM的终端黑屏）
    * 删除浏览器上的cookie
    * 再次打开PM（加载PM大约需要1-2分钟）
    * 尝试使用与之前相同的方法登录（使用 Google，或使用您的注册邮箱和密码）

    或者，您可以将Proxy Manager的托管切换到我们的云服务。我们将负责托管，甚至在多个Proxy Manager实例之间实施负载平衡。

    P.S. PM加载后，默认浏览器应会自动打开PM的登录页面。如果没有，请打开浏览器，浏览127.0.0.1:22999，然后尝试登录。
  </Accordion>

  <Accordion title="Proxy Manager connection error (port status is not &#x22;ok&#x22;)">
    如果您无法登录Proxy Manager，或者Proxy Manager无法连接到超级代理（即端口状态不是OK），请检查以下各项：

    * 确保VPN未开启
    * 确保没有防病毒软件或任何其他安全软件（如360、Norton 等）阻止Proxy Manager发送的流量
    * 确保防火墙（操作系统/服务器/任何其他安全软件的防火墙）允许TCP流量通过端口22000-25000
    * 如果Proxy Manager软件是安装在macOS/ Linux服务器上，请确认：
      * Node.js版本是在12.18.3和14.18.1之间
      * NPM版本是在6.14.6和8.1.3之间
      * 如果NPM和Nodejs的版本不是我们支持的版本，请将其移除，然后安装我们指定的版本。要了解更多Linux/Mac的安装信息，请访问我们的GitHub页面: [https://github.com/luminati-io/luminati-proxy/#linuxmacos---manual-install](https://github.com/luminati-io/luminati-proxy/#linuxmacos---manual-install)
  </Accordion>

  <Accordion title="为什么我会收到错误'400 Proxy Error: ip_requested_not_allocated_by_customer'?">
    使用数据中心/ISP或gIP产品时，如果您的区域下的IP已刷新、移除或只是因系统更新而发生变化，就可能会出现错误代码400

    <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 48 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>

    每当出现此错误时，您都应转到Bright Data区域页面，下载与该区域相关的新IP列表。

    如果您使用的是带有IP端口设置前缀的proxy manager工具，请务必也更新IP列表。

    示例：

    ```sh Shell
    curl --v "http://lumtest.com/myip.json" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-1.1.1.1:<zone_password>
    ```

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/shell-example.png?maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ce4705110d859894fe13df5b25b8eecb" alt="shell-example.png" width="1600" height="630" data-path="images/proxy-networks/proxy-manager/faqs/shell-example.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/shell-example.png?w=280&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d8acf089a9c247f8d9d83f918cb6859e 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/shell-example.png?w=560&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=32152e423bdabe9c82dc2dc201d2f661 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/shell-example.png?w=840&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=1107509fc27248a999ab412d5dc4b5cc 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/shell-example.png?w=1100&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=709888dba09506748b547a1c9053f1bf 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/shell-example.png?w=1650&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=bbbfb7254cc9ce3ae4419f9dc0a9ad56 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/shell-example.png?w=2500&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=844049b5967e76bcb1a7ee719df57721 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="如何获取特定位置的IP？">
    使用Bright Data，您可以指定用于发送流量的IP的地理位置和其他参数。 在Proxy Manager中，这特别简单，只需点击几下即可。

    您可以只请求特定国家的IP（如果您使用住宅或数据中心网络），或者请求额外的特定运营商IP（如果您使用移动网络）IP，这取决于您使用的区域。

    **如何在Proxy Manager中设置定位？**

    要获取特定位置的IP，请按照以下步骤操作：

    * 点击您要使用特定位置IP的代理端口
    * Go to **Targeting** tab
    * 选择国家、州、城市，以选择特定地理位置的对等点
    * 选择ASN或运营商名称（仅适用于移动对等点）
  </Accordion>
</AccordionGroup>

{/*tags:pmgr*/}


# Proxy Manager集成
Source: https://docs.brightdata.com/cn/proxy-networks/proxy-manager/integration

了解Bright Data的Proxy Manager集成选项以及一些最佳使用窍门。

{/*tags:pmgr*/}

## 与第三方应用程序集成

Proxy Manager是一个开源项目，可以安装在各种环境中，用作任何应用程序的代理服务器。

以下是几个在第三方应用程序中使用Proxy Manager作为代理服务器的示例。

与任何第三方应用程序集成，是无需用户名和密码的，可以将username:password留空，因为Proxy Manager中的每个端口都保留了所使用区域的凭据。

```js 端口24000的示例
IP:PORT:USERNAME:PASSWORD → 127.0.0.1:24000:[empty]:[empty]
```

## 集成到您的手机

<Tabs>
  <Tab title="Android设置">
    1. Android设备和使用Proxy Manager的计算机需要共享相同的WiFi连接
    2. Proxy Manager端口必须将Android设备的IP列入白名单
    3. 转到WiFi网络配置 -> 高级 -> 手动代理：
       * 代理主机：运行Proxy Manager的计算机的IPv4地址
       <CodeGroup>
         ```sh CMD
         ipconfig
         ```

         ```sh Shell
         ifconfig
         ```
       </CodeGroup>
       * 端口：24000（或您创建的其他端口）
  </Tab>

  <Tab title="iPhone（iOS）代理设置">
    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 '一般信息'\
       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>

## 与Puppeteer集成

* 以您想使用的网络、IP类型和IP数量创建一个区域。
* 安装Proxy Manager。
* 点击“添加新代理”，选择所需的区域和设置，点击“保存”。
* 在Puppeteer中，在“proxy-server”下输入您的本地IP和Proxy Manager端口（例如`127.0.0.1:24000`）
  * 本地主机IP是`127.0.0.1`
  * 在Proxy Manager中创建的端口是`24XXX`，例如`24000`
* 将用户名和密码值留空，因为Bright Data Proxy Manager已经通过超级代理进行验证。

```js 代码示例
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://lumtest.com/myip.json');
	await page.screenshot({path: 'example.png'});
	await browser.close();
})();
```

## 与Selenium集成

* 以您想使用的网络、IP类型和IP数量创建一个区域。
* 安装Bright Data Proxy Manager。
* 点击“添加新代理”，选择所需的区域和设置，点击“保存”。
* 在Selenium中，在setProxy下输入您的本地IP和Proxy Manager端口（例如127.0.0.1:24000）
  * 本地主机IP是127.0.0.1
  * 在Proxy Manager中创建的端口是24XXX，例如24000
* 将用户名和密码字段留空，因为Bright Data Proxy Manager已经通过超级代理进行验证。

```js
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://lumtest.com/myip.json');
		driver.switchTo().alert().accept();
	} finally  {
		await driver.quit();
	}
})();
```

## 与Insomniac浏览器集成

* 转到端口设置中的一般信息选项卡

* 在倍增代理端口字段中，选择要创建的代理端口数量。这将创建具有相同设置的多个代理端口

* 您的电子表格包含以下的列：
  * 自定义名称：为每个代理添加名称
  * Host: `127.0.0.1`
  * Port: `24XXX`
  * 用户名、密码和标签：留空
    <Note>Proxy Manager已经通过超级代理进行验证</Note>
  * 将文件保存为CSV格式，而不是XLS或XLSX格式
  * 在Insomniac的Proxy per tab扩展程序中，进入管理代理列表，然后选择批量添加代理
  <Frame>
      <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/add-bulk-proxies.png?maxW=1018&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=91a7f2be96d1a6689368cd9447229c10" alt="" width="1018" height="251" data-path="images/proxy-networks/proxy-manager/integration/add-bulk-proxies.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/add-bulk-proxies.png?w=280&maxW=1018&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ccf3bdf514fea43e1f0c15afd4cb561a 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/add-bulk-proxies.png?w=560&maxW=1018&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=bb986b012149e62d077f0ad7a4f9472e 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/add-bulk-proxies.png?w=840&maxW=1018&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a6c9f7026857996d617cc16726a9189d 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/add-bulk-proxies.png?w=1100&maxW=1018&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ff6f90e65dd97679d263448d0f3b7e72 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/add-bulk-proxies.png?w=1650&maxW=1018&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=001eb4cd70d53380958c22606a91d9d8 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/add-bulk-proxies.png?w=2500&maxW=1018&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0e0fb721832bc66839b729e8a978c5e6 2500w" data-optimize="true" data-opv="2" />
  </Frame>

* 选择导入代理列表，并上传CSV文件

<Frame>
    <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/proxies-in-csv.png?maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2d6eb6070ea579c08297c948e57438b7" alt="" width="1600" height="548" data-path="images/proxy-networks/proxy-manager/integration/proxies-in-csv.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/proxies-in-csv.png?w=280&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2b042b20f71a8c263c54083f34644356 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/proxies-in-csv.png?w=560&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2dc67fec0d37456dd738d7e7ecdfaef1 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/proxies-in-csv.png?w=840&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9dd6a52517a457b16c507adb957d7742 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/proxies-in-csv.png?w=1100&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3e8286b4f132829bf1ff39918a96b618 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/proxies-in-csv.png?w=1650&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=faf03b13e912be85b21135058ea1eda0 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/proxies-in-csv.png?w=2500&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b3fa242f5eded22ab814e961f10c91ed 2500w" data-optimize="true" data-opv="2" />
</Frame>

## 与Multilogin（MLA）集成

* 在Multilogin中，点击新建浏览器配置文件
* 点击编辑代理设置
* 在连接类型下选择Bright Data
* 在代理类型下选择您的协议
* 如果Proxy Manager是安装在本地，则IP或主机字段应输入127.0.0.1；或者，如果Proxy Manager是安装在远程服务器上，则请使用该服务器的IP1.1.1.1或example.com
* 端口：您在Bright Data Proxy Manager中创建的端口24XXX
* 将用户名和密码字段留空，因为Bright Data Proxy Manager已经验证
* 点击检查代理

<Frame>
    <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/lum_ml.gif?maxW=1147&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e11a1fedc01acbd192fbbdeb9d3ba136" alt="" width="1147" height="457" data-path="images/proxy-networks/proxy-manager/integration/lum_ml.gif" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/lum_ml.gif?w=280&maxW=1147&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ef215a3ab94f882abd0bd9eeb1c21026 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/lum_ml.gif?w=560&maxW=1147&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a672b1b0a1a380d9e7b1da70b6d30e1e 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/lum_ml.gif?w=840&maxW=1147&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7b284085fa54f6cf32b11b9e1f0c2348 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/lum_ml.gif?w=1100&maxW=1147&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b7fc1b04cb036d9e7165a032daf62a10 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/lum_ml.gif?w=1650&maxW=1147&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a04de9899c79530384204f8cd464f864 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/lum_ml.gif?w=2500&maxW=1147&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=dc0d4e7c5c883a960a614d3b5ffa96dd 2500w" data-optimize="true" data-opv="2" />
</Frame>

## 与Playwright Proxy集成

* 点击“添加新代理”，选择所需的区域和设置，点击“保存”。
* 在Playwright中，在“server”下输入您的本地IP和Proxy Manager端口（例如127.0.0.1:24000）
  * 本地主机IP是127.0.0.1
  * 在Proxy Manager中创建的端口是24XXX。例如24000
* 将用户名和密码值留空，因为Bright Data Proxy Manager已经通过超级代理进行验证。
* 例如：

```js 代码示例
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://lumtest.com/myip.json');
		await page.screenshot({ path: 'example.png' });
		await browser.close();
	}
})();
```

## 与Jarvee Proxy集成

* 在Jarvee 左侧，选择“Proxy Manager”选项卡。
* 点击“添加代理”，在“选择代理IP:端口”列中输入IP:端口（例如127.0.0.1:24000）
  * 本地主机IP是127.0.0.1
  * 在Proxy Manager中创建的端口是24XXX，例如24000
* 将用户名和密码字段留空，因为Bright Data Proxy Manager已经验证
* 点击“验证代理链接”。
* 在“社交个人档案”下，选择您创建的Jarvee个人档案，然后点击“添加”按钮。

<Frame>
    <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/jarvee.png?maxW=1024&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7644b2d47d104b25f0bd545f35d29cca" alt="" width="1024" height="406" data-path="images/proxy-networks/proxy-manager/integration/jarvee.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/jarvee.png?w=280&maxW=1024&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=16467e4fe75d2802f30e5c1b14ee8552 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/jarvee.png?w=560&maxW=1024&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=328d31792e9167213d76389003a6a398 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/jarvee.png?w=840&maxW=1024&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7cbf315f4a6dc319a66123e6cf290a77 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/jarvee.png?w=1100&maxW=1024&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e64baffae46885601f331260ba44328f 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/jarvee.png?w=1650&maxW=1024&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ab4f73338f58a95976cc3cd85e9135d8 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/jarvee.png?w=2500&maxW=1024&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6395468fd71f61b7ac338a369f0787a7 2500w" data-optimize="true" data-opv="2" />
</Frame>

## 与VMLogin Proxy集成

利用VMLogin的虚拟浏览个人档案，使用实体设备注册和管理多个在线账户，可以有助于反关联和规避指纹识别。

利用VMLogin的虚拟浏览个人档案，使用实体设备管理多个在线账户，可以有助于反关联和规避指纹识别。

以下是将Bright Data与VMLogin集成的分步指南：

* 在此处下载并安装VMLogin （3天免费试用）: [https://vmlogin.us/?ref=luminati](https://vmlogin.us/?ref=luminati)
* 首先启动VMLogin，并创建一个新的浏览器个人档案：
  * 点击“获取随机个人档案”
  * 选择最适合您的设置，例如操作系统、屏幕分辨率、语言、WebGL供应商、时区、媒体设备指纹等。


# Proxy Manager简介
Source: https://docs.brightdata.com/cn/proxy-networks/proxy-manager/introduction

了解Bright Data的Proxy Manager，这是一款用于控制、管理和监控代理的高级工具，具有独特的自定义、规则实施和API集成功能。

{/*tags:pmgr*/}

Bright Data Proxy Manager是一款应用程序，让您可以通过我们的应用程序界面或API控制、管理和监控所有代理。

这款应用程序是由开发人员为开发人员构建的高级开源应用程序工具 [(GitHub)](https://github.com/luminati-io/luminati-proxy)，允许独特的代理自定义、规则实施和外部代理集成。

## 最适用于：

* 自动处理不同代理产品和IP之间的流量分配
* 使用屏蔽某些类型数据的规则来减少带宽
* 监控HAR日志，可实时预览整个流量
* 使用白名单或生成的令牌来管理用户访问
* 希望自定义和管理其代理流程和基础设施的团队


# 如何开始使用代理管理器
Source: https://docs.brightdata.com/cn/proxy-networks/proxy-manager/quickstart

通过选择云服务器或本地部署，开始使用 Bright Data 的代理管理器，然后开始管理和自定义代理以获得最佳性能。

{/*tags:pmgr*/}

<Tip>
  如果您尚未注册 Bright Data，则可以免费注册，添加付款方式时，您将获得价值 \$5 的积分以开启服务！\
  [https://brightdata.com/](https://brightdata.com/)
</Tip>

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">登录</a>} />

  <Step title="选择您的首选方法">
    <CardGroup cols={2}>
      <Card title="云服务器（推荐）" href="/proxy-networks/proxy-manager/configuration#bright-data-cloud-hosting" icon="cloud" />

      <Card title="本地部署" href="/proxy-networks/proxy-manager/configuration#local-remote-installation" icon="house">
        您负责安装、管理和监控
      </Card>
    </CardGroup>

    <Accordion title="云服务器的优势">
      * 无需安装或设置服务器 - 从任何地方均可直接登录我们的 Web 应用程序: [https://brightdata.com/cp/zones/lpm](https://brightdata.com/cp/zones/lpm)
      * 端到端管理解决方案
      * Bright Data 的全天候团队实时监控服务器状态，查看有关安装和设置的更多信息，请参见介绍视频:\
        [https://brightdata.com/webinar/how-to-start-using-the-bright-data-proxy-manager](https://brightdata.com/webinar/how-to-start-using-the-bright-data-proxy-manager)
    </Accordion>
  </Step>

  <Step title="开始管理您的代理">
    安装代理管理器后，您可以登录并开始管理您的代理，使用您的区域设置所配置的端口进行设置 。
  </Step>

  <Step title="实现规则和标头">
    现在，您可以将规则和标头加以实现，并根据需要自定义代理:\
    [https://docs.brightdata.com/cn/proxy-networks/proxy-manager/configuration#rules-and-headers-configuration](https://docs.brightdata.com/cn/proxy-networks/proxy-manager/configuration#rules-and-headers-configuration)
  </Step>
</Steps>


# 保护您的 Proxy Manager 设置
Source: https://docs.brightdata.com/cn/proxy-networks/proxy-manager/security

执行保护 Proxy Manager 安全的最佳做法，包括 IP 白名单、管理员访问控制和基于令牌的身份验证。

{/*tags:pmgr*/}

确保我们产品的安全性至关重要，同时也是我们的首要任务。 我们采用最先进的架构，可为您提供完全可靠和安全的云托管 Proxy Manager，并向所有客户推荐这一选项。

对于需要预置 Proxy Manager 选项（不由 Bright Data 托管）的用户，我们在下文中概述了我们推荐的安全措施以及采取这些措施的最佳做法。

## 阻止不需要的来源使用 Proxy Manager 的端口

将代理管理器中所有端口上的 IP 列入白名单，以确保只有被允许和需要的来源才可以使用这些端口。 启用此功能后，只有被列入白名单的 IP 才允许通过此配置的端口发送请求。 使用此功能可确保您支付的带宽仅被可信来源使用。

## 阻止不需要的用户编辑 Proxy Manager 设置

将管理员访问权限列入白名单，确保只有经过授权的 IP 才能更改您的 Proxy Manager 设置。当从服务器（Proxy Manager 托管地）外部访问管理员页面和 Proxy Manager 的 API 时，这将阻止未列入白名单的 IP 访问该页面和 API。

## 使用令牌进行身份验证

如果使用 IP 不断变化的多个爬虫向远程 Proxy Manager 服务器发送请求，则需要生成一个令牌，用于在 Proxy Manager 上进行身份验证：

* 从服务器内部运行 Bright Data 进程
* 从 Proxy Manager 的服务器在终端/命令行中运行：

```sh
curl -X GET "http://127.0.0.1:22999/api/gen_token" -H "accept: application/json"
```

* 您应该会看到令牌响应：

```js
"token": "API key"
```

生成令牌后，您有两个选择：要么在设置爬虫服务器时使用该令牌将新 IP 列入白名单，要么在每次请求的代理身份验证中包含该令牌：

要在代理验证中使用令牌，可以使用用户名 “token” 和实际令牌作为密码，例如：

```sh
curl -x token:API_KEY@127.0.0.1:24000 "http://lumtest.com/myip.json"
```

要将新服务器 IP 列入白名单，以便无需在代理身份验证中发送该 IP，请执行以下操作：

* 将令牌从代理管理器服务器复制到新的爬虫服务器
* 从您的新服务器发出这个请求：

```sh
curl [REMOTE_SERVER_IP]:22999/api/add_wip -X POST -H "Content-Type: application/json" -H "Authorization:[API_KEY]" -d '{"ip":"[CRAWLER_IP]"}'
```

* 您的爬虫 IP 现已列入 Proxy Manager 白名单

<Info>
  这不会允许访问 Proxy Manager 的管理面板，而只能通过端口发送请求。
</Info>

## 本地网络

如果您想从许多人共享同一 IP 的网络访问 Proxy Manager，那么将 IP 列入白名单对您来说还不足够。 通过将您的 IP 列入白名单，您就向来自同一个本地网络的所有人员授予了访问权限（企业环境通常就是这样）。

使用 `local_login` 标志，Proxy Manager 将要求每个浏览器分别进行身份验证，并在 cookie 中存储新生成的令牌。

```sh 示例
pmgr --local_login
```


# 如何配置您的住宅代理
Source: https://docs.brightdata.com/cn/proxy-networks/residential/configure-your-proxy

轻松配置您的 Bright Data 住宅代理设置。 了解如何设置 IP 类型、启用地理位置定位、管理高级选项，如长会话对等点等。

首先，转到要配置的代理的配置选项卡。

## IP 类型

**为您的代理区域选择两种 IP 类型之一：**

<CardGroup cols={2}>
  <Card title="共享" href="/proxy-networks/faqs#what-are-ip-types-for-residential-and-mobile-proxy" icon="square-1">
    当您需要具有成本效益的选项，并且不需要 IP 专用权时。 These proxies will rotate, so in every request you can get a new IP address ("Rotating proxies").
    <Note>多个用户共享 IP</Note>
  </Card>

  <Card title="专用 IP" href="/proxy-networks/faqs#what-are-ip-types-for-residential-and-mobile-proxy" icon="square-2">
    当您需要使用专用 IP 地址访问网站时。
    <Note>IP 仅供您使用。</Note>
  </Card>
</CardGroup>

***

## 地理位置定位

<Tip>
  由于您的 IP 是自动分配的，因此建议为每个需要定位的地理位置设置单独的住宅代理。
</Tip>

地理位置定位允许您根据城市、 州、 邮政编码或 ASN 来定位特定地点。从下拉菜单中选择所需的参数。

<Frame>
  <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c2babc7def711369d0249cc5820e4caa" alt="地理位置定位" width="511" height="203" data-path="images/proxy-networks/residential/geotargeting.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?w=280&maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b34ec8323b5307560ce3c34906c0d19a 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?w=560&maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2d9a9a91968a19e96316e4aa649fddbb 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?w=840&maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=29e0c12f04aec36d9d66aa94e7c2146f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?w=1100&maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=58890929d555f8be3a229be672afd43e 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?w=1650&maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=de2a9470d63a8a114f3abd6cc8ca3f27 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?w=2500&maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8d45370c4ac71cc126d7103aac4bf0eb 2500w" data-optimize="true" data-opv="2" />
</Frame>

***

## IP Groups `gIPs`

<Warning>
  仅适用于专用选项
</Warning>

gIP 在任何给定时刻均包含 6-90 个 IP，共享相同的属性，定位到区域“访问参数”部分中选定的专用域名。

<Frame>
  <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5ed0bbca23ae05267b2456a2349b15b7" alt="地理位置定位" width="526" height="124" data-path="images/proxy-networks/residential/gips.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?w=280&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=acb16d5d6cc96fa2bcd3415d34e62164 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?w=560&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ef361918cc7d6a924a6ed9b6498a92f8 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?w=840&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9a7909edce3aad911238e5aaacc5dbf1 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?w=1100&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=abcc32fbd40697c8c281df9fa2cfa1db 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?w=1650&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d214c6f6ef3e312151577f63c418b6d4 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?w=2500&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f643cbe11055a98de688a6fc2ef2f4f6 2500w" data-optimize="true" data-opv="2" />
</Frame>

***

## 域名

<Warning>
  仅适用于专用选项
</Warning>

定义您希望代理拥有的专属域名。对该列表中某个域名的每个请求都将专门通过您的专用代理进行处理。 不允许其他人通过您的专用代理定位这些域名。 您可以使用此区域向其他目标域发送请求，但这些请求将通过我们数据中心托管的 Bright Data 代理进行处理。

例如：如果在列表中您有两个域名：a.com 和 b.com，则向 a.com 和 b.com 发出的每个请求都通过您的专用代理路由，发送到 c.com 的请求将通过我们的数据中心托管代理路由。 他人向 a.com 和 b.com 发出的请求永远不会通过您的专用代理 。

<Frame>
  <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=57db917f7a823e6d9703a4bf28bf68d1" alt="域名" width="518" height="130" data-path="images/proxy-networks/residential/domains.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?w=280&maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6114708991ef45cc5799cdcc2f111bb7 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?w=560&maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=328d3ad1f40a72ee54435e29944a85cf 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?w=840&maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2dcd1cd46638b19b7fd397a3cdd63f9f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?w=1100&maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=37dae90b2a8d34b68d015f7eb2a50ad2 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?w=1650&maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=16a782d50d20686dd3453233eee2dd47 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?w=2500&maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6672486d6d38264946a94909983c72aa 2500w" data-optimize="true" data-opv="2" />
</Frame>

***

## 缓存代理

Bright Data 的缓存代理是一项旨在减少目标站点不必要负载的功能，一方面允许客户缓存成功结果，另一方面，在可能的情况下根据请求接收缓存结果。

<AccordionGroup>
  <Accordion title="更健康的生态系统">
    从技术上讲，通过消耗网站资源并在数据收集领域造成性能问题可能使网站过载。 Bright Data 除了安装系统以避免目标站点过载之外，还提供缓存代理功能，以避免在我们从另一位客户提出的相同请求中获得最新缓存记录的情况下，向目标站点提出冗余请求。
  </Accordion>

  <Accordion title="提高了性能">
    从我们的缓存中收到的响应速度大约快了 20 倍！
    这意味着随着我们的缓存使用量的增长，性能将不断提高。
  </Accordion>

  <Accordion title="经济利益">
    为了促进我们维护健康生态系统的目标，对于通过选择使用缓存代理的代理区域中的任何使用量，我们将提供使用折扣。

    虽然我们将提供的缓存记录可能只占代理区域总使用量的一小部分，但折扣将充分适用于代理区域。
  </Accordion>
</AccordionGroup>

### 启用缓存代理

只需切换缓存代理开关

<Frame>
  <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3f0e8addd47eb5d1ea5013ac6acff62a" alt="缓存代理" width="580" height="79" data-path="images/proxy-networks/residential/cache_proxy.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=280&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=1ac56d7882de8d1d4e5a7e0bd077173c 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=560&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3ab022814cdedb7f66195c9961a82c9a 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=840&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=034f9eee12112ff7ce3863fb218a9323 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=1100&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b29cbd844b0f4f879e931dc5de261e55 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=1650&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a5c234e956773621691de0ae609e765f 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/cache_proxy.png?w=2500&maxW=580&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=cdd4e80279b979106bb8ce70840039c9 2500w" data-optimize="true" data-opv="2" />
</Frame>

开启后，我们将引导您完成缓存代理工作所需的一些说明。

**您有两个选项可供选择：**

<AccordionGroup>
  <Accordion title="安装证书">
    <Frame>
      <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b725dbfcbd11e988cca2d5afe9a61643" alt="安装证书" width="519" height="391" data-path="images/proxy-networks/residential/install_certificate.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=280&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=133152ca0cee8ec9d109814f39236c4c 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=560&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=689d21e5d99577cba7c287dadf074bf0 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=840&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6bb1481446931a99bf65b2844c26af4b 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=1100&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=89bcbb6caca76c665e36a3941ecf912c 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=1650&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=938bb88309b7577d3800dd499a05aaff 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/install_certificate.png?w=2500&maxW=519&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b5604353a301432e74d9e0ea0aeecc10 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>

  <Accordion title="无需证书即可继续">
    缺少我们证书或未使用“无证书”方法（忽略 SSL 错误）的计算机所发送的请求将导致失败。请确保您的系统符合这些要求才能成功缓存。
  </Accordion>
</AccordionGroup>

### `robots.txt` in 缓存代理

* 为了兑现我们尊重和合规使用网络资源的承诺，我们的缓存代理功能遵守 robots.txt 指令，并将其逻辑应用于我们的多种代理网络。选择在所选网络内使用缓存代理后，操作行为将根据 robots.txt 合规性和用户的 KYC 状态进行调整：

  当根据 `robots.txt` 访问终端节点时，无论是住宅、移动、数据中心还是 ISP，该服务通常在用户选择的代理网络内运行。

* 如果终端节点由 `robots.txt` 规则封锁，或者请求类型为 `POST`、 `PUT`、 `PATCH`或 `DELETE`之一，则请求的处理取决于网络类型和用户验证：
  * 对于住宅和移动网络用户，经过“了解您的客户”（KYC）验证的用户其请求将通过我们的超级代理重定向以进行直接处理。 未经验证的用户其请求将被屏蔽。
  * 对于数据中心和 互联网服务提供商 (ISP) 网络用户，无论 KYC 状态如何，此类请求都将被屏蔽。

***

## 高级选项：

### 使用托管浏览器启用 JavaScript 渲染

<Tip> **无需额外费用！** </Tip>

通过使用托管浏览器启用 JavaScript 渲染，您的代理请求还将通过 Bright Data 完全托管的基于 Chromium 的专用抓取浏览器运行。 这样，使用 Puppeteer、Playwright 或 Selenium 进行的动态抓取能够使用基于云的浏览器轻松进行扩展，并使用 HTTP 请求的预设进行优化，可以更快地解决验证码问题和实时故障排除。

<Accordion title="如何启用这项服务？">
  在您的住宅代理设置页面中，在“启用浏览器”部分的左侧，设置选择“启用”

  <Frame>
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configure-your-proxy/enable-browsers.png?maxW=860&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ba8136e6596532ea444c9a583d9ee58f" alt="enable-browsers.png" width="860" height="736" data-path="images/proxy-networks/residential/configure-your-proxy/enable-browsers.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configure-your-proxy/enable-browsers.png?w=280&maxW=860&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=1f9cffc0f98b05a411ed97f9f626c619 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configure-your-proxy/enable-browsers.png?w=560&maxW=860&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e168c63abe7ca6d4cf87940d987e405a 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configure-your-proxy/enable-browsers.png?w=840&maxW=860&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3f21f85e4f68a33519861381ab72f053 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configure-your-proxy/enable-browsers.png?w=1100&maxW=860&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=49b7afeb5b343054d6378d4c9e259fc2 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configure-your-proxy/enable-browsers.png?w=1650&maxW=860&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4006d70f0218460322e609468776a595 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configure-your-proxy/enable-browsers.png?w=2500&maxW=860&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=72c9acfa6e634b754f7f65d333d05d33 2500w" data-optimize="true" data-opv="2" />
  </Frame>
</Accordion>

### 启用自动解锁

通过启用自动解锁功能，代理请求将通过预设的 Bright Data 代理发送，该代理会自动处理您的 IP 级别管理和 HTTP 处理请求，从而提高成功率并简化抓取操作。

<AccordionGroup>
  <Accordion title="运行机制：">
    自动解锁功能使用我们先进的人工智能解锁引擎来自动处理和克服反爬虫保护，从而优化您的代理请求：

    1. 浏览器指纹识别 - 模拟真实用户的浏览器以模拟人工体验
    2. 验证码解决 - 分析和解决验证码问题并挑战响应测试
    3. JavaScript 渲染 - 从需要浏览器处理的网站提取数据
    4. 用户代理轮换 - 自动模仿不同类型的浏览器和设备
    5. 推荐标头 - 模拟来自热门或可信网站的流量
    6. Cookie 处理 - 防止 Cookie 相关因素造成的潜在封禁
    7. 自动重试和 IP 轮换 - 克服速率限制和 IP 封禁
    8. 全球覆盖 - 访问来自任何国家/地区、城市、州或 ASN 的本地化内容
    9. 数据验证 - 确保所提取数据的准确性、一致性和可靠性
  </Accordion>

  <Accordion title="如何启用这项服务？">
    在您的住宅代理设置页面中，在“自动解除封锁”部分的左侧，将开关设置为开（蓝色）

    <Frame>
            <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configure-your-proxy/automated-unlocking.png?maxW=787&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3b2e7926c78e38b6483c37557a071792" alt="automated-unlocking.png" width="787" height="736" data-path="images/proxy-networks/residential/configure-your-proxy/automated-unlocking.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configure-your-proxy/automated-unlocking.png?w=280&maxW=787&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a032ccdcaf04668f9cceee78dfc71b68 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configure-your-proxy/automated-unlocking.png?w=560&maxW=787&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2e379e68eee8f459c73415403ef8aec9 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configure-your-proxy/automated-unlocking.png?w=840&maxW=787&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4f93acb609cdb4af75847b3e4f4b8acb 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configure-your-proxy/automated-unlocking.png?w=1100&maxW=787&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b44dd64d71cf4aaac11918cd37f744dd 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configure-your-proxy/automated-unlocking.png?w=1650&maxW=787&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8eecbc07b8e230798a4ab9da5ddb6086 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configure-your-proxy/automated-unlocking.png?w=2500&maxW=787&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=475627dd0ed2615e69dc832744c6fb03 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>
</AccordionGroup>

### 端口

默认情况下，以下端口处于打开状态： 80、 443、 8080、 8443、 5678、 1962、 2000、 4443、 4433、 4430， 4444 和 1969。

如果您需要访问其他端口，请点击“添加端口”并填写表格。Bright Data 的合规团队将审查该请求并向您通报最新情况。

### 长会话对等点: Deprecated

<Warning> Long session peers option is now deprecated and no longer offerred </Warning>
Long-Session Peers enable you to maintain a stable IP address for an extended period, ensuring seamless and consistent scraping operations. Unlike regular residential IPs, where the IP can rotate at any moment if the peer unexpectedly disconnects, Long-Session Peers provide continuous sessions.

#### 启用长会话对等点: Deprecated

~~Simply, go to an existing 移动设备 zone or open a new one and toggle on the **长会话对等点** feature. 现在，您今后的请求将只通过已知的长期对等点进行路由。~~

<Frame>
  <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/proxy-networks/residential/long_session_peers.png?maxW=567&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c7319defa6d2058cc166b5b2cf82b7fb" alt="安装证书" width="567" height="286" data-path="images/proxy-networks/residential/long_session_peers.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/proxy-networks/residential/long_session_peers.png?w=280&maxW=567&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=4963c35082d9fbb5d3d258f185ebd237 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/proxy-networks/residential/long_session_peers.png?w=560&maxW=567&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=43f67c72377b653a910c54d2878aed7e 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/proxy-networks/residential/long_session_peers.png?w=840&maxW=567&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=ec05e1605c21d8e514d94fa3621eee51 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/proxy-networks/residential/long_session_peers.png?w=1100&maxW=567&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=73d74cf9e2a6d8b587b6c7aaabc702ff 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/proxy-networks/residential/long_session_peers.png?w=1650&maxW=567&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f0448d7811b039ef61ea5b87ff8a8f6b 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/proxy-networks/residential/long_session_peers.png?w=2500&maxW=567&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=7592e249f175c94f6eda4922cf9cf4c2 2500w" data-optimize="true" data-opv="2" />
</Frame>


# 住宅产品常见问题解答
Source: https://docs.brightdata.com/cn/proxy-networks/residential/faqs

Find answers to common questions about integrating, configuring, and using Bright Data's 住宅 proxy products, including IP types, geotargeting, and error codes.

<AccordionGroup>
  <Accordion title="如何将新代理集成到代码中？">
    要将代理集成到代码中，请访问 API 示例页面，该页面可通过您的区域设置在“访问参数”下访问：

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8865e37db6b85ba4c7b10554f96b5152" alt="integrate-new-proxy.gif" width="1828" height="978" data-path="images/proxy-networks/faqs/integrate-new-proxy.gif" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=280&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=af6967b98840c378451f71789844683c 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=560&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c8a668490c5e77e52cfaaa33e9611f92 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=840&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d8bc15aa37a36943e130b755bef3760c 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=1100&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f48c0c165a1ca706da431cb105685adb 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=1650&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e3a7b54c9cf2cd04dcfb7cbceb39b55b 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=2500&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e2e00c6be0bb7ce6e8c8b666071aff96 2500w" data-optimize="true" data-opv="2" />

    在该页面上，您可以选择大多数现代编码语言的集成示例，只需选择集成类型、代理区域、编码语言等，页面就会生成您可以立即使用的代码片段。
  </Accordion>

  <Accordion title="如何将代理集成到第三方软件中？">
    请查看上文提到的 API 示例页面中的一些示例（只需在“语言”下拉菜单中选择“其他软件”），或者查看我们的集成页面，其中提供了将我们的代理集成到当今业界最流行的工具中的具体指南。

    重要说明：如果您正在使用 Bright Data 的 Unlocker API、住宅代理或 SERP API，您可能需要使用我们的 SSL 证书来启用端到端安全连接。:
    [https://dashboard.mintlify.com/editor#how-to-integrate-a-proxy-into-3rd-party-software](https://dashboard.mintlify.com/editor#how-to-integrate-a-proxy-into-3rd-party-software)

    我们为最常用的工具准备了详细的指南。 您可以在下面的列表中找到这些指南的链接：

    BrowserScan 	[https://docs.brightdata.com/integrations/browserscan](https://docs.brightdata.com/integrations/browserscan)

    XLogin 		[https://docs.brightdata.com/integrations/xlogin](https://docs.brightdata.com/integrations/xlogin)

    GeeLark 	[https://docs.brightdata.com/integrations/geelark](https://docs.brightdata.com/integrations/geelark)

    Puppeteer 	[https://docs.brightdata.com/integrations/puppeteer](https://docs.brightdata.com/integrations/puppeteer)

    Playwright 	[https://docs.brightdata.com/integrations/playwright](https://docs.brightdata.com/integrations/playwright)

    Selenium 	[https://docs.brightdata.com/integrations/selenium](https://docs.brightdata.com/integrations/selenium)

    AdsPower 	[https://docs.brightdata.com/integrations/adspower](https://docs.brightdata.com/integrations/adspower)

    Dolphin Anty 	[https://docs.brightdata.com/integrations/dolphin-anty](https://docs.brightdata.com/integrations/dolphin-anty)

    Incogniton 	[https://docs.brightdata.com/integrations/incogniton](https://docs.brightdata.com/integrations/incogniton)

    Marketerbrowser [https://docs.brightdata.com/integrations/marketerbrowser](https://docs.brightdata.com/integrations/marketerbrowser)

    SMLOGIN 	[https://docs.brightdata.com/integrations/smlogin](https://docs.brightdata.com/integrations/smlogin)

    Hidemyacc 	[https://docs.brightdata.com/integrations/hidemyacc](https://docs.brightdata.com/integrations/hidemyacc)

    OpenBullet	[https://docs.brightdata.com/integrations/openbullet](https://docs.brightdata.com/integrations/openbullet)

    Switchyomega 	[https://docs.brightdata.com/integrations/switchyomega](https://docs.brightdata.com/integrations/switchyomega)

    PhantomBuster 	[https://docs.brightdata.com/integrations/phantombuster](https://docs.brightdata.com/integrations/phantombuster)

    BitBrowser 	[https://docs.brightdata.com/integrations/bitbrowser](https://docs.brightdata.com/integrations/bitbrowser)

    Maskfog 	[https://docs.brightdata.com/integrations/maskfog](https://docs.brightdata.com/integrations/maskfog)

    Ghost Browser 	[https://docs.brightdata.com/integrations/ghost-browser](https://docs.brightdata.com/integrations/ghost-browser)

    Postman 	[https://docs.brightdata.com/integrations/postman](https://docs.brightdata.com/integrations/postman)

    NGINX 		[https://docs.brightdata.com/integrations/nginx](https://docs.brightdata.com/integrations/nginx)

    StablerSOLO 	[https://docs.brightdata.com/integrations/stablersolo](https://docs.brightdata.com/integrations/stablersolo)

    VMLogin 	[https://docs.brightdata.com/integrations/vmlogin](https://docs.brightdata.com/integrations/vmlogin)

    GoLogin 	[https://docs.brightdata.com/integrations/gologin](https://docs.brightdata.com/integrations/gologin)

    Windows 	[https://docs.brightdata.com/integrations/windows](https://docs.brightdata.com/integrations/windows)

    Scrapy 		[https://docs.brightdata.com/integrations/scrapy](https://docs.brightdata.com/integrations/scrapy)

    AEZAKMI 	[https://docs.brightdata.com/integrations/aezakmi](https://docs.brightdata.com/integrations/aezakmi)

    Beautifulsoup 	[https://docs.brightdata.com/integrations/beautifulsoup](https://docs.brightdata.com/integrations/beautifulsoup)

    WebHarvy 	[https://docs.brightdata.com/integrations/webharvy](https://docs.brightdata.com/integrations/webharvy)

    Ubuntu 		[https://docs.brightdata.com/integrations/ubuntu](https://docs.brightdata.com/integrations/ubuntu)

    Lalicat 	[https://docs.brightdata.com/integrations/lalicat](https://docs.brightdata.com/integrations/lalicat)

    Multilogin 	[https://docs.brightdata.com/integrations/multilogin](https://docs.brightdata.com/integrations/multilogin)

    Undetectable 	[https://docs.brightdata.com/integrations/undetectable](https://docs.brightdata.com/integrations/undetectable)

    Apify 		[https://docs.brightdata.com/integrations/apify](https://docs.brightdata.com/integrations/apify)

    iPhone 		[https://docs.brightdata.com/integrations/ios](https://docs.brightdata.com/integrations/ios)

    MuLogin 	[https://docs.brightdata.com/integrations/mulogin](https://docs.brightdata.com/integrations/mulogin)

    Changedetection [https://docs.brightdata.com/integrations/changedetection](https://docs.brightdata.com/integrations/changedetection)

    Morelogin 	[https://docs.brightdata.com/integrations/morelogin](https://docs.brightdata.com/integrations/morelogin)

    Proxifier 	[https://docs.brightdata.com/integrations/proxifier](https://docs.brightdata.com/integrations/proxifier)

    Texau 		[https://docs.brightdata.com/integrations/texau](https://docs.brightdata.com/integrations/texau)

    Android 	[https://docs.brightdata.com/integrations/android](https://docs.brightdata.com/integrations/android)

    Kameleo 	[https://docs.brightdata.com/integrations/kameleo](https://docs.brightdata.com/integrations/kameleo)

    Screaming Frog 	[https://docs.brightdata.com/integrations/screaming-frog](https://docs.brightdata.com/integrations/screaming-frog)

    Foxy		[https://docs.brightdata.com/integrations/foxyproxy](https://docs.brightdata.com/integrations/foxyproxy)

    SessionBox 	[https://docs.brightdata.com/integrations/sessionbox](https://docs.brightdata.com/integrations/sessionbox)

    Insomniac 	[https://docs.brightdata.com/integrations/insomniac](https://docs.brightdata.com/integrations/insomniac)

    Helium Scraper 	[https://docs.brightdata.com/integrations/helium-scraper](https://docs.brightdata.com/integrations/helium-scraper)

    SaleFreaks 	[https://docs.brightdata.com/integrations/salefreaks](https://docs.brightdata.com/integrations/salefreaks)

    Postern 	[https://docs.brightdata.com/integrations/postern](https://docs.brightdata.com/integrations/postern)

    Antik 		[https://docs.brightdata.com/integrations/antik](https://docs.brightdata.com/integrations/antik)

    Easync 		[https://docs.brightdata.com/integrations/easync](https://docs.brightdata.com/integrations/easync)

    ParseHub 	[https://docs.brightdata.com/integrations/parsehub](https://docs.brightdata.com/integrations/parsehub)

    Sphere Browser 	[https://docs.brightdata.com/integrations/sphere-browser](https://docs.brightdata.com/integrations/sphere-browser)

    Octoparse 	[https://docs.brightdata.com/integrations/octoparse](https://docs.brightdata.com/integrations/octoparse)

    ixBrowser 	[https://docs.brightdata.com/integrations/ixbrowser](https://docs.brightdata.com/integrations/ixbrowser)

    Shadowrocket 	[https://docs.brightdata.com/integrations/shadowrocket](https://docs.brightdata.com/integrations/shadowrocket)

    Firefox 	[https://docs.brightdata.com/integrations/firefox](https://docs.brightdata.com/integrations/firefox)

    Chrome 		[https://docs.brightdata.com/integrations/chrome](https://docs.brightdata.com/integrations/chrome)

    MacOS 		[https://docs.brightdata.com/integrations/macos](https://docs.brightdata.com/integrations/macos)

    ClonBrowser 	[https://docs.brightdata.com/integrations/clonbrowser](https://docs.brightdata.com/integrations/clonbrowser)

    Octo Browser 	[https://docs.brightdata.com/integrations/octobrowser](https://docs.brightdata.com/integrations/octobrowser)

    Genlogin 	[https://docs.brightdata.com/integrations/genlogin](https://docs.brightdata.com/integrations/genlogin)

    Web Scraper 	[https://docs.brightdata.com/integrations/webscraper](https://docs.brightdata.com/integrations/webscraper)

    如果您使用的工具没有出现在列表中，而您又希望获得相关指南，请联系我们！
  </Accordion>

  <Accordion title="如何定位到特定国家/地区？">
    发送请求时，请在请求中的区域名称后添加-country标志，然后添加该国家/地区的 2 个字母 [ISO](https://www.nationsonline.org/oneworld/country_code_list.htm) 代码。

    在以下示例中：我们在请求中添加了 -country-us，因此我们将发送来自美国（“us”）的请求。

    ```sh
    curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us: <zone_password>
    ```
  </Accordion>

  <Accordion title="如何定位到欧盟地区">
    <Note>欧盟内部的国家分配是随机的。</Note>

    <Info>与 DC、ISP 和 Unlocker/SERP API 相关</Info>

    您可以按照与上述“国家/地区”相同的方式定位到整个欧盟地区，在请求中的 “country” 之后添加 “eu”：-country-eu

    使用 -country-eu 发送的请求将使用来自以下一个国家/地区的 IP，这些国家/地区自动包含在 “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
    ```
  </Accordion>

  <Accordion title="如何定位到特定城市？">
    要定位到特定城市，您需要使用共享（按 IP 付费）或专用代理网络。

    在配置代理区域时，选择首选国家/地区后，您可以添加一个城市，以进一步指定您的地理定位。

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ca7361e14082b55128dfeaecf1222f9a" alt="add-city.png" width="664" height="376" data-path="images/proxy-networks/faqs/add-city.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=280&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=04a0e4f99086ed0b3ffa814a0d6d8901 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=560&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e783c970a46a962b796015a72bf16acd 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=840&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3cac3ce62610ee6ae080145996ebb746 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=1100&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f66bf044a4bf60204463610aebca401a 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=1650&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c1478268f631d03401ac9e3c3ae0cdc2 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=2500&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fda8142825643a46c283f3bc55793d84 2500w" data-optimize="true" data-opv="2" />

    点击“添加城市” 后，您将看到所选国家/地区的可用定位城市。要查看特定地理位置的可用 IP 数量 。

    配置完成后，就可以使用以下语法从所选城市发送请求了

    ```sh
    curl "http://target.site" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-<country>-city-<city>: <zone_password>
    ```

    <Note>
      选择两个字的城市时，它将被写成一个词。

      例如，要定位到布宜诺斯艾利斯，请求语法将是：

      `-country-ar-city-buenosaires`
    </Note>

    要查看更多地理定位示例，请访问我们的代理集成示例页面。\
    [https://brightdata.com/cp/zones/proxy\_examples](https://brightdata.com/cp/zones/proxy_examples)
  </Accordion>

  <Accordion title="Bright Data 在哪些地方有代理服务器？">
    Bright Data 在全球所有国家/地区均提供代理服务，但以下国家除外：

    * 伊朗
    * 伊拉克
    * 叙利亚
    * 黎巴嫩
    * 巴勒斯坦
    * 朝鲜
    * 古巴
    * 苏丹
    * 俄罗斯克里米亚地区

    如果您需要这些国家/地区的代理，很遗憾，Bright Data 无法为您提供帮助。
  </Accordion>

  <Accordion title="如何查看代理事件日志？">
    事件日志（最多）将显示您的账户最近通过任何区域发出的 200 次请求。

    在您的 Bright Data 控制面板的代理页面中：[https://brightdata.com/cp/zones](https://brightdata.com/cp/zones)

    转到“事件日志”选项卡：

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e58931c902b2aa2b9cb71157e98e2ab9" alt="event-log.png" width="1833" height="977" data-path="images/proxy-networks/faqs/event-log.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=280&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3ca0f70abbd76e232d8bbe117f4350aa 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=560&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b08adc7e24153bf24ee8e4e36e79bf25 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=840&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=58efc19a1f43403f4cc6b896de99bc5e 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=1100&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2c9e851671051303d96f000a7e23bcfd 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=1650&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2f30a688c191fe1392e473e86826ee46 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=2500&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f7ee65bd5eabe6ae149263a8f9464acc 2500w" data-optimize="true" data-opv="2" />

    提供的数据是：

    * **日期**：请求的时间和日期
    * **区域**：请求使用的区域
    * **源 IP**：请求来自哪个 IP
    * **URL**：请求的目标站点
    * **结果**：请求成功或失败

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f2905127ebde0e5876295cb21ed341ce" alt="event-log-headers.png" width="1833" height="977" data-path="images/proxy-networks/faqs/event-log-headers.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=280&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7b9dd50469ff007397a1e8c93a030795 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=560&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=564c5cbb33cf376f1a4697557c98d724 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=840&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=888b55dcce504a411741144fed9ec49a 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=1100&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=22d813089ee901fe3d7ef46fd2dfbfda 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=1650&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=611238c6c04383d5b659d5d4fadf56af 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=2500&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6c16fdf908195d513b49f3577770876e 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="如何在多个请求中使用同一个 IP？">
    * 可以通过在代理用户名中添加会话标志来实现：

    ```sh
    brd.superproxy.io:33335 br-customer-<customer_id>-zone-<zone_name>-session-rand39484
    ```

    在线程启动时生成随机数，并在要更改为线程连接分配的代理对等节点时进行更改。

    * 会话 ID 可以是任何随机字符串/计数器：具有相同会话字符串的请求将使用相同的代理对等节点（尽可能长）；具有不同会话字符串的请求将分配给不同的代理对等节点。
    * 要强制更改 IP，只需修改会话 ID 即可。
    * 如果分配的代理对等节点（出口节点 IP）不可用，超级代理将在第一次请求时返回错误信息 “502 - 没有可用的对等节点”，然后在第二次请求时，即使不更改会话 ID，超级代理也会分配一个新的对等节点。
    * 会话 IP 最长可在 1 分钟的空闲时间内保持不变。 一分钟后，如果没有请求，IP 就会被释放回池中。\
      要延长会话/IP 的持续时间，可每隔 30 秒发送一个微小的保活请求，以防止会话空闲超过一分钟。\
      该请求可以是任何小请求，如 /favicon.ico，甚至是返回 404 的请求（只要网络服务器不会因为该请求而断开套接字）。
    * 如果您有多个客户端，并希望忽略客户端的源 IP（它与您的会话 ID 一起用于创建会话），那么您需要使用全局会话，然后在会话中添加 glob\_ 作为前缀：

    ```sh
    brd-customer-<customer_id>-zone-<zone_name>-session-glob_rand39484
    ```

    完整请求示例：

    ```sh
    brd-customer-CXXXXX-zone-ZONE_X-session-glob_rand39484
    ```

    在线程启动时生成随机数，并在要更改为线程连接分配的代理对等节点时进行更改。
  </Accordion>

  <Accordion title="如何定位到特定的操作系统？">
    Bright Data 允许定位到以下操作系统：

    <CodeGroup>
      ```sh Windows
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-windows:<zone_password> --proxy brd.superproxy.io:33335 "<target_site>"
      ```

      ```sh macOS
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-osx:<zone_password> --proxy brd.superproxy.io:33335 "<target_site>"
      ```

      ```sh Android
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-android:<zone_password> --proxy brd.superproxy.io:33335 "<target_site>"
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="如何使用特定 IP？">
    使用 Bright Data 的住宅代理网络时，您可能需要使用分配给您所在区域的特定 IP。

    1. 发送测试请求，并添加 “-verbose” 或 “-v” 选项（这将打开详细日志记录）

    ```sh
    curl "https://lumtest.com/myip.json" --verbose --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
    ```

    2. 找到 x-brd-ip 响应标头并复制其值
       <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ae57da3518779f40a958f78a00ecfedf" alt="x-brd-ip.png" width="423" height="23" data-path="images/proxy-networks/faqs/x-brd-ip.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=280&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4578ce7b27745497ae8123a53a852500 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=560&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=eea20a9293172fd0a758c50ab8438dca 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=840&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7549acd6febbfb9404217c4337ae4713 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=1100&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f2376a4f21caa18b90f3501d109f1c2e 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=1650&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=79eece5f221dab3bf68b12a7611e0a84 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=2500&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8d41955b988378d12e7838ad4e5a3b15 2500w" data-optimize="true" data-opv="2" />

    3. 在请求中的区域名称后添加 -ip- 标志，并使用上一步中复制的散列 IP 值

    4. 发送测试请求，然后查看响应

    ```sh
    curl "https://lumtest.com/myip.json" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-<hashed-ip>:<zone_password>
    ```

    我们建议使用 [https://lumtest.com/myip.json](https://lumtest.com/myip.json) 作为目标域进行测试，并审查您的 IP 凭据。
  </Accordion>

  <Accordion title="如何定位到 ASN 特定 IP？">
    将 ASN 参数添加到地理位置定位下的区域配置中，即可启用此功能。

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=382d3e5f40fd938e5a84ae2849fd0c3e" alt="asn-targeting.png" width="583" height="931" data-path="images/proxy-networks/faqs/asn-targeting.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=280&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=77b6b1aa38626011a34ca6486219d353 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=560&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e6630c50ab7413f6837e8d326ba00b3f 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=840&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6e220de756396a15aaba32b6c5da186f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=1100&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=da2df73c5b2c0d5d37cbe06ee086f73b 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=1650&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5664f5ee339248026f6350324c0adcbf 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=2500&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6df52c82ff5d02aeb05a43655e73736c 2500w" data-optimize="true" data-opv="2" />

    保存配置后，可将 ASN 标志添加到区域的凭据中，并在使用住宅代理时进行整合。

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-asn-<asn-number>:<zone_password> "<target_site>"
    ```

    **注意**：ASN 编号的值可在此处找到:
    [https://bgp.potaroo.net/cidr/autnums.html](https://bgp.potaroo.net/cidr/autnums.html)
  </Accordion>

  <Accordion title="如何定位到住宅 IP 组 (gIP)？">
    可以以 gIP 的形式选择专用住宅 IP。可通过在区域配置页面下选择“专用” IP 类型和选择 gip 数量来分配这些 IP。此外，还需要针对特定域名。

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c6271c5594fac3f6861969bd7af27f1e" alt="number-of-dedicated-gIPs.png" width="645" height="909" data-path="images/proxy-networks/faqs/number-of-dedicated-gIPs.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=280&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5dbdca062126def5cb6056cefbb9b7dd 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=560&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9bcacda84b73566eae2020e039b2e38b 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=840&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0d9c62f26e4bd3d36d89ee278440d204 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=1100&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=42f6b5b50b0e87f20029e4a89df13c2b 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=1650&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=655cc189fd49c7ffeb9b739f59a23ebd 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=2500&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=15972b33cfafd930e2d7b90d18768248 2500w" data-optimize="true" data-opv="2" />

    保存配置后，选择“显示已分配的专用住宅 IP” 将提供代表组 IP 的哈希值列表。
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=75d1f6c97b99b54c4bb1f4e6ac222b09" alt="show-allocated-dedicated-ips.png" width="583" height="393" data-path="images/proxy-networks/faqs/show-allocated-dedicated-ips.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=280&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2d56759505ae73cd244f0a59e673516d 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=560&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6ff579ae3da9b8a1fb08048c5cd40f42 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=840&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e9e229a90011d93f9128b7a67e47b47a 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=1100&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d26dd0084f0f82302519b8c73013a03c 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=1650&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=1936faef05312195dd9c83c8960bed3a 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=2500&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fd1c5fca0c04634e370f8b82cd451fb1 2500w" data-optimize="true" data-opv="2" />

    这些值可用于定位特定的 gip。 例如：

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-gip-<gip_hash_value>:<zone_password> "<target_site>"
    ```
  </Accordion>

  <Accordion title="如何启用长会话对等节点">
    长会话对等节点可让您长期保持一个稳定的 IP 地址，确保无缝和一致的抓取操作。 与普通住宅 IP 不同的是，如果对等节点意外断开连接，IP 可能会随时轮换，而长会话对等节点可提供连续的会话。

    **启用长会话对等节点**

    只需转到现有的住宅区或打开一个新的住宅区，然后切换到“长会话对等节点”功能即可。 现在，您今后的请求将只通过已知的长期对等节点发送。\
    **Note:** This feature does add an extra cost for the zone when enabled

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ceae664decd0148cb282001dd123898c" alt="long-session-peers.png" width="567" height="286" data-path="images/proxy-networks/faqs/long-session-peers.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?w=280&maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e8d1fd864c37a05db277361552f03f39 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?w=560&maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=96a200c7e795df0996b2446266395b85 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?w=840&maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e414da5c55131589268b1fd5d526b336 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?w=1100&maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b26c67e46f8139650350b404747aebe4 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?w=1650&maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fe7d9da5ecdefd978a2f3c05c0ef69da 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/long-session-peers.png?w=2500&maxW=567&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=efdade17ab582f8edfa18810e28216a7 2500w" data-optimize="true" data-opv="2" />

    **这些节点来自哪里？**

    我们的住宅对等节点池由世界各地选择使用我们产品的真实用户组成。作为选择加入的一部分，我们利用这些真实用户在“停机”期间的 IP 作为我们符合职业道德的住宅网络的一部分。启用“长会话对等节点”后，您就可以确保您将通过已知的长期保持活跃的对等节点进行路由，与普通的住宅对等节点相比，这些对等节点可以在更长的时间内保持一个 IP 地址。

    **长会话对等节点的好处**

    一致的抓取操作：这种稳定性最大限度地减少了因 IP 变更而造成的中断，并最大限度地提高了抓取任务的效率。 您可以长期依赖一致的 IP 地址，进行长时间的抓取操作。 这一功能对于需要持续提取或监控数据的项目尤其有用。
  </Accordion>

  <Accordion title="如何使用中国住宅 IP 浏览中文网站">
    **在中国境外时**

    定位到中国住宅 IP 对等节点就足够了：

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-cn:<zone_password> "<target_site>"
    ```

    在中国境内时除了定位到中国住宅 IP 对等节点外，还需要定位到我们的中国超级代理。

    * 使用 API 命令时，代理 DNS 服务器是 servercountry-cn.brd.superproxy.io

    ```sh
    curl --proxy servercountry-cn.brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-cn:<zone_password> "<target_site>"
    ```

    * 使用 Proxy Manager 时：
      * 点击端口，选择相关端口设置
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=60c9b798eabd855e54f15c9ed30532c2" alt="port-row.png" width="1490" height="231" data-path="images/proxy-networks/faqs/port-row.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=280&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=1faa89a7b9389f25ce2f2df9ae193acb 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=560&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=efb6903924f8bd83b6dcb191861c4ff2 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=840&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d1de11eb98f22e136fd84756eab9be3c 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=1100&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=abd917c6d5a4876eedaab8df719ca48d 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=1650&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=279bcb4f18934e70b834c32766d4dcba 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/port-row.png?w=2500&maxW=1490&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7074af21c015ff4464baacf4e6ff8cc7 2500w" data-optimize="true" data-opv="2" />
      * 选择“目标定位”并将中国设为定位国家
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4e9d4ff832de3da6c12d54b8e7117f87" alt="target-china.png" width="1848" height="459" data-path="images/proxy-networks/faqs/target-china.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=280&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7e8a54f7f5fef55ea745a2bcecc2b134 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=560&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0b6da7728c8d55330dedee5688064a58 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=840&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6a1153555ae45d3e58cb2b55bb5080a7 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=1100&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=35475a8710d937c48354ee0706a6b9ff 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=1650&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9e78a53887ad4d63f83c1da8e89e6d86 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/target-china.png?w=2500&maxW=1848&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4a583a62f471c4fc8ef963a9d0890a64 2500w" data-optimize="true" data-opv="2" />
      * 选择 IP 控制：将超级代理服务器位置设置为“中国”。
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=79fc7dda8eb2f7f223ccb1e7229dfec4" alt="super-proxy-china.png" width="1838" height="566" data-path="images/proxy-networks/faqs/super-proxy-china.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=280&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=dd62f53444546238099ce3daf1d86320 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=560&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6de9045b2c50ee90605f0da550a87d7e 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=840&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9f6435bff0c6d7dcc194a1466059bafe 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=1100&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2364095b48753d17748d25742385971b 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=1650&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d2d9cba66d209296757cfdd139679ebe 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/super-proxy-china.png?w=2500&maxW=1838&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5eef24fd9763e130b83ee9e9f7bde87f 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="运营商专属代理对等 IP">
    * 您可以选择使用以下列表中的特定运营商：

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

    * 例如

    <CodeGroup>
      ```sh Deutsche Telekom
      brd-customer-<customer_id>-zone-<zone_name>-carrier-dt
      ```

      ```sh Sprint
      brd-customer-<customer_id>-zone-<zone_name>-carrier-sprint
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="关于地理位置数据库，以及如何检查代理 IP 信息？">
    地理位置数据库 (GeoDB) 被互联网网站用于查询用户使用的 IP 地址信息。 Bright Data 监控并维护当今使用的 4 个主要 GeoDB 的正确记录：Maxmind、ip2location、db-ip 和 Google。

    还有许多其他较小的 GeoDB，其中大多数使用的都是过时的记录或有缺陷的测试方法，因此它们提供的信息并不准确，或者是为了引诱浏览者从它们那里购买 VPN 或代理产品。 因此，我们强烈建议在测试 IP 时使用上述 GeoDB。

    要查看我们关于您正在使用的代理 IP 的信息，请浏览以下网站之一：

    * [https://lumtest.com/echo.json](https://lumtest.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="哪些 Bright Data 产品最适合用于抓取搜索引擎 (SERP)？">
    #### 对于单步抓取：

    SERP API 是针对 SERP 的理想产品，因为它具有主动解锁、自动选择最佳代理、自定义标头、指纹识别、获取验证码等功能，可保证成功率（成功才需付费）。

    #### 对于多步抓取（playwright/puppeteer/selenium）：

    Browser API 是一款理想的产品，因为它是我们完全云托管的浏览器，旨在帮助您轻松专注于多步骤数据收集，而我们则为您提供全面的代理和解锁基础架构，包括验证码获取方案。
  </Accordion>

  <Accordion title="能否从住宅、数据中心或 ISP 代理网络定位到 Google SERP？">
    住宅代理——可以。
    SERP API 是针对 SERP 的理想产品，因为它具有主动解锁、自动选择最佳代理、自定义标头、指纹识别、获取验证码等功能，可保证成功率（成功才需付费）。

    数据中心和 ISP 代理——不行。当尝试通过上述任一代理网络专门定位到 Google 时，您的请求将被拒绝，您将在响应标头中收到以下错误信息：

    ```
    HTTP/1.1 403 搜索 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="住宅 & 移动 networks">
    通过住宅网络或移动网络定位搜索引擎时，请求不会通过住宅或移动对等节点发送，而是直接通过我们的超级代理发送。 这样做的原因是为了支持住宅网络和移动网络与浏览器的集成，因为浏览器可能需要从目标网站加载搜索引擎资源端点。

    **如果您使用住宅网络或移动网络定位搜索引擎域，请求将直接通过超级代理，以下响应标头将作为指示：**

    ```sh
    x-luminati-ip: superproxy bypass
    ```
  </Accordion>
</AccordionGroup>


# 住宅代理简介
Source: https://docs.brightdata.com/cn/proxy-networks/residential/introduction

Bright Data的住宅代理网络提供7200多万个IP（来自超过195个国家/地区），要以真实用户的方式浏览和收集数据，这是理想之选。

Bright Data住宅代理网络是我们的代理网络解决方案之一，由7200多万个IP组成，这些IP来自全球超过195个国家。

我们庞大的住宅IP库是由真实的用户组成，这些用户选择加入我们，将其IP借给我们的网络以换取奖励，这使您可以使用目标区域的本地IP来访问难以接触的复杂网站，像真实用户那样浏览或收集相关数据。

## 最适合

* 以真实用户身份浏览复杂的目标网站
* 获取商业情报、竞争对手分析和广告验证
* 如果您在使用我们的 数据中心 或 ISP 代理网络时成功率低下或被完全封锁

<Tip>
  如果您需要更高级的代理解锁解决方案来应对更多屏蔽挑战（如特定于网站的标头、cookie、CAPTCHA验证码等），请尝试我们的Unlocker API，或查看我们的其他代理产品。
</Tip>


# 住宅代理网络政策
Source: https://docs.brightdata.com/cn/proxy-networks/residential/network-access

为保护 Bright Data 的住宅网络，监控规则适用于所有流量，以防止客户访问超出其使用案例和 Bright Data 网络政策的域名。

## 快速入门，立即访问

Bright Data 允许客户在我们的服务条款框架内立即使用其整个住宅网络。

<Warning>
  要允许访问住宅网络，您必须执行此步骤。 否则，您的代码将收到错误信息，并且无法连接。

  要访问住宅网络，请按照以下说明操作:\
  [https://docs.brightdata.com/cn/general/account/ssl-certificate](https://docs.brightdata.com/cn/general/account/ssl-certificate)
</Warning>

<Tip>
  **不想安装证书？**

  在未认证的情况下查看我们的程序或进入 KYC 验证:\
  [https://brightdata.com/cp/kyc](https://brightdata.com/cp/kyc)

  Bright Data 将有权访问流量使用情况，即访问的网页、在这些网页上花费的时间、访问时间和日期。Bright Data 将在有限的时间内保存此信息，以便解决可能出现的任何性能问题，并允许我们的合规团队验证代理使用是否符合我们的道德准则。\
  [https://brightdata.com/ethical](https://brightdata.com/ethical)

  To start your KYC verification process, click [here](https://brightdata.com/cp/kyc).

  Bright Data 不会与第三方共享此信息，但遵守适用法律所需的情况除外。 了解有关我们隐私政策的更多信息。[https://brightdata.com/privacy](https://brightdata.com/privacy)
</Tip>

## `robots.txt` in Immediate Access 住宅

为了兑现我们尊重和合规地使用网络资源的承诺，我们的住宅代理立即访问模式遵守 `robots.txt` 指令，在我们不同的代理网络中应用其逻辑。 选择进入立即访问模式后，操作行为会根据 `robots.txt` 合规性和用户的 KYC 状态进行调整：

当端点可根据 robots.txt 进行访问时，服务会在用户选择的代理网络内正常运行，无论是住宅、移动、数据中心还是 ISP。

如果端点被 robots.txt 规则阻止，或者请求类型为 POST、PUT、PATCH 或 DELETE，则此类请求将被阻止:\
`502 住宅 Failed (bad_endpoint)`

要获得完整的住宅访问权限，请遵循我们的 KYC 验证流程。
[https://docs.brightdata.com/cn/proxy-networks/residential/network-access#kyc-verification](https://docs.brightdata.com/cn/proxy-networks/residential/network-access#kyc-verification)

## KYC 验证

了解您的客户（KYC）是针对每位希望在不安装 SSL 证书的情况下全面访问住宅代理，以及访问尚未获得我们合规团队预先批准网站的客户的一个流程。 在提交 KYC 时，系统会要求您陈述并阐明您的用例，以便使用住宅代理网络定位这些站点。

To start your KYC verification process right now, click [here](https://brightdata.com/cp/kyc).

在任何时候，您都可以通过选择“完全访问需要身份验证”选项来提交 KYC。

<Frame>
  <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/kyc-verification.png?maxW=969&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ee7618cfe7ca4992ce3ed4af3966b541" alt="完全访问需要进行身份验证" width="969" height="459" data-path="images/proxy-networks/residential/kyc-verification.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/kyc-verification.png?w=280&maxW=969&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=aba4bda95dc2944d5a438f01fbfda6d5 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/kyc-verification.png?w=560&maxW=969&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e6990716c4bd6908a84edf5f0fffdb97 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/kyc-verification.png?w=840&maxW=969&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5d09a868acce0e630bb2cca5d88a5eaa 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/kyc-verification.png?w=1100&maxW=969&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=30e9dea1dae7768e0c5f12e1a392b1e1 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/kyc-verification.png?w=1650&maxW=969&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c1685d1226169f8a1ee6c2f4e6c33cac 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/kyc-verification.png?w=2500&maxW=969&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f5c938dd053b4548044b9471e3b40a01 2500w" data-optimize="true" data-opv="2" />
</Frame>

如果您想返回 SSL 认证选项，请转到“基本信息”，然后点击“安装我们的证书”：

<Frame>
  <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/kyc-basic-information.png?maxW=995&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=de437f5a77fd2197e15bb95720b156aa" alt="安装我们的证书" width="995" height="678" data-path="images/proxy-networks/residential/kyc-basic-information.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/kyc-basic-information.png?w=280&maxW=995&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e2a392bb40629514fa78de3542ddec22 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/kyc-basic-information.png?w=560&maxW=995&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=909628a8c1211d75d720a7dcaec1324f 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/kyc-basic-information.png?w=840&maxW=995&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=bf5564bb91afe94c8941c0a170a0fa12 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/kyc-basic-information.png?w=1100&maxW=995&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=29cbd0ec2edeb7c1994f4e7474e1a11f 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/kyc-basic-information.png?w=1650&maxW=995&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=25c0cc6c8154cb1aac31bd7d0633597a 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/kyc-basic-information.png?w=2500&maxW=995&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3ca770a44926e5d536ffb5d5de6f2210 2500w" data-optimize="true" data-opv="2" />
</Frame>

<Warning>
  The KYC process is not available in [Playground](https://docs.brightdata.com/cn/general/faqs#what-is-playground-mode)/[Limited Trial](https://docs.brightdata.com/cn/general/faqs#what-is-limited-trial-mode) modes. The process can be started only after adding real funds to the account balance.
</Warning>


# 如何开始使用住宅代理
Source: https://docs.brightdata.com/cn/proxy-networks/residential/quickstart

使用 Bright Data 按照以下步骤设置住宅代理。登录，创建代理区域，然后验证您的账户即可开始。

<Tip>
  如果您尚未注册 Bright Data，则可以免费注册，添加付款方式时，您将获得价值 \$5 的积分以开启服务！
  [https://brightdata.com/](https://brightdata.com/)
</Tip>

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">登录</a>} />

  <Step title="导航到“我的区域”">
    <Accordion title="在“我的区域”页面的“住宅代理”下，点击“开始”">
      <Warning>
        如果您已经有活跃代理，只需选择右上角的“添加”
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/get_started.png?maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6877ab7b71796d26ce960f42ffec4b62" alt="开始" width="1157" height="888" data-path="images/proxy-networks/residential/get_started.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/get_started.png?w=280&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4f8edeb856d1d04e75463106be6a0808 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/get_started.png?w=560&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5ccb40539239854351126dbbac11aa35 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/get_started.png?w=840&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9937a9bd68383565b6f2e1781b46590c 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/get_started.png?w=1100&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=08625b8f49c175f65bd85d330ca8b7aa 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/get_started.png?w=1650&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=59ec5a318119941b4b8276e8bbdec437 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/get_started.png?w=2500&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8e793e8c0f30b8ce133458a77c5f7fde 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="选择您的代理名称">
    {    /* Enter `Proxy name` for your new 住宅 proxy zone */}

    <Accordion title="为您的新住宅代理输入代理名称">
      <Warning>
        请选择一个有意义的名称，因为区域名称一旦创建就无法更改。
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/add_a_new_proxy.png?maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6a3a3617f78b47171933f4806e37096e" alt="开始" width="1600" height="892" data-path="images/proxy-networks/residential/add_a_new_proxy.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/add_a_new_proxy.png?w=280&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c2590fe45fae433907d9c21e094dce2a 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/add_a_new_proxy.png?w=560&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a032b0c8092373dfa1181948d902b3ec 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/add_a_new_proxy.png?w=840&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8ebedf5d80397bc33a7ebe8553db9f33 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/add_a_new_proxy.png?w=1100&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=500fa701f1555b8d080ab5df8eed6f35 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/add_a_new_proxy.png?w=1650&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=141771afa509c01926f00c655d510256 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/add_a_new_proxy.png?w=2500&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a33314b33c9018f86e46dba8f09e3894 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="点击“添加代理”" />
</Steps>

<Accordion title="在继续操作之前，请验证您的账户">
  如果您尚未添加付款方式，此时系统会提示您添加付款方式以验证您的账户。如果您是第一次使用 Bright Data，您还将获得价值 \$5 的奖励积分以帮助您开启服务！

  <Tip>
    此时不会向您收取任何费用，这仅用于验证目的
  </Tip>
</Accordion>

<Note>
  别担心，我们将在下一节“配置您的代理”中介绍所有配置:
  [https://docs.brightdata.com/cn/proxy-networks/residential/configure-your-proxy](https://docs.brightdata.com/cn/proxy-networks/residential/configure-your-proxy)
</Note>


# 发送您的第一个请求
Source: https://docs.brightdata.com/cn/proxy-networks/residential/send-your-first-request

学习如何使用 Bright Data 的代理产品发送您的第一个请求，并使用多种编程语言编写简单易懂的代码示例。

<Accordion title="本指南适用于所有代理产品" icon="check">
  1. 住宅代理
  2. 移动代理
  3. ISP 代理
  4. 数据中心代理
  5. SERP API
  6. Browser API
  7. Unlocker API
</Accordion>

要开始使用，您需要代理凭证、用户名和密码以及主机名。您可以在代理产品的访问参数或概览选项卡中找到这些凭据。

## 代码示例

获得代理凭证后，使用以下代码发送您的第一个请求：

<CodeGroup>
  ```sh cURL
  curl "http://lumtest.com/myip.json" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```javascript Node.js
  #!/usr/bin/env node

  require('request-promise')({
      url: 'http://lumtest.com/myip.json',
      proxy: 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:33335',
    })
    .then(function (data) {
        console.log(data);
      },
      function (err) {
        console.error(err);
      });
  ```

  ```python Python
  import pprint
  import requests


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

  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://lumtest.com/myip.json"
  response = requests.get(url, proxies=proxies)
  pprint.pprint(response.json())

  ```

  ```php PHP

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

  ```

  ```ruby Ruby
  #!/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://lumtest.com/myip.json')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 33335, '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#
  using System;
  using System.Net;

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

  ```java Java
  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", 33335);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("http://lumtest.com/myip.json").viaProxy(proxy))
              .returnContent().asString();
          System.out.println(res);
      }
  }
  ```

  ```perl Perl
  #!/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:33335");
  print $agent->get('http://lumtest.com/myip.json')->content();
  ```

  ```vb VBA
  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:33335")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("http://lumtest.com/myip.json"))
      End Sub
  End Module
  ```
</CodeGroup>

上面的代码使用住宅代理向 [http://lumtest.com/myip.json](http://lumtest.com/myip.json) 发送请求。 它会以 JSON 格式返回您的 IP 信息：

```json 输出
{
  "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"
  }
}
```

现在，将 “[https://lumtest.com/myip.json”](https://lumtest.com/myip.json”) 替换为您选择的网站，然后...

就是这样！


# SOCKS和SOCKS5代理
Source: https://docs.brightdata.com/cn/proxy-networks/socks5

了解如何将 `SOCKS` 和 `SOCKS5` 协议与 Bright Data 代理网络结合使用

## 支持的 `SOCKS` 协议

Bright Data支持 `SOCKS` 协议版本5：`SOCKS5`。

## 使用 `SOCKS5` 执行抓取任务

互联网数据收集使用的最常见协议是 `HTTP` 和 `HTTPS` ，一些工具或实用程序需要 `SOCKS5` 才能运行。

Bright Data不区分`HTTP`、`HTTPS`和 [`SOCKS5` 代理](https://brightdata.com/solutions/socks5-proxies)： 我们的所有代理都支持所有三种协议。您可以在使用同一代理时在不同协议之间切换。

## 您真的需要 `SOCKS5` 吗？

我们的 `HTTP` 和 `HTTPS` 代理解决方案通常最适合抓取网站，成本最低，性能最高。但是，如果任务仍然需要 `SOCKS5` ，Bright Data可以在全球范围内提供优质代理。

## 支持的代理类型

所有 Bright Data 代理网络均支持 `SOCKS5` 代理连接：数据中心、ISP、住宅和移动代理网络。

<Info>目前仅针对 `HTTPS` 目标支持在Bright Data的住宅代理中使用 `SOCKS5`，很快也将为 `HTTP` 目标提供支持。</Info>

## SOCKS5主代理端口配置

<Note> **Bright Data将端口 `22228` 用于 `SOCKS5`** </Note>

使用 `SOCKS5` 时，请确保使用 `brd.superproxy.io:22228`，而不是 `HTTP` 和 `HTTPS` 协议的标准端口<Tooltip tip="Port 33335 replacing port 22225 deprecated on Sep 2026, click to read more">[`33335`](https://docs.brightdata.com/general/faqs#which-port-shall-i-use-22225-or-33335) </Tooltip>。

## 使用Bright Data进行 `SOCKS5` 定位

<Warning> **Bright Data 仅支持 `SOCKS5` 代理的主机名（域名）** </Warning>

根据我们的合规规定，我们仅允许 `SOCKS5` 请求以主机名/域名作为目标来转发。使用显式IP或本地IP解析发送的请求会被屏蔽。

因此，配置您的代码、客户端或调用应用程序以：

1. 使用域名作为目标

2. 远程而非本地解析 DNS

遵守这些规则将确保请求通过我们的代理对等节点到达目标域 IP。

### 目标端口

#### Datacenter & ISP

Bright Data 针对数据中心和ISP代理，支持所有高于 1024 的端口。

#### 住宅 & 移动

对于住宅和移动代理，Bright Data支持以下端口：`8080`、`8443`、`5678`、`1962`、`2000`、`4443`、`4433`、`4430`、`4444`和`1969`。

## 将SOCKS5与 `curl`、`Javascript` 和 `Python` 结合使用

<Tabs>
  <Tab title="curl">
    <Warning> **发出 `curl` 请求时使用 `socks5h://brd.superproxy.io:22228`** </Warning>

    要将 `curl` 与Bright Data SOCKS5代理一起使用，您必须明确执行以下操作：

    1. 将 `-x` 添加到命令行参数中

    2. 将 `SOCKS5h` 协议用于远程 DNS 查找

    3. 使用的代理地址为 `brd.superproxy.io:22228`

    4. 提供Bright Data代理区域凭证

    5. 住宅和移动代理：添加`curl -k` 选项以忽略SSL错误代理或设置SSL证书
       [Setup SSL Certificate](https://docs.brightdata.com/general/account/ssl-certificate#using-the-ssl-certificate-in-your-code)

    不符合上述所有要求的请求将被屏蔽。

    `curl` 命令示例：

    ```sh
    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
    // 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
    # 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>

#### `curl` 故障排除

我们建议使用 `curl` 来排除SOCKS5请求的故障，并添加 `curl` 选项 `-i` 或 `-v` 来打印标头字段。查找 `x-brd-error`、`x-brd-err-code` 和 `x-brd-err-msg` ，以获取Bright Data代理网络发送的详细错误消息。
要查看我们的完整错误目录（也适用于 `HTTP` 和 `HTTPS` ），请访问此页面: [代理错误故障排除](https://docs.brightdata.com/proxy-networks/errorCatalog)

## `SOCKS5` 身份验证配置

<Note> **Bright Data必须接收代理区域凭据才能访问`SOCKS5`代理** </Note>

身份验证也类似于 `HTTP` 和 `HTTPS` ，通过传递用户和密码来访问代理。

有些工具或实用程序会让您分别输入凭据和端口作为参数，如控制面板中所示；有些会要求您提供一个url，其中的凭据作为单个参数分隔：`userName:password@brd.superproxy.io:22228`。

## `SOCKS5` 地理位置和国家/地区选择

位置设置与 `HTTP/HTTPS` 代理地理定位相同，通过在您的 `SOCKS5` 用户名中添加 `-country-[国家代码]` 来设置。

使用 `curl` 命令获取意大利（国家代码：`it`）`SOCKS5` 代理的示例：

```sh
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
```

## `SOCKS5` 和 `SOCKS5h` 之间的区别

`SOCKS5` 和 `SOCKS5h` 之间的区别在于它们处理DNS（域名系统）解析的方式：

1. **SOCKS5**：在标准SOCKS5代理中，客户端负责解析DNS。这意味着域名（例如 `example.com`）在通过代理传递之前被解析为IP地址。然后，代理将流量路由到已解析的IP地址。

2. **SOCKS5h**: “h” 代表“主机名”。在这种情况下，代理服务器负责解析DNS。客户端将域名（而不是IP地址）发送给代理服务器，代理服务器将其解析并转发请求。如果您想从客户端网络隐藏目标域名，这很有用。

总结一下：

* **SOCKS5**：DNS 解析发生在客户端。

* **SOCKS5h**：DNS 解析发生在代理端。

Bright Data 支持代理端SOCKS5h - 选择最适合您要求的方案。


# 克服网站封锁
Source: https://docs.brightdata.com/cn/proxy-networks/website-blocking

查看有关如何克服网站封锁和错误的一般建议

{/* tags: 为什么我会被网站 X 屏蔽？如何绕过屏蔽？ */}

排除错误的第一步是检查整个网络错误响应——其中可能包含有关错误来源的重要信息，甚至可能提供解决问题的指示。

要分析完整的响应，您可以在终端运行 `curl` 命令，并添加 `-v` 或 `-i` 选项。这些选项会使 `curl` 以详细模式运行，并打印出请求和响应的头部信息。

```
curl -v [rest of curl command options]
```

## 通用建议

### IP 地址

在处理 IP 时，需要考虑的主要因素包括：

* **地理位置**：通常最好使对等 IP 的国家与目标网站所在的国家匹配。\
  使用更具体的定位也可能有所帮助：
  城市比州（省）更具体，州（省）比国家更具体。

* **IP 池类型**：如果目标网站对同一 IP 发送多个请求不敏感，可以使用共享 IP（Shared IP）以降低成本。\
  如果目标网站对此敏感，则使用专用 IP（Dedicated IP）可能会有所帮助。

* **质量**：Bright Data 除了提供自动化爬取解决方案外，还提供 4 种常规代理网络。按照被检测难度从低到高排列如下：\
  数据中心（Data Center）-> ISP 代理（ISP）-> 住宅代理（Residential）-> 移动代理（Mobile）

  如果某个网络持续被屏蔽，尝试使用下一个更难检测的代理类型可能有助于绕过封锁。

* **一致性**：对于单个 URL 的爬取，应频繁轮换 IP 以避免触发速率限制。如果希望模拟真实用户访问，可以参考下方的建议来保持 IP 的一致性。

### 会话（Sessions）

* 如果您希望模拟真实用户，应该使用会话 ID 作为用户名参数：\
  [代理和 IP 轮换控制](https://docs.brightdata.com/api-reference/proxy/rotate_ips#using-the-same-proxy-for-multiple-requests-session)

  这表明，对于具有相同会话 ID 的请求，您希望保持相同的 IP。\
  在使用住宅代理（Residential）或移动代理（Mobile）等轮换网络时，这样做可以使您的行为更接近普通用户。

* 如果您的用例是单次爬取，您仍然可以使用该参数，但方式有所不同：
  * 当会话 ID 更改时，表示您希望使用不同于上次的 IP。
  * 在 60 秒内遍历多个会话 ID，可以让您轮换已分配的 IP。

### 请求方法 / 指纹（Request Method / Fingerprint）

* **请求方法**：“普通用户”通常会使用浏览器访问网站。您可以直接将代理集成到常规浏览器中，或者使用我们的扩展程序（[点击这里](https://chrome.google.com/webstore/detail/bright-data/efohiadmkaogdhibjbmeppjpebenaool?hl=en)）。

  如果您使用的是其他集成方式，例如浏览器自动化或直接 API 请求，请务必注意这一点，并尽可能让您的请求看起来像真实的浏览器，以避免被检测。

* **指纹（Fingerprint）**：让请求看起来像真实用户的一部分是发送合适的 请求头（Headers） 和 Cookies，但另一部分是确保您的请求具有真实浏览器的属性。

  您可以在网上找到许多相关资源，我们还提供 Unlocker API 和 Browser API，这些工具可以自动处理所有这些细节，帮助您绕过检测。

## 自动化解决方案

如果您发现我们的代理解决方案（数据中心、ISP、住宅、移动代理）都无法满足您的需求，我们建议尝试 [自动化爬取解决方案](https://docs.brightdata.com/scraping-automation/introduction)，特别是 Unlocker API。该 API 可自主管理上述所有措施，并提供更多优化，以确保更高的成功率。


# Bright Data's Asset Shield
Source: https://docs.brightdata.com/cn/scraping-automation/bright-shield/asset-shield

使用 Bright Data 的资产盾保护您的域，监控流量，设置规则并接收警报以保护您的在线资产。

资产盾牌产品提供有关传入客户域的 brightdata 流量的数据，以便：

* 成功将自然流量和代理流量拆分到他们的域
* 监控特定端点，确保不访问禁用端点
* 为结果中的站点路径/特定模式定义速率限制
* 根据人们从我的网站抓取的内容了解趋势

## 资产盾牌功能

若要使用资产盾牌功能，客户需要添加域并验证其是否拥有该域。

### 添加域

* 登录您的账户并导航到资产盾牌页面。
* 添加新域
  * 如果您还没有域，请点击 “添加域” 按钮
  * 如果您有域，请点击域下拉列表并选择 “添加域” 选项
* 按照表格
  中的说明进行操作    - 输入您的域
  * 将记录复制到您的域的 DNS 配置中
  * 点击验证

<Note>
  DNS 更改可能需要一些时间才能生效。 如果我们无法立即找到记录，请等待一天并尝试再次验证。
</Note>

### 数据监控器

数据监控器功能允许客户查看其他 Bright Data 客户在所选时间范围内进入其域的流量，根据其路径或自定义模式监控其网站中的特定端点，并在对这些端点的请求量超过他们定义的阈值时收到警报。

<Accordion title="我能在“数据监控器”页面看到什么？">
  在数据监控器页面，您可以访问一个图表，其将所有传入您的域的代理流量可视化。 此图表提供基于 IP 类型（台式设备/移动设备）、代理 IP 国家/地区和网络爬虫所在国家/地区（请求来源）的筛选选项。

  <Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/requests-count.png?maxW=503&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=4a2d58918abb3b48bd8fbedd519e223c" alt="请求数" width="503" height="377" data-path="images/scraping-automation/bright-shield/asset-shield/requests-count.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/requests-count.png?w=280&maxW=503&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e47b60df92a2a756c9140c8f0135aaf2 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/requests-count.png?w=560&maxW=503&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=34c72f008c740eb68028944d9af39bf0 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/requests-count.png?w=840&maxW=503&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b5f6c23007d95a2925d1d97d53b05a88 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/requests-count.png?w=1100&maxW=503&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=24e00a3d45a07c74302dcb34d63c0f94 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/requests-count.png?w=1650&maxW=503&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c0178a4ad0ff50c304fd91abc853fd7f 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/requests-count.png?w=2500&maxW=503&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=89aa86685961c4c828422c2cf71f2dd1 2500w" data-optimize="true" data-opv="2" />

    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/filters.png?maxW=397&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a246a75cde3a5fc28929c954198e0896" alt="筛选工具" width="397" height="374" data-path="images/scraping-automation/bright-shield/asset-shield/filters.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/filters.png?w=280&maxW=397&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f8eebc0dfa221f97e13ec6e18365f459 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/filters.png?w=560&maxW=397&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=99c099339a99e1558ab7ca3521c10235 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/filters.png?w=840&maxW=397&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a85ae2f95d582575374a23a2097a4919 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/filters.png?w=1100&maxW=397&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=fb6dd6a5788155386eeace2987e5aeaf 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/filters.png?w=1650&maxW=397&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=11edd182f61fe36833c3d65ce190f3bc 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/filters.png?w=2500&maxW=397&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=008fbf3569b2667a8ee39e94bb7f3f96 2500w" data-optimize="true" data-opv="2" />
  </Frame>

  在图表下方，您将找到规则表以供进一步查看。
</Accordion>

### 添加和使用规则

资产盾牌使客户能够为自己域内的特定路径或模式制定规则。 设置规则后，将在表中创建一个新条目，显示对指定路径或模式的请求数。 客户还可以设置每小时请求的阈值，超过时触发警报。

若要添加规则：

<Steps>
  <Step title="登录">
    登录并导航到资产盾牌页面。
  </Step>

  <Step title="选择域">
    <Note>
      如果您没有任何域，请先按照 “如何添加域” 指南进行操作。
    </Note>
  </Step>

  <Step title="打开数据监控器">
    * 点击“数据监控器”旁的 “管理”。
    * 点击 “添加规则”。
  </Step>

  <Step title="选择规则类型">
    * 在预设选项下选择“新增”。
    * 在路径规则或模式规则之间进行选择。

    <Tabs>
      <Tab title="路径规则">
        使用正则表达式输入所需的路径。

        示例：`/path1/path2/`\* 将跟踪所有以 `/path1/path2/` 开头的路径的请求。
      </Tab>

      <Tab title="模式规则">
        Specify a pattern or content to track using regex.

        Example: entering "electronics" will track requests containing the word "electronics."
      </Tab>
    </Tabs>
  </Step>

  <Step title="设置警报（可选）">
    * 添加指定用户的电子邮件地址，以便在每小时请求金额超过自定义阈值时收到提醒。
    * 选择警报的阈值。
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/add-rules.gif?maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=ab6a00cb3f83008a6b6c118c3ad4b575" alt="添加和使用规则" width="1388" height="834" data-path="images/scraping-automation/bright-shield/asset-shield/add-rules.gif" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/add-rules.gif?w=280&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=23078ca66e71e9e6f6a20370353d47ff 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/add-rules.gif?w=560&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=ca3a7684e9ef2289fa468ea41c85ad15 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/add-rules.gif?w=840&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=306e59b64acc8e07ad78ff318e6d78c4 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/add-rules.gif?w=1100&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=4b245ace9dee404ee1005e5a8f8f701a 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/add-rules.gif?w=1650&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=6f5be3b8198c21543cb4f00cc5d38cf0 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/add-rules.gif?w=2500&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=285df1b88710b281e81e7b8f634f1658 2500w" data-optimize="true" data-opv="2" />
</Frame>

## 资产盾牌计费

资产盾牌的定价基于所选域的带宽，起价为每千兆字节 0.2 美元，最低月度承诺为 10,000 美元。此承诺与账户可能会有的任何其他月度承诺是分开的。

<Tip>
  对于带宽速率较低的较大套餐，请联系您的客户经理了解更多详情。
</Tip>


# 了解 Bright Shield
Source: https://docs.brightdata.com/cn/scraping-automation/bright-shield/introduction



Bright-Shield 是一套风险管理解决方案，可确保抓取活动以合法、合乎道德和合规的方式进行，从而保护进行抓取的企业和目标网站。

<CardGroup>
  <Card title="资产防护盾" icon="shield" href="/scraping-automation/bright-shield/asset-shield">
    监控 Bright Data 到您网站的流量
  </Card>

  <Card title="抓取防护盾" icon="spider" href="/scraping-automation/bright-shield/scraping-shield">
    监控从您的 Bright Data 账户发送的流量
  </Card>
</CardGroup>


# Bright Data's Scraping Shield
Source: https://docs.brightdata.com/cn/scraping-automation/bright-shield/scraping-shield



抓取盾牌提供有关客户传出代理流量的数据，以使他们能够更好地控制流量；此外，它还允许在满足某些条件时触发预定义的操作，例如：发送电子邮件警报，阻止请求等。

## 抓取盾牌功能

### 域分类

域分类功能将来自客户代理操作的传出流量分为购物、社交媒体和旅行等组别。客户可以查看每个类别的流量，向下钻取以查看特定的域名。 他们还可以设置规则，阻止特定类别或域使用代理，并在有人尝试访问时提醒指定用户。

<Accordion title="我可以在域分类页面看到什么？">
  在域分类页面，您可以查看显示您账户中所有传出代理流量的图表。 此图表可以按分类、域或区域进行细分。

  <Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/traffic-chat.png?maxW=473&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=5c5cf9c78a5a46bcb8d75eecc453bf51" alt="流量图" width="473" height="381" data-path="images/scraping-automation/bright-shield/scraping-shield/traffic-chat.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/traffic-chat.png?w=280&maxW=473&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a31840d8dcd11247ab082d707b9b0d51 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/traffic-chat.png?w=560&maxW=473&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=438f132b4180a0a7f542709f43ee2fed 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/traffic-chat.png?w=840&maxW=473&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f166507095d81530671b38b7ff5713bc 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/traffic-chat.png?w=1100&maxW=473&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=14bde05333de69ec9cc60db739ab9b5b 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/traffic-chat.png?w=1650&maxW=473&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8ab0ebe0b571cd478b398a79047ea6e0 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/traffic-chat.png?w=2500&maxW=473&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9b85788156e9ea7e79573fd6c106a0c3 2500w" data-optimize="true" data-opv="2" />
  </Frame>

  此外，还有一个表格显示按分类细分的所有流量。 客户可以展开此表的每一行，查看所使用的特定域或区域，以及请求数量和这些域/区域的流量。

  <Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/classification-table.png?maxW=1280&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f5b777d21b2d7d61e1ddb495de9af549" alt="分类表" width="1280" height="281" data-path="images/scraping-automation/bright-shield/scraping-shield/classification-table.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/classification-table.png?w=280&maxW=1280&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b53e60914b35c923dfc559256a420e53 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/classification-table.png?w=560&maxW=1280&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a09f24a8d6af14dc7be47e557b56ff0f 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/classification-table.png?w=840&maxW=1280&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=485dec25c3017b50119d536a594d571e 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/classification-table.png?w=1100&maxW=1280&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8c23f7d90875e54fa413bad60e252da3 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/classification-table.png?w=1650&maxW=1280&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8975158543d75d94c7d04f864c071bbe 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/classification-table.png?w=2500&maxW=1280&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a5c535d95957a7792bc7fac42e42cbfe 2500w" data-optimize="true" data-opv="2" />
  </Frame>

  客户还可以添加规则，在针对特定类别/域时执行特定操作。
</Accordion>

### 添加和使用规则

规则可使客户能够根据传出流量的分类或域设置特定的操作或警报。 这些规则包括阻止对某些分类或域的请求以及在针对特定类别或域时设置警报的功能。

有两种添加规则的方法：

<Tabs>
  <Tab title="从头开始创建规则">
    * 登录您的账户，转到域分类页面。
    * 选择页面顶部的 “规则” 选项卡。
    * 点击 “添加规则”
    * 选择规则应适用于整个分类还是特定域
    * 启用“阻止请求”复选框后，将会阻止对所选分类/域的所有请求。
    * 当向所选分类/域发送最少数量的请求时，“通知...” 复选框将允许您向指定用户发送警报。

    <Frame>
      <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-scratch.gif?maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=12477c6cf3f6f24d20a9a3ee7af6e7ce" alt="从头开始创建规则" width="1388" height="738" data-path="images/scraping-automation/bright-shield/scraping-shield/create-rule-from-scratch.gif" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-scratch.gif?w=280&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8f8ea8bd6660cc92af183a38f443c91a 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-scratch.gif?w=560&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3f841a488e9997b35a72563ed5349768 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-scratch.gif?w=840&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=1e7b2dee23c45cca82513e5a4fab002d 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-scratch.gif?w=1100&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=54e8a5af950b885479b00f71aeac50c6 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-scratch.gif?w=1650&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=91e8a82306c37c9e282122c9b8521699 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-scratch.gif?w=2500&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e2c2d3a2797c6f0d62ff6c9d086f8d1d 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Tab>

  <Tab title="根据统计表创建规则">
    * 登录您的账户，转到域分类页面。
    * 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
    * 启用“阻止请求”复选框后，将会阻止对所选分类/域的所有请求。
    * 当向所选分类/域发送最少数量的请求时，“通知...” 复选框将允许您向指定用户发送警报。

    <Frame>
      <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-table.gif?maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=2558c0e5a85def314a79982a6693b361" alt="根据统计表创建规则" width="1388" height="768" data-path="images/scraping-automation/bright-shield/scraping-shield/create-rule-from-table.gif" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-table.gif?w=280&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c6965fc05f538981f19a64826c219556 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-table.gif?w=560&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=d47b1cac9543d81cf41fca7568e6b92e 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-table.gif?w=840&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=533d5d14be74b3e2522a1b106ecfd6f2 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-table.gif?w=1100&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3bcae178513f6445c7c90e7df9633932 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-table.gif?w=1650&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=34378b1b31eb681f9a48568b31165468 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-table.gif?w=2500&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=fdc37d7e6cf30312f4bf1ac285e26bdc 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Tab>
</Tabs>

***

<Accordion title="正在下载示例请求">
  您可以查看从您的账户发送到所选域的示例请求，其中包括请求的时间戳、源 IP、区域、带宽（以字节为单位）和请求的总持续时间。
</Accordion>

## 抓取盾牌 - 计费

抓取盾牌的定价最低为每月 1 万美元。而对于每月使用成本超过 20 万美元的客户，价格将会使其使用成本增加 5％。（实际使用成本，而非月度承诺本身）。

例如，使用成本为每月 15 万美元的客户每月支付最低 1 万美元，而每月使用成本为 22 万美元的客户每月支付 1.1 万美元。

使用成本是使用服务所花费的总金额，仅考虑与抓取盾牌使用相关的产品：所有代理产品、网页抓取工具 IDE和自定义数据集。（除市场数据集之外的所有产品）

<Tip>
  点击这里，了解抓取盾牌 API 参考信息:\
  [https://docs.brightdata.com/cn/api-reference/scraping-shield-api/all-classification-data](https://docs.brightdata.com/cn/api-reference/scraping-shield-api/all-classification-data)
</Tip>


# 配置
Source: https://docs.brightdata.com/cn/scraping-automation/browser-extension/configuration



{/*tags:bext*/}

如何更改扩展程序的设置？

打开扩展程序设置页面，更改设置，例如区域、国家/地区、自定义标头或任何必要内容。完成后点击“应用”，您的扩展程序将使用新设置进行更新。

<img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/configuration/change-extension-settings.gif?maxW=912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=5f944a977d42ac1a285976f5de666af4" alt="" width="912" height="872" data-path="images/scraping-automation/browser-extension/configuration/change-extension-settings.gif" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/configuration/change-extension-settings.gif?w=280&maxW=912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=83db4e80ec996f448e529b6fa9e1021b 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/configuration/change-extension-settings.gif?w=560&maxW=912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=fe9b73910437beca8328a9e07e1dc3d7 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/configuration/change-extension-settings.gif?w=840&maxW=912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=17f7776c038a2fa5aca749292a6776cb 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/configuration/change-extension-settings.gif?w=1100&maxW=912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=72d3d5401e824439918ef8fe2a9a9fb8 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/configuration/change-extension-settings.gif?w=1650&maxW=912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a4e61ffd2f2f15becba4db207fd4a04d 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/configuration/change-extension-settings.gif?w=2500&maxW=912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e856fd6834d6c2fe0250bd4cb0e343c8 2500w" data-optimize="true" data-opv="2" />


# FAQs
Source: https://docs.brightdata.com/cn/scraping-automation/browser-extension/faqs



{/*tags:bext*/}

<AccordionGroup>
  <Accordion title="为什么一直出现登录信息？">
    Bright Data 使用Cookie来记住您的登录凭据，以提供最佳用户体验。如果您使用定期从设备中删除Cookie的第三方扩展程序，那么您会经常看到登录消息。
  </Accordion>

  <Accordion title="我升级到了新的 Bright Data SSL 证书，但扩展程序停止运行了">
    浏览器扩展程序尚不支持新的 SSL 证书（适用于端口`33335`）。\
    我们将很快为新证书提供支持，届时您就可以使用新证书了。
  </Accordion>

  <Accordion title="如何避免收到登录消息？">
    在右上角，您可以点击“删除 Cookie”。此操作从您的设备中删除除了Bright Data 和 Google 的 Cookie 之外的所有 Cookie，以便您可以不间断地使用我们的服务并让浏览器扩展程序保持活动状态。

        <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/delete-cookies.png?maxW=384&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c2e8dbf05de221cd9743a120778d4b1c" alt="delete-cookies.png" width="384" height="529" data-path="images/scraping-automation/browser-extension/faqs/delete-cookies.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/delete-cookies.png?w=280&maxW=384&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3c489c342bdda3e98344fce717f2ff67 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/delete-cookies.png?w=560&maxW=384&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c72a689508a1bb34a6d17de3c5430a18 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/delete-cookies.png?w=840&maxW=384&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9d232322ae4413d4c022f640602009b5 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/delete-cookies.png?w=1100&maxW=384&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c605bdaa8db16eb6241044a66d0804f9 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/delete-cookies.png?w=1650&maxW=384&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=49f90eddbf9a0a42b1e1b8da0a683f8e 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/delete-cookies.png?w=2500&maxW=384&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=bb11a07a2687da4e884d5ecf91e3da33 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="该扩展程序是否可以在隐身模式下运行？">
    > **是！**

    Bright Data 扩展程序在常规模式和隐身模式下均适用。

    要在 Chrome 上启用隐身支持，请执行以下操作：

    * 在 chrome 地址栏中输入 chrome://extensions
    * 确保勾选允许隐身

        <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/allow-in-incognito.gif?maxW=1536&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c9ef055f21e29333f0b89f6cf9a4747f" alt="allow-in-incognito.gif" width="1536" height="990" data-path="images/scraping-automation/browser-extension/faqs/allow-in-incognito.gif" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/allow-in-incognito.gif?w=280&maxW=1536&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=4a5ad28c8f7cb75f2913e0aea86f8bc1 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/allow-in-incognito.gif?w=560&maxW=1536&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8f1f01391a4f52ee913f4b354a9f7810 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/allow-in-incognito.gif?w=840&maxW=1536&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=ed5a9099d2fb0b08dd206c52095d8ed5 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/allow-in-incognito.gif?w=1100&maxW=1536&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=6a071bfec063336aae32e5a5692f7d8e 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/allow-in-incognito.gif?w=1650&maxW=1536&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=6a3cd500adb7fff1ee45da72ecdca484 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/allow-in-incognito.gif?w=2500&maxW=1536&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=fd110a9d9e9e782b577a47f0f5add143 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="何时应使用自定义标头？">
    自定义标头主要是为了使请求更加具体。当您需要将自定义参数与请求一起传递到目标站点时，您应该使用它。每个标头都应包含名称和值，您可以根据需要添加任意数量的标头。
  </Accordion>

  <Accordion title="为什么我在安装扩展程序时收到“错误”消息？">
    安装扩展程序时出现代理错误的原因可能是：

    * 未选择区域。确保正确填写表格。
    * 您的账户已被“禁用”。您可以在控制面板上轻松查看此信息: [https://brightdata.com/cp](https://brightdata.com/cp)
    * 您的余额为负数。请在您的账单部分查看此信息。[Billing](https://brightdata.com/cp/billing)
    * Bright Data 网络状态问题。您可以在此处查看网络在线状态: [https://brightdata.com/cp/status](https://brightdata.com/cp/status)
  </Accordion>

  <Accordion title="该扩展程序可以与Browser API配合使用吗？">
    不可以。Browser API 不是代理产品，不兼容扩展程序。
  </Accordion>

  <Accordion title="多台机器是否可以在同一个账户上使用该扩展程序？">
    是。登录同一账户的扩展程序数量没有限制。
  </Accordion>

  <Accordion title="我是否可以在不提供我的账户凭据的情况下让其他人使用该扩展程序？">
    > **是！**

    他们需要转到扩展程序安装页面并使用您希望他们访问的区域的客户名称、区域名称和区域密钥登录。他们需要转到扩展程序安装页面并使用您希望他们访问的区域的客户名称、区域名称和区域密钥登录。所有区域信息均可在区域部分中找到。 [extension setup page](https://brightdata.com/cp/bext), [Zones](https://brightdata.com/cp/zones)

    您也可以使用此链接来自动插入访客登录凭据：

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

  <Accordion title="如何使用 Bright Data 扩展程序授予电子邮箱访问权限？">
    此工作流程与在与浏览器集成时允许访问代理管理器有关。通过更新代理管理器的配置文件来授予访问权限。

    这可以通过发送下一个 API 命令来完成：

    ```sh
    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. 将 `remote-server-IP` 更改为安装代理管理器的服务器 IP地址，如果是本地安装，则更改为 `127.0.0.1`。
    2. 将 `account_ID` 更改为您在设置页面上的账户 ID [settings page](https://brightdata.com/cp/setting/customer_details)
    3. 将 `zone`, `zone_password`更改为区域页面的相关访问参数: [https://brightdata.com/cp/zones](https://brightdata.com/cp/zones)
    4. 将 `email` 更改为用户的电子邮箱。

    命令发送后，一封包含说明和凭据的详细电子邮件将发送至 `email`。

    在 API 输出中，还提供用户的密码以及端口号等附加信息。可以在下一个示例中查看：
        <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/user-credentials.png?maxW=591&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3eeab823ea3fa182ee54bf7aeeccb91a" alt="user-credentials.png" width="591" height="58" data-path="images/scraping-automation/browser-extension/faqs/user-credentials.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/user-credentials.png?w=280&maxW=591&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=eec9dba34f14a8099ac60cef603dc921 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/user-credentials.png?w=560&maxW=591&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b3e505d373e5f5ba6277723d182b6e65 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/user-credentials.png?w=840&maxW=591&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=51a4b6fca0c4ac70d1d47f1c6ffbdbf4 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/user-credentials.png?w=1100&maxW=591&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b97c276beb4d3668804f4a208511939b 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/user-credentials.png?w=1650&maxW=591&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e7d88cda19ce54d78b3782c295b0ea5e 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/user-credentials.png?w=2500&maxW=591&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f8ad4ebddfc26e7c82b409c11f810771 2500w" data-optimize="true" data-opv="2" />

    用户现在可以通过安装扩展程序来访问代理。[extension](https://brightdata.com/products/proxy-browser-extension).

    5. 安装后，选择“通过代理管理器连接”
       <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/connect-through-proxy-manager.png?maxW=315&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f7ce887f695365f8c2e6a3f7eeb1b2fd" alt="connect-through-proxy-manager.png" width="315" height="437" data-path="images/scraping-automation/browser-extension/faqs/connect-through-proxy-manager.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/connect-through-proxy-manager.png?w=280&maxW=315&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e4f5357b67bddb701efc21b9e6dede79 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/connect-through-proxy-manager.png?w=560&maxW=315&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=fead9b92acc0b725f7aa4a819d460f8f 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/connect-through-proxy-manager.png?w=840&maxW=315&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=2d28b97a9e2b8f66b578f19e28accf4a 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/connect-through-proxy-manager.png?w=1100&maxW=315&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c8bfa5e0feeae9d2113ad080081046a7 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/connect-through-proxy-manager.png?w=1650&maxW=315&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=720756ef37d8323547803b1e61b8225c 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/connect-through-proxy-manager.png?w=2500&maxW=315&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=22e91bbc0edf60cfda59605efe574006 2500w" data-optimize="true" data-opv="2" />

    6. 输入代理管理器服务器的IP地址以及相关的端口，例如：
       <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/proxy-manager-ip.png?maxW=319&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=0d06064f21fa7cb11c9675a9e99d400b" alt="proxy-manager-ip.png" width="319" height="425" data-path="images/scraping-automation/browser-extension/faqs/proxy-manager-ip.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/proxy-manager-ip.png?w=280&maxW=319&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b2fda9bc02a84316986894993901a323 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/proxy-manager-ip.png?w=560&maxW=319&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=247c256364188cc1bf4a9969d4099f62 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/proxy-manager-ip.png?w=840&maxW=319&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=057a2eaa0b78f71b8ac07ed3f17d8ed9 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/proxy-manager-ip.png?w=1100&maxW=319&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=76fde0a7b4e43fa53df49804049ad3a9 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/proxy-manager-ip.png?w=1650&maxW=319&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=0e9d2d603eb561c1c07a46d3cfeaa878 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/proxy-manager-ip.png?w=2500&maxW=319&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=1ff2dac19b93be1f42cb2121c829d8d9 2500w" data-optimize="true" data-opv="2" />

    7. 选择“完成”。然后，点击“登录”。
       <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/sign-in.png?maxW=463&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a23274bdeefdb9bd195bdd7de2f2ed21" alt="sign-in.png" width="463" height="59" data-path="images/scraping-automation/browser-extension/faqs/sign-in.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/sign-in.png?w=280&maxW=463&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9056ccead745f1304e5fc01e9686bc20 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/sign-in.png?w=560&maxW=463&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b019e6c32aeb44d2041f4e08fcadfb96 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/sign-in.png?w=840&maxW=463&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=70e391e1965ba4c0a1b09d3e150455aa 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/sign-in.png?w=1100&maxW=463&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=159a4b8b828e3fa5a9a566e5f56c465e 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/sign-in.png?w=1650&maxW=463&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e4f411239d827bc79ea66ad028e008ee 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/sign-in.png?w=2500&maxW=463&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=4d86609e79ccad4d0efbe6c3b93a07d4 2500w" data-optimize="true" data-opv="2" />

    8. 输入收到的凭据。
  </Accordion>
</AccordionGroup>


# 功能
Source: https://docs.brightdata.com/cn/scraping-automation/browser-extension/features



{/*tags:bext*/}

扩展中有哪些功能可用？

Bright Data 代理浏览器扩展支持数据中心和固定 IP 浏览，允许您从任何国家进行搜索。 您可以调整用户代理，自定义 DNS 配置以最大限度地提高判断能力或速度，以及设置随机 IP 切换。


# 如何安装扩展程序
Source: https://docs.brightdata.com/cn/scraping-automation/browser-extension/install

了解如何安装Bright Data扩展程序：下载、添加到Chrome、将其固定在工具栏上，然后登录您的Bright Data账户，即可开始使用。

{/*tags:bext*/}

<Info>确保您有Bright Data账户，或在brightdata.com中创建新的brightdata.com账户</Info>

<Steps>
  <Step title="登录" />

  <Step title="下载扩展程序">
    您可以在这里找到扩展链接:\
    [https://chromewebstore.google.com/u/1/detail/bright-data/efohiadmkaogdhibjbmeppjpebenaool?hl=en](https://chromewebstore.google.com/u/1/detail/bright-data/efohiadmkaogdhibjbmeppjpebenaool?hl=en)
  </Step>

  <Step title="添加到Chrome" />

  <Step title="进入浏览器设置中的“管理扩展程序”" />

  <Step title="确保扩展程序已打开，然后转到“详细信息”" />

  <Step title="打开“固定到工具栏”" />

  <Step title="“固定到工具栏”打开后，就可以在工具栏中看到Bright Data图标" />

  <Step title="登录您的账户">
    激活Bright Data账户后，点击“登录您的账户”，新的控制面板选项卡就会打开，请在其中键入您的凭据。
  </Step>

  <Step title="点击扩展程序图标打开扩展程序，即可使用。" />
</Steps>


# 简介
Source: https://docs.brightdata.com/cn/scraping-automation/browser-extension/introduction

了解 Bright Data 的浏览器扩展程序

{/*tags:bext*/}

我们的扩展程序可使您以最少的设置使用浏览器中的 Bright Data

<Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/introduction/introduction.gif?maxW=1912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c0774947202f78f32fd9877c84272450" alt="标题" width="1912" height="986" data-path="images/scraping-automation/browser-extension/introduction/introduction.gif" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/introduction/introduction.gif?w=280&maxW=1912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=29bfe25fde142ee2de7637f192185448 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/introduction/introduction.gif?w=560&maxW=1912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=493094e32b0033bcd83607dfd66e5e70 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/introduction/introduction.gif?w=840&maxW=1912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=0e3585304be574be00b24a2b3a554410 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/introduction/introduction.gif?w=1100&maxW=1912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a6f4d40cdc723ae2968755930ff8c3b4 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/introduction/introduction.gif?w=1650&maxW=1912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=38ed06f8467c5c6fa6729c8a1dcad5e6 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/introduction/introduction.gif?w=2500&maxW=1912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3dda4bfcdf4bdf5134b88002feba8cb7 2500w" data-optimize="true" data-opv="2" />
</Frame>


# 快速入门
Source: https://docs.brightdata.com/cn/scraping-automation/browser-extension/quickstart



{/*tags:bext*/}

## 如何开始使用扩展程序：

1. 要开始使用我们的扩展程序，需要确保您的 Bright Data 账户中“我的代理” 页面或“添加新区域”中至少有 1 个活跃区域。有关区域创建的更多详情，请访问我们的数据中心、 ISP、 住宅和移动指南。

<Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/active-proxy.png?maxW=1283&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8486b59d2860c4c281baca5538de7ab6" alt="" width="1283" height="237" data-path="images/scraping-automation/browser-extension/quickstart/active-proxy.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/active-proxy.png?w=280&maxW=1283&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=48fdc86467d665446cdfa98485120948 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/active-proxy.png?w=560&maxW=1283&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c123ddd61545faabd421fa833d5228d7 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/active-proxy.png?w=840&maxW=1283&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=28029ca39931e9a4019a38208294dfdc 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/active-proxy.png?w=1100&maxW=1283&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=40af0fd8eae6b5297d0a59c03a9475f7 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/active-proxy.png?w=1650&maxW=1283&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=0d951bcecb582bf9129b4877b2f01106 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/active-proxy.png?w=2500&maxW=1283&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b716a544c50f6ecdefd0cd9301e5028c 2500w" data-optimize="true" data-opv="2" />
</Frame>

2. 在扩展程序中选择您想要使用的区域：

<Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-the-zone.png?maxW=398&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=40b8f73697e7cb8272fffdbd79af17cd" alt="" width="398" height="538" data-path="images/scraping-automation/browser-extension/quickstart/select-the-zone.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-the-zone.png?w=280&maxW=398&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=92e57e36cb327cd8e98ee88b3433799f 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-the-zone.png?w=560&maxW=398&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=5afafeb0cb4ef72ced33fcfbfede77b7 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-the-zone.png?w=840&maxW=398&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=16b22564fdf99f235d09f158e1226031 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-the-zone.png?w=1100&maxW=398&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=341a7249590f8bd57b5effba04a8fa07 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-the-zone.png?w=1650&maxW=398&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=632fa7d0296da0be40f547c862439717 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-the-zone.png?w=2500&maxW=398&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=7fb630ff14f5a685c95e0ac107be75f8 2500w" data-optimize="true" data-opv="2" />
</Frame>

3. 选择或更改国家/地区和城市的地理位置。请注意，可以通过住宅和移动区域选择城市：

<Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-country.png?maxW=385&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3d48b88bca592a985d98e5a0b4eb4548" alt="" width="385" height="562" data-path="images/scraping-automation/browser-extension/quickstart/select-country.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-country.png?w=280&maxW=385&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9c1a423814944c4507ff96aa08a9d593 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-country.png?w=560&maxW=385&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=034022a012b4ab2300cba73e62f2ec5f 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-country.png?w=840&maxW=385&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=bd5a4a5a45af63fa1f0ea5f3ed32005b 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-country.png?w=1100&maxW=385&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=542dee63b0b4814666bcc4e7f0280cd7 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-country.png?w=1650&maxW=385&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=2eec46ed0b624220ba4377be70d10a7f 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-country.png?w=2500&maxW=385&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=73ad73d738d0fda2d786fb3c8b113c5f 2500w" data-optimize="true" data-opv="2" />
</Frame>

4. 打开代理并开始使用：

<Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/turn-on-the-proxy.png?maxW=383&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8e0e754c3c1ebca5fc1554876f091992" alt="" width="383" height="523" data-path="images/scraping-automation/browser-extension/quickstart/turn-on-the-proxy.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/turn-on-the-proxy.png?w=280&maxW=383&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=579e859d8221e88f29c1c5f61becb0d6 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/turn-on-the-proxy.png?w=560&maxW=383&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=dbd9871b4f8e05b99ab27ad1eeaa611a 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/turn-on-the-proxy.png?w=840&maxW=383&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=1a16083d92a3d35b05e22081205e4267 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/turn-on-the-proxy.png?w=1100&maxW=383&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=7d3fe987968cfb0213c19ca6e97d5399 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/turn-on-the-proxy.png?w=1650&maxW=383&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=ad847ad62f1508f09f4a0fb299b55307 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/turn-on-the-proxy.png?w=2500&maxW=383&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=fc121dd21bb32c47108af51775003c74 2500w" data-optimize="true" data-opv="2" />
</Frame>

## 如何启用城市选择：

1. 前往控制面板“我的代理”页面
2. 点击您要启用的区域（住宅/移动）：

<Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/enable-proxy.png?maxW=1409&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=02656492822f27217093157a10c4d4ab" alt="" width="1409" height="280" data-path="images/scraping-automation/browser-extension/quickstart/enable-proxy.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/enable-proxy.png?w=280&maxW=1409&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=51e461a01a267b908ab218babafd370c 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/enable-proxy.png?w=560&maxW=1409&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=310850698d518707d2a353a0a1d5b834 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/enable-proxy.png?w=840&maxW=1409&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=2f2e2bbf0dc47aac11e3fa01741a6149 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/enable-proxy.png?w=1100&maxW=1409&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=bd7103f2fb85613f5cc64923dca37d7f 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/enable-proxy.png?w=1650&maxW=1409&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a09ac32228447a37da9434b1842e6287 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/enable-proxy.png?w=2500&maxW=1409&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=15cfc824f3e86183ed8f4b209996c792 2500w" data-optimize="true" data-opv="2" />
</Frame>

3. 前往地理位置定位，然后选择城市：

<Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/geolocation-targetting.png?maxW=573&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=ddbc932e8d1e69871b3c6ce75c3ae8f6" alt="" width="573" height="292" data-path="images/scraping-automation/browser-extension/quickstart/geolocation-targetting.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/geolocation-targetting.png?w=280&maxW=573&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c047a34a65c6e192eeea5420cb77f59b 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/geolocation-targetting.png?w=560&maxW=573&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a016ac077d4266c1f33f5c8aac17967c 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/geolocation-targetting.png?w=840&maxW=573&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3890265fb5d8b8b9e906a92fef5395a4 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/geolocation-targetting.png?w=1100&maxW=573&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=ff7ad9adbccca9a384c0f2d22a1bf7c2 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/geolocation-targetting.png?w=1650&maxW=573&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=56975f0077c44f25c328aec3efdce234 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/geolocation-targetting.png?w=2500&maxW=573&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=43af489ee2dbb92ec346d2443e0b8c2d 2500w" data-optimize="true" data-opv="2" />
</Frame>

4. 保存该区域


# 网络存档 API（测试版）
Source: https://docs.brightdata.com/cn/scraping-automation/data-snapshots-api

了解如何使用网络存档 API（测试版）访问 Bright Data 的缓存并从中检索数据快照，然后通过 Amazon S3 或 webhook 交付数据。

网络存档 API 让您可以顺畅、高效地访问 Bright Data 采集的缓存数据并从中检索数据快照。

<Note>
  如想访问此 API，您需拥有 Bright Data API 令牌 \
  [API key](/cn/general/account/api-token)
</Note>

## 运行搜索请求

要开始搜索我们的网络存档，请使用以下 `/search` 端点。 \
**端点**: `POST api.brightdata.com/webarchive/search`

<Tabs>
  <Tab title="请求">
    ```js 请求
    POST api.brightdata.com/webarchive/search
    {
        filters: {
            max_age?: Duration,
            min_date?: yyyy-mm-dd,
            max_date?: yyyy-mm-dd,
            domain_whitelist?: ['example.com'],
            domain_blacklist?: ['example.com'],
            domain_regex_whitelist?: ['.*example..*'],
            domain_regex_blacklist?: ['.*example..*'],
            category_whitelist?: ['Automotive'],
            category_blacklist?: ['Automotive'],
            path_regex_whitelist?: ['.*/products/.*'],
            path_regex_blacklist?: ['.*/products/.*'],
            language_whitelist?: ['eng'], //ISO 639-3 letter language codes
            language_blacklist?: ['eng'],
            ip_country_whitelist?: ['us', 'ie', 'in'],
            ip_country_blacklist?: ['mx', 'ae', 'ca']
        }
    }
    ```
  </Tab>

  <Tab title="响应">
    <CodeGroup>
      ```js 200 OK
      {search_id: <search_id>}
      ```

      ```js 400 Bad 请求
      // Error: example with incorrect filter usage
      {"error": "domain_blacklist cannot be used along with domain_whitelist"}
      ```
    </CodeGroup>
  </Tab>

  <Tab title="代码示例">
    <CodeGroup>
      ```sh Curl
      curl -X POST https://api.brightdata.com/webarchive/search \
        -H "Authorization: Bearer $API_KEY" \
        -H 'Content-Type: application/json' \
        --data '{"filters": {"max_age": "1d", "domain_whitelist": ["example.com"]}}'
      ```

      ```python Python
      import requests
      import json

      # Configuration
      BRIGHT_DATA_API_KEY = '$Enter_API_Key'
      BASE_URL = 'https://api.brightdata.com'
      WEBHOOK_URL = 'https://my-domain/webhook?id=XXX'

      HEADERS = {
          'Content-Type': 'application/json',
          'Authorization': f'Bearer {BRIGHT_DATA_API_KEY}'
      }

      def run_search():
          url = f'{BASE_URL}/webarchive/search'
          payload = {
              'filters': {
                  'max_age': '7d',
                  'language_whitelist': ['jpn'], #ISO 639-3 letter language codes
                  'category': 'Education'
                  'domain_regex_whitelist': ['.*.google..*']
              }
          }
          
          response = requests.post(url, headers=HEADERS, json=payload)
          try:
              response.raise_for_status()
              return response.json()
          except requests.exceptions.HTTPError as http_err:
              print(f"HTTP error occurred: {http_err}")
              print(f"响应 Content: {response.text}")
              return None
          except requests.exceptions.请求Exception as req_err:
              print(f"请求 error occurred: {req_err}")
              print(f"响应 Content: {response.text if response else 'No response content'}")
              return None
          except ValueError:
              print("响应 content is not valid JSON")
              return None

      def main():
          search_response = run_search()
          if search_response:
              print(f"搜索 响应: {json.dumps(search_response, indent=2)}")
          else:
              print("搜索 failed.")

      if __name__ == "__main__":
          main()
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Dictionary">
    Here is a brief explanation of each of the parameters you are able to use in your requests:

    | Parameter              | Description                                                               |
    | ---------------------- | ------------------------------------------------------------------------- |
    | max\_age               | Limits results to records collected within a specified time range.        |
    | min\_date              | Returns records collected on or after the specified date.                 |
    | max\_date              | Returns records collected on or before the specified date.                |
    | domain\_whitelist      | Includes results only from listed domains.                                |
    | domain\_blacklist      | Excludes results from listed domains.                                     |
    | category\_whitelist    | Includes results from specified categories.                               |
    | category\_blacklist    | Excludes results from specified categories.                               |
    | path\_regex\_whitelist | Includes results matching the specified path regex.                       |
    | path\_regex\_blacklist | Excludes results matching the specified path regex.                       |
    | language\_whitelist    | Includes results for specific language codes (ISO 639-3).                 |
    | language\_blacklist    | Excludes results for specific language codes.                             |
    | ip\_country\_whitelist | Includes results collected through IPs or peers from specified countries. |
    | ip\_country\_blacklist | Excludes results collected through IPs or peers from specified countries. |
  </Tab>
</Tabs>

<Note>
  Your search cannot cover a date range of more than 7d. If you need to query a longer period than this, please contact your account manager.
</Note>

<Note>
  You can run 5 searches per day without triggering a dump.
  Once you trigger a dump, that search no longer count against your limit.
</Note>

## 获取搜索状态

查看已进行的特定查询的状态。 \
**端点**: `GET api.brightdata.com/webarchive/search/<search_id>`

调用成功后它将检索：

* 您查询的条目数量
* 完整数据快照的大小和成本的估算值

<Tabs>
  <Tab title="请求">
    ```js
    GET api.brightdata.com/webarchive/search/<search_id>
    ```
  </Tab>

  <Tab title="响应">
    <Note>
      The status code of all three following responses is `200 OK`
    </Note>

    <CodeGroup>
      ```js Pending
      {
          search_id: "ID",
          status: "in_progress"
      }
      ```

      ```js Success
      {
          search_id: "ID",
          status: "done",
          files_count: 12341294,
          estimate_batch_count: 130,
          estimate_batch_bytes: 153151351,
          cpm_cost_usd: 0.02, // example cost per CPM
          dump_cost_usd: 100 // example total cost 
      }
      ```

      ```js Failed
      {
          search_id: "ID",
          status: "failed",
          error: "Path regex filter caused non-retryable error"
      }
      ```
    </CodeGroup>
  </Tab>

  <Tab title="代码示例">
    <CodeGroup>
      ```sh Curl
      curl https://api.brightdata.com/webarchive/search/$SEARCH_ID \
        -H "Authorization: Bearer $API_KEY"
      ```

      ```python Python
      import requests
      import json

      # Configuration
      BRIGHT_DATA_API_KEY = '$Enter_API_Key'
      BASE_URL = 'https://api.brightdata.com'

      HEADERS = {
          'Authorization': f'Bearer {BRIGHT_DATA_API_KEY}'
      }

      def get_search_status(search_id):
          url = f'{BASE_URL}/webarchive/search/{search_id}'
          response = requests.get(url, headers=HEADERS)
          try:
              response.raise_for_status()
              return response.json()
          except requests.exceptions.HTTPError as http_err:
              print(f"HTTP error occurred: {http_err}")
              return None
          except requests.exceptions.请求Exception as req_err:
              print(f"请求 error occurred: {req_err}")
              return None
          except ValueError:
              print("响应 content is not valid JSON")
              return None

      def main():
          search_id = input("Enter the search ID: ")
          status_response = get_search_status(search_id)
          
          if status_response:
              print(f"Status 响应: {json.dumps(status_response, indent=2)}")
          else:
              print("Failed to retrieve search status.")

      if __name__ == "__main__":
          main()
      ```
    </CodeGroup>
  </Tab>
</Tabs>

## 获取所有搜索状态

检查当前所有搜索的状态。 \
**Endpoint**: `GET api.brightdata.com/webarchive/searches`

<Tabs>
  <Tab title="请求">
    ```js
    GET api.brightdat.com/webarchive/searches
    ```
  </Tab>

  <Tab title="响应">
    ```js 200 OK
    [
        {
            search_id: "ID",
            status: "in_progress"
        },
        {
            search_id: "ID",
            status: "done"
        },
        // ... + rest of the searches and status
    }
    ```
  </Tab>

  <Tab title="代码示例">
    ```sh Curl
    curl https://api.brightdata.com/webarchive/searches \
      -H "Authorization: Bearer $API_KEY"
    ```
  </Tab>
</Tabs>

## 将快照传送至 Amazon S3 Storage

<Note>
  要使用 S3 存储服务交付数据，您首先需要执行以下操作：

  * 创建一个可访问 Bright Data 系统的 AWS 角色: [https://docs.aws.amazon.com/IAM/latest/UserGuide/id\_roles\_create\_for-user\_externalid.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user_externalid.html)
    * 在此设置过程中，Amazon 会要求您提供与该角色一起使用的“外部 ID”。
    * 您的 S3 外部 ID 就是您的 Bright Data 账户 ID，可在“账户设置”中找到: [https://brightdata.com/cp/setting/customer\_details](https://brightdata.com/cp/setting/customer_details)
  * 创建角色后，您需允许我们的系统交付角色通过 AssumeRole 操作访问该角色。
    * 我们的系统交付角色是：arn:aws:iam::422310177405:role/brd.ec2.zs-dca-delivery
</Note>

要将特定 `search_id` 中的特定快照传送至 S3 存储服务平台，请使用以下 `/dump` 端点。\
**Endpoint**: `POST api.brightdata.com/webarchive/dump`

<Tabs>
  <Tab title="请求">
    <CodeGroup>
      ```js POST
      POST api.brightdata.com/webarchive/dump
      {
          search_id: <search_id>,
          max_entries?: 1000000, // (optional) limit how many files you purchase
          delivery: {
              strategy: 's3',
      	    settings: {
                  bucket: <your_bucket_name>,
                  assume_role: {
                      role_arn: <role_you_created_above>,
                  },
              },
          },
      }

      ```
    </CodeGroup>
  </Tab>

  <Tab title="响应">
    ```js 200 OK
    {dump_id: <dump_id>}
    ```
  </Tab>

  <Tab title="代码示例">
    <CodeGroup>
      ```sh Curl
      curl -X POST https://api.brightdata.com/webarchive/dump \
        -H "Authorization: Bearer $API_KEY" \
        -H 'Content-Type: application/json' \
        --data @- <<EOF
      {
          "search_id": "$SEARCH_ID",
          "max_entries": 1000000,
          "delivery": {
              "strategy": "s3",
      	    "settings": {
                  "bucket": "$YOUR_BUCKET_NAME",
                  "assume_role": {
                      "role_arn": "$YOUR_DELIVERY_ROLE"
                  }
              }
          }
      }
      EOF
      ```

      ```python Python
      import requests
      import json

      # Configuration
      BRIGHT_DATA_API_KEY = '$Enter_API_Key'
      BASE_URL = 'https://api.brightdata.com'

      HEADERS = {
          'Authorization': f'Bearer {BRIGHT_DATA_API_KEY}',
          'Content-Type': 'application/json'
      }

      def get_search_status(search_id):
          url = f'{BASE_URL}/webarchive/search/{search_id}'
          response = requests.get(url, headers=HEADERS)
          try:
              response.raise_for_status()
              return response.json()
          except requests.exceptions.HTTPError as http_err:
              print(f"HTTP error occurred: {http_err}")
              return None
          except requests.exceptions.请求Exception as req_err:
              print(f"请求 error occurred: {req_err}")
              return None
          except ValueError:
              print("响应 content is not valid JSON")
              return None

      def deliver_snapshot_to_s3(search_id, bucket_name, role_arn, max_entries=1000000):
          url = f'{BASE_URL}/webarchive/dump'
          payload = {
              'search_id': search_id,
              'max_entries': max_entries,
              'delivery': {
                  'strategy': 's3',
                  'settings': {
                      'bucket': bucket_name,
                      'assume_role': {
                          'role_arn': role_arn,
                      },
                  },
              },
          }
          
          response = requests.post(url, headers=HEADERS, data=json.dumps(payload))
          try:
              response.raise_for_status()
              return response.json()
          except requests.exceptions.HTTPError as http_err:
              print(f"HTTP error occurred: {http_err}")
              return None
          except requests.exceptions.请求Exception as req_err:
              print(f"请求 error occurred: {req_err}")
              return None
          except ValueError:
              print("响应 content is not valid JSON")
              return None

      def main():
          search_id = input("Enter the search ID: ")
          bucket_name = 'some-customer-provided-bucket-name-in-us-east-1'
          role_arn = 'some-customer-provided-aws-role-with-write-access-to-s3-bucket'
          
          status_response = get_search_status(search_id)
          
          if status_response:
              print(f"Status 响应: {json.dumps(status_response, indent=2)}")
              delivery_response = deliver_snapshot_to_s3(search_id, bucket_name, role_arn)
              if delivery_response:
                  print(f"Delivery 响应: {json.dumps(delivery_response, indent=2)}")
              else:
                  print("Failed to deliver snapshot to S3.")
          else:
              print("Failed to retrieve search status.")

      if __name__ == "__main__":
          main()
      ```
    </CodeGroup>
  </Tab>
</Tabs>

## 通过 Webhook 采集快照

通过 Webhook 从特定的 `search_id` 采集数据快照

**端点**: `POST api.brightdata.com/cache/dump`

<Tabs>
  <Tab title="请求">
    ```js
    {
        search_id: <search_id>,
        max_entries?: 1000000,
        delivery: {
    		strategy: 'webhook',
    		settings: {
                 url: string(),
                 auth?: string(), // will be added as an Authorization header
            },
        }
    }
    ```
  </Tab>

  <Tab title="响应">
    ```js 200 OK
    {"dump_id": <dump_id>}
    ```
  </Tab>

  <Tab title="代码示例">
    <CodeGroup>
      ```sh Curl
      curl -X POST https://api.brightdata.com/webarchive/dump \
        -H "Authorization: Bearer $API_KEY" \
        -H 'Content-Type: application/json' \
        --data @- <<EOF
      {
          "search_id": "$SEARCH_ID",
          "max_entries": 1000000,
          "delivery": {
              "strategy": "webhook",
      	    "settings": {
                  "url": "$YOUR_WEBHOOK_URL"
              }
          }
      }
      EOF
      ```

      ```python Python
      import requests
      import json

      # Configuration
      BRIGHT_DATA_API_KEY = '$Enter_API_Key'
      BASE_URL = 'https://api.brightdata.com'

      HEADERS = {
          'Authorization': f'Bearer {BRIGHT_DATA_API_KEY}',
          'Content-Type': 'application/json'
      }

      def get_search_status(search_id):
          url = f'{BASE_URL}/webarchive/search/{search_id}'
          response = requests.get(url, headers=HEADERS)
          try:
              response.raise_for_status()
              return response.json()
          except requests.exceptions.HTTPError as http_err:
              print(f"HTTP error occurred: {http_err}")
              return None
          except requests.exceptions.请求Exception as req_err:
              print(f"请求 error occurred: {req_err}")
              return None
          except ValueError:
              print("响应 content is not valid JSON")
              return None

      def deliver_snapshot_to_webhook(search_id, webhook_url, max_entries=1000000):
          url = f'{BASE_URL}/webarchive/dump'
          payload = {
              'search_id': search_id,
              'max_entries': max_entries,
              'delivery': {
                  'strategy': 'webhook',
                  'settings': {
                      'url': webhook_url
                  },
              },
          }
          
          response = requests.post(url, headers=HEADERS, data=json.dumps(payload))
          try:
              response.raise_for_status()
              return response.json()
          except requests.exceptions.HTTPError as http_err:
              print(f"HTTP error occurred: {http_err}")
              return None
          except requests.exceptions.请求Exception as req_err:
              print(f"请求 error occurred: {req_err}")
              return None
          except ValueError:
              print("响应 content is not valid JSON")
              return None

      def main():
          search_id = input("Enter the search ID: ")
          webhook_url = 'https://example.com/webhook'
          status_response = get_search_status(search_id)
          if status_response:
              print(f"Status 响应: {json.dumps(status_response, indent=2)}")
              delivery_response = deliver_snapshot_to_webhook(search_id, webhook_url)
              if delivery_response:
                  print(f"Delivery 响应: {json.dumps(delivery_response, indent=2)}")
              else:
                  print("Failed to deliver snapshot to S3.")
          else:
              print("Failed to retrieve search status.")

      if __name__ == "__main__":
          main()
      ```
    </CodeGroup>
  </Tab>
</Tabs>

## 获取数据快照的状态

使用 dump\_id 查看特定数据快照（转储）的状态。 \
**端点**: `GET api.brightdata.com/webarchive/dump/<dump_id>`

<Tabs>
  <Tab title="请求">
    ```js
    GET api.brightdata.com/webarchive/dump/<dump_id>
    ```
  </Tab>

  <Tab title="响应">
    <Note>
      The status code of all three following responses is `200 OK`
    </Note>

    <CodeGroup>
      ```js In progress
      {
          dump_id: <id>,
          status: 'in_progress',
          batches_total: 130,
          batches_uploaded: 29,
          files_total: 1241241251,
          estimate_finish: ISODate
      }
      ```

      ```js Finished
      {
          dump_id: <id>,
          status: 'done',
          batches_total: 130,
          files_total: 1241241251,
          files_uploaded: 2412515,
          completed_at: Date
      }
      ```

      ```js Failed
      {
          dump_id: <id>,
          status: 'failed',
          error: 'Designated delivery path not responding'
      }
      ```
    </CodeGroup>
  </Tab>

  <Tab title="代码示例">
    ```sh Curl
    curl https://api.brightdata.com/webarchive/dump/$DUMP_ID \
      -H "Authorization: Bearer $API_KEY"
    ```
  </Tab>
</Tabs>

## 获取所有数据快照的状态

**端点**: `GET api.brightdata.com/webarchive/dumps`

<Tabs>
  <Tab title="响应">
    ```js 200 OK
    [
        {
            dump_id: 'ID',
            status: 'in_progress',
            batches_total: 130,
            batches_uploaded: 29,
            files_total: 1241241251,
            estimate_finish: Date
        },
        {
            dump_id: 'ID',
            status: 'done',
            batches_total: 130,
            files_total: 1241241251,
            files_uploaded: 2412515,
            completed_at: Date
        }
        // ... rest of the dumps
    ]
    ```
  </Tab>

  <Tab title="代码示例">
    ```sh Curl
    curl https://api.brightdata.com/webarchive/dumps \
      -H "Authorization: Bearer $API_KEY"
    ```
  </Tab>
</Tabs>

## High-level process flow diagram

<img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/webarchive/webarchive-flow.png?maxW=777&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=da03ee353d3b42f1fe6e8c37bc9fec60" alt="flow diagram" width="777" height="782" data-path="images/api-reference/webarchive/webarchive-flow.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/webarchive/webarchive-flow.png?w=280&maxW=777&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b737b1ca56dcc5dd59ae67b20ae23189 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/webarchive/webarchive-flow.png?w=560&maxW=777&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b1812060d598233a18b22e1913cc0de2 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/webarchive/webarchive-flow.png?w=840&maxW=777&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=54cd34bdd22b3085f07446b781b8528d 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/webarchive/webarchive-flow.png?w=1100&maxW=777&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=8e62fec5fe9023de1c60df566e3d8816 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/webarchive/webarchive-flow.png?w=1650&maxW=777&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=3e1e7f9245566656e3f7f5b7c1c862d1 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/webarchive/webarchive-flow.png?w=2500&maxW=777&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=656dd7273351b1310f32b92f0be8f291 2500w" data-optimize="true" data-opv="2" />


# 常见问题解答
Source: https://docs.brightdata.com/cn/scraping-automation/easy-scraper/faqs



<AccordionGroup>
  <Accordion title="Easy Scraper 是什么？">
    Easy Scraper 是一款用户友好的数据收集工具，允许用户使用预定义的抓取工具从各种在线平台收集信息。它旨在简化抓取过程，方便具有极少专业技术知识的用户使用。
  </Accordion>

  <Accordion title="如何开始使用 Easy Scraper？">
    开始使用时，首先登录您的账户，导航到 Easy Scraper 部分，选择一种抓取工具，输入您的参数，然后运行该抓取工具。然后您就能以首选格式获取数据。
  </Accordion>

  <Accordion title="如何使用 Easy Scraper？">
    使用 Easy Scraper 时，选择一种抓取工具，添加输入内容，必要时设置结果限制，选择存储数据的位置，然后开始收集。您可以从“日志”选项卡监控和检索数据。
  </Accordion>

  <Accordion title="各种抓取工具之间有何区别？">
    每种抓取工具都专门用于从特定域收集数据。例如，Amazon 产品抓取工具收集产品信息，而 LinkedIn 个人资料抓取工具从 LinkedIn 个人资料收集数据。所需的具体输入内容和收集的数据类型取决于具体域。
  </Accordion>

  <Accordion title="抓取工具有没有什么限制？">
    某些抓取工具可能根据数据源有所限制，例如速率限制或数据访问受限。所有限制将显示在特定的抓取工具页面上，如果在抓取过程中遇到任何限制，系统将通知您。
  </Accordion>

  <Accordion title="Easy Scraper 支持哪些数据格式？">
    Web Scraper API 支持多种格式的数据提取，包括 JSON、NDJSON、JSON Lines 和 CSV。在请求参数中指定您想要的格式。
  </Accordion>

  <Accordion title="Easy Scraper 的费用是多少？">
    我们根据为有效输入内容提供的记录收费。每条记录的费率取决于您的订阅计划。请查看我们的价格计划或您的账户详情，了解具体的费用: [https://brightdata.com/pricing/web-scraper](https://brightdata.com/pricing/web-scraper)
  </Accordion>

  <Accordion title="如何升级订阅计划？">
    如需升级订阅计划，请访问控制面板中的账单部分，然后选择所需计划。如需更多帮助，请联系我们的支持团队。  您可以通过控制面板右上角的问号 (?) 按钮，直接从此链接 [https://brightdata.zendesk.com/hc/en-us/requests/new](https://brightdata.zendesk.com/hc/en-us/requests/new) 或通过发送电子邮件至
  </Accordion>

  <Accordion title="Easy Scraper 的速度有多快？">
    Easy Scraper 的响应时间受目标URL的加载时间和用户定义的页面交互的执行等因素影响。特定的抓取工具页面标注了每种抓取工具的平均响应时间。

    <Frame>
            <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/faqs/response-time-per-input.png?maxW=265&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f62c10ca7a25a57ec6c6b8ed92c1dc18" alt="response-time-per-input.png" width="265" height="103" data-path="images/scraping-automation/easy-scraper/faqs/response-time-per-input.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/faqs/response-time-per-input.png?w=280&maxW=265&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=708c209bcbcbd93dba878f9d5718812b 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/faqs/response-time-per-input.png?w=560&maxW=265&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e72a3782a080a7d5e0c87c5df2614d46 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/faqs/response-time-per-input.png?w=840&maxW=265&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9edacc2e29fac5ec3c14d4139f564fdc 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/faqs/response-time-per-input.png?w=1100&maxW=265&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=1e35cc340d8378a0947e784a20056e12 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/faqs/response-time-per-input.png?w=1650&maxW=265&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=fbddd464cf8b8626a75dd1eb2a30c5bd 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/faqs/response-time-per-input.png?w=2500&maxW=265&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=54040ef80e36009cb13ac726671adf55 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>
</AccordionGroup>


# 产品概述
Source: https://docs.brightdata.com/cn/scraping-automation/easy-scraper/overview



Easy Scraper 是一种即插即用的解决方案，允许用户使用现成的抓取工具轻松地从各个域收集数据。

该产品通过提供直观的控制面板简化了数据收集过程，用户可以在控制面板中选择抓取工具、输入参数、设置收集偏好并以多种格式检索数据。

<Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/overview/initiate-data-collection.png?maxW=2144&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=40f6521a27dd2f0c437c2a68a1a77f86" alt="initiate-data-collection.png" width="2144" height="1158" data-path="images/scraping-automation/easy-scraper/overview/initiate-data-collection.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/overview/initiate-data-collection.png?w=280&maxW=2144&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=24cba02f03503fe8387ba39035e1657b 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/overview/initiate-data-collection.png?w=560&maxW=2144&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=041b9cbb8e1007aadf409ea6d2f59a67 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/overview/initiate-data-collection.png?w=840&maxW=2144&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=32e0ffcdcf211d455a80d03e860c8739 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/overview/initiate-data-collection.png?w=1100&maxW=2144&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=4da5a22bfdeac5bcc583ea25134361f1 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/overview/initiate-data-collection.png?w=1650&maxW=2144&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=42128b20cdb37cc93a4f9097c1369255 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/overview/initiate-data-collection.png?w=2500&maxW=2144&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e9bba95e56c466fadf54f2a9b4f77495 2500w" data-optimize="true" data-opv="2" />
</Frame>

### 限制 文件大小

输入 - 最高 1GB

下载 - 最高5GB（对于更大的文件，请使用API交付）


# Easy Scraper入门指南
Source: https://docs.brightdata.com/cn/scraping-automation/easy-scraper/quickstart



<Steps>
  <Step title="访问控制面板">
    * 导航到控制面板中的 Easy Scraper 部分。.
    * 您将看到一系列可供选择的抓取工具（例如，Amazon产品、Airbnb、Instagram、LinkedIn 等等）。

    <Frame>
            <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/select-target.png?maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=25e44f9994c78d66d478f97bd86f599c" alt="select-target.png" width="624" height="372" data-path="images/scraping-automation/easy-scraper/quickstart/select-target.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/select-target.png?w=280&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=dbe960a1dff63dfbdc7258a0b4ba0e1d 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/select-target.png?w=560&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=7974db53a82ef0fa316e56a33146c796 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/select-target.png?w=840&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=15b1b4e5813c53021c7bee9e34b5e915 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/select-target.png?w=1100&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b1b30f38027de1503fabb4aed2462181 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/select-target.png?w=1650&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=2663a8188b858ded9e265ee1e38b193a 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/select-target.png?w=2500&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=1538b375a22057199a29d6bfb391cfd9 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="选择一种抓取工具">
    * 通过单击相应的抓取工具，选择您想要从中收集数据的域。
  </Step>

  <Step title="输入参数">
    * 输入所需的输入内容（例如关键字、URL或其他特定搜索参数，具体取决于所选的抓取工具）。

    <Frame>
            <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/instagram-posts.png?maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=6bc1255153e7c1303b16df6f0e8ee7e5" alt="instagram-posts.png" width="624" height="383" data-path="images/scraping-automation/easy-scraper/quickstart/instagram-posts.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/instagram-posts.png?w=280&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=d176c9c3af6e83fdc3e94c20be5d8a88 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/instagram-posts.png?w=560&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b9c085ecfbeaead6e5605af9e61e3721 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/instagram-posts.png?w=840&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=5f29f5c089be396828ca1051ea199f3c 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/instagram-posts.png?w=1100&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c18ecf21bd49b326b7933136c686ad5e 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/instagram-posts.png?w=1650&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b3f0c406e8113a6cf69c9b22b4f39e86 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/instagram-posts.png?w=2500&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9633919aec7a17941e33fa4cd027cfd2 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="设置结果限制">
    * 您可以选择性设置想要收集的结果数量的限制。如果没有设置限制，那么抓取工具将收集尽可能多的数据。
  </Step>

  <Step title="运行并监控">
    * 单击“开始收集”按钮开始数据收集过程。
    * 您将被定向至日志选项卡，在此您可以追踪抓取任务的进度并查看详细信息，例如快照ID、数据集名称、时间戳、状态、收集时间、记录数、文件大小以及任何错误。
  </Step>

  <Step title="检索数据">
    * 数据收集完成后，可以以所需格式下载

    1. `JSON`
    2. `CSV`
    3. `NDJSON`
    4. `JSON lines`

    <Frame>
            <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/retrieve-data.png?maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=41d165c3b67eaaf2c5b6e097c72b4453" alt="retrieve-data.png" width="624" height="55" data-path="images/scraping-automation/easy-scraper/quickstart/retrieve-data.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/retrieve-data.png?w=280&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=39eaf639a6d155e8b71d33c37d737f53 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/retrieve-data.png?w=560&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=dd674694ad4217b62e6bcf803f01ed26 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/retrieve-data.png?w=840&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=7b6d28a891dd3a5740a0a3463a569d46 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/retrieve-data.png?w=1100&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=39aa0f10dacd84269ffeac492e86e932 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/retrieve-data.png?w=1650&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a9c2e9579ae0778c326bb0a5366a9276 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/retrieve-data.png?w=2500&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=0d41785c949b0160a9aaecddfd89359b 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>
</Steps>


# 抓取自动化产品常见问题解答
Source: https://docs.brightdata.com/cn/scraping-automation/faqs

查找有关集成、配置和使用 Bright Data 自动化搜索的常见问题的解答，包括 IP 类型、地理定位和错误代码。

<AccordionGroup>
  <Accordion title="怎样才能避免被 Cloudflare 屏蔽？">
    要从使用 Cloudflare 的网站上抓取数据，我们建议使用我们的 [Unlocker API](https://docs.brightdata.com/cn/scraping-automation/web-unlocker/introduction) 或 [Browser API](https://docs.brightdata.com/cn/scraping-automation/scraping-browser/introduction) 解决方案。

    这两种解决方案使用不同的方法（如验证码解密、自定义指纹和标头），可以轻松突破 Cloudflare。

    如果只需从网站获取 HTML，而无需在页面上进行任何交互，建议使用 [Unlocker API](https://docs.brightdata.com/cn/scraping-automation/web-unlocker/introduction)。

    如果需要与页面进行交互（例如，填写表格、点击按钮等），则推荐使用 [Browser API](https://docs.brightdata.com/cn/scraping-automation/scraping-browser/introduction)。

    在这两种情况下，即使页面使用了 Cloudflare，您也可以访问页面上所需的信息。
  </Accordion>

  <Accordion title="How can I avoid getting blocked by Datadome?">
    To scrape data from sites that use Datadome, we recommend using our [Unlocker API](https://docs.brightdata.com/cn/scraping-automation/web-unlocker/introduction) or [Browser API](https://docs.brightdata.com/cn/scraping-automation/scraping-browser/introduction) solutions.

    这两种解决方案使用不同的方法（如验证码解密、自定义指纹和标头），可以轻松突破 Cloudflare。

    [Unlocker API](https://docs.brightdata.com/cn/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](https://docs.brightdata.com/cn/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>
</AccordionGroup>


# Bright Data's 抓取解决方案
Source: https://docs.brightdata.com/cn/scraping-automation/introduction



<Card>
  <CardGroup>
    <Card title="网络解锁器" href="/scraping-automation/web-unlocker" icon="lock-open">
      自动绕过验证码、指纹识别和其他反机器人限制，实现无缝的公共网络数据采集
    </Card>

    <Card title="SERP API" href="/scraping-automation/serp-api" icon="magnifying-glass">
      通过 API 查询搜索引擎结果
    </Card>

    <Card title="抓取浏览器" href="/scraping-automation/scraping-browser" icon="window-restore">
      使用具有网站解锁自动化功能的完全托管的浏览器抓取动态网络数据
    </Card>

    <Card title="IDE" href="/scraping-automation/web-scraper-ide" icon="code">
      借助抓取就绪功能、无限扩展和内置解锁代理基础架构，缩短开发时间
    </Card>

    <Card title="浏览器扩展" href="/scraping-automation/browser-extension" icon="location-dot">
      通过任何地理位置和浏览器浏览网页
    </Card>

    <Card title="Bright 盾牌" href="/scraping-automation/bright-shield" icon="shield">
      管理和监控您的抓取合规风险
    </Card>
  </CardGroup>
</Card>


# 自定义 CDP 函数
Source: https://docs.brightdata.com/cn/scraping-automation/scraping-browser/cdp-functions/custom



## 验证码解算器

使用抓取浏览器浏览页面时，默认情况下，我们的集成验证码解算器会自动解算所有验证码 。您可以使用以下自定义 CDP 函数在代码中监控此自动解算过程。

<Note>
  如果您想通过控制面板完全禁用验证码解算器，请参阅我们的禁用验证码解算器功能:\
  [https://docs.brightdata.com/cn/scraping-automation/scraping-browser/features/captcha-solver](https://docs.brightdata.com/cn/scraping-automation/scraping-browser/features/captcha-solver)
</Note>

<Note>
  验证码解算后，如有表单需要提交，则默认情况下会提交。
</Note>

## 验证码解算器 - 自动解算

<AccordionGroup>
  <Accordion title="Captcha.Solve">
    使用此指令返回验证码已解算、失败或未检测到之后的状态。
    使用此指令返回验证码已解算、失败或未检测到之后的状态。

    <CodeGroup>
      ```js Captcha.Solve
      Captcha.Solve({
          detectTimeout?: number // Detect timeout in millisecond for solver to detect captcha  
          options?: CaptchaOptions[] // Configuration options for captcha solving  
      }) : SolveResult
      ```

      ```js SolveResult
      SolveResult : {  
        status: SolveStatus // Detect and solve status  
        type?: string // Detected captcha type  
        error?: string // Error if captcha was not solved  
      }
      ```

      ```js SolveStatus
      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>

    **示例**

    <CodeGroup>
      ```js NodeJS - Puppeteer
      const page = await browser.newPage();
      const client = await page.target().createCDPSession();
      await page.goto('[https://site-with-captcha.com](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 client = await page.target().createCDPSession();  
      const {status} = await client.send('Captcha.Solve', {detectTimeout: 30*1000});   
      console.log(`Captcha solve status: ${status}`)
      ```

      ```python Python - Playwright
      page = await browser.new_page()   
      client = await page.context.new_cdp_session(page)   
      await page.goto('[https://site-with-captcha.com](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  
      client = await page.context.new_cdp_session(page)  
      solve_result = await client.send('Captcha.Solve', { 'detectTimeout': 30*1000 })   
      status = solve_result['status']   
      print(f'Captcha solve status: {status}') 
      ```
    </CodeGroup>

    <Note>
      如果验证码解算失败，请重新尝试。 如果问题仍然存在，请提交支持请求 ，详细说明您遇到的具体问题。
    </Note>
  </Accordion>

  <Accordion title="用于验证码状态的自定义 CDP 指令">
    使用以下指令查明验证码解算流程中更具体的阶段：

    |                         |                 |
    | ----------------------- | --------------- |
    | `Captcha.detected`      | 抓取浏览器遇到验证码并开始解算 |
    | `Captcha.SolveFinished` | 抓取浏览器成功解算验证码    |
    | `Captcha.SolveFailed`   | 抓取浏览器未能解算验证码    |
    | `Captcha.waitForSolve`  | 抓取浏览器等待验证码解算器完成 |

    **示例**

    <Tabs>
      <Tab title="异步">
        以下代码设置 CDP 会话、监听 CAPTCHA 事件并处理超时：

        <CodeGroup>
          ```js NodeJS - Puppeteer
          // 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
          # 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="同步">
        <Warning>
          Selenium doesn't support asynchronous server-driven events like Puppeteer and Playwright.
        </Warning>

        The `Captcha.waitForSolve` command waits for 抓取浏览器's CAPTCHA solver to finish.

        ```python Python - Selenium
        # Python Selenium - Waiting for Captcha to auto-solve after navigate  
        driver.execute('executeCdpCommand', {  
            'cmd': 'Captcha.waitForSolve',  
            'params': {},  
        })
        ```
      </Tab>
    </Tabs>
  </Accordion>
</AccordionGroup>

## 验证码解算器 - 手动控制

如果您想手动配置或完全禁用我们的默认验证码解算器，请改为手动调用解算器或自己解算，请参阅以下 CDP 指令和功能。

<AccordionGroup>
  <Accordion title="Captcha.setAutoSolve">
    此指令用于控制验证码的自动解算。 您可以禁用自动解算或为不同的验证码类型配置算法，然后手动触发此操作：

    <CodeGroup>
      ```js Captcha.setAutoSolve
      Captcha.setAutoSolve({  
        autoSolve: boolean // Whether to automatically solve captcha after navigate  
        options?: CaptchaOptions[] // Configuration options for captcha auto-solving  
      }) : void
      ```

      ```js CaptchaOptions
      CaptchaOptions : {  
        type: string // Captcha type  
        disabled?: boolean // Disable detect and solve for specified captcha  
        ... // additinal options related to captcha type  
      }
      ```
    </CodeGroup>

    在会话中完全禁用自动解算器的 CDP 指令示例：

    <CodeGroup>
      ```js NodeJS - Puppeteer
      // 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
      # 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
      # Python Selenium - Disable Captcha auto-solver completely  
      driver.execute('executeCdpCommand', {  
          'cmd': 'Captcha.setAutoSolve',  
          'params': {'autoSolve': False},  
      })
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="仅针对特定验证码类型禁用自动解算器 - 示例">
    <CodeGroup>
      ```js NodeJS - Puppeteer
      // 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
      # 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="手动解算验证码 - 示例">
    <CodeGroup>
      ```js NodeJS - Puppeteer
      // 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
      # 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
      # 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">
    对于以下三种验证码类型，我们支持以下附加选项，以控制和配置我们的自动解算算法。

    <Tabs>
      <Tab title="CF Challenge">
        ```js CF Challenge
        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
        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)
        { // 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>

## 仿真函数

<AccordionGroup>
  <Accordion title="Emulation.getSupportedDevices">
    使用此指令获取所有可仿真的设备列表。 此方法返回可与 setDevice 指令一起使用的设备选项阵列。

    ```js 示例
    Emulation.getSupportedDevices().then(devices => { console.log(devices);});
    ```
  </Accordion>

  <Accordion title="Emulation.setDevice">
    收到上面的支持设备列表后，您可以使用 Emulation.setDevice 指令模拟特定设备。此指令更改屏幕宽度、高度、userAgent 和 devicePixelRatio 以匹配指定的设备。

    <CodeGroup>
      ```js Usage
      Emulation.setDevice({device: '[device_name]'});
      ```

      ```js 示例
      Emulation.setDevice({device: 'iPhone X'});
      ```
    </CodeGroup>

    ## 横向模式

    如果您想将方向更改为横向（适用于支持横向的设备），可在device\_name 之后添加字符串landscape。

    ```js 示例
    Emulation.setDevice({device: 'iPhone X landscape'});
    ```
  </Accordion>
</AccordionGroup>


# 标准CDP函数
Source: https://docs.brightdata.com/cn/scraping-automation/scraping-browser/cdp-functions/standard

了解 Scraping Brower 的基本 CDP 函数，从 cookie 设置到国家/地区定位。 学习使用这些常见的 Puppeteer 和 Playwright 命令来优化网络抓取。

Scraping Brower 支持 CDP，因此所有 `puppeteer` 函数/功能都可以在我们的浏览器中运行。您可以在puppeteer官方文档页面上找到所有 [puppeteer API 文档](https://pptr.dev/)和使用示例。我们还添加了一些Bright Data特定[的自定义CDP事件](/scraping-automation/scraping-browser/cdp-functions/custom)，这些事件也非常有用。

下文介绍一些常见的浏览器导航函数，可帮助您入门。

<AccordionGroup>
  <Accordion title="获取页面HTML">
    ```js NodeJS - Puppeteer
    const page = await browser.newPage();  
    await page.goto('https://example.com');  
    const html = await page.content();
    ```

    更多信息请见: [https://pptr.dev/api/puppeteer.page.content](https://pptr.dev/api/puppeteer.page.content)
  </Accordion>

  <Accordion title="点击元素">
    ```js NodeJS - Puppeteer
    // node.js puppeteer   
    const page = await page.newPage();  
    await page.goto('https://example.com');  
    await page.click('a[href]');
    ```

    更多信息请见: [https://pptr.dev/api/puppeteer.page.click](https://pptr.dev/api/puppeteer.page.click)
  </Accordion>

  <Accordion title="滚动到页面底部">
    有时您可能需要将视窗滚动到底部，例如激活“无限滚动”时。具体方法如下：

    ```js NodeJS - Puppeteer
    // node.js puppeteer   
    const page = await page.newPage();  
    await page.goto('https://example.com');  
    await page.evaluate(()=>window.scrollBy(0, window.innerHeight));
    ```
  </Accordion>

  <Accordion title="截屏">
    <CodeGroup>
      ```js NodeJS - Puppeteer
      // More info at https://pptr.dev/api/puppeteer.page.screenshot  
      await page.screenshot({ path: 'screenshot.png', fullPage: true });
      ```

      ```python Python - Playwright
      # More info at <https://playwright.dev/python/docs/screenshots>  
      await page.screenshot(path='screenshot.png', full_page=True)
      ```

      ```cs C# - PuppeteerSharp
      await page.ScreenshotAsync("screenshot.png", new ()  
      {  
          FullPage = true,  
      });
      ```
    </CodeGroup>

    <Note>
      运行上述示例脚本时，以上屏幕截图将作为“screenshot.png”保存在您的文件中。
    </Note>
  </Accordion>

  <Accordion title="设置Cookie">
    请注意，此功能仅支持完成KYC验证流程的客户。

    ```js NodeJS Puppeteer
    const page = await browser.newPage();  
    await page.setCookie({name: 'LANG', value: 'en-US', domain: 'example.com'});  
    await page.goto('https://example.com');
    ```

    更多信息请见：[https://pptr.dev/api/puppeteer.page.setcookie](https://pptr.dev/api/puppeteer.page.setcookie)
  </Accordion>

  <Accordion title="屏蔽端点">
    可以屏蔽不需要的端点以节省带宽。 请参阅下面的相关示例：

    ```js NodeJS - Puppeteer
    // 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="国家/地区定位">
    使用 Scraping Brower 时，可使用与我们的其他代理产品相同的国家/地区定位参数。

    设置脚本时，在 Bright Data 端点的 “USER” 凭据后添加`-country`标志，然后添加该国家/地区的2个字母的 [ISO代码](https://www.nationsonline.org/oneworld/country_code_list.htm)。

    ```js
    const SBR_WS_ENDPOINT = `wss://${USER-country-us:PASS}@brd.superproxy.io:9222`;
    ```

    在以上示例中，我们在脚本中的Bright Data端点添加了-country-us，因此我们的请求将来自美国(“us”)。

    #### 欧盟地区

    您可以按照与上文“国家/地区”相同的方式定位整个欧盟地区，只需在请求中的“country”后添加“eu”即可: `-country-eu`

    使用`-country-eu`发送的请求将使用来自以下某一国家/地区的IP，这些国家/地区将自动包含在 “eu” 境内:

    ```sh 国家/地区
    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>
      欧盟国家/地区的分配是随机的。
    </Note>
  </Accordion>
</AccordionGroup>


# Browser API 代码示例
Source: https://docs.brightdata.com/cn/scraping-automation/scraping-browser/code-examples

探索将 Bright Data 的 Browser API 与 Playwright、Puppeteer 和 Selenium 等各种技术结合使用的详细代码示例。

以下是 Browser API 在不同场景和库中的使用示例。

<Warning>请确保在继续之前安装所需的库</Warning>

<Tabs>
  <Tab title="基础">
    目标页面的简单抓取

    ### 选择您喜欢的技术组合

    <Tabs>
      <Tab title="NodeJS">
        <CodeGroup>
          ```js Playwright
          #!/usr/bin/env node
          const playwright = require('playwright');
          const {
              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();
                  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
          #!/usr/bin/env node
          const puppeteer = require('puppeteer-core');
          const {
              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();
                  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
          #!/usr/bin/env node
          const { Builder, Browser } = require('selenium-webdriver');
          const {
              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();
              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
          #!/usr/bin/env python3
          import asyncio
          from os import environ
          from playwright.async_api import Playwright, async_playwright

          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()
                  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
          #!/usr/bin/env python3
          from os import environ
          from playwright.sync_api import Playwright, sync_playwright

          AUTH = environ.get('AUTH', default='USER:PASS')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          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 = 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
          #!/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='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...')
              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
          #!/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='USER:PASS') 
          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 == 'USER:PASS': 
                  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
          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 = "基础 " + 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", "USER:PASS");
                  var url = Env("TARGET_URL", "https://example.com");
                  var scraper = new Scraper(auth);
                  await scraper.Scrape(url);
              }

          }
          ```

          ```cs Selenium
          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 == "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)
              {
                  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", "USER:PASS");
                  var url = Env("TARGET_URL", "https://example.com");
                  var scraper = new Scraper(auth);
                  scraper.Scrape(url);
              }

          }
          ```
        </CodeGroup>
      </Tab>
    </Tabs>
  </Tab>

  <Tab title="验证码">
    Open a page and wait for captcha to solve

    ### 选择您喜欢的技术组合

    <Tabs>
      <Tab title="NodeJS">
        <CodeGroup>
          ```js Playwright
          #!/usr/bin/env node
          const playwright = require('playwright');
          const {
              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);
                  await page.goto(url, { timeout: 2 * 60 * 1000 });
                  console.log(`Navigated! Waiting captcha to detect and solve...`);
                  const { status } = await client.send('验证码.waitForSolve', {
                      detectTimeout: 10 * 1000,
                  });
                  console.log(`验证码 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
          #!/usr/bin/env node
          const puppeteer = require('puppeteer-core');
          const {
              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();
                  await page.goto(url, { timeout: 2 * 60 * 1000 });
                  console.log(`Navigated! Waiting captcha to detect and solve...`);
                  const { status } = await client.send('验证码.waitForSolve', {
                      detectTimeout: 10 * 1000,
                  });
                  console.log(`验证码 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
          #!/usr/bin/env node
          const { Builder, Browser } = require('selenium-webdriver');
          const {
              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();
              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('验证码.waitForSolve', {
                      detectTimeout: 10000,
                  });
                  console.log(`验证码 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
          #!/usr/bin/env python3
          import asyncio
          from os import environ
          from playwright.async_api import Playwright, async_playwright

          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)
                  await page.goto(url, timeout=2*60_000)
                  print('Navigated! Waiting captcha to detect and solve...')
                  result = await client.send('验证码.waitForSolve', {
                      'detectTimeout': 10 * 1000,
                  })
                  status = result['status']
                  print(f'验证码 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
          #!/usr/bin/env python3
          from os import environ
          from playwright.sync_api import Playwright, sync_playwright

          AUTH = environ.get('AUTH', default='USER:PASS')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          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 = 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('验证码.waitForSolve', {
                      'detectTimeout': 10 * 1000,
                  })
                  status = result['status']
                  print(f'验证码 status: {status}')
              finally:
                  browser.close()


          def main():
              with sync_playwright() as playwright:
                  scrape(playwright)


          if __name__ == '__main__':
              main()

          ```

          ```python Selenium
          #!/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='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...')
              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': '验证码.waitForSolve',
                      'params': {'detectTimeout': 10 * 1000},
                  })
                  status = result['value']['status']
                  print(f'验证码 status: {status}')
              finally:
                  driver.quit()


          if __name__ == '__main__':
              scrape()

          ```
        </CodeGroup>
      </Tab>

      <Tab title="C#">
        <CodeGroup>
          ```cs Puppeteer
          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 = "基础 " + 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("验证码.waitForSolve", new
                      {
                          detectTimeout = 10 * 1000,
                      });
                      var status = (string) result["status"]!;
                      Log($"验证码 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", "USER:PASS");
                  var url = Env("TARGET_URL", "https://example.com");
                  var scraper = new Scraper(auth);
                  await scraper.Scrape(url);
              }

          }
          ```

          ```cs Selenium
          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)
              {
                  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", "验证码.solve"},
                          {"params", new Dictionary<string, object>(){
                              {"detectTimeout", 10000},
                          }},
                      }) as Dictionary<string, object>;
                      var status = (string) result!["status"];
                      Log($"验证码 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", "USER:PASS");
                  var url = Env("TARGET_URL", "https://example.com");
                  var scraper = new Scraper(auth);
                  scraper.Scrape(url);
              }

          }

          ```
        </CodeGroup>
      </Tab>
    </Tabs>
  </Tab>

  <Tab title="高级">
    Inspect scraping session, advanced scraping using js snippets

    ### 选择您喜欢的技术组合

    <Tabs>
      <Tab title="NodeJS">
        <CodeGroup>
          ```js Playwright
          #!/usr/bin/env node
          const playwright = require('playwright');
          const {
              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! 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
          #!/usr/bin/env node
          const puppeteer = require('puppeteer-core');
          const {
              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! 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
          #!/usr/bin/env node
          const { Builder, Browser, By } = require('selenium-webdriver');
          const {
              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! 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
          #!/usr/bin/env python3
          import asyncio
          from os import environ
          from playwright.async_api import Playwright, async_playwright

          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('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
          #!/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='USER:PASS')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          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 = 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
          #!/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='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...')
              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
          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 = "基础 " + 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", "USER:PASS");
                  var url = Env("TARGET_URL", "https://example.com");
                  var scraper = new Scraper(auth);
                  await scraper.Scrape(url);
              }

          }

          ```

          ```cs Selenium
          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)
              {
                  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", "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>
  </Tab>
</Tabs>


# 如何配置抓取浏览器
Source: https://docs.brightdata.com/cn/scraping-automation/scraping-browser/configuration

了解如何使用您的凭据设置和配置 Bright Data 的抓取浏览器、运行示例脚本以及浏览实时浏览器会话。使用我们的详细说明确保高效的网页抓取。

首先，获取您的凭据——您的用户名和密码。您可以在你刚刚创建的抓取浏览器区域中找到它们。我们假设您已经安装了首选的网络自动化工具。 如果尚未安装，请安装它。

## 示例代码

运行以下基本示例，检查您的抓取浏览器是否正常运行（记得换入您的凭据和目标 URL）：

<Tabs>
  <Tab title="NodeJS">
    <CodeGroup>
      ```js Puppeteer
      const puppeteer = require('puppeteer-core');  
      // Enter your zone name and password below
      const AUTH = 'USER:PASS';  
      const SBR_WS_ENDPOINT = `wss://${AUTH}@brd.superproxy.io:9222`;  
        
      async function main() {  
          console.log('Connecting to 抓取浏览器...');  
          const browser = await puppeteer.connect({  
              browserWSEndpoint: SBR_WS_ENDPOINT,  
         });  
          try {  
              console.log('Connected! Navigating...');  
              const page = await browser.newPage();  
              // Enter your test URL below
              await page.goto('https://example.com', { timeout: 2 * 60 * 1000 });  
              console.log('Taking screenshot to page.png');  
              await page.screenshot({ path: './page.png', fullPage: true });  
         console.log('Navigated! Scraping page content...');  
       const html = await page.content();  
       console.log(html)  
       // CAPTCHA solving: If you know you are likely to encounter a CAPTCHA on your target page, add the following few lines of code to get the status of 抓取浏览器's automatic CAPTCHA solver   
       // 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 client = await page.target().createCDPSession();  
       // const {status} = await client.send('Captcha.solve', {detectTimeout: 30*1000});   
       // console.log(`Captcha solve status: ${status}`)   
          } finally {  
              await browser.close();  
         }  
      }  
        
      if (require.main === module) {  
          main().catch(err => {  
              console.error(err.stack || err);  
              process.exit(1);  
         });  
      }
      ```

      ```js Playwright
      const pw = require('playwright');

      // Enter your zone name and password below
      const AUTH = 'USER:PASS';  
      const SBR_CDP = `wss://${AUTH}@brd.superproxy.io:9222`;  
        
      async function main() {  
          console.log('Connecting to 抓取浏览器...');  
          const browser = await pw.chromium.connectOverCDP(SBR_CDP);  
          try {  
              console.log('Connected! Navigating...');  
              const page = await browser.newPage();
              // Enter your test URL below
              await page.goto('https://example.com', { timeout: 2 * 60 * 1000 });  
              console.log('Taking screenshot to page.png');  
              await page.screenshot({ path: './page.png', fullPage: true });  
       console.log('Navigated! Scraping page content...');  
       const html = await page.content();  
       console.log(html);  
          } finally {  
              await browser.close();  
         }  
      }  
        
      if (require.main === module) {  
          main().catch(err => {  
              console.error(err.stack || err);  
              process.exit(1);  
         });  
      }
      ```

      ```js Selenium
      const fs = require('fs/promises');  
      const { Builder, Browser, By } = require('selenium-webdriver');  

      // Enter your zone name and password below 
      const AUTH = 'USER:PASS';  
      const SBR_WEBDRIVER = `https://${AUTH}@zproxy.lum-superproxy.io:9515`;  
        
      async function main() {  
         const driver = await new Builder()  
             .forBrowser(Browser.CHROME)  
             .usingServer(SBR_WEBDRIVER)  
             .build();  
         try {  
       console.log('Connected! Navigating...');
             // Enter your test URL below
             await driver.get('https://example.com');  
              console.log('Taking page screenshot to file page.png');  
             const screenshot = await driver.takeScreenshot();  
             await fs.writeFile('./page.png', Buffer.from(screenshot, 'base64'));  
       console.log('Navigated! Scraping page content...');  
       const html = await driver.getPageSource();  
       console.log(html);          
         } finally {  
             driver.quit();  
         }  
      }  
        
      if (require.main == module) {  
         main().catch(err => {  
             console.error(err.stack || err);  
             process.exit(1);  
         });  
      }
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Python">
    <CodeGroup>
      ```python Playwright
      import asyncio  
      from playwright.async_api import async_playwright  
        
      AUTH = 'USER:PASS'  
      SBR_WS_CDP = f'wss://{AUTH}@brd.superproxy.io:9222'  
        
      async def run(pw):  
          print('Connecting to 抓取浏览器...')  
          browser = await pw.chromium.connect_over_cdp(SBR_WS_CDP)  
          try:  
              print('Connected! Navigating...')  
              page = await browser.new_page()  
              await page.goto('https://example.com', timeout=2*60*1000)  
              print('Taking page screenshot to file page.png')  
              await page.screenshot(path='./page.png', full_page=True)  
       print('Navigated! Scraping page content...')  
       html = await page.content()  
       print(html)  
       # CAPTCHA solving: If you know you are likely to encounter a CAPTCHA on your target page, add the following few lines of code to get the status of 抓取浏览器's automatic CAPTCHA solver   
       # 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  
       # client = await page.context.new_cdp_session(page)  
       # solve_result = await client.send('Captcha.solve', { 'detectTimeout': 30*1000 })   
       # status = solve_result['status']   
       # print(f'Captcha solve status: {status}')   
           finally:  
       await browser.close()  
         
      async def main():  
          async with async_playwright() as playwright:  
              await run(playwright)  
        
      if _name_ == '_main_':  
       asyncio.run(main())
      ```

      ```python Selenium
      from selenium.webdriver import Remote, ChromeOptions  
      from selenium.webdriver.chromium.remote_connection import ChromiumRemoteConnection  
      from selenium.webdriver.common.by import By  

      # Enter your credentials - the zone name and password  
      AUTH = 'USER:PASS'  

      SBR_WEBDRIVER = f'https://{AUTH}@zproxy.lum-superproxy.io:9515'  
        
      def main():  
          print('Connecting to 抓取浏览器...')  
          sbr_connection = ChromiumRemoteConnection(SBR_WEBDRIVER, 'goog', 'chrome')  
          with Remote(sbr_connection, options=ChromeOptions()) as driver:  
              print('Connected! Navigating...')  
              driver.get('https://example.com')  # use this, or replace with URL of your choice
              print('Taking page screenshot to file page.png')  
              driver.get_screenshot_as_file('./page.png')  
              print('Navigated! Scraping page content...')  
              html = driver.page_source  
              print(html)  
        
      if __name__ == '__main__':  
         main()
      ```
    </CodeGroup>
  </Tab>

  <Tab title="C#">
    <CodeGroup>
      ```cs PuppeteerSharp
      using PuppeteerSharp;  
      using System.Net.WebSockets;  
      using System.Text;  
        
      var AUTH = "USER:PASS";  
      var SBR_WS_ENDPOINT = $"wss://{AUTH}@brd.superproxy.io:9222";  
        
      var Connect = (string ws) => Puppeteer.ConnectAsync(new ()  
      {  
          BrowserWSEndpoint = ws,  
          WebSocketFactory = async (url, options, cToken)=>{  
              var socket = new ClientWebSocket();  
              var authBytes = Encoding.UTF8.GetBytes(new Uri(ws).UserInfo);  
              var authHeader = "Basic " + Convert.ToBase64String(authBytes);  
              socket.Options.SetRequestHeader("Authorization", authHeader);  
              socket.Options.KeepAliveInterval = TimeSpan.Zero;  
              await socket.ConnectAsync(url, cToken);  
              return socket;  
         },  
      });  
        
      Console.WriteLine("Connecting to 抓取浏览器...");  
      using var browser = await Connect(SBR_WS_ENDPOINT);  
      Console.WriteLine("Connected! Navigating...");  
      var page = await browser.NewPageAsync();  
      await page.GoToAsync("https://example.com", new 导航Options()  
      {  
          Timeout = 2 * 60 * 1000,  
      });  
      Console.WriteLine("Taking page screenshot to file page.png");  
      await page.ScreenshotAsync("./page.png", new ()  
      {  
          FullPage = true,  
      });  
      Console.WriteLine("Navigated! Scraping page content...");  
      var html = await page.GetContentAsync();   
      Console.WriteLine(html);
      ```

      ```cs Playwright
      var AUTH = "USER:PASS";  
      var SBR_CDP = $"wss://{AUTH}@brd.superproxy.io:9222";  
        
      Console.WriteLine("Connecting to 抓取浏览器...");  
      using var pw = await Playwright.CreateAsync();  
      await using var browser = await pw.Chromium.ConnectOverCDPAsync(SBR_CDP);  
      Console.WriteLine("Connected! Navigating...");  
      var page = await browser.NewPageAsync();  
      await page.GotoAsync("https://example.com", new()  
      {  
          Timeout = 2 * 60 * 1000,  
      });  
      Console.WriteLine("Taking page screenshot to file page.png");  
      await page.ScreenshotAsync(new ()  
      {  
          Path = "./page.png",  
          FullPage = true,  
      });  
      Console.WriteLine("Navigated! Scraping page content...");   
      var html = await page.ContentAsync();   
      Console.WriteLine(html);  
      ```

      ```cs Selenium
      using OpenQA.Selenium;  
      using OpenQA.Selenium.Chrome;  
      using OpenQA.Selenium.Remote;  
      var AUTH = "USER:PASS";  
      var SBR_WEBDRIVER = "https://{AUTH}@brd.superproxy.io:9515";  
        
      Console.WriteLine("Connecting to 抓取浏览器...");  
      var options = new ChromeOptions();  
      using var driver = new RemoteWebDriver(new Uri(SBR_WEBDRIVER), options);  
      Console.WriteLine("Connected! Navigating to https://example.com...");  
      driver.Navigate().GoToUrl("https://example.com");  
        
      Console.WriteLine("Taking page screenshot to file page.png");  
      var screenshot = driver.GetScreenshot();  
      screenshot.SaveAsFile("./page.png");  
        
      Console.WriteLine("Navigated! Scraping page content...");  
      var html = driver.PageSource;  
      Console.WriteLine(html);
      ```
    </CodeGroup>
  </Tab>
</Tabs>

## 运行脚本

<Tabs>
  <Tab title="NodeJS">
    将以上代码另存为 script.js（别忘了输入您的凭据！），然后使用此命令运行它：

    ```sh
    node script.js
    ```
  </Tab>

  <Tab title="Python">
    将以上代码另存为 main.py（别忘了输入您的凭据！），然后使用此命令运行它：

    ```sh
    python main.py
    ```
  </Tab>

  <Tab title="C#" />
</Tabs>

## 查看实时浏览器会话

抓取浏览器 Debugger 使开发人员能够与 Chrome 开发者工具一起检查、分析和微调代码，从而实现更好的控制、可见性和效率。 您可以集成以下代码片段，为每个会话自动启动开发者工具：

```js
// Node.js Puppeteer - 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');
```

## 每个会话单次导航

抓取浏览器会话被构建为允许每个会话进行一次初始导航。 此初始导航指的是加载要从中提取数据的目标站点的第一个实例。 之后，用户可以在同一会话中使用点击、滚动和其他交互式操作自由浏览网站。 然而，要从初始导航阶段开始新的抓取作业（无论是在同一个站点还是不同的站点），都必须开始一个新的会话。

## 会话时间限制

抓取浏览器有两种超时设置，旨在使我们的客户不会进行不受控制的使用。

1. 空闲会话超时：如果浏览器会话在空闲模式下保持打开状态5分钟及以上，这意味着没有使用该会话，抓取浏览器将自动使会话超时。
2. 最大会话长度超时：抓取浏览器会话最多可持续30分钟。 一旦达到最长会话时间，会话将自动超时。


# Browser API 常见问题解答
Source: https://docs.brightdata.com/cn/scraping-automation/scraping-browser/faqs

查找有关 Bright Data 的 Browser API 的常见问题的解答，包括支持的语言、调试技巧和集成指南。

<AccordionGroup>
  <Accordion title="如何配置 Browser API 以在特定国家/地区运行？">
    使用 Browser API 时，可使用与其他 Bright Data 代理产品相同的国家定位参数。

    **特定国家/地区**

    设置脚本时，在 Bright Data 端点的 “USER” 凭据后添加 “-country” 标志，然后添加该国家/地区的 2 个字母的
    ISO 代码。

    例如，对于在美国使用 Puppeteer 的 Browser API：

    <CodeGroup>
      ```sh NodeJS, Puppeteer
      const SBR_WS_ENDPOINT = `wss://${USERNAME-country-us:PASSWORD}@brd.superproxy.io:9222`;
      ```
    </CodeGroup>

    **欧盟地区**

    欧盟地区
    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". 请求 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.
  </Accordion>

  <Accordion title="Which coding languages, libraries, and webdrivers are supported by Browser API?">
    Bright Data 的 Browser API 支持多种编程语言和库。目前，我们使用 puppeteer、playwright 和 selenium 为 Node.js 和 Python 提供全面的本地支持，还可以使用下面的其他库集成其他语言，让您可以灵活地将 Browser API 直接集成到您当前的技术栈中。

    | 语言/平台     | puppeteer             | playwright             | selenium                      |
    | --------- | --------------------- | ---------------------- | ----------------------------- |
    | Python    | N/A                   | playwright-python      | Selenium WebDriver            |
    | JS / Node | 原生支持                  | 原生支持                   | WebDriverJS                   |
    | Ruby      | Puppeteer-Ruby        | playwright-ruby-client | 适用于 Ruby 的 Selenium WebDriver |
    | C#        | .NET: Puppeteer Sharp | 适用于 .NET 的 Playwright  | 适用于 .NET 的 Selenium WebDriver |
    | Java      | Puppeteer Java        | 适用于 Java 的 Playwright  | 原生支持                          |
    | Go        | chromedp              | playwright-go          | 适用于 Go 的 Selenium WebDriver   |
  </Accordion>

  <Accordion title="如何调试 Browser API 会话的幕后情况？">
    您可以实时查看 Browser API 在本地计算机上的运行情况。 这与在 Puppeteer 上将无头浏览器设置为 “FALSE” 类似。

    网络抓取项目通常需要与目标网站进行复杂的交互，调试对于识别和解决开发过程中发现的问题至关重要。

    Browser API Debugger是一项宝贵的资源，它使您能够与 Chrome 浏览器开发工具一起检查、分析和微调代码，从而实现更好的控制、可见性和效率。
  </Accordion>

  <Accordion title="在哪里可以找到 Browser API Debugger？">
    您可以实时查看 Browser API 在本地计算机上的运行情况。 这与在 Puppeteer 上将无头浏览器设置为 “FALSE” 类似。

    我们的 Browser API Debugger 可以通过两种方法启动：通过控制面板手动启动或通过脚本远程启动。

    <Tabs>
      <Tab title="通过控制面板">
        可以在 Bright Data 控制面板中轻松访问 Browser API Debugger。请按照以下步骤操作：

        1. 在控制面板中，转到我的代理视图
        2. 点击您的 Browser API 代理
        3. 点击访问参数或概述选项卡
        4. 在右侧点击 “Chrome 开发工具调试器”按钮
           <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3759089ff3e4caf5fb7215348326e7f4" alt="chrome-devtools-debugger.png" width="1111" height="626" data-path="images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=280&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a8aa92c87ecc992d1ad179b0ff2c7836 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=560&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=af7f099ba10a62471b87132b05137d16 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=840&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=12615e64adf87432e5bc0b703c682edd 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=1100&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=72e87aa83c54d5db8531d848cc7c1fc5 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=1650&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=1baa8d713834f6764840edbf4696bb54 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=2500&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=55e0708a8f748a53bff2fd4aaeada736 2500w" data-optimize="true" data-opv="2" />

        **Debugger 和 Chrome 开发工具入门**

        <Steps>
          <Step title="打开 Browser API 会话">
            * 确保有一个活跃的 Browser API 会话
            * 如果您还不知道如何启动 Browser API 会话，请参阅我们的快速入门指南: [https://docs.brightdata.com/cn/scraping-automation/scraping-browser/introduction](https://docs.brightdata.com/cn/scraping-automation/scraping-browser/introduction)
          </Step>

          <Step title="启动 Debugger">
            * 会话启动并运行后，就可以启动 Debugger 了。
            * 点击访问参数选项卡中的 Debugger 按钮，启动 Browser API Debugger 界面（参见上面的截图）
          </Step>

          <Step title="连接您的实时浏览器会话">
            * 在 Debugger 界面中，您将看到实时 Browser API 会话的列表。
            * 选择要调试的首选会话
            * 点击会话链接或将其复制/粘贴到所选浏览器中，这将在 Debugger 和所选会话之间建立连接。
          </Step>
        </Steps>
      </Tab>

      <Tab title="通过代码（远程）">
        To access and launch the debugger session directly from your script, you'll need to send the CDP command: `Page.inspect`.

        <CodeGroup>
          ```js Puppeteer
          // 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
          // 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
          # 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
          // 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
          // 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>

    **利用 Chrome 开发工具**

    * 将 Browser API Debugger 连接到实时会话后，您就可以使用 Chrome 开发工具的强大功能了: [https://chromedevtools.github.io/devtools-protocol/](https://chromedevtools.github.io/devtools-protocol/)
    * 利用开发工具界面检查 HTML 元素、分析网络请求、调试 JavaScript 代码并监控性能。 利用断点、控制台日志和其他调试技术来识别和解决代码中的问题。

        <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=73be8cd05bfbc078b67cfd45646feb42" alt="test-sites.png" width="955" height="411" data-path="images/scraping-automation/scraping-browser/features/debugger/test-sites.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=280&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=97bf18869d563134b4a7516269bbec3c 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=560&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=dcc656cc62a699b7b5944571f1db6316 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=840&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e6862147f7242a688333ba04b66b0aef 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=1100&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=bc1141f5905fc019e8f27a8c9bf0d477 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=1650&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c373be4ec6b3cdae31f8f65256647662 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=2500&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3e999b6e99516a6c44496570bb63a66f 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="如何在本地自动启动开发工具以查看实时浏览器会话？">
    如果您想在每次会话中自动启动开发工具以查看实时浏览器会话，可以集成以下代码片段：

    ```js NodeJS - Puppeteer
    // Node.js Puppeteer - 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');

    ```

    **Debugger 演示**

    下面就来看看 Browser API Debugger 的运行情况

    \<inser-video-here>
  </Accordion>

  <Accordion title="如何直观地了解浏览器中发生的情况？">
    <Tabs>
      <Tab title="触发屏幕截图">
        只要在代码中添加以下内容，就能随时轻松触发浏览器截图：

        ```js NodeJS
        // node.js puppeteer - Taking screenshot to file screenshot.png 
        await page.screenshot({ path: 'screenshot.png', fullPage: true });
        ```

        要截取 Python 和 C# 的屏幕截图，请参阅此处: [https://docs.brightdata.com/cn/scraping-automation/scraping-browser/code-examples](https://docs.brightdata.com/cn/scraping-automation/scraping-browser/code-examples)
      </Tab>

      <Tab title="在本地启动开发工具">
        See our full section on [opening devtools automatically.](https://docs.brightdata.com/cn/scraping-automation/scraping-browser/features/troubleshooting#scraping-browser-debugger)
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="为什么某些页面的初始导航时间比其他页面长？">
    解锁目标网站需要大量的“幕后”工作。

    有些网站只需要几秒钟就能完成导航，而有些网站可能需要长达一两分钟才能完成导航，因为它们需要更复杂的解锁程序。 因此，我们建议将导航超时时间设置为 “2 分钟”，以便在需要时有足够时间完成导航。

    在脚本中的 `page.goto` 调用前添加以下一行，即可将导航超时设置为 2 分钟。

    <CodeGroup>
      ```js Puppeteer
      // node.js puppeteer - Navigate to site with 2 min timeout  
      page.goto('<https://example.com>', { timeout: 2*60*1000 });  
      ```

      ```python Playwright
      # python playwright - Navigate to site with 2 min timeout   
      page.goto('<https://example.com>', timeout=2*60*1000)  
      ```

      ```cs PuppeteerSharp
      // C# PuppeteerSharp - Navigate to site with 2 min timeout   
      await page.GoToAsync("https://example.com", new 导航Options()  
      {  
          Timeout = 2*60*1000,  
      });
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="最常见的错误代码有哪些？">
    |             |             |                                                                  |
    | ----------- | ----------- | ---------------------------------------------------------------- |
    | **错误代码**    | **含义**      | **您能做些什么？**                                                      |
    | 服务器意外响应：407 | 远程浏览器的端口有问题 | 请检查您的远程浏览器的端口。Browser API 的正确端口是端口:9222                          |
    | 服务器意外响应：403 | 身份验证错误      | 从 Bright Data 控制面板检查身份验证凭据（用户名和密码），并检查是否使用了正确的 “Browser API” 区域。 |
    | 服务器意外响应：503 | 服务不可用       | 我们现在可能正在扩展浏览器以满足需求。 请尝试在 1 分钟后重新连接。                              |
  </Accordion>

  <Accordion title="我似乎无法连接，是不是连接有问题？">
    您可以使用下面的 curl 检查您的连接：

    ```sh Shell
    curl -v -u USER:PASS https://brd.superproxy.io:9222/json/protocol
    ```

    如有任何其他问题，请参阅我们的故障排除指南或联系技术支持: [https://help.brightdata.com/hc/en-us/requests/new](https://help.brightdata.com/hc/en-us/requests/new)
  </Accordion>

  <Accordion title="如何将 Browser API 与 .NET Puppeteer Sharp 集成？">
    使用 C# 与 Browser API 产品集成需要修补 PuppeteerSharp 库，以添加对 websocket 身份验证的支持。 具体方法如下：

    ```cs C# PuppeteerSharp
    using PuppeteerSharp;  
    using System.Net.WebSockets;  
    using System.Text;  
      
    // Set the authentication credentials  
    var auth = "USER:PASS";  
    // Construct the WebSocket URL with authentication  
    var ws = $"wss://{auth}@zproxy.lum-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="Browser API 支持哪些编程语言？">
    Bright Data 的 Browser API 支持多种编程语言和库。目前，我们使用 puppeteer、playwright 和 selenium 为 Node.js 和 Python 提供全面的本地支持，还可以使用下面的其他库集成其他语言，让您可以灵活地将 Browser API 直接集成到您当前的技术栈中。

    | 语言/平台     | puppeteer             | playwright             | selenium                      |
    | --------- | --------------------- | ---------------------- | ----------------------------- |
    | Python    | N/A                   | playwright-python      | Selenium WebDriver            |
    | JS / Node | 原生支持                  | 原生支持                   | WebDriverJS                   |
    | Ruby      | Puppeteer-Ruby        | playwright-ruby-client | 适用于 Ruby 的 Selenium WebDriver |
    | C#        | .NET: Puppeteer Sharp | 适用于 .NET 的 Playwright  | 适用于 .NET 的 Selenium WebDriver |
    | Java      | Puppeteer Java        | 适用于 Java 的 Playwright  | 原生支持                          |
    | Go        | chromedp              | playwright-go          | 适用于 Go 的 Selenium WebDriver   |
  </Accordion>

  <Accordion title="如何调试 Browser API 会话的幕后情况？">
    您可以实时查看 Browser API 在本地计算机上的运行情况。 这与在 Puppeteer 上将无头浏览器设置为 “FALSE” 类似。

    网络抓取项目通常需要与目标网站进行复杂的交互，调试对于识别和解决开发过程中发现的问题至关重要。

    Browser API Debugger是一项宝贵的资源，它使您能够与 Chrome 浏览器开发工具一起检查、分析和微调代码，从而实现更好的控制、可见性和效率。
  </Accordion>

  <Accordion title="在哪里可以找到 Browser API Debugger？">
    您可以实时查看 Browser API 在本地计算机上的运行情况。这与在 Puppeteer 上将无头浏览器设置为 “FALSE” 类似。

    我们的 Browser API Debugger 可以通过两种方法启动：通过控制面板手动启动或通过脚本远程启动。

    <Tabs>
      <Tab title="通过控制面板">
        可以在 Bright Data 控制面板中轻松访问 Browser API Debugger。

        1. 在控制面板中，转到我的代理视图
        2. 点击您的 Browser API 代理
        3. 点击访问参数或概述选项卡
        4. 在右侧点击 “Chrome 开发工具调试器”按钮
           <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3759089ff3e4caf5fb7215348326e7f4" alt="chrome-devtools-debugger.png" width="1111" height="626" data-path="images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=280&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a8aa92c87ecc992d1ad179b0ff2c7836 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=560&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=af7f099ba10a62471b87132b05137d16 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=840&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=12615e64adf87432e5bc0b703c682edd 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=1100&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=72e87aa83c54d5db8531d848cc7c1fc5 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=1650&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=1baa8d713834f6764840edbf4696bb54 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=2500&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=55e0708a8f748a53bff2fd4aaeada736 2500w" data-optimize="true" data-opv="2" />

        **Debugger 和 Chrome 开发工具入门**

        <Steps>
          <Step title="打开 Browser API 会话">
            * 确保有一个活跃的 Browser API 会话
            * 如果您还不知道如何启动 Browser API 会话，请参阅我们的快速入门指南: [https://docs.brightdata.com/cn/scraping-automation/scraping-browser/introduction](https://docs.brightdata.com/cn/scraping-automation/scraping-browser/introduction)
          </Step>

          <Step title="启动 Debugger">
            * 会话启动并运行后，就可以启动 Debugger 了。
            * 点击访问参数选项卡中的 Debugger 按钮，启动 Browser API Debugger 界面（参见上面的截图）
          </Step>

          <Step title="连接您的实时浏览器会话">
            * 在 Debugger 界面中，您将看到实时 Browser API 会话的列表。
            * 选择要调试的首选会话
            * 点击会话链接或将其复制/粘贴到所选浏览器中，这将在 Debugger 和所选会话之间建立连接。
          </Step>
        </Steps>
      </Tab>

      <Tab title="通过代码（远程）">
        To access and launch the debugger session directly from your script, you'll need to send the CDP command: `Page.inspect`.

        <CodeGroup>
          ```js Puppeteer
          // 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
          // 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
          # 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
          // 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
          // 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>

    **利用 Chrome 开发工具**

    * 将 Browser API Debugger 连接到实时会话后，您就可以使用 Chrome 开发工具的强大功能了: [https://chromedevtools.github.io/devtools-protocol/](https://chromedevtools.github.io/devtools-protocol/)
    * 利用开发工具界面检查 HTML 元素、分析网络请求、调试 JavaScript 代码并监控性能。 利用断点、控制台日志和其他调试技术来识别和解决代码中的问题。

        <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=73be8cd05bfbc078b67cfd45646feb42" alt="test-sites.png" width="955" height="411" data-path="images/scraping-automation/scraping-browser/features/debugger/test-sites.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=280&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=97bf18869d563134b4a7516269bbec3c 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=560&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=dcc656cc62a699b7b5944571f1db6316 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=840&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e6862147f7242a688333ba04b66b0aef 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=1100&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=bc1141f5905fc019e8f27a8c9bf0d477 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=1650&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c373be4ec6b3cdae31f8f65256647662 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=2500&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3e999b6e99516a6c44496570bb63a66f 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="如何在本地自动启动开发工具以查看实时浏览器会话？">
    如果您想在每次会话中自动启动开发工具以查看实时浏览器会话，可以集成以下代码片段：

    ```js NodeJS - Puppeteer
    // Node.js Puppeteer - 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');

    ```

    **Debugger 演示**

    下面就来看看 Browser API Debugger 的运行情况

    \<inser-video-here>
  </Accordion>

  <Accordion title="如何直观地了解浏览器中发生的情况？">
    <Tabs>
      <Tab title="触发屏幕截图">
        只要在代码中添加以下内容，就能随时轻松触发浏览器截图：

        ```js NodeJS
        // node.js puppeteer - Taking screenshot to file screenshot.png 
        await page.screenshot({ path: 'screenshot.png', fullPage: true });
        ```

        要截取 Python 和 C# 的屏幕截图，请参阅此处: [https://docs.brightdata.com/cn/scraping-automation/scraping-browser/code-examples](https://docs.brightdata.com/cn/scraping-automation/scraping-browser/code-examples)
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="为什么某些页面的初始导航时间比其他页面长？">
    解锁目标网站需要大量的“幕后”工作。

    有些网站只需要几秒钟就能完成导航，而有些网站可能需要长达一两分钟才能完成导航，因为它们需要更复杂的解锁程序。 因此，我们建议将导航超时时间设置为 “2 分钟”，以便在需要时有足够时间完成导航。

    在脚本中的 “page.goto” 调用前添加以下一行，即可将导航超时设置为 2 分钟。

    <CodeGroup>
      ```js Puppeteer
      // node.js puppeteer - Navigate to site with 2 min timeout  
      page.goto('<https://example.com>', { timeout: 2*60*1000 });  
      ```

      ```python Playwright
      # python playwright - Navigate to site with 2 min timeout   
      page.goto('<https://example.com>', timeout=2*60*1000)  
      ```

      ```cs PuppeteerSharp
      // C# PuppeteerSharp - Navigate to site with 2 min timeout   
      await page.GoToAsync("https://example.com", new 导航Options()  
      {  
          Timeout = 2*60*1000,  
      });
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="最常见的错误代码有哪些？">
    |             |             |                                                                  |
    | ----------- | ----------- | ---------------------------------------------------------------- |
    | **错误代码**    | **含义**      | **您能做些什么？**                                                      |
    | 服务器意外响应：407 | 远程浏览器的端口有问题 | 请检查您的远程浏览器的端口。Browser API 的正确端口是端口:9222                          |
    | 服务器意外响应：403 | 身份验证错误      | 从 Bright Data 控制面板检查身份验证凭据（用户名和密码），并检查是否使用了正确的 “Browser API” 区域。 |
    | 服务器意外响应：503 | 服务不可用       | 我们现在可能正在扩展浏览器以满足需求。 请尝试在 1 分钟后重新连接。                              |
  </Accordion>

  <Accordion title="我似乎无法连接，是不是连接有问题？">
    您可以使用下面的 curl 检查您的连接：

    ```sh Shell
    curl -v -u USER:PASS https://brd.superproxy.io:9222/json/protocol
    ```

    如有任何其他问题，请参阅我们的故障排除指南或联系技术支持。
  </Accordion>

  <Accordion title="如何将 Browser API 与 .NET Puppeteer Sharp 集成？">
    使用 C# 与 Browser API 产品集成需要修补 PuppeteerSharp 库，以添加对 websocket 身份验证的支持。 具体方法如下：

    ```cs C# PuppeteerSharp
    using PuppeteerSharp;  
    using System.Net.WebSockets;  
    using System.Text;  
      
    // Set the authentication credentials  
    var auth = "USER:PASS";  
    // Construct the WebSocket URL with authentication  
    var ws = $"wss://{auth}@zproxy.lum-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="Can I choose the country that the Browser API will scrape from?">
    This is possible, but **not recommended**. The reason is that the Browser API utilises Bright Data's full suite of unblocking capabilities which automatically chooses the best IP type and location to get you the page you want to access.

    In case you still want to make the Browser API work from a specific country, simply use the username that includes the country-xx in the configuration.

    See the example below for Puppeteer: We added -country-us to our request, so we will send a request originating from the United States (“us”).

    `const SBR_WS_ENDPOINT = 'wss://brd-customer-<customer_id>-zone-<zone_name>-country-us:<password>@brd.superproxy.io:9222'`
  </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>
</AccordionGroup>


# 禁用验证码解决器
Source: https://docs.brightdata.com/cn/scraping-automation/scraping-browser/features/captcha-solver



禁用验证码解决器时，我们的解锁算法仍然会负责寻找最佳代理网络、自定义标头、指纹识别等整个不断变化的流程，但故意不自动解决验证码，从而为您的团队提供轻量级、简化的解决方案，扩大潜在抓取机会的范围。

最适合：

* 在不被屏蔽的情况下从网站抓取数据
* 模拟真实用户的网络行为
* 内部没有解锁基础架构且不希望其抓取工具自动解决验证码的团队

<Accordion title="如何开始使用？">
  要禁用验证码解决功能，只需打开相关区域，转到“配置”选项卡并打开高级设置，您将在其中找到“自动验证码解决”控制器。 要禁用验证码解决功能，只需关闭开关。

  <Frame>
        <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/captcha-solver/automatic-captcha-solving.png?maxW=641&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=02ec5c6548ff70cb930730fecb9e998a" alt="automatic-captcha-solving.png" width="641" height="325" data-path="images/scraping-automation/scraping-browser/features/captcha-solver/automatic-captcha-solving.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/captcha-solver/automatic-captcha-solving.png?w=280&maxW=641&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=635d970fb10ddba6c5dae02bb645f9b4 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/captcha-solver/automatic-captcha-solving.png?w=560&maxW=641&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c93dca581c47b4921ffff358b96aaeb3 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/captcha-solver/automatic-captcha-solving.png?w=840&maxW=641&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e15209f2fd55bbc014d246b1849f2ac3 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/captcha-solver/automatic-captcha-solving.png?w=1100&maxW=641&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=ee0c2051b717f4782af050b308b9862f 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/captcha-solver/automatic-captcha-solving.png?w=1650&maxW=641&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=81ab5eff07e1dceb14c91aa24e1fc44f 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/captcha-solver/automatic-captcha-solving.png?w=2500&maxW=641&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=aac6650d8bd28d1d4b434dd219f74530 2500w" data-optimize="true" data-opv="2" />
  </Frame>
</Accordion>

<Note>
  如果您想自行通过 CDP 命令手动配置我们的默认验证码解决器，请参阅自定义 CDP 函数:\
  [https://docs.brightdata.com/cn/scraping-automation/scraping-browser/cdp-functions/custom](https://docs.brightdata.com/cn/scraping-automation/scraping-browser/cdp-functions/custom)
</Note>


# Browser API Playground
Source: https://docs.brightdata.com/cn/scraping-automation/scraping-browser/features/playground

使用 Playground 试用 Browser API。运行或编辑脚本，查看实时日志和浏览器交互。目前支持 Puppeteer 和 JavaScript。

Playground 是一个代码编辑器，用于试用 Browser API。您可以使用该工具运行现成的示例脚本，或编辑脚本并运行自己的脚本进行测试。
Playground 支持的库、语言和功能

虽然 Browser API 支持所有常见的库和语言，但当前版本的 Playground 只能支持 Puppeteer 和 JavaScript。我们保证很快会添加其他功能！

请注意，任何涉及与用户端基础设施连接的功能将在生产环境中得到支持，但在测试环境中不支持。例如，保存文件到用户的文件系统或使用像 Cheerio 这样的预安装库。要全面测试 Browser API 的功能，请使用您常用的编码环境。

### Playground 功能

* 代码编辑器：
  * 默认情况下，代码编辑器将托管一个示例抓取工具脚本。
  * 可自由编辑脚本示例，也可完全删除示例，并从头开始创建任何自定义脚本，以便与 Browser API 一起运行。
  * 重置按钮可还原到原始示例脚本。
* 控制台日志视图
* 网络交互和结果视图：显示通过浏览器的原始 HTML 或可视化浏览器交互。

<Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/playground/playground-features.png?maxW=1303&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9328f3467c31c8a9167ae1b5d39f1144" alt="playground-features.png" width="1303" height="636" data-path="images/scraping-automation/scraping-browser/features/playground/playground-features.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/playground/playground-features.png?w=280&maxW=1303&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=bdc44bf81a7957857baccf7f25dea3cb 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/playground/playground-features.png?w=560&maxW=1303&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e733e0391c71c1fc530528d39f751cc1 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/playground/playground-features.png?w=840&maxW=1303&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9304ab513b0bb15b1dc9ea0e80de9d4e 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/playground/playground-features.png?w=1100&maxW=1303&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=2c1eafd40ed6d2dcbda613ca15fae8e5 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/playground/playground-features.png?w=1650&maxW=1303&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=78cd8fffc2a92a2d3283e879f5d861ba 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/playground/playground-features.png?w=2500&maxW=1303&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=d81d161f5afc88e9047e6662b55fb6a6 2500w" data-optimize="true" data-opv="2" />
</Frame>

### 现成的示例

运行现有的示例脚本，即时查看产品的运行情况。示例脚本演示了对真实目标网站的抓取。您可以看到完整的脚本、控制台日志以及浏览器与目标网站交互的可视化效果。

### 代码编辑

使用代码编辑器编辑默认示例脚本，或用自己的脚本完全替换它们，并运行任何自定义脚本来查看结果或调试代码。
如有需要，您可以随时点击重置按钮，返回到原始示例脚本。


# 抓取浏览器: Premium Domains
Source: https://docs.brightdata.com/cn/scraping-automation/scraping-browser/features/premium-domains

优质域是 Bright Data 两层网站分类系统的一部分，这些网站比其他网站更难解锁，需要额外的网络解锁器资源。

### 启用优质域

当您创建网络解锁器区域时，勾选“特殊功能”下的“优质域”复选框

### 定价

启用后，每千次展示费用（CPM）增加5美元（总计8美元）的溢价将反映在“估算费用”部分。

<Note>
  即使启用后，也只有针对这些域的特定请求才会按更高的费率定价。 对其他域的请求将按默认的较低层级定价。
</Note>

### 当前的优质域列表

<Note>
  根据我们的网站分类逻辑，此列表经常发生变化。 您可以在代理区域内看到最新的列表.
</Note>

<div id="premium_domains">Loading...</div>


# 设置代理位置
Source: https://docs.brightdata.com/cn/scraping-automation/scraping-browser/features/proxy-location

使用 `Proxy.setLocation`，动态更改代理位置，实现地理目标数据采集。 在抓取开始前设置纬度、经度和半径。

使用 `Proxy.setLocation` 函数，用户可以动态更改代理位置，使其位于指定半径内的所需目的地。
该功能对于需要特定地理位置数据或测试地理位置目标内容的操作特别有用。

## 参数

<ParamField path="lat" type="float">
  指定所需代理位置的纬度。
</ParamField>

<ParamField path="lon" type="float">
  指定所需代理位置的经度。
</ParamField>

<ParamField path="distance" type="float">
  定义从提供的坐标到代理位置的最大距离。
  <Note>单位：千米。</Note>
</ParamField>

<ParamField path="strict" type="boolean" default="true">
  定义在指定距离内没有对等节点时的行为。

  `strict: true` - 我们的系统将只搜索特定距离内的可用对等节点。\
  `strict: false` - 如果在指定距离内没有对等节点可用，我们将自动扩大距离并寻找最近的可用对等节点。
</ParamField>

## 用法

应在导航到要使用代理的网站之前调用 `Proxy.setLocation` 命令。这样可确保在发出任何数据请求之前，根据指定参数准确设置代理位置。

**如何运行示例**

您需要在控制面板中获取 Browser API 凭据。

以 `USER:PASS` 的格式作为环境变量 AUTH 发送。

<CodeGroup>
  ```sh Shell
  export AUTH=brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```sh CMD
  set AUTH=brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```powershell Powershell
  $Env:AUTH = 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>'
  ```
</CodeGroup>

<Tip>您还可以通过 `TARGET_URL` 环境变量来更改默认目标网站。</Tip>

## 代码示例

在抓取之前更改代理位置

<Tip>选择您喜欢的技术组合</Tip>

<CodeGroup>
  ```js NodeJS - Playwright
  #!/usr/bin/env node
  const playwright = require('playwright');
  const {
      AUTH = 'USER:PASS',
      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 == 'USER:PASS') {
          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
  #!/usr/bin/env node
  const puppeteer = require('puppeteer-core');
  const {
      AUTH = 'USER:PASS',
      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 == 'USER:PASS') {
          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
  #!/usr/bin/env node
  const { Builder, Browser, By } = require('selenium-webdriver');
  const {
      AUTH = 'USER:PASS',
      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 == 'USER:PASS') {
          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>


# Browser API 故障排除
Source: https://docs.brightdata.com/cn/scraping-automation/scraping-browser/features/troubleshooting

获取 Browser API 的故障排除技巧。 了解如何使用调试器、分析错误代码，以及如何使用 Chrome 开发工具优化网络抓取。

## Browser API Debugger

网络抓取项目通常需要与目标网站进行复杂的交互，调试对于识别和解决开发过程中发现的问题至关重要。 Browser API Debugger 是一项宝贵的资源，它使您能够与 Chrome 浏览器开发工具一起检查、分析和微调代码，从而实现更好的控制、可见性和效率。

### 在哪里可以找到

可通过以下两种方法启动我们的 Browser API Debugger：

1. 通过控制面板手动启动
2. 通过脚本远程启动

请在下面选择您喜欢的方式，了解更多信息：

<Tabs>
  <Tab title="通过控制面板手动启动">
    可以在 Bright Data 控制面板中轻松访问 Browser API Debugger。 请按照以下步骤操作：

    1. 在控制面板中，转到我的代理视图
    2. 点击您的 Browser API 代理
    3. 点击访问参数选项卡
    4. 在右侧点击 “Chrome 开发工具调试器”按钮

    <Frame>
            <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3759089ff3e4caf5fb7215348326e7f4" alt="chrome-devtools-debugger.png" width="1111" height="626" data-path="images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=280&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a8aa92c87ecc992d1ad179b0ff2c7836 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=560&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=af7f099ba10a62471b87132b05137d16 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=840&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=12615e64adf87432e5bc0b703c682edd 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=1100&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=72e87aa83c54d5db8531d848cc7c1fc5 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=1650&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=1baa8d713834f6764840edbf4696bb54 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=2500&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=55e0708a8f748a53bff2fd4aaeada736 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    ### Debugger 和 Chrome 开发工具入门

    <Steps>
      <Step title="打开 Browser API 会话">
        * 确保有一个活跃的 Browser API 会话
        * 如果您还不知道如何启动 Browser API 会话，请参阅我们的快速入门指南。
      </Step>

      <Step title="启动 Debugger">
        * 会话启动并运行后，就可以启动 Debugger 了。
        * 点击访问参数选项卡中的 Debugger 按钮，启动 Browser API Debugger 界面（参见上面的截图）
      </Step>

      <Step title="连接您的实时浏览器会话">
        * 在 Debugger 界面中，您将看到实时 Browser API 会话的列表。
        * 选择要调试的首选会话
        * 点击会话链接或将其复制/粘贴到所选浏览器中，这将在 Debugger 和所选会话之间建立连接。

        <Frame>
                    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/all-set.png?maxW=825&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3f07792ce4f16cebbc50d191f68ee109" alt="" width="825" height="496" data-path="images/scraping-automation/scraping-browser/features/debugger/all-set.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/all-set.png?w=280&maxW=825&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=245430ae5d0e187b795c40201e245bcb 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/all-set.png?w=560&maxW=825&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=d0ef0bcc668a6a743b710a2e2c4b6e7e 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/all-set.png?w=840&maxW=825&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=35bd9b983c72e010dbc28c3abb97e765 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/all-set.png?w=1100&maxW=825&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=da5e834597c6e578a034a0e0788756e9 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/all-set.png?w=1650&maxW=825&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f4956d265211b71177fbc38fddecaaaf 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/all-set.png?w=2500&maxW=825&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=339992b603aada66916830386d37b67d 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="通过脚本远程启动">
    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
      // 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
      # 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#
      // 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>

### 利用 Chrome 开发工具

* 将 Browser API Debugger 连接到实时会话后，您就可以使用 Chrome 开发工具的强大功能了。
* 利用开发工具界面检查 HTML 元素、分析网络请求、调试 JavaScript 代码并监控性能。 利用断点、控制台日志和其他调试技术来识别和解决代码中的问题。

<Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=73be8cd05bfbc078b67cfd45646feb42" alt="test-sites.png" width="955" height="411" data-path="images/scraping-automation/scraping-browser/features/debugger/test-sites.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=280&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=97bf18869d563134b4a7516269bbec3c 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=560&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=dcc656cc62a699b7b5944571f1db6316 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=840&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e6862147f7242a688333ba04b66b0aef 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=1100&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=bc1141f5905fc019e8f27a8c9bf0d477 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=1650&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c373be4ec6b3cdae31f8f65256647662 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=2500&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3e999b6e99516a6c44496570bb63a66f 2500w" data-optimize="true" data-opv="2" />
</Frame>

### 在本地自动启动开发工具以查看实时浏览器会话

如果您想在每次会话中自动启动开发工具以查看实时浏览器会话，可以集成以下代码片段：

```js NodeJS - Puppeteer
// 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');
```

### Debugger 演示

下面就来看看 Browser API Debugger 的运行情况

<Frame>
  <iframe width="660" height="350" src="https://www.youtube.com/embed/68Kom7tS-QY" title="Debugger 演示" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen />
</Frame>

## 错误代码

下面分析一些您可能会收到的常见错误代码：

| 错误代码  | 含义          | 您能做些什么？                                                               |
| ----- | ----------- | --------------------------------------------------------------------- |
| `407` | 远程浏览器的端口有问题 | 请检查您的远程浏览器的端口。Browser API 的正确端口是默认端口：9222，或者如果使用 Selenium，则使用端口：9515。 |
| `403` | 身份验证错误      | 从 Bright Data 控制面板检查身份验证凭据（用户名和密码），并检查是否使用了正确的 “Browser API” 区域。      |
| `503` | 服务不可用       | 我们现在可能正在扩展浏览器以满足需求。 请尝试在 1 分钟后重新连接。                                   |

## 常见问题解答

查看有关 Browser API 的常见问题:\
[https://docs.brightdata.ccom/scraping-automation/scraping-browser/faqs](https://docs.brightdata.ccom/scraping-automation/scraping-browser/faqs)

## 怎么做

进一步了解常用库导航功能和浏览器自动化示例，特别是用于 Browser API 的示例:\
[https://docs.brightdata.com/cn/scraping-automation/scraping-browser/code-examples](https://docs.brightdata.com/cn/scraping-automation/scraping-browser/code-examples)


# Browser API 简介
Source: https://docs.brightdata.com/cn/scraping-automation/scraping-browser/introduction

了解Bright Data的Browser API如何通过强大的代理网络、浏览器自动化和全面的解锁功能来简化多步骤数据收集。

Browser API 是我们的一款代理解锁解决方案，旨在帮助简化您通过浏览器多步骤收集数据的流程。 [Unlocker API scraping suite](/scraping-automation/introduction)

我们在专属浏览器上运行您的抓取代码，使用多个代理网络（包括住宅IP代理网络），并管理每个页面的全面解锁，包括自定义标头、指纹识别、验证码破解等等。

通过`puppeteer`、`playwright` 和 `selenium`（[请参阅我们此处的完整列表](/scraping-automation/scraping-browser/faqs#which-coding-languages-does-scraping-browser-support)）等标准浏览库轻松访问和浏览您的目标网站，以无限规模提取您需要的精确数据。

<Tip>
  在幕后，Browser API 使用我们完整的代理基础架构以及动态解锁功能，为您提供最高的成功率。

  [complete proxy infrastructure](/introduction)
</Tip>

### 最适用于

* 轻松浏览网站、填写表单、点击按钮、滚动加载整个页面、悬停、破解验证码等交互操作

* 与 `puppeteer`、`playwright` 和 `selenium` 集成，特别是当您需要增加或减少活动浏览器数量时。

* 内部没有可靠的可扩展浏览器解锁基础架构的团队


# 如何开始使用抓取浏览器
Source: https://docs.brightdata.com/cn/scraping-automation/scraping-browser/quickstart

只需几步即可启用 Bright Data 的抓取浏览器。按照本指南设置代理，验证账户，即可开始抓取。

<Tip>
  如果您尚未注册 Bright Data，则可以免费注册，添加付款方式时，您将获得价值 \$5 的积分以开启服务:\
  [https://brightdata.com/](https://brightdata.com/)
</Tip>

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">登录</a>} />

  <Step title="导航到“我的区域”">
    <Accordion title="在“我的区域”页面的“抓取浏览器”下，点击“开始”">
      <Warning>
        如果您已经有活跃代理，只需选择右上角的“添加”
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/quick-start/get-started.png?maxW=829&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=99e84a963e8f2a9198f9318a7ce78732" alt="开始" width="829" height="712" data-path="images/scraping-automation/scraping-browser/quick-start/get-started.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/quick-start/get-started.png?w=280&maxW=829&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3844346bdbd260e9013589fbdad9d884 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/quick-start/get-started.png?w=560&maxW=829&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c4f3e84855d2494178a5ac9be8dd8105 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/quick-start/get-started.png?w=840&maxW=829&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=be0ea46170dcc3dc040841218c7c1bae 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/quick-start/get-started.png?w=1100&maxW=829&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=1ce9657b7e3baf1db0950448ce437b8e 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/quick-start/get-started.png?w=1650&maxW=829&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=487aaee965e10a8d9e19ea2081ab87fc 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/quick-start/get-started.png?w=2500&maxW=829&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=dc28e4b3d7badde58401ff23ee57bd86 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="选择您的代理名称">
    <Accordion title="输入新抓取浏览器的代理名称">
      <Warning>
        请选择一个有意义的名称，因为区域名称一旦创建就无法更改。
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/quick-start/proxy-name.png?maxW=1298&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=4b4a01dcd11ed4a2a720ca33f788971a" alt="代理名称" width="1298" height="1536" data-path="images/scraping-automation/scraping-browser/quick-start/proxy-name.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/quick-start/proxy-name.png?w=280&maxW=1298&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=19bc1c4628d0788560dd911ee1f3a927 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/quick-start/proxy-name.png?w=560&maxW=1298&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=5195b7a42ead8b654cfc5921e8a9e522 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/quick-start/proxy-name.png?w=840&maxW=1298&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=22c6ef9a09a8d677943feb04eaac75c6 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/quick-start/proxy-name.png?w=1100&maxW=1298&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=1123af44737558b815d5d99910c5aeb1 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/quick-start/proxy-name.png?w=1650&maxW=1298&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9445860ed5af87f232c7d9d8ebc0b3b0 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/quick-start/proxy-name.png?w=2500&maxW=1298&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=5f3dbe2433d0462a2e62633838c7b8aa 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="点击“添加代理”" />
</Steps>

<Accordion title="在继续操作之前，请验证您的账户">
  如果您尚未添加付款方式，此时系统会提示您添加付款方式，以验证您的账户。 如果您是第一次使用 Bright Data，您还将获得价值 \$5 的奖励积分以帮助您开启服务！

  <Tip>
    此时不会向您收取任何费用，这仅用于验证目的
  </Tip>
</Accordion>

<Note>
  别担心，我们将在下一节“配置您的代理”中介绍所有配置:\
  [https://docs.brightdata.com/cn/scraping-automation/scraping-browser/configuration](https://docs.brightdata.com/cn/scraping-automation/scraping-browser/configuration)
</Note>


# 异步请求
Source: https://docs.brightdata.com/cn/scraping-automation/serp-api/asynchronous-requests

在本文中，我们将解释同步和异步请求之间的区别，重点介绍异步 API 的好处，并通过示例描述关键参数。 

## 发送异步请求

我们有两种方式处理您的 SERP API 请求：

* **同步请求 默认** - 发送请求并在几秒钟内按需获得响应
* **异步请求** - 无需等待实时完整响应即可发送请求，然后通过指定的端点 API 采集您的响应。在高峰时段，异步模式的回调时间可能需要长达 8 小时，但通常会更短。 自请求发送之时起，我们会将响应存储长达 24 小时。

<Tip>异步请求推荐那些请求量大、不需要在单一层级提供即时响应并且可以等待几分钟即可一次性检索所有响应的用户。</Tip>

### 为何使用异步

* 99.99% 的成功率
* 稳定性
* 灵活性 - 能够在您选择的之后时间检索您的请求（无需在发送请求后立即等待响应）
* 使用异步模式，应用任何 SERP API 区域均将额外获得 5% 的折扣

### 如何运行

使用异步模式发送请求和接收响应分为两个步骤：

* **发送请求** - 此请求包含搜索参数，返回`response_ID`，其为直接请求（即您将为此请求付费）。
* **采集响应** - 此请求包含response\_ID ，其为免费（即不会为此请求向您收费）。如您需要response\_ID ，但其仍在处理中，您将会收到 102 状态码。

<Note>自请求发送之时起，我们会将响应存储长达 24 小时。</Note>

### 开始使用

<Steps>
  <Step title="启用 “异步请求”">
    在您的特定 SERP API 区域中，启用 “异步请求” 开关。
  </Step>

  <Step title="可选设置 webhook（POST 或 GET）">
    在这里，您将收到有关未来请求状态的通知
    <Note>也可以为每个请求设置 webhook （参见下面的 “初始请求参数”）</Note>
  </Step>

  <Step title="发送 SERP API 异步请求">
    请求语法与同步请求的语法略有不同，需要一个 API 令牌以进行身份验证。参见下面的基本示例（更多请求参数见下文）：

    ```sh
    curl -i --silent --compressed "https://api.brightdata.com/serp/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"}}'
    ```

    您将收到对上述请求的响应，其中包含`x-response-id`标头，内含您的请求的 ID。这是此请求的RESPONSE\_ID ，您将在下一步采集结果时用到。

    <Note>
      如果您想接收 JSON 格式的已解析的响应，则需要在初始请求中使用可选的brd\_json参数（请参阅下面的 “初始请求参数”）对其进行配置。
    </Note>
  </Step>

  <Step title="Webhook 通知">
    如果您已设置 webhook，则在请求准备就绪后，您将立即收到包含以下参数的通知： 状态、 response\_id、 request\_url 和 hook\_data （可选 - 如果您在请求中使用了webhook\_data 参数）。
  </Step>

  <Step title="采集您的结果">
    使用步骤 3 中收到的RESPONSE\_ID发送以下内容：

    ```sh
    curl -i --silent --compressed "https://api.brightdata.com/serp/get_result?customer=[ACCOUNT_ID]&zone=[zone_name]&response_id=${[RESPONSE_ID]}" -H "Authorization: Bearer [API_KEY]"
    ```

    <Note>
      在上述步骤 3（发送初始请求）中，您可以轻松地将RESPONSE\_ID 与您的请求一起初始化，从而将其保存在脚本中，如下所示：

      ```js
      RESPONSE_ID=$(
      	curl -i --silent --compressed "[https://api.brightdata.com/serp/req?customer=[ACCOUNT_ID]&zone=[zone_name]](https://api.brightdata.com/serp/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>
</Steps>

## 初始请求参数

<Note>所有这些参数均为可选</Note>

|                                          |                                                                                                                                                                                                   |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `webhook_url`                            | 定义将向其发送任务状态通知的 URL。如果您不想设置默认 webhook（上文），或者希望每个请求的 URL 不同，则可用此参数。                                                                                                                                 |
| `webhook_method`                         | `POST` or `GET` (Default). 定义传送任务状态通知的方法。                                                                                                                                                         |
| `webhook_data`                           | 定义将随任务状态通知一起发送的数据                                                                                                                                                                                 |
| `query`                                  | 定义请求的查询对象并支持各种SERP API 参数 （例如国家）                                                                                                                                                                  |
| `brd_json`                               | 启用和配置 解析。默认情况下，SERP API 请求返回定向 SERP 的 未解析 结构化的 HTML。如您希望收到已解析的 JSON 响应，则可添加以下参数值中的一个- brd\_json=1 - 返回单个已解析的 JSON（而非原始 HTML）- brd\_json=html - 返回单个包含额外 “html” 字段的已解析的 JSON（含原始字段 HTML）以及 其他已解析字段 |
| <Note> query.brd\_json 可以用来代替这个参数</Note> |                                                                                                                                                                                                   |
| `multi`                                  | 在同一个请求中运行多个查询（见下文）                                                                                                                                                                                |

```sh brd_json=1
curl -i --silent --compressed "https://api.brightdata.com/serp/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"}'
```

## 响应/采集参数

<Warning>此参数为 必要项</Warning>

|               |                            |
| ------------- | -------------------------- |
| `response_id` | 定义任务 ID。 在对您的初始异步请求的响应中收到。 |

## 单个请求中的多个查询

SERP API 支持使用 multi 参数通过一个 API 请求发送 2 个并行查询请求。

这些并行请求使用相同的对等 IP 和会话，可用于采集其他数据、比较测试等，例如，发出一对具有不同参数/值的请求。 它们使用相同的 IP 和会话。

**条件：**

1. 仅支持已启用异步请求的区域: [https://docs.brightdata.com/cn/scraping-automation/serp-api/asynchronous-requests](https://docs.brightdata.com/cn/scraping-automation/serp-api/asynchronous-requests)
2. 仅支持 Google 搜索
3. 仅限 2 个请求
4. 按 2 个请求计费

**`multi`参数使用：**

<CodeGroup>
  ```js Same Keyword
  multi: [
    {"keyword":"pizza","num":20},
    {"keyword":"pizza","num":100}
  ]
  ```

  ```js Different Keyword
  multi: [
    {"keyword":"pizza"},
    {"keyword":"burger"}
  ]
  ```
</CodeGroup>

**`multi`请求示例：**

```sh 样本请求
curl -v --compressed "https://brightdata.com/api/serp/req" -H "Content-Type: application/json" -H "Authorization: Bearer {API_KEY}" -d "{\"country\":\"us\",\"multi\":[{\"keyword\":\"pizza\",\"num\":20},{\"keyword\":\"pizza\",\"num\":100}]}"
```

### 采集结果

使用上面返回的`x-response-id`中的响应 ID 采集结果：

```sh
curl -k -v --compressed "https://brightdata.com/api/serp/get_result?customer={ACCOUNT_ID&zone={ASYNC_ZONE}&response_id={response_id}" -H "Authorization: Bearer {API_Key}" -o {Your_result_output_file}
```


# SERP API 配置
Source: https://docs.brightdata.com/cn/scraping-automation/serp-api/configuration

配置 SERP API 以最大限度地提高异步请求的效率，访问酒店和增强型广告数据，并通过示例了解关键参数。

## 增强型广告（仅限谷歌）

<Card>
  <CardGroup>
    <Card title="关闭（默认）">
      同时抓取自然搜索结果和广告，涵盖广泛的地理范围。
    </Card>

    <Card title="开启">
      抓取更大范围、更多样化的搜索结果和广告，模拟没有 cookie 的隐身浏览场景。
    </Card>
  </CardGroup>
</Card>

## 异步请求

请求在后台无缝处理，允许您在稍后更方便的时间通过指定端点收集响应，从而提高稳定性、灵活性和效率。
[Learn more](/cn/scraping-automation/serp-api/asynchronous-requests)

<Tip>
  ### 将我们的 webhook IP 列入白名单

  我们的异步 webhook 交付会从一对稳定的 IP 地址发送通知：

  1. `100.27.150.189`
  2. `18.214.10.85`

  客户可能需要在其一侧将这些 IP 列入白名单。
</Tip>


# SERP API 常见问题解答
Source: https://docs.brightdata.com/cn/scraping-automation/serp-api/faqs

通过有关设置、故障排除和高级搜索技术（包括 Google Image 和酒店数据抓取）的详细常见问题解答，了解如何有效使用 Bright Data 的 SERP API。

<AccordionGroup>
  <Accordion title="为什么要选择 Bright Data 的 SERP API？">
    Bright Data SERP API 解决方案可让您专注于最重要的数据。它为您提供了一个三合一代理解锁解决方案，可自主处理代理管理（使用哪个代理以及何时使用）、解锁逻辑（验证码解密、指纹识别、重试、最佳标头等）和抓取功能。

    <Tab title="易于集成">
      在您的代码中，只需将常规代理网络请求中的一行替换为 SERP API 请求中的一行即可。

      <br />
    </Tab>

    <Tab title="只有操作成功之后才需付费">
      您只需为成功的请求付费。

      <br />
    </Tab>

    <Tab title="稳定且可预测的账单">
      CPM 定价 （每 1k 个请求的价格）允许这样做，因此您的请求带宽与此无关。

      <br />
    </Tab>

    <Tab title="准确度">
      使用真实用户设备和激光聚焦地理定位（包括城市级别），以真实用户的身份从主要搜索引擎收集准确的搜索引擎结果页面（SERP）。

      <br />
    </Tab>

    <Tab title="专为数量和规模而打造">
      无论您的请求量有多大，Bright Data 都能以较高的成功率和卓越的响应时间（5 秒以内）支持您不断增长的流量需求和高峰期。

      <br />
    </Tab>

    <Tab title="降低成本">
      节省数据提取工程师和 IT 专业人员的费用，无需担心服务器维护。

      <br />
    </Tab>

    <Tab title="避免操作上的麻烦">
      每个请求都从不同的 IP 发送，确保没有 IP 被标记或封禁。

      <br />
    </Tab>

    <Tab title="结构化数据响应">
      以 JSON 或 HTML 格式获取已解析或未解析的响应，以便与任何系统轻松集成。

      <br />
    </Tab>

    <Tab title="高度自定义">
      Bright Data 支持各种定制参数，以满足您的搜索要求，包括不同的搜索类型、不同的设备、每页的结果等。

      <br />
    </Tab>

    <Tab title="真实住宅 IP">
      可访问所有地理位置的超过 7200 万个真实用户的 IP。

      <br />
    </Tab>
  </Accordion>

  <Accordion title="如何使用 SERP API 进行“谷歌按图搜索（Google Search By Image）”？">
    利用 Bright Data 的 SERP API，可以轻松收集谷歌按图搜索数据。

    谷歌反向图片搜索（正式名称为“谷歌按图搜索”）是谷歌提供的一项服务，允许用户以图搜图，而不是通过书面或口头搜索查询。

    <Note>
      JSON 响应包含 base64 编码的图片。
    </Note>

    <CodeGroup>
      ```sh 搜索 by image URL
      curl -v --compressed --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> "https://www.google.com/searchbyimage?image_url={TARGET_IMAGE_URL}"
      ```

      ```sh 搜索 by an image stored locally
      curl -v --compressed --proxy brd.superproxy.io:33335 --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}'
      ```

      ```sh Adding a query to the image
      <insert-code-here>
      ```
    </CodeGroup>

    查看我们谷歌图片 SERP 的其余功能:\
    [https://docs.brightdata.com/cn/api-reference/serp/images](https://docs.brightdata.com/cn/api-reference/serp/images)
  </Accordion>

  <Accordion title="如何使用 SERP API 收集酒店数据？">
    Bright Data 的 SERP API 可轻松收集酒店数据，如价格、空房情况、评论等。

    **有两种酒店数据收集方式：**

    <Tabs>
      <Tab title="谷歌搜索酒店知识">
        **为每家酒店提供有关价格和日期的有限信息**

        当您使用“谷歌搜索”搜索特定酒店时，其详细信息和评论会出现在下面右侧的知识图谱/小工具中：

                <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=65a519d4d1df376be92072f37e960564" alt="hotels-html.png" width="1485" height="825" data-path="images/scraping-automation/serp-api/parsing-search-results/hotels-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=280&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ea51010d652f7efb5fc2e53f7f9c2b3d 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=560&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e53526df0ebde2a6e5585a80b88c8925 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=840&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=239d278dd1edd6249281f2c725600f54 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=1100&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=948e3112a099ec78602f0c4169bb55d6 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=1650&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9e47d7829affa1e15fb7f963d55a827c 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=2500&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=afe375ec32d8742412037efe2a68cd87 2500w" data-optimize="true" data-opv="2" />

        您可以设置到店和离店日期、入住数量，还可以比价……

        通过 SERP API，请参阅我们 API 文档中的全套酒店参数和功能:\
        [https://docs.brightdata.com/cn/scraping-automation/serp-api/parsing-search-results#hotels](https://docs.brightdata.com/cn/scraping-automation/serp-api/parsing-search-results#hotels)

                <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=18fa40bdcd198e4d337ccb5301902634" alt="hotels-availability.png" width="548" height="666" data-path="images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=280&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=55ad6ed979ae83dcbbdc244da9856b96 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=560&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=75d638ee411bca2c0cd3aa33c51754b5 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=840&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b053d968ea76d60b4cfa30860de4f7ad 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=1100&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f6b7e3482c9b500e8f4bfd5f5e8efe5b 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=1650&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1d1d2097689da1396849b05b074526bd 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=2500&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ce827ec1b01d6a89cbb5e127939d9c9c 2500w" data-optimize="true" data-opv="2" />
      </Tab>

      <Tab title="谷歌旅行酒店页面">
        **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](/cn/scraping-automation/serp-api/parsing-search-results#hotels).

                <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/hotel-info.png?maxW=1234&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=91a2eaa3ee96b6957ab7a45a4381837c" alt="hotel-info.png" width="1234" height="807" data-path="images/scraping-automation/serp-api/faqs/hotel-info.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/hotel-info.png?w=280&maxW=1234&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=4b8aecd955cb38186418e3afd3e7d5fa 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/hotel-info.png?w=560&maxW=1234&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=abc3fda52a0c0dab6f99719d94b58773 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/hotel-info.png?w=840&maxW=1234&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=ee405cee51d157de903957512d51caf3 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/hotel-info.png?w=1100&maxW=1234&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=510fb8ed724b32d2b09f07ed9933dbce 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/hotel-info.png?w=1650&maxW=1234&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=cbed79f0f9b11862d458b3a5d3126b05 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/hotel-info.png?w=2500&maxW=1234&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e73f8f6e3f8e3ccd84304cbf85538990 2500w" data-optimize="true" data-opv="2" />
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="如何在没有 SSL 证书的情况下发送 SERP API HTTPS 请求？">
    当以 HTTPS 为目标时，网址数据是加密的。 因此，要让 SERP API 解密数据并返回结果，您需要下载并安装 Bright Data Certificate 或跳过 SSL 验证。

    以下是有关如何发送 HTTPS 请求的示例代码：

    <CodeGroup>
      ```sh Shell
      curl "https://www.google.com/search?q=pizza&lum_json=1" -v --insecure--compressed --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
      ```

      ```js NodeJS
      process.env.NODE_TLS_REJECT_UNAUTHORIZED = 0;
      ```

      ```java Java
      -Dcom.sun.net.ssl.checkRevocation=false
      ```

      ```cs C#
      ServicePointManager.ServerCertificateValidationCallback += (sender, cert, chain, sslPolicyErrors) => true;
      ```

      ```python Python
      import ssl._create_default_https_context = ssl._create_unverified_context
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="如何通过 SSL 验证发送 HTTPS 请求？">
    <Tabs>
      <Tab title="Shell">
        使用 `cacert` 标志，后跟证书文件路径：

        ```sh Shell
        curl -v --compressed "https://www.google.com/search?q=pizza&lum_json=1" --cacert “{cert file path}“ --proxy brd.superproxy.io:33335 --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
          %JAVA_HOME% Keystore (mostly the cacerts file in ..\lib\security\).
          ```

          ```sh Keytool Command Example
          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="其他编程语言">
        Follow the instructions in the following article on [how to download and Install the Bright Data certificate](https://docs.brightdata.com/cn/general/account/ssl-certificate) to your local machine's Trusted Root Certification Authorities.

        ```sh Shell
        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="如何使用 SERP API 解析 JSON？">
    请参阅这篇文章: [解析搜索结果](/cn/scraping-automation/serp-api/parsing-search-results)
  </Accordion>

  <Accordion title="如何在相同的 API 请求中发送多个查询？">
    SERP API 支持使用 `multi` 参数通过一个 API 请求发送 2 个并行查询请求。

    这些并行请求使用相同的对等 IP 和会话，可用于采集其他数据、比较测试等，例如，发出一对具有不同参数/值的请求。 它们使用相同的 IP 和会话。

    <Note>
      **条件：**

      * 仅支持已启用异步请求的区域: [https://docs.brightdata.com/cn/scraping-automation/serp-api/asynchronous-requests](https://docs.brightdata.com/cn/scraping-automation/serp-api/asynchronous-requests)
      * 仅支持谷歌搜索
      * 仅限 2 个请求
      * 按 2 个请求计费
    </Note>

    **用例：**

    <CodeGroup>
      ```json Different num parameter
      multi:[
        {
          "keyword": "pizza",
          "num": 20
        },
        {
          "keyword": "pizza",
          "num": 100
        }
      ]

      ```

      ```json Different keyword
      multi:[
        {
          "keyword": "pizza"
        },
        {
          "keyword": "burger"
        }
      ]
      ```
    </CodeGroup>

    **示例代码：**

    <CodeGroup>
      ```sh Send request
      curl -v --compressed "https://brightdata.com/api/serp/req" -H "Content-Type: application/json" -H "Authorization: Bearer {API_KEY}" -d "{\"country\":\"us\",\"multi\":[{\"keyword\":\"pizza\",\"num\":20},{\"keyword\":\"pizza\",\"num\":100}]}"
      ```

      ```sh Collect respone
      # Collect the result 
      # use the response ID from the `x-response-id` returned above to collect the result

      curl -k -v --compressed "https://brightdata.com/api/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="我看到谷歌正在对 SERP 结果进行一些修改。 你们会继续支持 SERP `num` 参数吗？">
    绝对可以！

    Bright Data 为 `num` 参数开发了一项备份功能，一旦谷歌将来停止支持 `num` 参数，我们就会启动该功能。

    我们的新功能将无缝补偿在初始 SERP 响应数据中发现的任何 “num” 参数限制，并发送 9 个额外请求（每个请求 10 个结果），将它们合并在一起，然后将全部 100 个结果作为综合全面的响应返回给您。 这个新响应将与 “num=100” 参数的响应在外观和功能上完全一致。

    <Accordion title="那么，这项新功能是否会导致定价改变呢？">
      不会！ 尽管这项新功能涉及到额外的请求并提供合并回复，但定价将不会有任何变化，而且在计费时，该请求将作为一个单独的常规请求来计算。 我们理解维持成本的重要性，因此我们将承担任何额外成本，而不会将其转嫁给我们的客户。
    </Accordion>

    <Note>
      如果您在使用 “num” 参数时遇到问题，请联系您的 Bright Data 客户经理，我们将为您激活该功能。
    </Note>
  </Accordion>

  <Accordion title="SERP API 的常见用例有哪些？">
    <Tab title="自然关键词追踪">
      绘制公司在不同地点的各种关键词排名图

      <br />
    </Tab>

    <Tab title="品牌保护">
      追踪公司品牌和商标的热门结果

      <br />
    </Tab>

    <Tab title="价格比较">
      在在线购物网站上搜索产品并比较不同供应商的价格

      <br />
    </Tab>

    <Tab title="市场调研">
      收集公司、联系人、地点等信息

      <br />
    </Tab>

    <Tab title="检测版权侵权行为">
      搜索图片或其他受版权保护的内容

      <br />
    </Tab>

    <Tab title="广告智能">
      查看输入关键词在不同国家显示的广告，包括双击和谷歌广告服务。

      <br />
    </Tab>
  </Accordion>

  <Accordion title="如何使用日期过滤器查询微软必应？">
    在下面的文章中，我们将分析必应上特定日期搜索查询的不同选项，以及如何有效地使用它们。

    ## 日期过滤器查询类型

    <Tabs>
      <Tab title="所有日期">
        未应用日期过滤器

        * 网址：[https://www.bing.com/search?q=YOUR\_QUERY](https://www.bing.com/search?q=YOUR_QUERY)
      </Tab>

      <Tab title="过去 24 小时">
        Add `filters=ex1%3a"ez1"` to the 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="上周">
        Add `filters=ex1%3a"ez2"` to the 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="过去一年">
        Add `filters=ex1%3a"ez3"` to the 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="精确匹配">
        Specify the exact date range by adding `filters=ex1:"ez5_StartDateSequence_EndDateSequence”` to the 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>

    ***

    ## 确定“精确匹配”查询的序列字符串

    要执行精确匹配日期搜索，需要计算所需日期范围的序列字符串。 请按照以下步骤确定序列字符串。

    <Steps>
      <Step title="使用已知序列作为“起点”">
        使用 2024 年 1 月 1 日作为已知序列 19723 的起点
      </Step>

      <Step title="计算 StartDateSequence">
        * 计算从 1 月 1 日到所需开始日期的天数。
        * 将计算的天数与 1 月 1 日的序号相加，得到 `startDateSequence`。
          <Tip>计数从 “0” 开始。例如 0、1、2、3 ...</Tip>

        > #### 示例：
        >
        > 计算 2024 年 2 月 4 日的序列号：
        >
        > * 从 1 月 1 日到 2 月 4 日的总天数：35 天
        > * 35-1（从 “0” 开始计数）= 34
        > * February 4, 2024: 19723 (Jan1) + 34 = 19757 (`StartDateSequence`)
      </Step>

      <Step title="计算 EndDateSequence">
        将日期范围内的天数与 `startDateSequence` 相加，得到 `EndDateSequence`。

        > #### 示例：
        >
        > 计算 2024 年 2 月 20 日的序列号：
        >
        > * 2024 年 2 月 4 日：19757
        > * 从 2 月 4 日到 2 月 20 日的天数：17 天
        > * 17-1（从 “0” 开始计数）= 16
        > * February 20, 2024: 19757 + 16 = 19773 (`EndDateSequence`)
      </Step>

      <Step title="形成序列字符串">
        * 使用格式 `ez5_startDateSequence_endDateSequence`
        * 用上面计算的开始日期序列号替换 `startDateSequence` 。
        * 用上面计算的结束日期序列号替换 `endDateSequence` 。

        > #### 示例：从 2024 年 2 月 4 日到 2024 年 2 月 20 日：
        >
        > * 计算得出的 `startDateSequence`：19757
        > * 计算得出的 `endDateSequence`：19773
        > * 序列字符串：`ez5_19757_19773`
        > * "查询 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 src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/bing-exact-date-filter.png?maxW=1022&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=75661a89fca5b18d040fb9642e8c76c4" alt="bing-exact-date-filter.png" width="1022" height="233" data-path="images/scraping-automation/serp-api/faqs/bing-exact-date-filter.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/bing-exact-date-filter.png?w=280&maxW=1022&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=4905244fd2b5ad0b6583c39b7f92f704 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/bing-exact-date-filter.png?w=560&maxW=1022&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=dc24a9ffe778c01c4d5c963df6db0584 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/bing-exact-date-filter.png?w=840&maxW=1022&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=69b361343966022617cd9b480455d9b5 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/bing-exact-date-filter.png?w=1100&maxW=1022&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=97a54338cb9ced86ef9d0d0bdf65aece 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/bing-exact-date-filter.png?w=1650&maxW=1022&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=5685b133f3ce62d3bb4f1c431864e16c 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/bing-exact-date-filter.png?w=2500&maxW=1022&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=7bca1c07793bc7db8eee4ddfbe8b8bc0 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>
    </Steps>

    利用上述方法，您可以构建网址来查询必应的任何特定日期范围。
  </Accordion>
</AccordionGroup>


# SERP API简介
Source: https://docs.brightdata.com/cn/scraping-automation/serp-api/introduction

了解Bright Data的SERP API，这是一款全面的解决方案，用于搜索引擎的无缝数据收集、处理代理管理、解锁和轻松解析。

SERP API是我们的代理解锁解决方案之一，旨在由我们为您全面处理代理工作、解锁和基础架构解析，让您可以专注于数据收集。

您只需向特定的目標搜索引擎发送一个代理请求，我们就会将已解析（或未解析）的HTML/JSON干净数据交付给您。就是这么简单。

在幕后，我们SERP API的强大平台管理着整个抓取和解锁流程（从选择最佳代理网络到自定义标头、指纹识别、CAPTCHA验证码破解），最后返回干浄的结构化HTML或已解析的JSON数据:\
[http://docs.brightdata.com/scraping-automation/serp-api/parsing-search-results](http://docs.brightdata.com/scraping-automation/serp-api/parsing-search-results)

### Best for

* 抓取搜索引擎，例如Google、Bing、DuckDuckGo、Yandex、百度、Yahoo和Naver 搜索API
* 自然关键词跟踪、品牌保护、价格比较、市场研究、版权侵权检测、广告情报
* 发出多个并发请求

<Tip>
  如果您的目标是普通网页，正在寻找用于抓取普通网页的解锁解决方案，请查看我们的 [Unlocker API](/cn/scraping-automation/web-unlocker/)
</Tip>


# 使用 SERP API 解析的JSON结果
Source: https://docs.brightdata.com/cn/scraping-automation/serp-api/parsing-search-results

在本文中，我们将介绍使用 SERP API 进行解析的基础知识，了解解析后数据的实际示例。

## 什么是解析？

SERP API 的解析是将原始HTML响应转换为含数据字段和数据值的结构化JSON的过程。此高级解析功能专门支持 Google 和 Bing。 [Parsing](https://brightdata.com/blog/web-data/what-is-data-parsing)

激活解析后，SERP HTML中的数据将被进一步划分为可用的字段和数值（例如排名、链接、标题、描述、 评分等数十个字段），以便您监控竞争对手的SERP排名，分析关键词趋势，并收集有价值的市场洞察。

## 发送基本的解析后请求

以下是使用 `brd_json=1` 或 `brd_json=html` 实现的最简单 `GET` 解析后请求（通过 SERP API）：

<CodeGroup>
  ```sh brd_json=1
  # Returns a single parsed JSON (instead of a raw HTML)

  curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> -k "https://www.google.com/search?q=pizza&brd_json=1"
  ```

  ```sh brd_json=html
  # Returns a single parsed JSON which contains an "html" field 
  # (with the raw HTML in addition to the other parsed fields)

  curl -k --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> "https://www.google.com/search?q=pizza&brd_json=html"
  ```
</CodeGroup>

<Tip>支持 **Google** 和 **Bing** 搜索引擎的解析</Tip>

<Info>
  上述请求属于同步请求（响应为实时接收）。如果想发送异步解析请求，请参阅此处。[here](/scraping-automation/serp-api/asynchronous-requests)
</Info>

***

## 基本请求 - 详解

|                                                                                                                                                                                                |                                                       |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| `brd.superproxy.io`                                                                                                                                                                            | 我们的负载均衡器的地址，此工具可为您的请求找到最快速的超级代理                       |
| <Tooltip tip="Port 33335 replacing port 22225 deprecated on Sep 2026, click to read more">[`33335`](https://docs.brightdata.com/general/faqs#which-port-shall-i-use-22225-or-33335) </Tooltip> | 我们的超级代理基础架构端口，用于接收您的请求                                |
| `-user brd-customer-<customer_id> -zone-<zone_name>`                                                                                                                                           | 用户名验证。以最基本的形式定义您的用户名，以及您的请求将使用哪个区域。                   |
| `ZONE_PASSWORD`                                                                                                                                                                                | 区域密码。所有区域都有用于身份验证的密码                               \` |
| `brd_json=1`                                                                                                                                                                                   | 返回经过解析的 JSON 而不是原始 HTML                               |
| `brd_json=html`                                                                                                                                                                                | 返回已解析的 JSON + 完全嵌套的 HTML                              |

***

## 使用 `brd_json=1` 时的预期解析输出

以下是发送上述请求时收到的确切JSON响应:

<Accordion title="JSON 响应">
  ```JSON
  {
    "general": {
      "search_engine": "google",
      "results_cnt": 1980000000,
      "search_time": 0.57,
      "language": "en",
      "mobile": false,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Google Search",
      "code_version": "1.90",
      "timestamp": "2023-06-30T08:58:41.786Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&brd_json=1",
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12) AppleWebKit/608.2.11 (KHTML, like Gecko) Version/13.0.3 Safari/608.2.11",
      "request_id": "hl_1a1be908_i00lwqqxt1"
    },
    "organic": [
      {
        "link": "https://www.pizzahut.com/",
        "display_link": "https://www.pizzahut.com",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "image": "data:image/jpeg;base64,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",
        "image_alt": "pizza from www.pizzahut.com",
        "image_base64": "data:image/jpeg;base64,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",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.dominos.com/en/",
        "display_link": "https://www.dominos.com › ...",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Chicken & 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": "data:image/jpeg;base64,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",
        "image_alt": "pizza from www.dominos.com",
        "image_base64": "data:image/jpeg;base64,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",
        "rank": 2,
        "global_rank": 3
      },
      {
        "link": "https://en.wikipedia.org/wiki/Pizza",
        "display_link": "https://en.wikipedia.org › wiki › Pizza",
        "title": "Pizza - Wikipedia",
        "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 ...",
        "image": "data:image/jpeg;base64,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",
        "image_alt": "pizza from en.wikipedia.org",
        "image_base64": "data:image/jpeg;base64,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",
        "rank": 3,
        "global_rank": 4
      },
      {
        "link": "https://www.papajohns.com/",
        "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 ...",
        "rank": 4,
        "global_rank": 5
      },
      {
        "link": "https://littlecaesars.com/",
        "display_link": "https://littlecaesars.com",
        "title": "Little Caesars® Pizza: Best Value Delivery and Carryout",
        "description": "Your home for HOT-N-READY® pizzas, EXTRAMOSTBESTEST® pizzas, DEEP!DEEP!™ Dish pizzas, Crazy Bread® and MORE! Order online for no-contact delivery or ...",
        "rank": 5,
        "global_rank": 6
      },
      {
        "link": "https://www.blazepizza.com/",
        "display_link": "https://www.blazepizza.com",
        "title": "Blaze Pizza - Fast-Fire'd Pizzas - Order Online | Blaze Pizza",
        "description": "Get fired up with Fast-Fire'd Pizzas from Blaze! Made just the way you want. Order online for delivery or pickup.",
        "rank": 6,
        "global_rank": 7
      },
      {
        "link": "https://www.theguardian.com/food/2023/jun/28/rightwingers-say-pink-haired-liberals-are-killing-new-york-pizza-heres-whats-really-happening",
        "display_link": "https://www.theguardian.com › food › jun › rightwing...",
        "title": "Rightwingers say 'pink-haired liberals' are killing New York ...",
        "description": "The pizza pile-on was sparked by a inaccuracy-riddled report ... 'This is not legislation that will corrode the New York pizza scene,' says ...",
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "20 hours ago",
            "rank": 1
          }
        ],
        "rank": 7,
        "global_rank": 8
      },
      {
        "link": "https://www.youtube.com/watch?v=oxLzRjYBxQQ",
        "display_link": "https://www.youtube.com › watch",
        "title": "Barstool Pizza Review - YouTube",
        "description": "YouTube",
        "extensions": [
          {
            "type": "text",
            "text": "One Bite Pizza Reviews",
            "rank": 1
          },
          {
            "type": "text",
            "text": "1 day ago",
            "rank": 2
          }
        ],
        "image": "https://i.ytimg.com/vi/oxLzRjYBxQQ/mqdefault.jpg?sqp=-oaymwEFCJQBEFM&rs=AMzJL3lRRTbw1I91F1168NO_w1YftuPlgA",
        "image_url": "https://i.ytimg.com/vi/oxLzRjYBxQQ/mqdefault.jpg?sqp=-oaymwEFCJQBEFM&rs=AMzJL3lRRTbw1I91F1168NO_w1YftuPlgA",
        "duration": "11:14",
        "duration_sec": 674,
        "rank": 8,
        "global_rank": 12
      },
      {
        "link": "https://www.youtube.com/watch?v=9X56jc_68EU",
        "display_link": "https://www.youtube.com › watch",
        "title": "Barstool Pizza Review - NYC Pizza Kitchen (New York, NY)",
        "description": "YouTube",
        "extensions": [
          {
            "type": "text",
            "text": "One Bite Pizza Reviews",
            "rank": 1
          },
          {
            "type": "text",
            "text": "3 days ago",
            "rank": 2
          }
        ],
        "image": "https://i.ytimg.com/vi/9X56jc_68EU/mqdefault.jpg?sqp=-oaymwEFCJQBEFM&rs=AMzJL3lO46CkRjZWL3FEQeeQkBJgCxZzeQ",
        "image_url": "https://i.ytimg.com/vi/9X56jc_68EU/mqdefault.jpg?sqp=-oaymwEFCJQBEFM&rs=AMzJL3lO46CkRjZWL3FEQeeQkBJgCxZzeQ",
        "duration": "4:10",
        "duration_sec": 250,
        "rank": 9,
        "global_rank": 13
      }
    ],
    "recipes": {
      "title": "Recipes",
      "items": [
        {
          "title": "Homemade Pizza & Pizza Dough",
          "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS47CWfkHqjbfUIaFrK8RjTm_KngqQxsXQ2OTmW7q1lrTebxVxzzYG3mmpj4g&s",
          "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS47CWfkHqjbfUIaFrK8RjTm_KngqQxsXQ2OTmW7q1lrTebxVxzzYG3mmpj4g&s",
          "link": "https://www.simplyrecipes.com/recipes/homemade_pizza/",
          "rating": 4.8,
          "reviews_cnt": 90,
          "source": "Simply Recipes",
          "cook_time": "2 hr 30 min",
          "ingredients": [
            "Italian sausage",
            "pizza dough",
            "pesto",
            "feta cheese",
            "bell peppers"
          ],
          "rank": 1,
          "global_rank": 9
        },
        {
          "title": "Pizza Dough",
          "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQHSV3fiR1QKeO5Gu7eVRg66v32XW049i_F8_sAYXxXHxS1oRwZ3IS0mTPY&s",
          "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQHSV3fiR1QKeO5Gu7eVRg66v32XW049i_F8_sAYXxXHxS1oRwZ3IS0mTPY&s",
          "link": "https://www.foodnetwork.com/recipes/bobby-flay/pizza-dough-recipe-1921714",
          "rating": 4.5,
          "reviews_cnt": 1600,
          "source": "Food Network",
          "cook_time": "1 hr 30 min",
          "ingredients": [
            "Bread flour",
            "olive oil",
            "sugar",
            "dry yeast"
          ],
          "rank": 2,
          "global_rank": 10
        },
        {
          "title": "Easy Homemade Pizza Dough",
          "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTzzGNfXoRqbKBti55KO34rb_SW-xePkIvSMgef0AsbRArRcu9nMLpyr8-Iyw&s",
          "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTzzGNfXoRqbKBti55KO34rb_SW-xePkIvSMgef0AsbRArRcu9nMLpyr8-Iyw&s",
          "link": "https://www.allrecipes.com/recipe/20171/quick-and-easy-pizza-crust/",
          "rating": 4.7,
          "reviews_cnt": 3900,
          "source": "Allrecipes",
          "cook_time": "45 min",
          "ingredients": [
            "Bread flour",
            "olive oil",
            "active dry yeast",
            "white sugar"
          ],
          "rank": 3,
          "global_rank": 11
        }
      ]
    },
    "knowledge": {
      "name": "Pizza",
      "subtitle": "Dish",
      "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, which is then baked at a high temperature, traditionally in a wood-fired oven.",
      "description_source": "Wikipedia",
      "description_link": "https://en.wikipedia.org/wiki/Pizza",
      "images": [
        {
          "link": "https://www.google.com/search?q=pizza&hl=en&tbm=isch&source=iu&ictx=1&vet=1&fir=vwyNmrlxb87lKM%252C5xpz_Vm2ema2NM%252C%252Fm%252F0663v%253BefJ23c2_JH_n7M%252CbBq_NwtYzsoXvM%252C_%253B4T1KqgPBvr4X6M%252CJGW8XVFocJC4wM%252C_%253B7mn1Wr2V2et-TM%252CCk5z3mFwtc-sLM%252C_%253BHAxRWExZGt4a0M%252CTQkQ0B0M4aWgcM%252C_%253BAOp1u9WxhkknqM%252CDnbYrezaqAeTBM%252C_%253BZiJze8NWYgm1BM%252CmUmiEmWVfPIjPM%252C_&usg=AI4_-kQ40qSc7MuZBzNVnuLne9fo9Vl5gA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ_B16BAhUEAE#imgrc=vwyNmrlxb87lKM",
          "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4QCARXhpZgAASUkqAAgAAAACAA4BAgBSAAAAJgAAABIBAwABAAAAAQAAAAAAAABsYXJnZSBhbWVyaWNhbiBzdHlsZSBwZXBwZXJvbmkgYW5kIGNoZWVzZSBwaXp6YSBpbiBjYXJkYm9hcmQgZGVsaXZlcnkgYm94IGNsb3NlIHVw/+0AnFBob3Rvc2hvcCAzLjAAOEJJTQQEAAAAAACAHAJQAAdyZXotYXJ0HAJ4AFJsYXJnZSBhbWVyaWNhbiBzdHlsZSBwZXBwZXJvbmkgYW5kIGNoZWVzZSBwaXp6YSBpbiBjYXJkYm9hcmQgZGVsaXZlcnkgYm94IGNsb3NlIHVwHAJuABhHZXR0eSBJbWFnZXMvaVN0b2NrcGhvdG//4QTYaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wLwAJPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4KCQk8cmRmOkRlc2NyaXB0aW9uIHJkZjphYm91dD0iIiB4bWxuczpwaG90b3Nob3A9Imh0dHA6Ly9ucy5hZG9iZS5jb20vcGhvdG9zaG9wLzEuMC8iIHhtbG5zOklwdGM0eG1wQ29yZT0iaHR0cDovL2lwdGMub3JnL3N0ZC9JcHRjNHhtcENvcmUvMS4wL3htbG5zLyIgICB4bWxuczpHZXR0eUltYWdlc0dJRlQ9Imh0dHA6Ly94bXAuZ2V0dHlpbWFnZXMuY29tL2dpZnQvMS4wLyIgeG1sbnM6ZGM9Imh0dHA6Ly9wdXJsLm9yZy9kYy9lbGVtZW50cy8xLjEvIiB4bWxuczpwbHVzPSJodHRwOi8vbnMudXNlcGx1cy5vcmcvbGRmL3htcC8xLjAvIiAgeG1sbnM6aXB0Y0V4dD0iaHR0cDovL2lwdGMub3JnL3N0ZC9JcHRjNHhtcEV4dC8yMDA4LTAyLTI5LyIgeG1sbnM6eG1wUmlnaHRzPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvcmlnaHRzLyIgcGhvdG9zaG9wOkNyZWRpdD0iR2V0dHkgSW1hZ2VzL2lTdG9ja3Bob3RvIiBHZXR0eUltYWdlc0dJRlQ6QXNzZXRJRD0iMTI1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",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4QCARXhpZgAASUkqAAgAAAACAA4BAgBSAAAAJgAAABIBAwABAAAAAQAAAAAAAABsYXJnZSBhbWVyaWNhbiBzdHlsZSBwZXBwZXJvbmkgYW5kIGNoZWVzZSBwaXp6YSBpbiBjYXJkYm9hcmQgZGVsaXZlcnkgYm94IGNsb3NlIHVw/+0AnFBob3Rvc2hvcCAzLjAAOEJJTQQEAAAAAACAHAJQAAdyZXotYXJ0HAJ4AFJsYXJnZSBhbWVyaWNhbiBzdHlsZSBwZXBwZXJvbmkgYW5kIGNoZWVzZSBwaXp6YSBpbiBjYXJkYm9hcmQgZGVsaXZlcnkgYm94IGNsb3NlIHVwHAJuABhHZXR0eSBJbWFnZXMvaVN0b2NrcGhvdG//4QTYaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wLwAJPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4KCQk8cmRmOkRlc2NyaXB0aW9uIHJkZjphYm91dD0iIiB4bWxuczpwaG90b3Nob3A9Imh0dHA6Ly9ucy5hZG9iZS5jb20vcGhvdG9zaG9wLzEuMC8iIHhtbG5zOklwdGM0eG1wQ29yZT0iaHR0cDovL2lwdGMub3JnL3N0ZC9JcHRjNHhtcENvcmUvMS4wL3htbG5zLyIgICB4bWxuczpHZXR0eUltYWdlc0dJRlQ9Imh0dHA6Ly94bXAuZ2V0dHlpbWFnZXMuY29tL2dpZnQvMS4wLyIgeG1sbnM6ZGM9Imh0dHA6Ly9wdXJsLm9yZy9kYy9lbGVtZW50cy8xLjEvIiB4bWxuczpwbHVzPSJodHRwOi8vbnMudXNlcGx1cy5vcmcvbGRmL3htcC8xLjAvIiAgeG1sbnM6aXB0Y0V4dD0iaHR0cDovL2lwdGMub3JnL3N0ZC9JcHRjNHhtcEV4dC8yMDA4LTAyLTI5LyIgeG1sbnM6eG1wUmlnaHRzPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvcmlnaHRzLyIgcGhvdG9zaG9wOkNyZWRpdD0iR2V0dHkgSW1hZ2VzL2lTdG9ja3Bob3RvIiBHZXR0eUltYWdlc0dJRlQ6QXNzZXRJRD0iMTI1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"
        },
        {
          "link": "https://www.google.com/search?q=pizza&hl=en&tbm=isch&source=iu&ictx=1&vet=1&fir=efJ23c2_JH_n7M%252CbBq_NwtYzsoXvM%252C_%253B4T1KqgPBvr4X6M%252CJGW8XVFocJC4wM%252C_%253B7mn1Wr2V2et-TM%252CCk5z3mFwtc-sLM%252C_%253BHAxRWExZGt4a0M%252CTQkQ0B0M4aWgcM%252C_%253BAOp1u9WxhkknqM%252CDnbYrezaqAeTBM%252C_%253BZiJze8NWYgm1BM%252CmUmiEmWVfPIjPM%252C_&usg=AI4_-kRwEYdg29oH_CmkbTMQheFOmeF4NA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ_h16BAhWEAE#imgrc=efJ23c2_JH_n7M",
          "image": "data:image/jpeg;base64,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",
          "image_alt": "Classic Cheese Pizza",
          "image_base64": "data:image/jpeg;base64,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"
        },
        {
          "link": "https://www.google.com/search?q=pizza&hl=en&tbm=isch&source=iu&ictx=1&vet=1&fir=efJ23c2_JH_n7M%252CbBq_NwtYzsoXvM%252C_%253B4T1KqgPBvr4X6M%252CJGW8XVFocJC4wM%252C_%253B7mn1Wr2V2et-TM%252CCk5z3mFwtc-sLM%252C_%253BHAxRWExZGt4a0M%252CTQkQ0B0M4aWgcM%252C_%253BAOp1u9WxhkknqM%252CDnbYrezaqAeTBM%252C_%253BZiJze8NWYgm1BM%252CmUmiEmWVfPIjPM%252C_&usg=AI4_-kRwEYdg29oH_CmkbTMQheFOmeF4NA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ_h16BAhYEAE#imgrc=4T1KqgPBvr4X6M",
          "image": "data:image/jpeg;base64,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",
          "image_alt": "Homemade Pepperoni Pizza",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBwgHBgkIBwgKCgkLDRYPDQwMDRsUFRAWIB0iIiAdHx8kKDQsJCYxJx8fLT0tMTU3Ojo6Iys/RD84QzQ5OjcBCgoKDQwNGg8PGjclHyU3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3N//AABEIAHgAoAMBIgACEQEDEQH/xAAbAAACAgMBAAAAAAAAAAAAAAAFBgAEAgMHAf/EADoQAAIBAwMCBAQEAwgCAwAAAAECAwAEEQUSITFRBhNBYRQicYEykaGxFSNCJDNywdHh8PFDUhZigv/EABoBAAIDAQEAAAAAAAAAAAAAAAMEAQIFAAb/xAAlEQACAgEEAgICAwAAAAAAAAABAgADEQQSITETIkFRMmEUI4H/2gAMAwEAAhEDEQA/ABniJrd7JrpIt0iIWjI9DwQfpxSpY3gKGVwJJUyNxPUE5H60/HRryeB3ZEtoUz/Mm4yPUgUv2Hg1JWdp7jagY/LEegJ6civPaexErKuep6cAscrFuBlurl4iPMMjDai96ZLDRb25Ais0UOpHOfw1Y0zw9b2+rFY0y8ZyQx/AM8fnjOfam3Qo5XKzkYK8fLxnj9uKJqLABkSADtJgGHwfevcK95aQ3DMwUSSyEqg6Z2jr9zV+DRZLCT+HXgeaMLuLRnYmD/7AcU33GpWtpFvuHCMVPC9W7AUnXfi9baV/OglcHOAWGMduOv3qEsLLiDqrZySFmyzuBYaZE6RxlZZSgZBhV9ux7DvRm0miCELEsZPzNuDEr2xxQC11rTNRMcNswhBwHt5OM85yp7ij+mzWgkaaaN+gCyqPxgdz96HtG79w1vA5EKFnayDbg2Pmzj8VAIdbVr94kkynUlj+E9qMXIE6s0LK6HIZSeg9qR9atWtr2SaFRtVlYc8E9qr+T4ga8bSDDWpCXX72Gwt2HlBw903UbAeh+v8AzpTnY20dpbRwxqiKqgYjXav2HpQfwvp7WNnvmA+JnIkk9uy/b9yaONIsURdzhVGa1qKxUnMydQ+99q/EEeKtPS90i5jZAx2ZB9cilXRNLb4QSwPmJhgW46Eng805xmSdTNMhjEo2hWPTtS5ZO9nLJaI6FCxyMcpyf+6S1NnkTcv3G9MDWxUzOPwZBLAJzM8DAglWHrRGy8N24QC2UKMn+0YBPTHFX7fzWXBfzIyOdwHNe3uqxadEhfaoLhcD1JoC8gbxCtdY3AMuiD4e1jheQy7FAZwoBb6ikzxHon9oN3pIRpM5ZQo3/XORgUdOvW6Tus5ZVxzhc4z06VUt5bWG6Z0YkOMjcemeRx6dasSVbiRUhGSe4Etf4rG4t5rhZTwSTztGO/GaIiaGyVmmYGR+CRVTxHdWp8V2VmXZOB5p3YPOeP0/eterWUdhcxPBi6WZSVdn/B/zPpU7GPIhGBABPzzM/wD5Bb3LPaO67tnzGRwo3Y7dj3ofZ6jL+KOe2eSTPCqRnPv9aF+I9Je21gJAxCq2QQfxocEEVs1WF9hk09WZW/vocZc8fiU9/vVLKkrswezD6WwFJtttTle7aIRyNPtKSSKoxgckEfU0e0vUDb28q3EoVc5X/wBfXp+dJFvNKZnktCZ4vR/6seuQPXn9DRVr03MDwXTojoMqGOM1e+nI4hR7DErX2pT395LOpwu7aoBxgemK1RWU11AZDjb0w3Wqml3MsUTrGEYhiAGAIret9PJK7RxBPQ4/cUyq7RxCtxwIOuNN2Mdjqzg5wDzTV4Qlj1aN9MuxuaLnG/AI/wBjQNk3SATMGz03EHd3op4dsnt797rooRjgHjFUt/HJlbeUMYorS4sp5I0fMCjIRid3+9CtLkk1jxIlvcRjyLPNw2OhbgKPz5+1eajqzM5mguU+dSiru69h9aYvDWlnTrL+cQ1zM3mTv3PoPoOn/dV0lW5t2Jm327E57MPxtgZJ/OqFjqqarczR26hkhOME539j+hoT4v1cWNl8JC2Z5vl2jriqXgtLnddX1tHndtTL5C4UYyAOuecUzqXwMCB02m/rNjf5GmC21FN8t9Kuwqf5K+mPelfX5pIJYNStwSXGHxzjFON+162n5jRS7DkucDFALiyNzZXFs6AYUMgU5A49PyFJoo8pT4IlmJ27/ozDQNbN4zYwy4AViefcH9auakG+JhbIIkbjbxtI+lJGm3n8P1Bo5Sz5HyL0C9wPfrTbp3kzqbia7YsWzEjHgdvvXEAdwuOdw6lTUbyXesAtJZVLYR43DMDznIz09O9UrK31CQ5m2KobI+fBBwD0x2/asr/UbizuXiMygbgTKSFB59/t+Vbra4ZIP7OSWkOEzg8epzQrLNoziNpVxEvVrz4zxLcyPuZS5AIPzYAqzY6xLDamNVBG35c5zEeOlVdRtjb6pM0reSkpLA5z1PtVSCbzJApdY024ZyOgp1cMoIjxQbRnqdJ8Raext8Rg/EWXzxHH4oc8j/8AJ/SloXabSdoDY+VhxXStWtnIE8OPOiO5c9DxyD7EcVzrXLNdPuFuLcH4K4YlMjmNvVD7ir6ugPzPN6O/adpgyC9t1nllkgfZO2DLEwXa/f8A1qS5lHmGUzRKMIxC7m/LrmsbhoDA0TYWNgSFxznvQGGR7S5ZGnkaOIcxhvbhvoKBUN4xNUPtIPxLVmJ7qf8AlxOischWHqOKYE0i8SNSYH3HgnaTnP06ULk1KxhgVLMMZm/88jZ+X/CeBz96ljLqjIXkumt1J/8AHkE49cZHA9c0bJxLliTnMIfAbADJiGPPJZslvoKxnnlNtN5E+yNU+UL/AE4z+tV0v2gbdcYlGMZkXJA++a9ubmC8h3JIPJhIwE4yOx4oDZLdSzncst+F9KWbULcli8cKCRwfVv6f1/aug3VwllaPPIcBB+Z9BQLwVYx2+mLcDINwfNOfQHoPyqeISmpDyEkbbEQzqpHTPrTZfxJk9mY23+RdgdCArC1ufEetPOAzfP8AMTn5V7DH6/lXWtOtIrCzVVUBVUcdABS54fZbSIRrDHbwxKFBIA6+mc0wtcfKpZ0aNuD2pIEsxcxnVsTitehNWpvvjO58ZB+U85FLr3flX0EMiqhbK4J528YP7UwvL5g3FRn+nI4pa1+L4q48zDCSMqyMi+q88+3pVdqq/kB5g6hlShEVfFtpJaX73VuQCwJIxx7/AK4oD/8AKNXKeWnw+0A/KYwMj7c0+eKoFubHzMAqy8H6jj/Kuc2/kBdjl/NHG70FM2Ku7JEc0HvXtPYhCDxALiULfWwRs/iU5574NOemPCtk1wWeZo0yNxyD2+tc7ubV3RnGGIbGBTJ4XS6ks5re6dVtlOSTnjHoKU1NY27hHnQBYaurWz1eNbm9/kKu7LkAcYpIubDyLmSOORZE3AIVP4vtj3qzrmrzTzbFVVt04iReM4/qHNZWep/0Kqi7mwpmUfLCOOnf60Wqpqk5MELSpwDO3zLuBpZ1mwi2ypOpa0n/AL0KOUb0kHuP1FNTVUuoFkQgitgieVBwZxzWNLaxuVtbrBQYaCVTlXX0OaptDCwEBgG4nO4Dn7H/AC6V0LWdOhMDWd8p+EJJjkAybdj6/wCHuPvSTe2N1pNyYrpcrjMcwOVdfQg9qQuqYeyzU0+pBG1pQsLGNp3je1LhTgFR+AHnkfX1q1ealFyrG4jkQYx5nzZ9m9fv3+1D73zDKVRmVCNwZfQ1qst0zGO+l2QSLjzRAHLH6+nv9KoOeTHg4xgTfZM118SAsrYXdl/lcd+PvV3Q9KjudVFuqn4VD5kiOOvb8z+xodFbpb3UUtnMWSNgSq5G4g5GRk5FP3h+1SBHuWILSgHOMYGOB+9XC5fjqBusKVfuE766SxsG6dMBQaXI9NuZIriZ5xE54Zo13dR070Vvm+JWTflUXkZGAxqrBqwaExxwjdHxgHqP+d+1VfDncZfSVtVXkDmB01bW9FyJQbu0HDLKnGPfinDQteh1mwdbZjHMuBtYcIPb8qVdR1drmxZIbbyieu4g5HtnmgXh+5m0/WoZEJVZH2Nngc8UKysFSy9xxkFg9hgx/vrrUHdYgJhDCfmYALvJHFWX1MWsISeHEjIAQTn8z9a2LqMckDiZgjx/1bB6ffmh817FdMsMeWcNlicYPaki2BiACbux1LcxN3o8m9SpXIwe3UVy/UIjDeSYODuJx3zXVbGaO4RlGVwmCpHQg0uarYac0RDTiG6Zzt9QRn1649acFo8asYLSMKr2X7itFNJ5IeMDHvzmmHTpLyLTAWWMROCzjae3B5PtVuPw/Z2yK1/cRRouCcSBt9DNb1i2JMVkSYuiqrfMf9u/3pZ2Np2oJoPYpGBFi8ja7ujIm0ljgAnJPuB3ojp1pJaRuzKxmlOEJIKD1z9aoKjzzOYlKGToocttB9Mn0pnsLHytkMCbnfgHt357U3ax4URMsF9iJ2E9KwIzXtSteeclG8tVmRlYZzSnqdgLeFrW5haexY52j8UR7of8uhp5I4qpdWqzKVZQQRVWEkHE5FqWizWCefbOLmxY4WVOMexH9J9jQdosRusLNtyWKjvjt/lXTr7S5rR3lsSNrjEkbLuWQdmXof3pZv8AQ7S/kzaMLG7zgwO3yOeyN6fRqVspzyI7TqccGB/C2irqetQIGk8tN0k4Gdp4GBn69a6JLp2XEG5sH8QUd698AeH59OgkLy+WztudHQD/AL+tb5vEBtPjp2sWwrlUcZII9D0/Sg3N468E8mFBN9vqOBBV9i1Btb3dNCRhJSPTsR6+tCL21htgJUWNmPSNf6s/nXuq61DdW6x7lnMjbgox8p/fPpQuLVLmBgsEM00aHhZI8YPtS9BYJh+5sorYyIQtNPe+URs2H9uAOK2pYW/xEUMbLNKrqzMeAuO/1x+9eGeY6eJ7SOOCb8IEp4B9sDHSt+kJJp9u19qEkWwD58APuJ6c+lTY+1fXuUYnJOZhLLbxCR5Xw7Od3zdDz9q3aApeWSVwHjXpIQPtjvVTU76xNqZXsYmaQfI6/Lz39M15Fqkk9vBHZbI5eRKm3+7IHpx60syNjJ+ZBO4YEKpcY17y4xiLb8x75H+tD/FNlcAfE2i5lUcfX/maJaDbpNCZZCfNQbckYzzTG9ibrTRcRYyUzyPX1FM6Vg6FPqZ2pPitDCcVjh1DUXL3YldQxAj3EZ/zrelvLbI6mMlyOrY6dh2FM2rzxWd1LFcwpCy/hk6bwaFfA6xrMedI0u4eFjgXDDYD9C2BVKzbZwFwI29qKMkz3RIra3ieSZ0knPJA5wTXT/B2gC0i/iOqRf2mTmOFv6B6ZHf2ob4S8FW+hJHf6ncI8qfMAQPLQ9+7sO9E9U8S4ZotOVi54Mx6/btT1NGxt79zK1F/k9V6hmpXle09EZDWJFZV5UTpolgVxyKCaposVwCdoB7imHFYOgwc9KqRJBirHJeaPprwOzXCyA7YvMwVX756/akjU9c1XMUezyYQGDFTkZ5xx396a/Fun3U05urOZ/MCBPLzgEDtXPdWurl4TDIGEikZQ+xrLtSw3ZYcTa0j1qnHcx0+7lS68y6uVgY4DyypuOPXbjofbFXX1VWZ0l1e4KM+Y/JX5j7nH7VquSt7abmwjYz8v+lBPK2vtEbsG6lTjA9u1WRg3YjXkIHEJPc3k0AjS5M0YO4Owy2fXrz3rOHVrmLFijBZXx/OmYkHHTg4AqjbX0sMTRI6WsanAHJJ684HWtUt1cXkbR3KghsAeaMmi7fvqCazd13LF351xfKb6bKxrn+UuS2CR6dPqavWnmXMMccUsabWyTuAxnpk+poJb2+GVDcCFCMEZxx2xnJ+lXHdIg6W1msmMjzHYZ+w9KlwrYAk1bkyxjlY3rLbrax3Q8yIYKqSSPf9K6T4E1OC7sjZMVM0Q3EH1U/7/vXBdPdmuw0jspGfkXJYkA4FM2l39xbXUXlEx+aoVokbcyBmA+Y/lStdHgv3L18zr1GooP3OrX2keGLW4e4ube0ecncTIvmHP06VRu/E8SgJp9sGI4DOOB9B0FB7fSZ7ggsGb/EaNWehxpgy8+1aY4/EYmIf2YGf+IarNuneSQn0z0o1p2iRwAGXDN2otDbxxLtRQBW0LipA+5UtNFeisQa9osHPc17XleV06ZE1hJ+E1kKxblTXEToKuog/UUra1osdxklMN6EdRTlKhzVOeEMKGVB4MIrkTltxos9sT5ZyvoGquEuYW4ixkc4FdHuLJTnihk+mrzxS7UAxpdSwiHcw20kwfaYnHOccflW62g2S+aPKkA6h15xTTNpaNwyAj6VU/gsIJIQDPagtQcYBhl1Q+RAV1bWL75RbkS//AFbFS20yF4svKZD1C9qOfwaP3rJdHjByMj6GqeF8YzC/yli6ulpFcTNJEGj5IUDJB7ferGmbFvltYNPZpMcJbjOGPQ0wjTImXa67l7HmmDwlZQ2EzR2yFVkJLZOeasNOzfmZx1qqPURss1YQRh879gznvVkVrTpWwVoAYmUeZlUqVKmVxKgr3NSpVpWe5r3NSpXTpKlSpXTpgwzxWiSHI4qVKjEmVZYD2qtJB7VKlVlgZWktq0Nae1SpUYlph8H7VPgx2qVKqRJzNsViWIwuaM6fYmFw5wOOlSpUgSDCq1nUqVaRIDivc1KldOn/2Q=="
        },
        {
          "link": "https://www.google.com/search?q=pizza&hl=en&tbm=isch&source=iu&ictx=1&vet=1&fir=efJ23c2_JH_n7M%252CbBq_NwtYzsoXvM%252C_%253B4T1KqgPBvr4X6M%252CJGW8XVFocJC4wM%252C_%253B7mn1Wr2V2et-TM%252CCk5z3mFwtc-sLM%252C_%253BHAxRWExZGt4a0M%252CTQkQ0B0M4aWgcM%252C_%253BAOp1u9WxhkknqM%252CDnbYrezaqAeTBM%252C_%253BZiJze8NWYgm1BM%252CmUmiEmWVfPIjPM%252C_&usg=AI4_-kRwEYdg29oH_CmkbTMQheFOmeF4NA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ_h16BAhaEAE#imgrc=7mn1Wr2V2et-TM",
          "image": "data:image/jpeg;base64,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",
          "image_alt": "Homemade Pepperoni Pizza",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBwgHBgkIBwgKCgkLDRYPDQwMDRsUFRAWIB0iIiAdHx8kKDQsJCYxJx8fLT0tMTU3Ojo6Iys/RD84QzQ5OjcBCgoKDQwNGg8PGjclHyU3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3N//AABEIAHgAVgMBEQACEQEDEQH/xAAbAAACAwEBAQAAAAAAAAAAAAAFBgMEBwECAP/EADgQAAEDAgQFAgMHAwQDAAAAAAECAwQFEQASITEGE0FRYSJxFIGRByMyQqGx0RXB8BYzUuFicvH/xAAaAQADAQEBAQAAAAAAAAAAAAACAwQFAAEG/8QAMBEAAgECBAMHBAIDAQAAAAAAAQIAAxEEEiExE0HwIlFhcZGhsYHB0eEF8RQjMkL/2gAMAwEAAhEDEQA/AEe6UjTfGXN9Z8XRqQffAkQ7iQKkoSgbXBuPGCykwCwEJUih1avKSuA0lLO3NcNhvhi07DWJeuFMZ1cDKorLc2U+JgQDz0LRlQO1gLk298BWdUGgvBpM1RrbSZ2JSBTGnIzcdMh5sllbqbNka6kdBp17Yz/8l89isp4DEGxnabw7Bp1K+OqSUTXlq1TGSCACbaDYADvgnxQqPZTYQUptfLbWD+HW3Z0yS48zGjxmyopCmgpQAPXQ+P074e7GnRDKTf2nuW7lWEaodIFRP3MRKEqF0qW0GevcfwcIWvUqaC3xPGCUtz9517hN1ll1xldwGz6VWuDta98Ele4uwgcRb2EU1NKSvKoWIFiD0xaDcXEJt4iuSgk6HBBDBzgTsdiXKaU62lKWgdXHFBKRgioG8XxJJFDbb6Esx/i3AoXU6i6PkjqPe/ywWgF4NiTaaXFnv1GkIE1gw2EG7imEZLDS2l/87YyMWHFQWN/CXYZUAJG/jLvGFUai8LFpDl1PoKUqN75QP00wvCBnfXl1tAK2JaZi4J9ZlxYTAzO5VJSgKGU26drY16FNAxI5wa71MgA9ppHDcKROp6qVI5aX8qm3Xc99B0HS43+WM5sOGr5xt9413NKmGbrxnarwrJjrYp9KcDam0oceku+kSLG2XwBe9rWOmBNQCrkqa6bf3OWvmTiePnKLM40irvtOJfmcshNm1FLYGXQedTe4+WOagjUwGGsq4NSsAw0B8pz/AFvLRPZjNHntFWiXFCxX0FwNh0B8dsc1C6Xvb9Tw4Ola/PwjL8C7XYyZEuC1BlqIVdBSsrTbrghW4VgpzAjymZYKZhtIpkipyyhlBUlAzK7D3xq1aoprcxSoWNoTqtNfdcZiRHEuEJ1Qm9gf2vieliFALNpHNh2Isss8LUx3mc8pLa27rupQsEgm+/a398Pq16arc6xdPDVCRyml8IiNLVMQ6kygHj96PwLt39t+22M6vULWYjTl5x9RDRGh1MqfaHSkOQcrAKjzCoG1yBrf5YXScU2BvvKMIBWOV5mdLW2idEUptPLDgStJJFzfv4ONBybG2/KOWiMuZdJqdOrbo4kbp7K3GsgsRyk6am4N/Y64zuJXFPMP3EVKNM07kddfmOtaj/EMOspc++WyotpBsb67D574biaXEI1/uZmGqBHBO14jcVVyMyw7BbF5XLAecygLRpsD3N99NDpiqvUyi1tTNPB4ZqjF/wDyDp3H9RE4ciOTOJYCANEuZx2GXW/sLYWdUt3y2oxQMzcgY5PUuYxMkLqP9RQkL5aCw8FA2SOo0t4tfEVVUU2qWHmJItQVFHDMAU2NT26KKbDYW5Nd9K5GU+pZ/KCNtsUOajnOehJ0SzW5SWRwtWaS2y/KLbgLdkstg/dC+5+vc46qyWtbfWOoVVZ9DpD4q8SIGIcCTHRlJU4orunMNVAjc3uRYdumuEYdHtmYevrCqgau8bodPp8NqSimNZC7YrUVm5TtoLeBYe2KXo0ypCn3mYa9RyOJykcujuT0KAT8Mtacyw8dRa41+uJzh79nbnrHU8TwiDvbumQVGE3B4lc+6X8O3IDiwhP4Qo3t1/MF/IYsVwyAg+H1E0uIadMi2p28m6M02kxotNYTWaq0Vz1ozpDYzWRob/K9r23OJaSIq3352/PXrIXarWY0k0E7/r6H8WQYTyUMpUG1pIIvbQkG1hfrY77YPjHMDa1uXX78o0/w7hL5h11+5BG4SpFcpzc0KUp2QorW806db3P4ToNTr2x522F+c4fyFbDOU5DkR94VpPDNOoE3moacUVslK5DoBCU21Gmgv7dPr4A6ObnTy7/rvJ8RjqmJUKe/lCLNXp6WEs85tptNsgUQNgBbTApXLoAdB42ijhaua4F/KZjwLSWKnWJD0lSdFBTbKRohWuhv3698OZhYUrb+8qql6QzgzSeI4MR+K+t2OH1R2Vqb2uVFPftb9sDUChjl5fMkwzNmUE2uR8zIJTceeW21OJbKUhLZRf0pvsPF8eCo668p9O2FXuvGb7Oqq9Tq4qi1decWUY72cqsRa4Hcfxh65L5x/UxsfTzU8y6H5mjwHGpK3HYyghKTmsk5lL0ub9MeUkQMWXTn5995lVMy2DDrwg2rUSLJnNzHmQ2H20oUkWB9JURe3/uceVUzZWIteOpVmQEA3tBFbAZYksvPlK3QltsE3VygNP1PvthYHDpnXU2H0mjhjnZWA0FyfO/4iPJQpuMtZWEZnVoTdXRI8e+AKW1molYOxW21o2/ZKqUinSBlCopfNgr83/Ij5/scMZnWopAuDuOutJh46mo3Pa6tD3FTLlRfiNpvkTnVbmZULUE+m/i+OJ41YA+PtaLwhFJGbnpM4qT8kvZ0KDZBKUtpCgEp0It4wnMhOm0+jw6Nksw1589ZoECitQqc3zWQJCXUvZlp9aFZbZietuw746oSPUelvfynzvGLGwOliPeQU6uVGq8SuRBGQKaQsc0LBIIHa/XDg3EOvWkB6IpUw3ODarwO9zVyKGQoE/7bnoKT4J9xhIRiLgEj0M1sP/LKFyV/WV6VwVMjyY0uqybPlzMiO2Db3K/ne39r4JnyABRqeuucTicdSrXVBp3wxHMuj1JhiWM0d1tbTD9gi9tbHybE384XUFRe14WEQFp1qZynUG9t4zTXg7CbUtbXNQ+kCxuCew28/TFWdnpXP/QPL0695nKuV7DYxU4+pDr7yZVPDyn22eWvIdUgbEAddf2wNXs1FXfQTQwOJ4dJlbYxUoXDdTrrCVemLHSbBbidVJ6kX8/XAgDNYay6vjVpjQR/jSKJwjRm4yJOiE3SBZa1jc7aa3PzvhmdQLjc+XXP5mUaeIxVS+WW1Pf1qA2uOhLLS2yhLqkZzy1Cw7b2B+eOWoNMq+Hf1sIsK1BiHOt/cRZe4NhMyVO1CoyhmFrpWgDXbceDhbcNQM3tNBP5GuRamIV4iqpi0hclpIeDiSppJOh0uT9CLDCiGOh8YnC4fiVch074kNVuuRwipx3WfUkBaSjQb+mwOulj8z2wbKo1uevaaqYbDOTQcHTWPHCPE6K5EUl9KW5STZ1vMAPVsoeMegOOydQfv+OjMjG4PgNdT2eUtzqnBQFSG5iCpvSyVZyALkjLudf80xPVT/ZmU++1vO/PrSKRHtlI3gWt11+UXOWG0xnEFKErCbhNrgg3vfb203xRVY1B4S3DYTIR3j5lFHEkZlhiOITLBck+pAPoW5ve+9wAD5JtpfHZ8ylbbCdXwhpkMWvf1tGOQ7l5KnGnFxnUFKnc1whZ19dj764R3u3zzki72U6xQ4mSGaPApsR18MZFXC3lEAX2senbBcW4F5q4CkC7uw165yjAprTURsLSkaKWSoZwhIGYqIGvjHq3qsTKq1bJoP75QlENWZosRt2QltLLXMDSQUqSi/pvrb5fxhzUyLEGRsKL1WJG535X5zieM31Moakhl9tKQcroBsSL308HbphVQ1lGUfE5MFh6nbQ2MWpUue/w7khSi8GPvHmGmQAEqABte5uLYdTIVyrc++dnyvntr1+YMZjVUhLaGZAKgLApUCobAfr+uDIUby3NTYXJEauC+Dpa6lGqcwFKGnCUp1Ou1r9NcBUqdmwG/XRmfiq9FFKIdY+1WA20yREjc6UVJUptv080C+Yf/f74S9MU9EGvt4zNpVCx7ZsPjugGdShUFMSucmPTeVd1tf8AuMAfkte58Y8uHQPew28f3NOji1oZqdrv7Hx/MSeNAX1pU02GWG05WW0/kSD189ScNw7DNtaKqglSWNzzMma4rqkmGy2zJKUNtJRZKUg3Fgb3Bvjnp8NiOUrwlGg6BiLmMPCtbE6SmlVQIeEly4cKQbq6X0t2GlsICWNhsT11pPMXhuGnGp6FR7decZJ0Cnw2ZbbUZtCCgF4l3RSRr8uvv3x7pmZE366+8zlxFV8ru223XOIkyoSZb7yHhlC28llaAW6ft9MGzljmM3KdCmKYC6wJIhLba5ZNyXCs7i19LfpihKtxJjhwjEgyb7P1vfHPPF7lsJupxWeyQCbC/S1vf5YdiMgQDnMpM7MxO01ik1mnzW+bGcUtMdxWdKwSUn8x/wDLfzvpiRq2Ugk7a8zvFPh3U2I36EklT20IXNZDjTTTZzBWa5GthY6DU4m4ud+IAQB339O7eElE3FM6kxUhV2pzJinlSVx2UgobSEZgkdRtqSRudMODHQsxAmo2Co00ykXPnBfEfFK3gqI9ID6WFE8zIEqVv2/z6Y9YNUtFLSpUjnVbHzvBUNlyqRnZc9RairGRkADMo3316eOuPHIpEBdTCpo1Y2EACMmn1x6GjOpAQlaC5p6ikG48WJxY5L0Q87C/68Qad9PuIcpSnXq5TWY7alPNyEOOFrokG5JtsP5whbAFjKsTUyqVJ3B+Jr6Xo/8AWS38MvnFnIkqTosX1Bv0GmOSmq1S9tduh1pPnC7cPLfTeDazQae/zmmmWw6GjlWFEBCzfKdPNjbbUnCnAD2306+0sw+LqoAQdLwc9w/EZb+8pSXpAXYiQ4vl27pUAb7bHBA5BYrr7R3+VUc6PYeAF/reDKTEpsiktx2GGyVr5qmisp5ht+G46XxG9ZkbM3KHdgfCLVKljhqpIUylzmB4olNk5gpoi1tNQb3G/ntjQzM40+kOpTFQWJ0mgVOqRajTZLRUllbzYU004sZ3F723J2FvOJCSzMzaDffn/URQoNSqqd7HXTYRR4rrrVIpUemU4IEh9Aecd6tgi1/c62+vTF9MKyDu+/d9PxGEPVrsfp9P3OcN8KRUxYcips86QskuJ5qglKb2Gg36edcT1K7ZstIRRJubnURtTwZGqDocgVZxMNo6thOc5tyMxO23T3wS4dXBKnb6wx/KvQGV6evpp5RG+0qPGpPFsJaY6+U5EQ0QVa+k2uOm2W+KVXNTKDS0Thq5FTiNrc/M7wfJp7U9luQHGpKnSVrLtgodgbad/wDu2J2FxrtNDF0HILLrNdQhCEFDcYvN8tKieZc5TcEA7k6fO+GAKTkAuCBfXkbg/E+f2F726/cRqi4/KqHxLUwxoTclbdo6bqITly5j/OwJwhlWmP8AnTXrxmjQs623bTeGZRmSI/MLshCi5ZQYK0gWFtLf5thFZ6gTML69cp6gpq2Ww252mX8Lz3YzjMSashDchC23b726H3xViqW7oPOe02t2TG6mO0o1CoMVJ9gzJGZ1CFj0f8klSulxbfEq0WcZxcDv8YT1GAVV5esCqkVGGh+bKacQlTyXYynQUtunW2Udtj7DFQpUxlsOUozcQlE1+0WHVvVirJaccLz8hz1OKHXv4AHToBigXAvGU0Wn2eQ1M2yFEz0cxIrQU4202UZzqvKQdT5Kf1xMFKsVtqLGZTVRxeIx0N/pf8RSdqrsepuqHPiuuEpcZUopB9Nr+nr1uMJqPmu6/WbQwwakF0YcjEHjKoTqpNC572dxpJaSB+UA9PmcaVEjlMiogUaT3HyyGm1hQClAE67Hr+uJnuhIm7RcVEV5tHCC3JnD8KW6QkoZVncXa6wNib/XAU6Vu0oA3/PtvMDH5VxDIOZHX2l+LFYkIL8QsqWU53g036HLi1h22vglIe5U+emnd9pMSafZYW7vCV6DLblxi1OyxZjSiFpaRoRfvr745WR6YF7eQ+YzEIytdRceMx9wRhES3ymkFJK1KcsST0FsVA22jmFzrB1KrqYVTjolN/GMNODLmQVqR7dSPGBq0CyE0zlPtBWpZrNHZmMOMwxKq9QejuuuKTEjAfkAG46E73+WI3fIbX26/Upo1XoqcqabmHqBwbTqRKW8y0uW8UKSFu6csWt6QBa+o37+MdmepTJIv4dX1g18czjKOyPmFKtUUUZhDmRtCgQkJynYe3a/XEed82o1EXQocdrdaypGq1P4nedYmQWVFprNzXVZTpbe3S/S+KeI9TRlBNt9pRUw1bAqHRzqdhFHi+VSX6LUG8qFyEBKG3ihAW+q4OYZQPSNRew098VU8/EB5SUqbeMT+G47EhA+LUvksrILbY1WPxanoN8HXJDaDeXYOpakRzE02n8Qh4sRPhEiAIed9x27dmydQnwNfe2I8psTfw/PXhE1KJDZr9q+nn16T7i+qL4cYZg0JwIjkBYBN9Dpe53H/WPVpqahp5jl+8Ul6imrUALS7wfEcLMiWsKffdKSsFFzqN9/lil6AXsqtx14xNSvmAubTF6oXc+ZJO218Pp2jakI8P0UuxXZDnKLjrYKHFE3ZvqbAbmxwjEV7OEH9z2lTAGcxip9Qfo77kFtWR1AslaLKLYtbS+xudRvfE7UWc5hvHLUSogJjRw5XJzbPxdbmNJCza50CwL3IHb8NtvOuF1Rw2DU2Ou48ID0QwyhZY4jmwJkIBpXMDiVghu5SFKBCSbeyh76YGkaQfUW0PqY7CUqyNfut7dCAODs0CvvEKQvNGXYkA5SElV/G2HK4Ugnxl/8j/sw31HzaLlVj8zmXOYBJCRc6HTX98WILTLc8hPHBMaO/W36W/fJIaKkFWnrTci3yJwrGZuGGTcRdGpw2JmlzKE6Xoa2orMphTQS6HjYnfMnTca317YhLMihhz+YaV1OYMbHlJq9QIMyIympSilDLKkoLmWw10A2uRuDbph6M+YMDrbroxAqXBXLoT0ZPQqhR6dAbYXMVmSAnOFHUDbYbYcGZx21N/CLq02J02mNupStJBGvU4cJYQDKESRKpNQbkx1KLaVhakX3scEyrUXtbycgqTbYzQ+Hn4L2SesNLWpN17D6++mMfEM6HLKkXsWElqlGXIqgmMSUfDJeL7EZRGVJIBJvrvjlr5TkGl4atdLNvPfCXEkSXGl0Kew2zHZzONyOYUWuskEpO1iRi9qVlNtR9++IZKgqB1/67u+E4lAejVlU1t9tcblqbISLWTyyNANFAZh2/XE/Eu4zdafuUVMWjYY0spB39/7io6hvnFJsf0xau0W288x7Q5iZDIs4hQKSBj1hmWxgZRDBr9QcSpK5a0joEAJt9MKFFBynmRe6RTZK3GY6nHFLVYklar4bSHaM9O0qlXpAvhttYF9Iqu2SrQ6DXCl2jDIMqVvJUToTsMdOAkS2pcPOuI4pAV+NAPpVfBWR9GEWwZdVjTSuIZT9MTEADeVaQuxtdOunnENTCKHuY1Xvrzk39EVKaUptv79CxookB1J3QfG5B84D/IVDblKRUKm94ycNzksqbYWl9TMVktuMLPqRa1gr2H6HHVVUuHIve3PQxNdOwSNyd4tu5eaDbXa9sXJtBbeecwU6Re1j3wUET45RmN7nzju6dLc5JDTAUNMv8Y6juYLbSuLm+uH7QJ//2Q=="
        },
        {
          "link": "https://www.google.com/search?q=pizza&hl=en&tbm=isch&source=iu&ictx=1&vet=1&fir=efJ23c2_JH_n7M%252CbBq_NwtYzsoXvM%252C_%253B4T1KqgPBvr4X6M%252CJGW8XVFocJC4wM%252C_%253B7mn1Wr2V2et-TM%252CCk5z3mFwtc-sLM%252C_%253BHAxRWExZGt4a0M%252CTQkQ0B0M4aWgcM%252C_%253BAOp1u9WxhkknqM%252CDnbYrezaqAeTBM%252C_%253BZiJze8NWYgm1BM%252CmUmiEmWVfPIjPM%252C_&usg=AI4_-kRwEYdg29oH_CmkbTMQheFOmeF4NA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ_h16BAhZEAE#imgrc=HAxRWExZGt4a0M",
          "image": "data:image/jpeg;base64,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",
          "image_alt": "Pizza Dough recipe",
          "image_base64": "data:image/jpeg;base64,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"
        },
        {
          "link": "https://www.google.com/search?q=pizza&hl=en&tbm=isch&source=iu&ictx=1&vet=1&fir=efJ23c2_JH_n7M%252CbBq_NwtYzsoXvM%252C_%253B4T1KqgPBvr4X6M%252CJGW8XVFocJC4wM%252C_%253B7mn1Wr2V2et-TM%252CCk5z3mFwtc-sLM%252C_%253BHAxRWExZGt4a0M%252CTQkQ0B0M4aWgcM%252C_%253BAOp1u9WxhkknqM%252CDnbYrezaqAeTBM%252C_%253BZiJze8NWYgm1BM%252CmUmiEmWVfPIjPM%252C_&usg=AI4_-kRwEYdg29oH_CmkbTMQheFOmeF4NA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ_h16BAhXEAE#imgrc=AOp1u9WxhkknqM",
          "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSBTiGlL3eQeQk_UYQGpoyg3OE6RQsOhx60YyUbNvPFng&s",
          "image_alt": "Chicken Alfredo Pizza",
          "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSBTiGlL3eQeQk_UYQGpoyg3OE6RQsOhx60YyUbNvPFng&s"
        },
        {
          "link": "https://www.google.com/search?q=pizza&hl=en&tbm=isch&source=iu&ictx=1&vet=1&fir=efJ23c2_JH_n7M%252CbBq_NwtYzsoXvM%252C_%253B4T1KqgPBvr4X6M%252CJGW8XVFocJC4wM%252C_%253B7mn1Wr2V2et-TM%252CCk5z3mFwtc-sLM%252C_%253BHAxRWExZGt4a0M%252CTQkQ0B0M4aWgcM%252C_%253BAOp1u9WxhkknqM%252CDnbYrezaqAeTBM%252C_%253BZiJze8NWYgm1BM%252CmUmiEmWVfPIjPM%252C_&usg=AI4_-kRwEYdg29oH_CmkbTMQheFOmeF4NA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ_h16BAhQEAE#imgrc=ZiJze8NWYgm1BM",
          "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcShqNOrnCWng5zaBj2reNeU2QHAMaeyj1EJJhqbunN9kg&s",
          "image_alt": "Classic Cheese Pizza",
          "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcShqNOrnCWng5zaBj2reNeU2QHAMaeyj1EJJhqbunN9kg&s"
        }
      ],
      "facts": [
        {
          "key": "Origin",
          "key_link": "https://www.google.com/search?hl=en&q=pizza+origin&stick=H4sIAAAAAAAAAOPgE-LQz9U3MDMzLtOSySi30k_Oz8lJTS7JzM_TT8kszkgttsovykzPzFvEylOQWVWVqADhAgAjO0XtOQAAAA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ6BMoAHoECEcQAg",
          "predicate": "hw:/collection/dishes:origin",
          "value": [
            {
              "text": "Italy",
              "link": "https://www.google.com/search?hl=en&q=Italy&si=AMnBZoFk_ppfOKgdccwTD_PVhdkg37dbl-p8zEtOPijkCaIHMj99cmEC8YmqzIntfXVZNtU5L5s_BYkw6CsmIn-L56QSbpr6PIZUjdVkuKrffw6c1CKZ_9pKBFW4qlnB9Bhm0MDfT6vScNQrXeycat32kzuoKi0SbwH1ZOSp7Rw9H4b-NlpUU9DyezwS3Hx3MvdZtCWf0TlV&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQmxMoAXoECEcQAw"
            }
          ]
        }
      ],
      "widgets": [
        {
          "type": "carousel",
          "key": "downwards",
          "predicate": "kc:/common:downwards",
          "key_link": "https://www.google.com/search?hl=en&q=where+to+buy+neapolitan+pizza+dough&stick=H4sIAAAAAAAAAD3IMQrCMBQAUIoUOosHCHVziSJ06GVCmnySkJ_Q5Ma7HEcPYHH08nt8YbDcZBJXqfp_hj_upyimaXhlJhmy42aXm15d7ffIYKpgUlG4oZgHaisCbDI4jnnQE7FrACDCwvCqz83DyuIymLZnoJAZ8ZQNYkc9l0Ly5vzn777AncBsYyJAAAA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQMSgAegQIQxAB",
          "title": "where to buy neapolitan pizza dough",
          "items": [
            {
              "title": "Delallo Pizza Dough Kit",
              "link": "https://www.google.com/search?hl=en&q=Delallo+Pizza+Dough+Kit&stick=H4sIAAAAAAAAAONgFmJQ4tVP1zc0zDArSa-KL7TUYljEKu6SmpOYk5OvEJBZVZWo4JJfmp6h4J1ZsoOVEQCmdWPwMgAAAA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQxA16BAhDEAQ",
              "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBwgHBgkIBwgKCgkLDRYPDQwMDRsUFRAWIB0iIiAdHx8kKDQsJCYxJx8fLT0tMTU3Ojo6Iys/RD84QzQ5OjcBCgoKDQwNGg8PGjclHyU3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3N//AABEIAEgASAMBIgACEQEDEQH/xAAcAAEAAgMBAQEAAAAAAAAAAAAABwgBBAUGAwL/xAAwEAABAwMDAgUCBQUAAAAAAAABAAIDBAURBhIxFCEHEyJRcUHRFjJhgfAVYpShwf/EABgBAQADAQAAAAAAAAAAAAAAAAABAgQF/8QAJBEAAgIBAwMFAQAAAAAAAAAAAAECAxEEITESE2EjUdHh8CL/2gAMAwEAAhEDEQA/AJxREQBR/e/Eo2283i3RWgz/ANLYHyyGpDNwLQ70jHc9/wCZCkBV41zT0c3iDdev8wRGRuXRjJz5bAMKsngtFZPUHxygAy6wTf5A+y7Fp8VIbk+2NZbmNdX1XTCPqgZI/wC5zdvH7/UKMHUdlDywx1OzI2gxjdjJz3P6Afvn3TTjKKDWFg6PeXdTEJd7ceouA7fooz5JwWWREVygREQBERAFAusaF1brG87Q8lsrfyDj0N5U9KDtSTti1jfAWRl7pQGveM7PQM9uDnjutejohdNxks7GXV3Sqh1ReDzxsoe47i8FpwQcDA+owtixWuKk1FZ3DO/rYCO+RjzAusK2AtBcxkoafU5zM9uw+rewJyV86OaOW/2YRxMYRWQ7i0YyTIM/z6cfPQloaFFtQ48v5MENZe5JOfP72J4REXEOyEREAREQBQXqEs/Gd8kdGJS2sZFHG44D5HhoA+OVOir3qQSVOs9QxQjMorGvZg4OQ0YITvWVJ9t4b2JVddkl3OEdNtE7yN8sfmvqTshh3Bhc1zceoHB7OB7ccLn2un6TUFkLGyeQ+vhY0PBzG4OB2nPc/K22SB0csdMTBLBuZK92HAAHgNJPck/77YWnTVkFVrGwx0Ic2kjrYjtdKZMybhkhx5A/6Vi0ttlVn8PGefJs1NcbK/UXHH0WBbwFlYHAWVtMQREQBERAFW2/vqPx1fXU0jWuFUAcuxy0fZWSVXdUSMGt73vlqWB1SSeneQ44A9vZR09TwM43OpQ3F/R1DKlrauTf6S7u4O4IIPJ478L82Jko1rY3PczY6taGhnAwVxt1F5gkdVXgPxt3EnPxnHz2XQ0k9kuubKGz1MgbUgtFQ4l3B9wEdKT6soK3O2CzI4RYb+UfCypAREQBERAF4S5eFWmLlWzVdVSzummeXvcKh4yfgFEQGofBnSR4p6kfFS/7ratfhVpy1V8FdRx1TKiB26NxqHHB44KwiA940YaB7BZREAREQH//2Q==",
              "image_alt": "Delallo Pizza Dough Kit",
              "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBwgHBgkIBwgKCgkLDRYPDQwMDRsUFRAWIB0iIiAdHx8kKDQsJCYxJx8fLT0tMTU3Ojo6Iys/RD84QzQ5OjcBCgoKDQwNGg8PGjclHyU3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3N//AABEIAEgASAMBIgACEQEDEQH/xAAcAAEAAgMBAQEAAAAAAAAAAAAABwgBBAUGAwL/xAAwEAABAwMDAgUCBQUAAAAAAAABAAIDBAURBhIxFCEHEyJRcUHRFjJhgfAVYpShwf/EABgBAQADAQAAAAAAAAAAAAAAAAABAgQF/8QAJBEAAgIBAwMFAQAAAAAAAAAAAAECAxEEITESE2EjUdHh8CL/2gAMAwEAAhEDEQA/AJxREQBR/e/Eo2283i3RWgz/ANLYHyyGpDNwLQ70jHc9/wCZCkBV41zT0c3iDdev8wRGRuXRjJz5bAMKsngtFZPUHxygAy6wTf5A+y7Fp8VIbk+2NZbmNdX1XTCPqgZI/wC5zdvH7/UKMHUdlDywx1OzI2gxjdjJz3P6Afvn3TTjKKDWFg6PeXdTEJd7ceouA7fooz5JwWWREVygREQBERAFAusaF1brG87Q8lsrfyDj0N5U9KDtSTti1jfAWRl7pQGveM7PQM9uDnjutejohdNxks7GXV3Sqh1ReDzxsoe47i8FpwQcDA+owtixWuKk1FZ3DO/rYCO+RjzAusK2AtBcxkoafU5zM9uw+rewJyV86OaOW/2YRxMYRWQ7i0YyTIM/z6cfPQloaFFtQ48v5MENZe5JOfP72J4REXEOyEREAREQBQXqEs/Gd8kdGJS2sZFHG44D5HhoA+OVOir3qQSVOs9QxQjMorGvZg4OQ0YITvWVJ9t4b2JVddkl3OEdNtE7yN8sfmvqTshh3Bhc1zceoHB7OB7ccLn2un6TUFkLGyeQ+vhY0PBzG4OB2nPc/K22SB0csdMTBLBuZK92HAAHgNJPck/77YWnTVkFVrGwx0Ic2kjrYjtdKZMybhkhx5A/6Vi0ttlVn8PGefJs1NcbK/UXHH0WBbwFlYHAWVtMQREQBERAFW2/vqPx1fXU0jWuFUAcuxy0fZWSVXdUSMGt73vlqWB1SSeneQ44A9vZR09TwM43OpQ3F/R1DKlrauTf6S7u4O4IIPJ478L82Jko1rY3PczY6taGhnAwVxt1F5gkdVXgPxt3EnPxnHz2XQ0k9kuubKGz1MgbUgtFQ4l3B9wEdKT6soK3O2CzI4RYb+UfCypAREQBERAF4S5eFWmLlWzVdVSzummeXvcKh4yfgFEQGofBnSR4p6kfFS/7ratfhVpy1V8FdRx1TKiB26NxqHHB44KwiA940YaB7BZREAREQH//2Q==",
              "rank": 1
            },
            {
              "title": "King Arthur Flour Piz...",
              "link": "https://www.google.com/search?hl=en&q=King+Arthur+Flour+Pizza&stick=H4sIAAAAAAAAAONgFmJQ4tVP1zc0zM4wNjQsiS_WYljEKu6dmZeu4FhUklFapOCWkw8kAzKrqhJ3sDICAJ9B7QQyAAAA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQxA16BAhDEAY",
              "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBwgHBgkIBwgKCgkLDRYPDQwMDRsUFRAWIB0iIiAdHx8kKDQsJCYxJx8fLT0tMTU3Ojo6Iys/RD84QzQ5OjcBCgoKDQwNGg8PGjclHyU3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3N//AABEIAEgASAMBIgACEQEDEQH/xAAbAAACAwEBAQAAAAAAAAAAAAAABQMEBgcCAf/EADMQAAEDAgQEBAQFBQAAAAAAAAECAxEABAUSITEGQVFhEyIykRRScaEVI8HR8EJigYKx/8QAGQEAAwEBAQAAAAAAAAAAAAAAAAECAwQF/8QAIREAAgICAgEFAAAAAAAAAAAAAAECEQMSMUEEEyEiMnH/2gAMAwEAAhEDEQA/AO41WdWsOEJVAqzWR4i4vtcIxr8OXaXLz3hB0lBQlOU6bqUJpSkoq2aYsU8stYK2aFLr+YpUNBsobGsPxO/xd+P3CcMdvW7DwkltTFuhwZoE7ievOtPgmLN4zhjV/boWht0qAS5GYZVFJ2JG4q6pxYEpSVGdgR+tTJbLk1w5H42R7RTfFP3Ob/EccjLN1iyvNCosWxp125c6dcFvcVqxd9OOOXTlmGJbU+yluV5hyAnaa1XxD0SbZ3b5kfvUqHFFIJSUn5TEj2qVjp3bN8vn7wcfTir7pE5cX1r0w74h0J/yIqFJUTtUzSYVWp55PRRRQAUoxjCMNvnkvXuH2lw5lCc7zKVmBMCSO596b1XvR+UD0NJ8FRk4u4uhfZ29vZsJt7RlthlM5W2kBKRJkwB3qPFH1s2v5RhazlzfLoTO46fXprUwVXy5YF0xkCsqgZSqNjSsHbdszKLpo4iu3SVi6bCiVRHpEqkg9Bvz171psPdU/aoW6MrmygYMHvGk/TSkjfDwTem5TbW6Hzu8AJA7K3+3tT9hoMNJbBmOcRJOtSr7B10WEnWKmZ51A3vVhnY/WtCSSiiigAqK6TmYWO01LXxQzJIPMRQAn50kxBeLhxzwrdp1CM+RS4A9BKeexVAV0+9NnPEIGRSUmdcyZ/UVGvxfDV4rjGSDmKmzGXv5qhF0UrlVyzcuKYS0tlstiFBMqBICyOkDMfsKktbrEc7YThqENqU3nhQhMxnPq5TpprB7T6HgvSA9Yrzeb0ZpB/271ca8WcqXmYSYIDZ07erpRaYtRg3vVln0VTtwoJ86go9QIq80IbT9KpCZ6ooopiCiiigBJcgofcSB/UfasDxjiL9xxBaYW24/8IgFVyhmZOggGNeY21966LiKctxmj1AVzzjTC7pjEm8VsXFNocIFycoISBlBUJ3VAEDtXPm+p0YGtxBgLPxOL3F6+u+atGHMqrNTrihmiAkg8tCo9NBzprwNfP3vGeJPtXr71nmUpYKvLKgIkdspA6CO9KLZ1eF8QOjBviHG30hT7krIKyST55CRMjrHSug8I4fdW1g27iT/AMTdrTq8pEKI/ke01jBfKkbzmlB/lGkdUU26yn1RA1jU0yAgAdKoNltag0Skq0JT2mmFdqOAKKKKYBRRRQBBeMm4YUhKsqt0mJg0mcsL1aS2tlpxCtFBexH01r7RSasLImsGIKSuwYBQfIUgaftVxiycZWpSbcJzqzLgAZj1PfSiikopcDbbLVthzLd65fFMPuIS2T/aJI/7V6iiqEFFFFAH/9k=",
              "image_alt": "King Arthur Flour Pizza",
              "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBwgHBgkIBwgKCgkLDRYPDQwMDRsUFRAWIB0iIiAdHx8kKDQsJCYxJx8fLT0tMTU3Ojo6Iys/RD84QzQ5OjcBCgoKDQwNGg8PGjclHyU3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3N//AABEIAEgASAMBIgACEQEDEQH/xAAbAAACAwEBAQAAAAAAAAAAAAAABQMEBgcCAf/EADMQAAEDAgQEBAQFBQAAAAAAAAECAxEABAUSITEGQVFhEyIykRRScaEVI8HR8EJigYKx/8QAGQEAAwEBAQAAAAAAAAAAAAAAAAECAwQF/8QAIREAAgICAgEFAAAAAAAAAAAAAAECEQMSMUEEEyEiMnH/2gAMAwEAAhEDEQA/AO41WdWsOEJVAqzWR4i4vtcIxr8OXaXLz3hB0lBQlOU6bqUJpSkoq2aYsU8stYK2aFLr+YpUNBsobGsPxO/xd+P3CcMdvW7DwkltTFuhwZoE7ievOtPgmLN4zhjV/boWht0qAS5GYZVFJ2JG4q6pxYEpSVGdgR+tTJbLk1w5H42R7RTfFP3Ob/EccjLN1iyvNCosWxp125c6dcFvcVqxd9OOOXTlmGJbU+yluV5hyAnaa1XxD0SbZ3b5kfvUqHFFIJSUn5TEj2qVjp3bN8vn7wcfTir7pE5cX1r0w74h0J/yIqFJUTtUzSYVWp55PRRRQAUoxjCMNvnkvXuH2lw5lCc7zKVmBMCSO596b1XvR+UD0NJ8FRk4u4uhfZ29vZsJt7RlthlM5W2kBKRJkwB3qPFH1s2v5RhazlzfLoTO46fXprUwVXy5YF0xkCsqgZSqNjSsHbdszKLpo4iu3SVi6bCiVRHpEqkg9Bvz171psPdU/aoW6MrmygYMHvGk/TSkjfDwTem5TbW6Hzu8AJA7K3+3tT9hoMNJbBmOcRJOtSr7B10WEnWKmZ51A3vVhnY/WtCSSiiigAqK6TmYWO01LXxQzJIPMRQAn50kxBeLhxzwrdp1CM+RS4A9BKeexVAV0+9NnPEIGRSUmdcyZ/UVGvxfDV4rjGSDmKmzGXv5qhF0UrlVyzcuKYS0tlstiFBMqBICyOkDMfsKktbrEc7YThqENqU3nhQhMxnPq5TpprB7T6HgvSA9Yrzeb0ZpB/271ca8WcqXmYSYIDZ07erpRaYtRg3vVln0VTtwoJ86go9QIq80IbT9KpCZ6ooopiCiiigBJcgofcSB/UfasDxjiL9xxBaYW24/8IgFVyhmZOggGNeY21966LiKctxmj1AVzzjTC7pjEm8VsXFNocIFycoISBlBUJ3VAEDtXPm+p0YGtxBgLPxOL3F6+u+atGHMqrNTrihmiAkg8tCo9NBzprwNfP3vGeJPtXr71nmUpYKvLKgIkdspA6CO9KLZ1eF8QOjBviHG30hT7krIKyST55CRMjrHSug8I4fdW1g27iT/AMTdrTq8pEKI/ke01jBfKkbzmlB/lGkdUU26yn1RA1jU0yAgAdKoNltag0Skq0JT2mmFdqOAKKKKYBRRRQBBeMm4YUhKsqt0mJg0mcsL1aS2tlpxCtFBexH01r7RSasLImsGIKSuwYBQfIUgaftVxiycZWpSbcJzqzLgAZj1PfSiikopcDbbLVthzLd65fFMPuIS2T/aJI/7V6iiqEFFFFAH/9k=",
              "rank": 2
            },
            {
              "title": "Pizza Buddy Pizza Do...",
              "link": "https://www.google.com/search?hl=en&q=Pizza+Buddy+Pizza+Dough&stick=H4sIAAAAAAAAAONgFmJQ4tVP1zc0TM9IKkwqsjTQYljEKh6QWVWVqOBUmpJSqQBhu-SXpmfsYGUEAHLKv6oyAAAA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQxA16BAhDEAg",
              "image": "data:image/jpeg;base64,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",
              "image_alt": "Pizza Buddy Pizza Dough",
              "image_base64": "data:image/jpeg;base64,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",
              "rank": 3
            },
            {
              "title": "Pillsbury Classic Pizza Cr...",
              "link": "https://www.google.com/search?hl=en&q=Pillsbury+Classic+Pizza+Crust&stick=H4sIAAAAAAAAAONgFmJQ4tVP1zc0LDExNjTNqsjTYljEKhuQmZNTnFRaVKngnJNYXJyZrBCQWVWVqOBcVFpcsoOVEQCR9ToAOAAAAA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQxA16BAhDEAo",
              "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBwgHBgkIBwgKCgkLDRYPDQwMDRsUFRAWIB0iIiAdHx8kKDQsJCYxJx8fLT0tMTU3Ojo6Iys/RD84QzQ5OjcBCgoKDQwNGg8PGjclHyU3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3N//AABEIAEgASAMBIgACEQEDEQH/xAAbAAEAAgMBAQAAAAAAAAAAAAAABgcCAwUEAf/EADMQAAEDAwMBBwIDCQAAAAAAAAEAAgMEBREGEiExBxMUMkFRYRWBcZLDFiIlM0NSYmOR/8QAGgEBAAMBAQEAAAAAAAAAAAAAAAMEBQIGAf/EACQRAAICAQIGAwEAAAAAAAAAAAABAgMREhMEITFBUrEiQvAU/9oADAMBAAIRAxEAPwC8UREAREQBERAEREAREQBFAe0y/Xa1VFuhtFa6lMjJHSkRsfuwWhvmafcri2G9akvkrojql1JM1uGwsoYXmT3fktAAGeRnOAePfjWtWkuLgrdjf+pbCKl62+67oZjHU3lwDQC+VsFPsaM/3FgGeOnX4WX7R6uic11Tf5BTnzPZSwEsHvju+nv8ZVrYljKMz+iGUmXMirB1bqhsDJTqhwDnYO+CmYGH2JLMfgfw45XKq9T6npKqOnlv9S4vk2l8NHTyNaPQkhnGfZU9+ry9lvas8fRciKqaTU95nmZR02pWTVQJdI2amgY7AGSBjAJ4KzlveqHvP8VrIom+ot8TXH7Oac4+APvwm9X5HxVzfYtNFFtHVNwkqKuK5XV9edrHxh8McZjBH+AHXI6j0KKRSUllHLTXUjnajIxl3o94605x+ZR6aujgutHNFMGGMRbZHNLQAABk59MdfhSrtO0/eLvW0E1oojVCOJ7ZAJWM25II8zh8qJXLSOrKx0ZFglAbE2M76uAk4GM+f2wuIcrU2uWTXdlb4DQpfLEu/wC6ktudPR1lY51y7uqmpAcxxR8twRkcZPqfXGcctysZo4SI5rjEympY+NhcA9/OdvHr146jPPUFR+msmuImzNmsLasTY3+IqYXZIOQf5nPU9eOecrz1Wmda1Je6Syv3SEl58VBucT153+q0k4rlqPLShJ9YkktM1s+h00s9MainwYiS3IO1xAJB9x0HzhcGaS0VTJqmt72ncxwFPHVhru8HGdsRALT8jqStB0vrcW/wAtL/AAwl73Z4mHzcf7BxwCtD9PdowZtFnY8dMd/CP1Vi8RRNWNwxhmzRanWlJtM6+nmRz3Kf6dFRmSm2uLmxCNzc5xtOMgj1zwpPdKH61TRVEcUEdRtIInk8x9DloPycD7qA0unu0Zhx9Dhh5PLaqIY/5IvfQ2LXVCTMLUJZiXf1acEg84Lt+SM/KjVVmOcSWVkNWpSJToGhfQ3Sdk0EbJu5IkfFna/97jGQDjBRaOzC06morhcanU1IaYSRsZA0zMk6El3lccdQviuUxcYJMrWy1SznJYmEX1FIRhERAEREAREQBERAEREAREQBERAEREAREQH/2Q==",
              "image_alt": "Pillsbury Classic Pizza Crust",
              "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBwgHBgkIBwgKCgkLDRYPDQwMDRsUFRAWIB0iIiAdHx8kKDQsJCYxJx8fLT0tMTU3Ojo6Iys/RD84QzQ5OjcBCgoKDQwNGg8PGjclHyU3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3N//AABEIAEgASAMBIgACEQEDEQH/xAAbAAEAAgMBAQAAAAAAAAAAAAAABgcCAwUEAf/EADMQAAEDAwMBBwIDCQAAAAAAAAEAAgMEBREGEiExBxMUMkFRYRWBcZLDFiIlM0NSYmOR/8QAGgEBAAMBAQEAAAAAAAAAAAAAAAMEBQIGAf/EACQRAAICAQIGAwEAAAAAAAAAAAABAgMREhMEITFBUrEiQvAU/9oADAMBAAIRAxEAPwC8UREAREQBERAEREAREQBFAe0y/Xa1VFuhtFa6lMjJHSkRsfuwWhvmafcri2G9akvkrojql1JM1uGwsoYXmT3fktAAGeRnOAePfjWtWkuLgrdjf+pbCKl62+67oZjHU3lwDQC+VsFPsaM/3FgGeOnX4WX7R6uic11Tf5BTnzPZSwEsHvju+nv8ZVrYljKMz+iGUmXMirB1bqhsDJTqhwDnYO+CmYGH2JLMfgfw45XKq9T6npKqOnlv9S4vk2l8NHTyNaPQkhnGfZU9+ry9lvas8fRciKqaTU95nmZR02pWTVQJdI2amgY7AGSBjAJ4KzlveqHvP8VrIom+ot8TXH7Oac4+APvwm9X5HxVzfYtNFFtHVNwkqKuK5XV9edrHxh8McZjBH+AHXI6j0KKRSUllHLTXUjnajIxl3o94605x+ZR6aujgutHNFMGGMRbZHNLQAABk59MdfhSrtO0/eLvW0E1oojVCOJ7ZAJWM25II8zh8qJXLSOrKx0ZFglAbE2M76uAk4GM+f2wuIcrU2uWTXdlb4DQpfLEu/wC6ktudPR1lY51y7uqmpAcxxR8twRkcZPqfXGcctysZo4SI5rjEympY+NhcA9/OdvHr146jPPUFR+msmuImzNmsLasTY3+IqYXZIOQf5nPU9eOecrz1Wmda1Je6Syv3SEl58VBucT153+q0k4rlqPLShJ9YkktM1s+h00s9MainwYiS3IO1xAJB9x0HzhcGaS0VTJqmt72ncxwFPHVhru8HGdsRALT8jqStB0vrcW/wAtL/AAwl73Z4mHzcf7BxwCtD9PdowZtFnY8dMd/CP1Vi8RRNWNwxhmzRanWlJtM6+nmRz3Kf6dFRmSm2uLmxCNzc5xtOMgj1zwpPdKH61TRVEcUEdRtIInk8x9DloPycD7qA0unu0Zhx9Dhh5PLaqIY/5IvfQ2LXVCTMLUJZiXf1acEg84Lt+SM/KjVVmOcSWVkNWpSJToGhfQ3Sdk0EbJu5IkfFna/97jGQDjBRaOzC06morhcanU1IaYSRsZA0zMk6El3lccdQviuUxcYJMrWy1SznJYmEX1FIRhERAEREAREQBERAEREAREQBERAEREAREQH/2Q==",
              "rank": 4
            }
          ],
          "rank": 1,
          "global_rank": 2
        }
      ]
    },
    "snack_pack_map": {
      "image": "data:image/png;base64,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",
      "image_alt": "Map of pizza",
      "image_base64": "data:image/png;base64,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",
      "link": "https://www.google.com/search?hl=en&q=pizza&npsic=0&rflfq=1&rldoc=1&rllag=40711584,-74006968,203&tbm=lcl&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQtgN6BAgWEAI",
      "latitude": 40.711584,
      "longitude": -74.006968,
      "altitude": 203
    },
    "pagination": {
      "current_page": 1,
      "next_page_link": "https://www.google.com/search?q=pizza&hl=en&ei=P5meZMuIMLyiptQP89muyA0&start=10&sa=N",
      "next_page_start": 10,
      "next_page": 2
    },
    "related": [
      {
        "text": "Family-friendly dinner near New York",
        "list_group": true,
        "image": "https://lh5.googleusercontent.com/p/AF1QipN9vMB3YUcI2E2RBZYuhQcpa9q3yCLDClsVS20_=w40-h40-n-k-no",
        "image_url": "https://lh5.googleusercontent.com/p/AF1QipN9vMB3YUcI2E2RBZYuhQcpa9q3yCLDClsVS20_=w40-h40-n-k-no",
        "rank": 1,
        "global_rank": 14
      },
      {
        "text": "Quick bites near New York",
        "list_group": true,
        "image": "https://lh5.googleusercontent.com/p/AF1QipM0BsBfNtUBmGyzowDeE9Zkp30pYTdtbTJCpqai=w40-h40-n-k-no",
        "image_url": "https://lh5.googleusercontent.com/p/AF1QipM0BsBfNtUBmGyzowDeE9Zkp30pYTdtbTJCpqai=w40-h40-n-k-no",
        "rank": 2,
        "global_rank": 15
      },
      {
        "text": "Pizza takeaway near New York",
        "list_group": true,
        "image": "https://lh5.googleusercontent.com/p/AF1QipO_5JRLn_XOBC5luGuOcIG_JCdfGoeBOggO69Ly=w40-h40-n-k-no",
        "image_url": "https://lh5.googleusercontent.com/p/AF1QipO_5JRLn_XOBC5luGuOcIG_JCdfGoeBOggO69Ly=w40-h40-n-k-no",
        "rank": 3,
        "global_rank": 16
      },
      {
        "text": "Best restaurants near New York",
        "list_group": true,
        "image": "https://lh5.googleusercontent.com/p/AF1QipNgm_8G1gbEVoaG2CvygurS-TZpEIohi2zrx6tz=w40-h40-n-k-no",
        "image_url": "https://lh5.googleusercontent.com/p/AF1QipNgm_8G1gbEVoaG2CvygurS-TZpEIohi2zrx6tz=w40-h40-n-k-no",
        "rank": 4,
        "global_rank": 17
      },
      {
        "list_group": false,
        "link": "https://www.google.com/search?hl=en&q=Domino%27s+Pizza+Pakistan&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ1QJ6BAg4EAE",
        "text": "domino's pizza pakistan",
        "rank": 5,
        "global_rank": 18
      },
      {
        "list_group": false,
        "link": "https://www.google.com/search?hl=en&q=Domino%27s+pizza+near+me&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ1QJ6BAg3EAE",
        "text": "domino's pizza near me",
        "rank": 6,
        "global_rank": 19
      }
    ]
  }
  ```
</Accordion>

接下来，我们将检查经过解析的JSON数据中的一些重要字段，以了解我们所提供的结构化数据类型。

***

## SERP API 全面指南

在JSON响应的顶部，您可以找到general字段，其中包含有关您运行的搜索的详细信息，以及响应中的“结果数量”。

<Frame>
    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/general-field.png?maxW=686&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=eaa23c72b9c23b3e6ef1d9e2efbcba62" alt="General-Field" width="686" height="475" data-path="images/scraping-automation/serp-api/parsing-search-results/general-field.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/general-field.png?w=280&maxW=686&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d504f7339ca1540eb1314705c757e5f1 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/general-field.png?w=560&maxW=686&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=4ca4f87b9a398a9b663c969da6337989 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/general-field.png?w=840&maxW=686&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=144872548edef0c4584f499d019d88ad 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/general-field.png?w=1100&maxW=686&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f0d58cc1de586d4f07beef7c132add5a 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/general-field.png?w=1650&maxW=686&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d48a1de3bcbc96fc51070cc22a8076da 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/general-field.png?w=2500&maxW=686&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ad6dba22f82583284c675c026904df6f 2500w" data-optimize="true" data-opv="2" />
</Frame>

在 `general` 字段中可以找到以下字段

|                         |                                                            |
| ----------------------- | ---------------------------------------------------------- |
| `general.search_engine` | 用于搜索的搜索引擎                                                  |
| `general.query`         | 用于搜索的关键词                                                   |
| `general.results_cnt`   | 结果数量<br /><Info>Google不显示移动设备的结果数量，因此，此字段仅支持桌面搜索结果。</Info> |
| `general.search_time`   | 获取结果页面的响应时间                                                |
| `general.language`      | 为搜索设置的语言，<br /><br />**默认**: `hl=en`                       |
| `general.location`      | 搜索的目标位置（根据本地化和地理位置参数而定）                                    |
| `general.mobile`        | 搜索时使用的设备（台式机/移动设备）                                         |
| `general.basic_view`    | 已弃用                                                        |
| `general.search _type`  | 为请求设置的搜索类型                                                 |
| `general.Page_title`    | 结果页面标题                                                     |
| `general.Code_version`  | Bright data解析器版本                                           |
| `general.Timestamp`     | 执行搜索的时间                                                    |
| `Input.original_url`    | 用于搜索的URL，此URL包含应用于搜索的所有参数。.                                |

## 入门字段

| JSON字段          | 描述                         |
| --------------- | -------------------------- |
| `type`          | 字段类型（`site_link`、文本、评分等）   |
| `title`         | 文本标题，通常为链接文本。              |
| `description`   | 在链接下方的描述                   |
| `referral_link` | 重定向链接                      |
| `image`         | 此字段可能会包含图像的base64字符串或图像URL |
| `image_alt`     | 图像替代名称                     |

## 其他字段的说明

<AccordionGroup>
  <Accordion title="rank">
    |               |                          |
    | ------------- | ------------------------ |
    | `rank`        | 表示元素在该组成部分之内的位置（相对于其他元素） |
    | `global_rank` | 表示元素在SERP之内的位置（相对于所有元素）  |

    <Frame>
            <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rank-field.png?maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=0140578f985a05c0c5de988045f72a26" alt="Rank-Field" width="429" height="628" data-path="images/scraping-automation/serp-api/parsing-search-results/rank-field.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rank-field.png?w=280&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5aec929460eec2acd2d19d60675107f5 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rank-field.png?w=560&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=fc82fe8c6da4be28b72da1a0aa65ccb6 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rank-field.png?w=840&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f6085716bd327c2360d3cf3ca170957e 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rank-field.png?w=1100&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=fe69f3288de4c48ea204ee68ce302cc6 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rank-field.png?w=1650&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=bce0d4d0d50a06fd5b6f2cb4023bd7ff 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rank-field.png?w=2500&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b4b4d274bb1fae1c7a3b537642f44f5a 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>

  <Accordion title="spelling">
    当您的搜索词不准确时，Google 会建议其他搜索词，建议的搜索词将显示在`spelling`（拼写）字段下方。

    **子字段：**

    |                       |                 |
    | --------------------- | --------------- |
    | `Original_text`       | 用于搜索的文本         |
    | `Original_empty`      | true，表示未找到任何结果。 |
    | `Auto_corrected_link` | 指向建议结果的链接       |
    | `auto_corrected_text` | 建议的链接文本         |

    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-html.png?maxW=496&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a3aa86133e59b20411a77e6043f97f2f" alt="Spelling-HTML" width="496" height="254" data-path="images/scraping-automation/serp-api/parsing-search-results/spelling-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-html.png?w=280&maxW=496&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=63fc4d71586f6ad2e367a16ff080ca34 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-html.png?w=560&maxW=496&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=414a55cd2ebb6e46884f76b72702170d 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-html.png?w=840&maxW=496&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c46ab82f52d1ebd861794729e2b048b2 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-html.png?w=1100&maxW=496&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=59d63b972e7f88c04fb9001e855b6637 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-html.png?w=1650&maxW=496&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=0359220b0066025cf1cadda260882ab7 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-html.png?w=2500&maxW=496&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=cb557771128e727fb7de0f6e46de109c 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-json.png?maxW=781&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8a132f601a05977bb61699361b68f97f" alt="Spelling-JSON" width="781" height="135" data-path="images/scraping-automation/serp-api/parsing-search-results/spelling-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-json.png?w=280&maxW=781&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8d8db016613562c819af0b6ed826234e 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-json.png?w=560&maxW=781&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=86034cd436487dcd26cd4c6b0d9c96af 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-json.png?w=840&maxW=781&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=76ae55a0e9c66d62baf01972afefd15c 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-json.png?w=1100&maxW=781&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=408273d1b37c6b9ada4538b8b32bc819 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-json.png?w=1650&maxW=781&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=55b24f1e7844055b1eab7f50f3749d70 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-json.png?w=2500&maxW=781&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1dfd1be7a682421880cc29873701e3e0 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="rating & reviews">
    SERP的组成部分可能包括评论和评分字段

    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rating-reviews-html.png?maxW=366&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1addedb0972d777e56fa14eb09a41422" alt="Rating-Reviews-HTML" width="366" height="28" data-path="images/scraping-automation/serp-api/parsing-search-results/rating-reviews-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rating-reviews-html.png?w=280&maxW=366&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=dcbd6fc82af2a791cb72ad291ff5e17f 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rating-reviews-html.png?w=560&maxW=366&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=583e44e1cfffdb30e06459ade95b698f 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rating-reviews-html.png?w=840&maxW=366&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ff251b619c4fcc6d736c60a90805104f 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rating-reviews-html.png?w=1100&maxW=366&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=53cdbeadb1007d726d1b2abd04ed51e7 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rating-reviews-html.png?w=1650&maxW=366&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e481a96b44b89a28605167c4b9c63e87 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rating-reviews-html.png?w=2500&maxW=366&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=56beba3cbd8b3a632c5d31d2e59ca243 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ratings-reviews-json.png?maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=37eca3158aa0c4c502fdfb6e7533abc9" alt="Rating-Reviews-JSON" width="429" height="628" data-path="images/scraping-automation/serp-api/parsing-search-results/ratings-reviews-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ratings-reviews-json.png?w=280&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8e888a525e131c03e976036f37a6150f 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ratings-reviews-json.png?w=560&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=111bff45aeb9470cd9be79941a598d2d 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ratings-reviews-json.png?w=840&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a062172af9fac704a272f62fe7632a85 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ratings-reviews-json.png?w=1100&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=63261ff9b200cc650a237ef7223c45c4 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ratings-reviews-json.png?w=1650&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=15f3f665b73e57c9a3ff3fc5eeb82ff8 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ratings-reviews-json.png?w=2500&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f45c252645673bc6bfc25cf6188aa7db 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="extensions">
    一些SERP结果可能包括以垂直或水平列表显示的网站子链接（即网站链接）

    <Tab title="垂直 - 用“extended:true”标记">
      <Tabs>
        <Tab title="HTML">
          <Frame>
                        <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-html.png?maxW=610&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=332ffc6555ba4d530a86cefa94e1bfea" alt="Extensions-Vertical-HTML" width="610" height="375" data-path="images/scraping-automation/serp-api/parsing-search-results/ext-vertical-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-html.png?w=280&maxW=610&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=34fdf472a4c120d9b952e5aa4fc30cbf 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-html.png?w=560&maxW=610&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=2dfa5fc8bac3519cb2304466e69d638c 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-html.png?w=840&maxW=610&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e8d432ac8453a9034746682add142c30 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-html.png?w=1100&maxW=610&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=111377ba742cfb28b68edf65fe20021f 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-html.png?w=1650&maxW=610&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c6460a165bafad7c12a3736ecb6b10d4 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-html.png?w=2500&maxW=610&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=216c080a2eb9b330cb75180ad6f9fe74 2500w" data-optimize="true" data-opv="2" />
          </Frame>
        </Tab>

        <Tab title="JSON">
          <Frame>
                        <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-json.png?maxW=715&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9e41c3c59d5a44470a21c31a498ef757" alt="Extensions-Vertical-JSON" width="715" height="621" data-path="images/scraping-automation/serp-api/parsing-search-results/ext-vertical-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-json.png?w=280&maxW=715&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1d8e13127dbd58887acca21f9e5b0601 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-json.png?w=560&maxW=715&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5716b6a2054585059c0b41c03b4936ff 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-json.png?w=840&maxW=715&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=95b5d1753660fed7cb6b603a9623e4d5 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-json.png?w=1100&maxW=715&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=3572dfce7bc6dbcdf432b4161157c4bd 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-json.png?w=1650&maxW=715&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=134c1a28f0306f3e1c0676d51f4e4d21 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-json.png?w=2500&maxW=715&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d36a6bbcda41b61f1e45125dc71d66df 2500w" data-optimize="true" data-opv="2" />
          </Frame>
        </Tab>
      </Tabs>
    </Tab>

    <Tab title="水平 - 没有用“extended:true”标记">
      <Tabs>
        <Tab title="HTML">
          <Frame>
                        <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-html.png?maxW=557&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=90dbc9c364fb2051c327c550f955a861" alt="Extensions-Horizontal-HTML" width="557" height="139" data-path="images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-html.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-html.png?w=280&maxW=557&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=167a255737cc0eb7cd2827bcf0158d21 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-html.png?w=560&maxW=557&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8fbba38922d81efe3c054337d16fe542 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-html.png?w=840&maxW=557&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3442cd417f5fdc6b1a580b9ab4c40e95 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-html.png?w=1100&maxW=557&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=762940d039e1def0fa642b38fda5e516 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-html.png?w=1650&maxW=557&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=2fd7ad25025e02ab0f9994cdc446bd5b 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-html.png?w=2500&maxW=557&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=805f57c6db71ad76617ed1fab4cccc04 2500w" data-optimize="true" data-opv="2" />
          </Frame>
        </Tab>

        <Tab title="JSON">
          <Frame>
                        <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-json.png?maxW=752&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=bbec2f9253c80461235ee39073de3021" alt="Extensions-Horizontal-JSON" width="752" height="584" data-path="images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-json.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-json.png?w=280&maxW=752&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f093f96cad7823712e70853c4c236039 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-json.png?w=560&maxW=752&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=0a223f514630a8f76d1ffae6a124a4cc 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-json.png?w=840&maxW=752&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=93b35c0320d5327324b18c9ddbf276d8 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-json.png?w=1100&maxW=752&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a1a57720e51689803304c444d39fcf50 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-json.png?w=1650&maxW=752&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c36e025f4b3792e038689f6170450313 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-json.png?w=2500&maxW=752&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f99e93d3ef99e6740d3cc69e0b69f48f 2500w" data-optimize="true" data-opv="2" />
          </Frame>
        </Tab>
      </Tabs>
    </Tab>
  </Accordion>

  <Accordion title="display_link">
    以下是结果中的URL的面包屑：

    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-html.png?maxW=965&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=da1aecda11967b7f7db5db963396cef1" alt="Display-Link-HTML" width="965" height="572" data-path="images/scraping-automation/serp-api/parsing-search-results/display-link-html.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-html.png?w=280&maxW=965&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3575089e4c29f929e6681d9659b65558 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-html.png?w=560&maxW=965&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9c75adfbd4eb14239c1a7456abde83c9 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-html.png?w=840&maxW=965&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8b15e13968749a4da495e9a838740cc1 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-html.png?w=1100&maxW=965&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=85532ae2fcc6dd27f84eda3672db92c6 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-html.png?w=1650&maxW=965&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=47f3152c36bb884246e4142d3af31b83 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-html.png?w=2500&maxW=965&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=cad83d249fc9e5271a45aca0d0014fac 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-json.png?maxW=783&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c444d04557357d4cb3b18095307cd6be" alt="Display-Link-JSON" width="783" height="439" data-path="images/scraping-automation/serp-api/parsing-search-results/display-link-json.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-json.png?w=280&maxW=783&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=d8edb5254eb762386285dc7b91e208ec 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-json.png?w=560&maxW=783&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a969e17776de3849bbceddf135757120 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-json.png?w=840&maxW=783&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=d372c7d648978e9cc4460ed967728ed4 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-json.png?w=1100&maxW=783&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=5933bea0bc91d78412861601e7f84d51 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-json.png?w=1650&maxW=783&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=150e4ae9f8e758eff4d7eb3f7012394c 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-json.png?w=2500&maxW=783&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=076fffefd3518037add18d19fb82ef0f 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="organic">
    主搜索结果称为自然搜索结果，位于自然json节点中。

    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-html.jpg?maxW=758&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=932af4e587710ea1f0b2b3598bf807cb" alt="Orgranic-HTML" width="758" height="734" data-path="images/scraping-automation/serp-api/parsing-search-results/organic-html.jpg" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-html.jpg?w=280&maxW=758&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e127997b2cc2b804b03801372ab46075 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-html.jpg?w=560&maxW=758&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8d0d4d96618a798e7b5bd2ee730bb17c 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-html.jpg?w=840&maxW=758&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f6abb02b71ab7e7f6ca850cf410d7e07 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-html.jpg?w=1100&maxW=758&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=4959acfd7b77adebf89031acd330fb58 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-html.jpg?w=1650&maxW=758&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=457da038000ff7aeb26a8bd1bf79245d 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-html.jpg?w=2500&maxW=758&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f97ad7a8813663c27e813c9da1f55962 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-json.jpg?maxW=761&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=57e4724262c305d0c942d0dda3a60d0e" alt="Orgranic-JSON" width="761" height="663" data-path="images/scraping-automation/serp-api/parsing-search-results/organic-json.jpg" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-json.jpg?w=280&maxW=761&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=70351bf190a333ed26149235ab560654 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-json.jpg?w=560&maxW=761&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=2a022b7340bcea747ac8bc342db8f51c 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-json.jpg?w=840&maxW=761&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e55eb505e3098194ae4504ed429ded83 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-json.jpg?w=1100&maxW=761&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=40be6e88431aa792ea0504ed56a3593f 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-json.jpg?w=1650&maxW=761&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7bf3f1c8f1252ce74a6227f71d7b1b3a 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-json.jpg?w=2500&maxW=761&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ab9bd0089418c0ba901ba9a4fd33acee 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="ads">
    在SERP中有四个不同的广告位置，工具会分别对每个位置进行解析：

    |               |                                       |
    | ------------- | ------------------------------------- |
    | `top_ads`     | 位于SERP顶部的广告                           |
    | `top_pla`     | 位于SERP顶部的轮播图中的广告                      |
    | `jackpot_pla` | 位于右侧购物广告面板中的广告。通常在一种特定产品与您的搜索完全匹配时出现。 |
    | `bottom_ads`  | 位于SERP底部的广告                           |

    <Note>
      默认情况下，SERP API显示的是“自然”广告（根据IP位置和Cookie等而定）。 如果您希望SERP API以不同的方式（无痕模式、广告测试模式）展示广告，可以在控制面板的SERP API区域中进行更改。
    </Note>

    <AccordionGroup>
      <Accordion title="top_ads">
        <Tabs>
          <Tab title="HTML">
            <Frame>
                            <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-html.jpg?maxW=751&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=108cb006ad8a83cc2cf7ff8e7062bfe2" alt="Top-Ads-HTML" width="751" height="590" data-path="images/scraping-automation/serp-api/parsing-search-results/top-ads-html.jpg" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-html.jpg?w=280&maxW=751&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=181f11d0a77f018dc351c86710237470 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-html.jpg?w=560&maxW=751&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7a2a1354a85249ec8cf577862376f197 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-html.jpg?w=840&maxW=751&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=36c09be08927edf812d4011be4f36171 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-html.jpg?w=1100&maxW=751&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=90a6aa6ca04e75145bda72c51dc4d031 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-html.jpg?w=1650&maxW=751&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a7eed5da155595f06bc0072b759407f4 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-html.jpg?w=2500&maxW=751&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ad60d144dd28059f4215417ebcf33fd9 2500w" data-optimize="true" data-opv="2" />
            </Frame>
          </Tab>

          <Tab title="JSON">
            <Frame>
                            <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-json.jpg?maxW=774&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ef471b861a719f1a2b729abf064b7e57" alt="Top-Ads-JSON" width="774" height="601" data-path="images/scraping-automation/serp-api/parsing-search-results/top-ads-json.jpg" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-json.jpg?w=280&maxW=774&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8b9e874d8e0922cbb8b4171ceb27a1ae 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-json.jpg?w=560&maxW=774&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=58b115264c11e5107879797d0d6fb94c 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-json.jpg?w=840&maxW=774&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=313f3f3612fdc594445b76258c9418d8 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-json.jpg?w=1100&maxW=774&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b2bd1fddb8b574ed34cd9f2f26b91cab 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-json.jpg?w=1650&maxW=774&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b7111cbf2fd14196d74e9639ba47c773 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-json.jpg?w=2500&maxW=774&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c916ed443b53ae355c1c3f38c359b92a 2500w" data-optimize="true" data-opv="2" />
            </Frame>
          </Tab>
        </Tabs>
      </Accordion>

      <Accordion title="top_pla">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-pla.png?maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=62766a789e156d04fbd5aedf0bc706c3" alt="Top-PLA" width="1600" height="471" data-path="images/scraping-automation/serp-api/parsing-search-results/top-pla.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-pla.png?w=280&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=3cd9e0c674662d2ab8d0d4e13697a7c5 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-pla.png?w=560&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=04aa10b3e4660aef3cb019afe721d374 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-pla.png?w=840&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=0ada00da3e364dc0da9e6224ffb22ea7 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-pla.png?w=1100&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=cf1777a6cc1ebe5df388f823b9c4a815 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-pla.png?w=1650&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d0fb59657fc9c547684f48a9b935ed53 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-pla.png?w=2500&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d02577c90d8958c5d7715d9d406867fb 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="jackpot_pla">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/jackpot-pla.png?maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9b11af57d2b0ba033e9df7b8aa23116c" alt="Jackpot-PLA" width="1600" height="663" data-path="images/scraping-automation/serp-api/parsing-search-results/jackpot-pla.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/jackpot-pla.png?w=280&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1740bc2fc04be9f68d5fb85c36f87cf6 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/jackpot-pla.png?w=560&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5fe4f3304acd52c84f36e3228172d0c9 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/jackpot-pla.png?w=840&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=675364d1fa519b8e666f49f3b33c78e2 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/jackpot-pla.png?w=1100&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=50d3e4455269bab45a669c56d15972d0 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/jackpot-pla.png?w=1650&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7492fb264cd7653d0aa3a57c1594c1c3 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/jackpot-pla.png?w=2500&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e149b70d236694556055618a1ed21d6b 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="bottom_ads">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/bottom-ads.png?maxW=1600&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=5775b23e9a84e15179ed761b20fa0b2a" alt="Bottom-Ads" width="1600" height="599" data-path="images/scraping-automation/serp-api/parsing-search-results/bottom-ads.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/bottom-ads.png?w=280&maxW=1600&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=50dfcee40dc3c90452aecab3027a3bde 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/bottom-ads.png?w=560&maxW=1600&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=7562a71402b1c905f6264f2c7306ddd8 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/bottom-ads.png?w=840&maxW=1600&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e4948b9e1a6ab4f401432328481387b2 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/bottom-ads.png?w=1100&maxW=1600&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9cc369a379be81dd84faf6356323aea2 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/bottom-ads.png?w=1650&maxW=1600&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=913b5634c05ce552be7c7e890b6acad8 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/bottom-ads.png?w=2500&maxW=1600&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f8006dbbf9e281a37fc94baaa5f2e890 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="people_also_ask">
    `people_also_ask`（PAA）部分包含Google根据其认为与您的问题相关的查询自动生成的问题。

    ### `answers`

    在SERP中，PAA框中的问题带有答案，用户只需点击即可阅读。这可以帮助人们更好地理解自己最初的问题，而又无需点击其他结果。这里的每个问题都在“答案”元素下有其答案。

    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-html.png?maxW=624&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1ee62cb886198ccedda1603cac220e88" alt="People-Also-Ask-HTML" width="624" height="502" data-path="images/scraping-automation/serp-api/parsing-search-results/people-also-ask-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-html.png?w=280&maxW=624&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8c21050f179d8b03c46cda9d9253d6fb 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-html.png?w=560&maxW=624&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=799739cc7c79ade14a42bf6414a56c87 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-html.png?w=840&maxW=624&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=cc8aef982d50f872dc94b7adae2fd8ac 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-html.png?w=1100&maxW=624&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=17b970ccfeeb72b0bbbb38edd3f4e5f9 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-html.png?w=1650&maxW=624&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7c1773a03f7f7e7093129af2dd9c5ed6 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-html.png?w=2500&maxW=624&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=45c87b5c616afa099d80545518952866 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-json.png?maxW=676&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9caac338374b7d71a2bf7e12227cf38d" alt="People-Also-Ask-JSON" width="676" height="634" data-path="images/scraping-automation/serp-api/parsing-search-results/people-also-ask-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-json.png?w=280&maxW=676&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d81f54264952e3da506eda9ecae8678e 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-json.png?w=560&maxW=676&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5eccce1c4bf05f9033f40ddd18d5fbfc 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-json.png?w=840&maxW=676&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9d7676898c77afdb4efd2714e9757186 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-json.png?w=1100&maxW=676&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=47f5dd5d9f8192204a02d7925c3ed440 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-json.png?w=1650&maxW=676&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=39642e2c03eb8ba7c7609b94f5145ae4 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-json.png?w=2500&maxW=676&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=163d97360b3417a3aa1f5a0ece48cf85 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="videos">
    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-html.png?maxW=724&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b1cc197615658d63702de46f0cbf6f31" alt="Videos-HTML" width="724" height="639" data-path="images/scraping-automation/serp-api/parsing-search-results/videos-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-html.png?w=280&maxW=724&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d99f1d635795e58081972e4d8f7d34fd 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-html.png?w=560&maxW=724&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=44bbbd52596ca3279a88f979560ad25f 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-html.png?w=840&maxW=724&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=121d084d823b610aa64510822dd1dd52 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-html.png?w=1100&maxW=724&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=283fb4b38924329abd0eabe95a86911a 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-html.png?w=1650&maxW=724&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=94eb4ba92d9f32c998e063bfc66b7497 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-html.png?w=2500&maxW=724&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=4f5980a2fba6d1edfd11675b08978b70 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-json.png?maxW=703&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=636aad9d7e448c777ddb54cc60f6fd16" alt="Videos-JSON" width="703" height="648" data-path="images/scraping-automation/serp-api/parsing-search-results/videos-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-json.png?w=280&maxW=703&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b0866cab6f88ea62023307ec42bca59f 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-json.png?w=560&maxW=703&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1d4538ac5420815819469d55a6c70264 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-json.png?w=840&maxW=703&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ab89d45f07836b18f476340db538e590 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-json.png?w=1100&maxW=703&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ffcb4f19a6da15b8a861ef900295231b 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-json.png?w=1650&maxW=703&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=58d739c2fa839b2d72af4b0fe3227ed0 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-json.png?w=2500&maxW=703&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b9531199244644f9f91cd97622e3cdd8 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="twitter">
    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-html.png?maxW=647&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a431398dc8e7add26dc845543727cc5f" alt="Twitter-HTML" width="647" height="301" data-path="images/scraping-automation/serp-api/parsing-search-results/twitter-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-html.png?w=280&maxW=647&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=aa5d9dc1ac9ce3437f8f9adc2a719db1 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-html.png?w=560&maxW=647&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7502cb4d548c15b5958905cb627c3fd3 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-html.png?w=840&maxW=647&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=cb6c1db0455a07c4dd7f8d94c3c2d491 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-html.png?w=1100&maxW=647&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f0f3558f36cf0b37a1dded8d7056a5b9 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-html.png?w=1650&maxW=647&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1f29040d4e865a0bc198133b84754c2c 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-html.png?w=2500&maxW=647&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8cd3d40cb39bed0040d9ce15ba525016 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-json.png?maxW=783&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d49417f7939f9b904eed91f7d848c696" alt="Twitter-JSON" width="783" height="559" data-path="images/scraping-automation/serp-api/parsing-search-results/twitter-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-json.png?w=280&maxW=783&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5dd11d532e40af8ae696c827f7524f31 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-json.png?w=560&maxW=783&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a1bff14a0bad521a1d5e61b8d0823a03 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-json.png?w=840&maxW=783&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d43f978f165070566ddd8e64d92841bc 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-json.png?w=1100&maxW=783&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a520c29f365efad2e5d52323627732f2 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-json.png?w=1650&maxW=783&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=cf1a72a601f1022e5fae50078f691c01 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-json.png?w=2500&maxW=783&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7eac6f3b1bef5ba281e053ebc1e55f36 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="top_stories">
    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-html.png?maxW=511&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d6e72070250cba8ce2f8343b0c9bbc8f" alt="Top-Stories-HTML" width="511" height="567" data-path="images/scraping-automation/serp-api/parsing-search-results/top-stories-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-html.png?w=280&maxW=511&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=6671caed4a8f40f6bb9575f7dd294dfd 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-html.png?w=560&maxW=511&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=519b91135d360a05fe36620f373fb3bf 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-html.png?w=840&maxW=511&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c0250c7bdda7469e0eac7459901988ab 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-html.png?w=1100&maxW=511&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=3dc90443282c4fd6824745c98e3bc131 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-html.png?w=1650&maxW=511&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=329547ccc19c949221719680c1fbe2ee 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-html.png?w=2500&maxW=511&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ca2f622e13d0fd3d55cb20e1a717cffd 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-json.png?maxW=786&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a679543ad933991dc01117fd7bb95561" alt="Top-Stories-JSON" width="786" height="536" data-path="images/scraping-automation/serp-api/parsing-search-results/top-stories-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-json.png?w=280&maxW=786&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7417f34c897ee2ea8da505f410f1f57f 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-json.png?w=560&maxW=786&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ca6954924897ac5d5ad2f8a4dd8f965d 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-json.png?w=840&maxW=786&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=19648fdf35913d98317018aa8a36167d 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-json.png?w=1100&maxW=786&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e77599bd408fbf0c6cbdf2a027cd74bc 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-json.png?w=1650&maxW=786&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=acaec31be92203d02a30726685a018ab 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-json.png?w=2500&maxW=786&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=28edfc5a022f5e4b9a3a48e61448ea90 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="knowledge">
    在知识面板（桌面 - 在右侧，移动设备 - 在顶部）中提供所搜索主题的简要概述

    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-html.png?maxW=479&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=af621c0bc698b6278ad35199dd3982fd" alt="Knowledge-HTML" width="479" height="520" data-path="images/scraping-automation/serp-api/parsing-search-results/knowledge-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-html.png?w=280&maxW=479&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=25203d7b8ce85b451baa60cc7d633865 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-html.png?w=560&maxW=479&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f76e3dd0ea7e804310b9e8585f03bb3b 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-html.png?w=840&maxW=479&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=36f3705a2554673a8d2f6a3af40df4ae 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-html.png?w=1100&maxW=479&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9f6a8984a69b0416af309d6a3f01096a 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-html.png?w=1650&maxW=479&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=dd6bf68d859bd8c55c511d727d36682c 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-html.png?w=2500&maxW=479&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=96b637c8e85b905ff661a1893fec8191 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-json.png?maxW=305&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ddf6b596685a4c029cba8a713cdf5313" alt="Knowledge-JSON" width="305" height="548" data-path="images/scraping-automation/serp-api/parsing-search-results/knowledge-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-json.png?w=280&maxW=305&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=300b7229d65a514c304ec286da3b97f9 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-json.png?w=560&maxW=305&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=31174a74338e54026a0c218dac41311f 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-json.png?w=840&maxW=305&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=06efcec60ec335337948134d3d57c86b 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-json.png?w=1100&maxW=305&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=69973b94c6deca05d2d88c8b1ca99fd7 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-json.png?w=1650&maxW=305&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=78d1f7bdce01502c943343533242ebda 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-json.png?w=2500&maxW=305&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=df2d3ee2bb40f48ae1c039ef433235a0 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>

    ### `widgets`

    |                                           |                 |
    | ----------------------------------------- | --------------- |
    | `knowledge.widgets.social_media_presence` | 包括个人档案          |
    | `knowledge.widgets.sideways_refinements`  | people also ask |
  </Accordion>

  <Accordion title="recipes">
    搜索食物时，SERP 可能还会包含食谱

    <Frame>
            <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/recipes.png?maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=af99462ed7720260f2a1faf5e1c5848b" alt="Recipes" width="1600" height="491" data-path="images/scraping-automation/serp-api/parsing-search-results/recipes.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/recipes.png?w=280&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b00392c1a1f72f2f503c4f1fdfc37ddd 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/recipes.png?w=560&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ba3dffab2de388b7845a20e3b60c7a7c 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/recipes.png?w=840&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f390667ce473007a79b5d82a67827f5b 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/recipes.png?w=1100&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a459b39cd9b9db7ddcf25d548bb74ecd 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/recipes.png?w=1650&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=2f6336ff5ece2577bea8463f51c0311a 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/recipes.png?w=2500&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=71c6f8c7ed4c4eda8e211626b6cb16e2 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>

  <Accordion title="snack_pack_map & snack_pack">
    与在SERP中显示的Google地图相关。

    ### `snack_pack_map`

    这个地图部分显示在JSON中，包含地图位置的坐标。

    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=cbea8ec3c762484bf1a70f2c1be0dbe4" alt="Snackpack-Map-HTML" width="687" height="718" data-path="images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=280&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f93d9faa6031d141243b598d49444b07 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=560&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1155ac85c51cb03cfab4591f0a74f638 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=840&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=70f2cac5aadfc3cc2a18fa2ded54f5e5 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=1100&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e8355c1d9009a0d5dcaa6ba77e9b046c 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=1650&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=865ebdaa73c7c56fe313f5305a450ca3 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=2500&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5911114035a7285265fab667d094ed63 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=3f6bc95cc6d5a74ea981723bd40b67c1" alt="Snackpack-Map-JSON" width="798" height="504" data-path="images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=280&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=72c606e73a275fc8a48afa70b3ec4d91 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=560&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ea60c7f4f6289508d18a3d5956a1865a 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=840&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8735ca6a9d68fd46344c03282da2a4ba 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=1100&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=47bd6bb41913695b7d956bb337a58962 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=1650&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9a1d0a2ca3feb2db2e98779f18bfd7cf 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=2500&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c8129be60b5793be346b90bf53d8891e 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>

    ### `snack_pack`

    如果地图包含特定位置的图钉，则JSON中会包含每个位置的snack\_pack字段，其中包含更多详细信息，如营业时间、联系方式、标签等。

    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=cbea8ec3c762484bf1a70f2c1be0dbe4" alt="Snackpack-HTML" width="687" height="718" data-path="images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=280&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f93d9faa6031d141243b598d49444b07 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=560&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1155ac85c51cb03cfab4591f0a74f638 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=840&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=70f2cac5aadfc3cc2a18fa2ded54f5e5 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=1100&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e8355c1d9009a0d5dcaa6ba77e9b046c 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=1650&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=865ebdaa73c7c56fe313f5305a450ca3 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=2500&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5911114035a7285265fab667d094ed63 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=3f6bc95cc6d5a74ea981723bd40b67c1" alt="Snackpack-JSON" width="798" height="504" data-path="images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=280&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=72c606e73a275fc8a48afa70b3ec4d91 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=560&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ea60c7f4f6289508d18a3d5956a1865a 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=840&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8735ca6a9d68fd46344c03282da2a4ba 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=1100&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=47bd6bb41913695b7d956bb337a58962 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=1650&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9a1d0a2ca3feb2db2e98779f18bfd7cf 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=2500&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c8129be60b5793be346b90bf53d8891e 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="related">
    在SERP的底部，Google还为用户提供了一个“相关搜索”部分，提示与初始搜索相关的其他搜索查询。

    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-html.png?maxW=691&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=12fb8fd40a2c0020a09d51040aaa74c2" alt="Related-HTML" width="691" height="301" data-path="images/scraping-automation/serp-api/parsing-search-results/related-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-html.png?w=280&maxW=691&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ee4ef791d80f83d196c0d55e481ba0e3 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-html.png?w=560&maxW=691&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=bde83b511832dbcd5cb978e392eea11d 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-html.png?w=840&maxW=691&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=bee987ab5aa7c39a4f537910f2b8bfc9 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-html.png?w=1100&maxW=691&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1299a7977367f8cb54c21b801d86864e 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-html.png?w=1650&maxW=691&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=eb93dbff38f159a7a6208f187e911159 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-html.png?w=2500&maxW=691&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=760121c146f09def60147ba8f279c3b1 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-json.png?maxW=680&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c30a5629704c66c035dc28b377e0c3e9" alt="Related-JSON" width="680" height="688" data-path="images/scraping-automation/serp-api/parsing-search-results/related-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-json.png?w=280&maxW=680&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f6585c4b26163bd5fedb993daad2eb32 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-json.png?w=560&maxW=680&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ea8b55e1e7527b2b8a68a6797cb4dc5d 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-json.png?w=840&maxW=680&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a924b35121745b64c7b371b5b5b4d27f 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-json.png?w=1100&maxW=680&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e42e84377cb8b3f283d5ed0494013fe1 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-json.png?w=1650&maxW=680&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=91ada88068170fffc38b948316ec23a4 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-json.png?w=2500&maxW=680&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=4e6345e7fe449f3471227e4696126246 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>

    <Note>
      | `List_group` | Description       |
      | ------------ | ----------------- |
      | `true`       | 元素按照以下截图顶部所示分组时   |
      | `false`      | 元素没有按照以下截图底部所示分组时 |

      <Frame>
                <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/list-group.png?maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=90febdf89882a6f92dfddeac4e90ea83" alt="List-Group" width="1600" height="520" data-path="images/scraping-automation/serp-api/parsing-search-results/list-group.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/list-group.png?w=280&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=128c3d7b329efe00a0187404e984e2e6 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/list-group.png?w=560&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b38b2c3216f5cef8adc01c7aec106f73 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/list-group.png?w=840&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=0a87a9bdec90acba1284b958ef0602d2 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/list-group.png?w=1100&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5cbfa31b4a310992ed7e0fd3566086e6 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/list-group.png?w=1650&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=2c5553f18605ed6cbe4cbfb7a140af2a 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/list-group.png?w=2500&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=fa645c6f5f647354648bf4dc1c734c91 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Note>
  </Accordion>

  <Accordion title="flights">
    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-html.png?maxW=517&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=4ce78d0969174687fe396bc3036d710f" alt="Flights-HTML" width="517" height="379" data-path="images/scraping-automation/serp-api/parsing-search-results/flights-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-html.png?w=280&maxW=517&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b6f2e1d24005121d65a74d3f924497ca 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-html.png?w=560&maxW=517&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a37abce23f2697ec0afe0b54457607a9 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-html.png?w=840&maxW=517&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=6de564bb8fc76c9480c9113bed2c393e 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-html.png?w=1100&maxW=517&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=65c6ac60875e70fe819f319954d800a2 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-html.png?w=1650&maxW=517&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b254f8f3c8472fa94db7e9b3a534645d 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-html.png?w=2500&maxW=517&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1a716dcb93e01894f64ce03027fce733 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-json.png?maxW=771&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c252435942c8cfcd0205202ea247b309" alt="Flights-JSON" width="771" height="560" data-path="images/scraping-automation/serp-api/parsing-search-results/flights-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-json.png?w=280&maxW=771&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=6a5d876a9aba45e8a107eecc8ce39814 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-json.png?w=560&maxW=771&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d3ccb85a6d086114c754593a5cad00fb 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-json.png?w=840&maxW=771&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=22bd3e74e6d437ce344b47a67370f1dc 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-json.png?w=1100&maxW=771&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7ba83dbb19e6aca9645d7e89f24ef7dc 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-json.png?w=1650&maxW=771&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=83c82254827ab345bf051a196808668f 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-json.png?w=2500&maxW=771&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=05dbe370dec926f8cb7ee98dbe9b41fd 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="hotels">
    Bright Data 的 SERP API使收集酒店数据（例如价格、空房情况、评论等）变得轻松简单。

    以下介绍使用Google Search从酒店知识图谱中收集数据的方法，以及如何从Google Travel的酒店页面获取更多详细信息。

    当您使用Google Search搜索酒店时，酒店的详细信息和评价会显示在右侧出现的知识图谱中

    <Frame>
            <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=65a519d4d1df376be92072f37e960564" alt="Hotels-HTML" width="1485" height="825" data-path="images/scraping-automation/serp-api/parsing-search-results/hotels-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=280&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ea51010d652f7efb5fc2e53f7f9c2b3d 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=560&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e53526df0ebde2a6e5585a80b88c8925 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=840&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=239d278dd1edd6249281f2c725600f54 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=1100&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=948e3112a099ec78602f0c4169bb55d6 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=1650&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9e47d7829affa1e15fb7f963d55a827c 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=2500&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=afe375ec32d8742412037efe2a68cd87 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    设置入住和离开日期以及房客数量，就可以查看和比较一些酒店的价格。

    通过SERP API，您可以设置这些字段，以使用专用参数来收集不同的价格组合。

    <Frame>
            <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=18fa40bdcd198e4d337ccb5301902634" alt="Hotels-Availability" width="548" height="666" data-path="images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=280&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=55ad6ed979ae83dcbbdc244da9856b96 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=560&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=75d638ee411bca2c0cd3aa33c51754b5 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=840&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b053d968ea76d60b4cfa30860de4f7ad 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=1100&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f6b7e3482c9b500e8f4bfd5f5e8efe5b 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=1650&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1d1d2097689da1396849b05b074526bd 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=2500&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ce827ec1b01d6a89cbb5e127939d9c9c 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    您还可以使用SERP API来针对 Google Travel 的酒店页面进行抓取，在其中您能够找到更多价格，并以更多参数（包括入住和离开日期、成人和儿童人数、儿童年龄以及是否可免费取消）进行搜索，从而收集更多价格组合。请转到API指南了解详情: [https://brightdata.com/cp/serp\_api/api/google/hotels](https://brightdata.com/cp/serp_api/api/google/hotels)
  </Accordion>

  <Accordion title="pagination">
    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-html.png?maxW=533&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=28427e8a436f0b63b00f02e91c6333f0" alt="Pagination-HTML" width="533" height="138" data-path="images/scraping-automation/serp-api/parsing-search-results/pagination-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-html.png?w=280&maxW=533&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f94521f0a0d2e6eddd883642c4595fd9 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-html.png?w=560&maxW=533&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ce8a921b6cd44cd9b46b6f5b448e7333 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-html.png?w=840&maxW=533&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=624fead96dcbd78eb058c5dc9caf7456 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-html.png?w=1100&maxW=533&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=585194aee30f7861c5f3ee040ef630f5 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-html.png?w=1650&maxW=533&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8bf39e70eb8fe57a5c0f15c4f9c576bc 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-html.png?w=2500&maxW=533&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f0796ba6c9f9e7dc478a15a747fa0e79 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-json.png?maxW=566&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e9690b38b9cb43ceffb34dc8acb70429" alt="Pagination-JSON" width="566" height="508" data-path="images/scraping-automation/serp-api/parsing-search-results/pagination-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-json.png?w=280&maxW=566&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ed7bea5e663bd41d15c010fe2f4d56da 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-json.png?w=560&maxW=566&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c515193ef2930c850b21c38f9a8bd0d8 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-json.png?w=840&maxW=566&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=57ff9dcc47155e573f52424f3d07be7b 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-json.png?w=1100&maxW=566&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=39fa0798ac5fdb620259f66b76bf2d21 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-json.png?w=1650&maxW=566&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=fbafbb09a6f2da70283e5c6c33d45bb1 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-json.png?w=2500&maxW=566&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ec0e42243806ee981004605d872cb9ac 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>

    分页索引可以在底部的 JSON 部分找到：

    |                                          |                    |
    | ---------------------------------------- | ------------------ |
    | `current_page`                           | 搜索中请求的页面位置         |
    | `first_page_link`                        | 第一页的链接             |
    | `prev_page_link`<br />`next_page_link`   | 指向请求页面             |
    | `prev_page_start`<br />`next_page_start` | 上一页和下一页中的第一个搜索结果编号 |
    | `prev_page`<br />`next_page`             | 上一页和下一页的页数         |
    | `page`                                   | 页码                 |
    | `link`                                   | 页面链接               |
    | `start`                                  | 页面中的第一个结果          |
  </Accordion>
</AccordionGroup>


# SERP API 必应查询参数
Source: https://docs.brightdata.com/cn/scraping-automation/serp-api/query-parameters/bing

使用 Bright Data 的 SERP API 配置必应搜索查询，包括本地化参数、地理位置、分页、设备定位和自定义数据输出选项。

## 搜索

<AccordionGroup>
  <Accordion title="本地化" icon="flag">
    ### `cc`

    用于定义搜索国家/地区的双字母国家/地区代码

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&cc=us"
    ```
  </Accordion>

  <Accordion title="地理位置" icon="location-dot">
    ### `位置`

    搜索起点位置。

    同时还必须指定 `lat` 和 `lon` 参数

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&位置=New+York%2C+New+York%2C+United+States&lat=40.7001958&lon=-74.1087142"
    ```

    ### `lat`

    搜索起点的 GPS 纬度

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&lat=40.7001958&lon=-74.1087142"
    ```

    ### `lon`

    搜索起点的 GPS 经度

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&lat=40.7001958&lon=-74.1087142"
    ```

    ### `mkt`

    搜索结果来自的市场。 使用此链接可查看所有可选值。

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&mkt=en-US"
    ```
  </Accordion>

  <Accordion title="分页" icon="file">
    ### `first`

    定义结果偏移量——结果从所选值开始。 用于管理分页。

    > #### 示例：
    >
    > `first=1` （默认）— 第一页结果 \
    > `first=11` — 第二页结果 \
    > `first=21` — 第三页结果，以此类推

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&first=11"
    ```

    ### `count`

    定义要返回的结果数。

    > #### 示例：
    >
    > `count=10` （默认） - 返回 10 个结果 \
    > `count=30` - 返回 30 个结果，以此类推

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&num=20"
    ```
  </Accordion>

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

    定义要在用户代理中表示的设备类型

    默认或 `brd_mobile=0` 时将提供随机桌面用户代理，而 `brd_mobile=1` 时将提供随机移动用户代理。

    > **对于特定的移动平台，提供以下值之一:** \
    > `brd_mobile=ios` - iPhone 用户代理（别名 `brd_mobile=iphone`） \
    > `brd_mobile=ipad` - iPad 用户代理（别名 `brd_mobile=ios_tablet`） \
    > `brd_mobile=android` - 安卓手机 \
    > `brd_mobile=android_tablet` - 安卓平板 \\

    ```sh
    curl --proxy brd.superproxy.io:33335 --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` - 谷歌 Chrome \
    > `brd_browser=safari` - Safari \
    > `brd_browser=firefox` - Mozilla Firefox (not compatible with `brd_mobile=1`)

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

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

    Bright Data 自定义参数允许返回已解析的 JSON 而不是原始 HTML

    > #### 示例：
    >
    > `brd_json=1` - 返回 JSON 格式的结果 \
    > `brd_json=html` - 返回带有包含原始 HTML 的 “html” 字段的 JSON 文件

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza?brd_json=1"
    ```
  </Accordion>
</AccordionGroup>


# SERP API DuckDuckGo 查询参数
Source: https://docs.brightdata.com/cn/scraping-automation/serp-api/query-parameters/duckduckgo

Configure DuckDuckGo search queries with Bright Data's SERP API, including parameters for localization, safe search, time range, and device targeting, tailored to meet your data extraction needs.

## 搜索

<AccordionGroup>
  <Accordion title="本地化" icon="flag">
    ### `kl`

    用于定义搜索国家/地区和语言的国家/地区和语言代码。 点击此处查看完整列表:\
    [https://api.brightdata.com/serp/duckduckgo/kl\_values](https://api.brightdata.com/serp/duckduckgo/kl_values)

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://duckduckgo.com/?q=pizza&kl=us-en"
    ```

    ### `kad`

    搜索页面界面语言：按钮、菜单。 点击此处查看完整列表:\
    [https://api.brightdata.com/serp/duckduckgo/kad\_values](https://api.brightdata.com/serp/duckduckgo/kad_values)

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://duckduckgo.com/?q=pizza"
    ```
  </Accordion>

  <Accordion title="安全搜索" icon="shield">
    ### `kp`

    移除搜索结果中的成人内容。

    > **可用值如下：** \
    > ` 1` - 打开安全搜索 \
    > `-1` - 适度搜索内容 \
    > `-2` - 关闭安全搜索

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://duckduckgo.com/?q=pizza&kp=1"
    ```
  </Accordion>

  <Accordion title="时间范围" icon="calendar">
    ### `df`

    搜索时间范围。

    > **可用值如下：** \
    > `d` - 过去 2 周 \
    > `w` - 上个月 \
    > `m` - 过去 3 个月 \
    > `w` - 过去 6 个月

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://duckduckgo.com/?q=pizza&df=d"
    ```
  </Accordion>

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

    定义要在用户代理中表示的设备类型

    默认或 `brd_mobile=0` 时将提供随机桌面用户代理，而 `brd_mobile=1` 时将提供随机移动用户代理。

    > **对于特定的移动平台，提供以下值之一：**  \
    > `brd_mobile=ios` - iPhone 用户代理（别名 `brd_mobile=iphone`） \
    > `brd_mobile=ipad` - iPad 用户代理（别名 `brd_mobile=ios_tablet`） \
    > `brd_mobile=android` - 安卓手机 \
    > `brd_mobile=android_tablet` - 安卓平板

    ```sh
    curl --proxy brd.superproxy.io:33335 --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` - 谷歌 Chrome \
    > `brd_browser=safari` - Safari \
    > `brd_browser=firefox` - Mozilla Firefox (not compatible with `brd_mobile=1`)

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://duckduckgo.com/?q=pizza&brd_browser=chrome"
    ```
  </Accordion>
</AccordionGroup>


# SERP API 谷歌查询参数
Source: https://docs.brightdata.com/cn/scraping-automation/serp-api/query-parameters/google

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

## 搜索

<AccordionGroup>
  <Accordion title="本地化" icon="flag">
    ### `gl`

    用于定义搜索国家/地区的双字母国家/地区代码

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

    ***

    ### `hl`

    用于定义页面语言的双字母语言代码

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

  <Accordion title="搜索类型" icon="magnifying-glass">
    ### `tbm`

    定义搜索类型。 对于常规搜索，无需使用 `tbm` 参数，而其他类型则有唯一的 `tbm` 值。

    > #### 示例：\\
    >
    > `tbm=isch` - 图片 \
    > `tbm=shop` - 购物 \
    > `tbm=nws` - 新闻 \
    > `tbm=vid` - 视频

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

    ### `ibp`

    对 Job 搜索类型使用 `ibp` 参数。

    > #### 示例：
    >
    > `ibp=htl;jobs` - Jobs

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

  <Accordion title="分页" icon="file">
    ### `start`

    定义结果偏移量——结果从所选值`start`。 用于管理分页。

    > #### 示例：
    >
    > `start=0` （默认） -结果的第一页 \
    > `start=20` - 结果的第二页 \
    > `start=40` - 结果的第三页，以此类推

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

    ***

    ### `num`

    定义要返回的结果数。

    > #### 示例：
    >
    > `num=20`（默认） - 返回 20 条结果 \
    > `num=50` - 返回 50 条结果，以此类推

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

  <Accordion title="地理位置" icon="location-dot">
    ### `ule`

    代表您希望用于搜索的编码位置，将用于更改地理位置。 可以在此处下载包含所有可用 uule 值的 CSV:  [https://developers.google.com/adwords/api/docs/appendix/geotargeting](https://developers.google.com/adwords/api/docs/appendix/geotargeting)

    CSV 中“规范名称”列的值可用作 API 的原始字符串

    > #### 示例：
    >
    > `&ule=New+York,New+York,United+States`

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

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

    定义要在用户代理中表示的设备类型. \
    默认或 brd\_mobile=0 时将提供随机桌面用户代理，而 brd\_mobile=1 时将提供随机移动用户代理。

    > **对于特定的移动平台，提供以下值之一：** \
    > `brd_mobile=ios` - iPhone 用户代理（别名 `brd_mobile=iphone`） \
    > `brd_mobile=ipad` - iPad 用户代理（别名 `brd_mobile=ios_tablet`） \
    > `brd_mobile=android` - 安卓手机 \
    > `brd_mobile=android_tablet` - 安卓平板

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

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

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

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

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

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

    Bright Data 自定义参数允许返回已解析的 JSON 而不是原始 HTML

    > #### 示例：
    >
    > `brd_json=1` - 返回 JSON 格式的结果 \
    > `brd_json=html` - 返回带有包含原始 HTML 的 `html` 字段的 JSON 文件

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

  <Accordion title="酒店搜索" icon="buildings">
    ### `hotel_occupancy`

    预订房间的客人数量（最多 4 人）。
    <Note>参见酒店的 `brd_occuppany` 参数，该参数提供了更大的灵活性。</Note>

    > #### 示例：
    >
    > `hotel_occupancy=1` - 1 位客人 \
    > `hotel_occupancy=2`（默认）- 2 位客人

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

    ***

    ### `hotel_dates`

    入住日期和退房日期，用逗号分隔。 \
    格式： `年月日，年月日`

    > #### 示例：
    >
    > `hotel_dates=2022-05-01,2022-05-03` - 查找 2022 年 5 月 1 日至 3 日的空房

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

  <Accordion title="按图片搜索（仅限 /searchbyimage）" icon="image">
    ### `download`

    在代理端下载图片，并使用 POST 请求发布到谷歌

    > #### 示例：
    >
    > `default` - 如果谷歌无法下载图片，则下载并发布 \
    > `download=1` - 强制下载并发布图片 \
    > `download=0` - 带有图像链接的常规 GET 请求

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

  <Accordion title="多个请求" icon="rectangle-history">
    <Warning>请注意，并行请求只能在异步模式下运行。</Warning>

    ### `multi`

    使用 POST 请求通过我们的 API 服务器发送并行请求。 \
    并行请求将使用相同的对等节点和会话，可用于比较测试，即对选定参数的 2 个不同值发出一对相同的请求。\\

    > `multi=[{"query":{"q":"pizza","num":20}},{"query":{"q":"pizza","num":100}}]` - 带有不同 `num` 参数的相同关键词  \
    > `multi=[{"query":{"q":"pizza"}},{"query":{"q":"burger"}}]` - 不同关键词

    要发起请求，请执行：

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

    `x-response-id` 标头将包含请求的 ID，以便在下一次请求中使用它来获取结果

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

## 地图

<AccordionGroup>
  <Accordion title="本地化" icon="flag">
    ### `gl`

    用于定义搜索国家/地区的双字母国家/地区代码

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

    ***

    ### `hl`

    用于定义页面语言的双字母语言代码

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

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

    定义搜索位置 GPS 坐标的参数。其结构应符合如下格式：`@ + latitude + , + longitude + , + zoom`。

    > #### 示例：
    >
    > `@47.30227,1.67458,14.00z`

    <Tip>
      `zoom` 为可选参数，但建议使用该参数以获得更高精度。缩放范围从 3z （地图完全放大）到 21z （地图完全缩小）
    </Tip>

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

  <Accordion title="分页" icon="file">
    ### `开始`

    定义结果偏移量——结果从所选值开始。 用于管理分页。

    > #### 示例：
    >
    > `start=0` （默认）- 结果的第一页 \
    > `start=20` - 结果的第二页 \
    > `start=40` - 结果的第三页，以此类推

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

    ***

    ### `num`

    定义要返回的结果数。

    > #### 示例：
    >
    > `num=20` （默认）- 返回 20 条结果 \
    > `num=50` - 返回 50 条结果，以此类推

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

  <Accordion title="地图位置概览" icon="buildings">
    ### `fid`

    通过 `fid` 获取谷歌地图位置结果。

    在 [http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s](http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s) 上使用 GET 请求，并在末尾加上 `fid` 值。

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

  <Accordion title="排序和筛选" icon="filter">
    ### `brd_accomodation_type`

    住宿类型：酒店或度假屋。

    > #### 示例：
    >
    > `brd_accomodation_type=hotels` (default) - 搜索酒店 \
    > `brd_accomodation_type=vacation_rentals` - search for Vacation Rentals

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

  <Accordion title="输出格式" icon="magnifying-glass">
    ### `brd_json`

    Bright Data 自定义参数允许返回已解析的 JSON 而不是原始 HTML

    > #### 示例：
    >
    > `brd_json=1` - 返回 JSON 格式的结果

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

## 趋势

<AccordionGroup>
  <Accordion title="地理" icon="map-location-dot">
    ### `geo`

    感兴趣的位置，由两个字母组成的国家/地区代码

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://trends.google.com/trends/explore?q=pizza&geo=us"
    ```
  </Accordion>

  <Accordion title="本地化" icon="flag">
    ### `hl`

    首选语言，由两个字母组成的语言代码

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://trends.google.com/trends/explore?q=pizza&hl=de"
    ```
  </Accordion>

  <Accordion title="时间范围" icon="calendar">
    ### `date`

    搜索时间范围。

    > **可用值如下：** \
    > `now 1-H` - 过去一小时 \
    > `now 4-H` - 过去 4 小时 \
    > `now 1-d` - 过去一天 \
    > `now 7-d` - 过去 7 天 \
    > `today 1-m` - 过去 30 天 \
    > `today 3-m` - 过去 90 天 \
    > `today 12-m（默认）` - 过去 12 个月 \
    > `today 5-y` - 过去 5 年 \
    > `2020-07-01 2020-12-31` - 自定义日期范围

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://trends.google.com/trends/explore?q=pizza&date=now+1-d"
    ```
  </Accordion>

  <Accordion title="类别" icon="list">
    ### `cat`

    要搜索的类别。 默认情况下，在所有类别中搜索。 \
    您可以在此处找到所有类别的列表: [https://trends.google.com/trends/api/explore/pickers/category?lang=en-US\&tz=240](https://trends.google.com/trends/api/explore/pickers/category?lang=en-US\&tz=240)

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://trends.google.com/trends/explore?q=pizza&cat=3"
    ```
  </Accordion>

  <Accordion title="搜索类型" icon="magnifying-glass">
    ### `gprop`

    要筛选的谷歌属性。 默认为网络搜索。 \
    可能的值如下: `images`, `news`, `froogle` (for 谷歌 Shopping), `youtube`

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://trends.google.com/trends/explore?q=pizza&gprop=images"
    ```
  </Accordion>
</AccordionGroup>

## 评论

<AccordionGroup>
  <Accordion title="功能 ID" icon="stars">
    ### `fid`

    要获取评论的功能 ID。
    `fid` 参数可在谷歌搜索响应的 knowledge.`fid` 字段中找到。

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

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

  <Accordion title="本地化" icon="flag">
    ### `hl`

    首选语言，由两个字母组成的语言代码

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

  <Accordion title="排序和筛选" icon="filter">
    ### `sort`

    评论的排序方式。

    > **可能的值如下：**  \
    > `sort=QualityScore` （默认）- 最相关的评论优先 \
    > `sort=newestFirst` - 最新评论优先 \
    > `sort=RatingHigh` - 最高分评论优先 \
    > `sort=RatingLow` - 最低分评论优先

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

    ### `filter`

    筛选关键词。 将回复仅包含指定关键词的评论。

    > #### 例如：
    >
    > `filter=awesome` - 搜索包含“很棒”一词的评论

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

  <Accordion title="分页" icon="file">
    ### `开始`

    定义结果偏移量——结果从所选值开始。 用于管理分页。

    > #### 示例：
    >
    > `start=0` （默认）- 结果的第一页 \
    > `start=20` - 结果的第二页 \
    > `start=40` - 结果的第三页，以此类推

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

    ### `num`

    定义要返回的结果数。

    > #### 示例：
    >
    > `num=20` （默认）- 返回 20 条结果 \
    > `num=50` - 返回 50 条结果，以此类推

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

## 镜头

<AccordionGroup>
  <Accordion title="图片网址" icon="image">
    ### `url`

    您要搜索的图片的网址

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

  <Accordion title="本地化" icon="flag">
    ### `hl`

    首选语言，由两个字母组成的语言代码

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

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

    Bright Data 自定义参数允许返回已解析的 JSON 而不是原始 HTML

    > #### 示例：
    >
    > `brd_json=1` - 返回 JSON 格式的结果 \
    > `brd_json=html` - 返回带有包含原始 HTML 的 `html` 字段的 JSON 文件

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

  <Accordion title="将图片作为文件上传" icon="arrow-up-from-bracket">
    ### `upload`

    上传位于当前目录中名为 `cat.jpg` 的图片（不支持异步区域）

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

  <Accordion title="获取精确匹配" icon="expand">
    ### `data`

    向 [https://lens.google.com/exact\_matches](https://lens.google.com/exact_matches) 发送 POST 请求和 data 字符串。

    此字符串源于 /v3/upload 或 /uploadbyurl?url= 请求的 json 响应中的 image\_sources（不支持异步区域）。

    ```sh
    curl --data "WyJodHRwczovL2xlbnMuZ29vZ2xlLmNvbS9fL0xlbnNXZWJTdGFuZGFsb25lVWkvZGF0YS9iYXRjaGV4ZWN1dGU/cnBjaWRzPUI3ZmRrZSZzb3VyY2UtcGF0aD0lMkZzZWFyY2gmZi5zaWQ9NDc2NTI2MTc4OTExNzkzNDk1MiZibD1ib3FfbGVuc2Zyb250ZW5kYXBpc2VydmVyXzIwMjMxMjA0LjA3X3AzJnNvYy1hcHA9MSZzb2MtcGxhdGZvcm09MSZzb2MtZGV2aWNlPTEmX3JlcWlkPTU2ODk5JnJ0PWMiLCJmLnJlcT0lNUIlNUIlNUIlMjJCN2Zka2UlMjIlMkMlMjIlNUIlNUIlNUMlMjI0MTU4MTI0NjElNUMlMjIlMkMxJTJDMSU1RCUyQyU1Qm51bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQyU1QiU1QyUyMjhlYjdhZTFiLWJjMmUtNDNiMS1hYjRkLWRjMmM1ZTZlNTExOCU1QyUyMiU1RCUyQyU1QiU1QyUyMiUyRmxlbnMtd2ViLXN0YW5kYWxvbmUtcHJvZCUyRmNlMWFkMWRlLTgyNzgtNDEwMy05YmRiLWY1YWUxNjY0MGMwOSU1QyUyMiUyQyU1Qm51bGwlMkNudWxsJTJDMTAwMCUyQzEwMDAlNUQlNUQlNUQlMkMlNUJudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDMyUyQyU1QiU1QyUyMmVuLVVTJTVDJTIyJTJDbnVsbCUyQyU1QyUyMlVTJTVDJTIyJTJDJTVDJTIyQW1lcmljYSUyRk5ld19Zb3JrJTVDJTIyJTVEJTJDbnVsbCUyQ251bGwlMkMlNUJudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkMxJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkMxJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDMSUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDMSUyQ251bGwlMkNudWxsJTJDbnVsbCUyQzElMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkMxJTJDMSUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkMxJTJDbnVsbCUyQzElMkNudWxsJTJDbnVsbCUyQzElNUQlMkMlNUIlNUJudWxsJTJDMSUyQzElMkMxJTJDMSUyQzElMkMxJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDMSUyQzElMkMxJTJDMSUyQ251bGwlMkNudWxsJTJDbnVsbCUyQzElMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkMxJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkMxJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQzElMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQzElMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkMxJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDMSUyQ251bGwlMkNudWxsJTJDbnVsbCUyQzElMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkMxJTJDMSUyQzElMkNudWxsJTJDMSUyQzElMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDMCUyQzAlMkNudWxsJTJDbnVsbCUyQ251bGwlMkMlNUI1JTJDNiUyQzIlNUQlMkNudWxsJTJDbnVsbCUyQ251bGwlMkMxJTJDbnVsbCUyQzElMkNudWxsJTJDMSUyQ251bGwlMkNudWxsJTJDbnVsbCUyQzAlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDMSUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQzElMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQzAlMkMxJTJDMSUyQ251bGwlMkNudWxsJTJDMSUyQzElMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkMxJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDMCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkMxJTVEJTVEJTJDJTVCJTVCJTVCNyU1RCU1RCU1RCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQzI2JTJDbnVsbCUyQ251bGwlMkNudWxsJTJDJTVCMTkyMCUyQzEwODAlNUQlMkMlNUJudWxsJTJDNiU1RCUyQyU1Qm51bGwlMkMxNCU1RCUyQ251bGwlMkMlNUIxNCU1RCUyQyU1QiU1RCU1RCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDJTVDJTIyRWtjS0pERTJORFF3WkRJd0xUTm1Zamt0TkRSbU5TMDROR1ZpTFdVNFpXUm1ZV1JoWVdVek9SSWZjekJXTkZKMmJVbDFkamhaYzA1cFgzcDFWbUZaVFZWeU9FMU9TbnBvWnclM0QlM0QlNUMlMjIlMkNudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQyU1QiU1Qm51bGwlMkMlNUIlNUQlNUQlMkMlNUJudWxsJTJDbnVsbCUyQ251bGwlMkNudWxsJTJDbnVsbCUyQ251bGwlMkMlNUIlNUMlMjI4ZWI3YWUxYi1iYzJlLTQzYjEtYWI0ZC1kYzJjNWU2ZTUxMTglNUMlMjIlNUQlMkMlNUIlNUMlMjIlMkZsZW5zLXdlYi1zdGFuZGFsb25lLXByb2QlMkZjZTFhZDFkZS04Mjc4LTQxMDMtOWJkYi1mNWFlMTY2NDBjMDklNUMlMjIlMkMlNUJudWxsJTJDbnVsbCUyQzEwMDAlMkMxMDAwJTVEJTVEJTVEJTVEJTJDbnVsbCUyQyU1QyUyMlFqUTRRalJCUkRndE1UUXpOQzAwTWpFMExUa3pNVFF0T0VOR01FSTVNa0k1TmtJMiU1QyUyMiU1RCUyMiUyQ251bGwlMkMlMjJnZW5lcmljJTIyJTVEJTVEJTVEJiJd" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://lens.google.com/exact_matches"
    ```
  </Accordion>
</AccordionGroup>

## 酒店

<AccordionGroup>
  <Accordion title="本地化" icon="flag">
    ### `gl`

    用于定义搜索国家/地区的双字母国家/地区代码

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

    ### `hl`

    用于定义页面语言的双字母语言代码

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

  <Accordion title="预订日期和选项" icon="calendar">
    ### `brd_dates`

    入住日期和退房日期，用逗号分隔。

    > #### 格式：
    >
    > `年月日，年月日`
    >
    > #### 示例：
    >
    > `2022-01-20,2022-02-05`

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

    ### `brd_occupancy`

    预订房间的客人数量（最多 6 人）。

    > #### 示例：
    >
    > `brd_occupancy=1` - 寻找 1 人间 \
    > `brd_occupancy=2` （默认）- 寻找 2 人间 \
    > `brd_occupancy=3` - 寻找 3 人间，依此类推

    还支持以逗号分隔的整数列表，其中：

    * 第一个值代表成年客人的数量
    * 后续值代表儿童年龄

    > #### 格式：
    >
    > `brd_occupancy=<number of adults>,<child 1 age>,<child 2 age>,...,<child N age>`
    >
    > #### 示例：
    >
    > `brd_occupancy=1,5,7,12` - 1 名成人和 3 名儿童（5 岁、7 岁和 12 岁）  \
    > `brd_occupancy=2,1,3` - 2 名成人和 2 名儿童（1 岁和 3 岁）

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

    ### `brd_free_cancellation`

    仅显示可免费取消的报价

    > #### 示例：
    >
    > `brd_free_cancellation=true` - 可免费取消 \
    > `brd_free_cancellation=false` （默认）- 显示所有报价

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

    ### `brd_accomodation_type`

    住宿类型：酒店或度假屋。

    > #### 示例：
    >
    > `brd_accomodation_type=hotels` （默认）- 搜索酒店 \
    > `brd_accomodation_type=vacation_rentals` - 搜索度假屋

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

    ### `brd_currency`

    显示价格的币种（3 个字母代码）。

    > #### 示例：
    >
    > `brd_currency=USD` - 美元 \
    > `brd_currency=EUR` - 欧元 \
    > `brd_currency=INR` - 印度卢比

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

  <Accordion title="输出格式" icon="magnifying-glass">
    ### `brd_mobile`

    定义要在用户代理中表示的设备类型

    默认或 `brd_mobile=0` 时将提供随机桌面用户代理，而 `brd_mobile=1` 时将提供随机移动用户代理。

    > \*\*对于特定的移动平台，提供以下值之一： \*\* \
    > `brd_mobile=ios` - iPhone 用户代理（别名 `brd_mobile=iphone`） \
    > `brd_mobile=ipad` - iPad 用户代理（别名 `brd_mobile=ios_tablet`） \
    > `brd_mobile=android` - 安卓手机 \
    > `brd_mobile=android_tablet` - 安卓平板

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

    ### `brd_json`

    Bright Data 自定义参数允许返回已解析的 JSON 而不是原始 HTML

    > #### 示例：
    >
    > `brd_json=1` - 返回 JSON 格式的结果

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

## 航班

<AccordionGroup>
  <Accordion title="本地化" icon="flag">
    ### `gl`

    用于定义搜索国家/地区的双字母国家/地区代码

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

    ### `hl`

    用于定义页面语言的双字母语言代码

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

  <Accordion title="航班详情" icon="plane-departure">
    ### `tfs`

    代表航班搜索参数的字符串

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

    ### `curr`

    定义返回价格的币种

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


# SERP API Yandex 查询参数
Source: https://docs.brightdata.com/cn/scraping-automation/serp-api/query-parameters/yandex

探索用于 SERP API 的 Yandex 查询参数，包括本地化、分页、时间范围和设备定位，以有效优化您的搜索结果。

## 搜索

<AccordionGroup>
  <Accordion title="本地化" icon="flag">
    ### `lr`

    要搜索的地区或国家。

    > #### 示例：
    >
    > `1` -莫斯科 \
    > `2` -圣彼得堡 \
    > `84` -美国 \
    > `95` -加拿大 \
    > `134` -中国

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.yandex.com/search/?text=pizza&lr=84"
    ```

    ### `lang`

    用于定义页面语言的双字母语言代码

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.yandex.com/search/?text=pizza&lang=en"
    ```
  </Accordion>

  <Accordion title="分页" icon="file">
    ### `p`

    定义结果页——结果从所选值开始。 用于管理分页。

    > #### 示例：
    >
    > `p=1` （默认）- 结果的第一页 \
    > `p=2` - 结果的第二页 \
    > `p=4` - 结果的第四页，以此类推

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.yandex.com/search/?text=pizza&p=1"
    ```
  </Accordion>

  <Accordion title="时间范围" icon="calendar">
    ### `within`

    搜索时间范围。

    > **可用值如下：** \
    > `77` - 过去 24 小时\
    > `1` - 过去 2 周  \
    > `[%pm]` - 过去一个月

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.yandex.com/search/?text=pizza&within=1"
    ```
  </Accordion>

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

    定义要在用户代理中表示的设备类型

    默认或 `brd_mobile=0` 时将提供随机桌面用户代理，而 `brd_mobile=1` 时将提供随机移动用户代理。

    > **对于特定的移动平台，提供以下值之一：** \
    > `brd_mobile=ios` - iPhone 用户代理（别名 `brd_mobile=iphone`） \
    > `brd_mobile=ipad` - iPad 用户代理（别名 `brd_mobile=ios_tablet`） \
    > `brd_mobile=android` - 安卓手机 \
    > `brd_mobile=android_tablet` - 安卓平板

    ```sh
    curl --proxy brd.superproxy.io:33335 --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` - 谷歌 Chrome \
    > `brd_browser=safari` - Safari \
    > `brd_browser=firefox` - Mozilla Firefox (not compatible with `brd_mobile=1`)

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.yandex.com/search/?text=pizza&brd_browser=chrome"
    ```
  </Accordion>
</AccordionGroup>


# 如何开始使用SERP API
Source: https://docs.brightdata.com/cn/scraping-automation/serp-api/quickstart

按照以下简单步骤，快速开始使用Bright Data的SERP API。登录、创建代理并验证您的账户，即可轻松开始收集搜索引擎数据。

<Tip>
  如果您尚未注册Bright Data，可以免费注册 ，在添加付款方式后，即可获得5美元的信用额度以开始使用:\
  [https://brightdata.com/](https://brightdata.com/)
</Tip>

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">登录</a>} />

  <Step title="导航到“我的区域”">
    <Accordion title="在“我的区域”页面，点击SERP API下方的“开始”">
      <Warning>
        如果您已经有正在运行的代理，只需在右上角选择添加即可
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/get-started.png?maxW=846&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f78109e376c33dcb1a852caedec55ef4" alt="开始" width="846" height="911" data-path="images/scraping-automation/serp-api/quick-start/get-started.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/get-started.png?w=280&maxW=846&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=83396e664721aa5063f93125eb9fcc00 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/get-started.png?w=560&maxW=846&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5d95d3e6a2358e56899f66407fdb4044 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/get-started.png?w=840&maxW=846&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7dd11ed02ede86bd8ea68f147d0e2770 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/get-started.png?w=1100&maxW=846&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=3f0978b511859486364348a5c6d14c18 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/get-started.png?w=1650&maxW=846&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7336cb3c61286fb6a24860b57e235e7b 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/get-started.png?w=2500&maxW=846&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a6910bf71137179337b30434a4bf2dda 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="选择SERP API名称">
    <Accordion title="输入新SERP API的代理名称">
      <Warning>
        请选择一个有意义的名称，因为区域名称一旦创建就无法更改。
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/proxy-name.png?maxW=690&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=be3a114fb9c49db2c4db301b5be00036" alt="代理名称" width="690" height="931" data-path="images/scraping-automation/serp-api/quick-start/proxy-name.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/proxy-name.png?w=280&maxW=690&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e598eaec6ac81deae5ebe6a9708fb2a9 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/proxy-name.png?w=560&maxW=690&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=bc33cfb55271258738bba051bdef69d1 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/proxy-name.png?w=840&maxW=690&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=0946d0aee8338f981019a8c82028ec6b 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/proxy-name.png?w=1100&maxW=690&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=4c9a14816d27eb89a5294d8f9f99d9bc 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/proxy-name.png?w=1650&maxW=690&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=286ccaf2f7d664733e6c278f1930c5d0 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/proxy-name.png?w=2500&maxW=690&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b21b9084aec127435555aa96ecc0b7bf 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="点击“添加代理”" />
</Steps>

<Accordion title="在继续之前，请验证您的账户">
  如果您尚未添加付款方式，此时系统会提示您添加付款方式，以验证您的账户。 如果您是第一次使用Bright Data，您还将获得5美元的奖励信用额度，帮助您开始使用！

  <Tip>
    这仅用于验证目的，此时不会向您收取任何费用
  </Tip>
</Accordion>

<Note>
  别担心，我们将在下一节配置您的代理中介绍所有配置:\
  [https://docs.brightdata.com/cn/scraping-automation/serp-api/configuration](https://docs.brightdata.com/cn/scraping-automation/serp-api/configuration)
</Note>


# 发送您的第一个请求
Source: https://docs.brightdata.com/cn/scraping-automation/serp-api/send-your-first-request



要开始使用，您需要 API 凭据、用户名和密码以及主机名。您可以在代理产品的访问参数选项卡中找到这些凭据。

## 代码示例

获得 API 凭据后，使用以下代码发送您的第一个请求：

<Warning>
  为确保 SERP API 区域内请求的安全性，请使用我们的 SSL 证书或忽略 SSL 错误。

  [SSL certificate](/cn/general/account/ssl-certificate#how-to-download-the-ssl-certificate), [ignore SSL errors](/cn/general/account/ssl-certificate#how-to-ignore-ssl-errors)
</Warning>

<CodeGroup>
  ```sh cURL
  curl "https://www.google.com/search?q=pizza" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```js Node.js
  #!/usr/bin/env node

  require('request-promise')({
      url: 'https://www.google.com/search?q=pizza',
      proxy: 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:33335',
    })
    .then(function (data) {
        console.log(data);
      },
      function (err) {
        console.error(err);
      });
  ```

  ```python Python
  import pprint
  import requests


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

  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"
  response = requests.get(url, proxies=proxies)
  pprint.pprint(response.json())

  ```

  ```php PHP

  <?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:33335');
  curl_setopt($curl, CURLOPT_PROXYUSERPWD, 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>');
  curl_exec($curl);
  ?>

  ```

  ```ruby Ruby
  #!/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', 33335, '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#
  using System;
  using System.Net;

  class Example {
    static void Main() {
      var client = new WebClient();
      client.Proxy = new WebProxy("brd.superproxy.io:33335");
      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
  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", 33335);
          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
  #!/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:33335");
  print $agent->get('https://www.google.com/search?q=pizza')->content();
  ```

  ```vb VBA
  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:33335")
          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>

转到下一节解析搜索结果，了解如何解析搜索结果。

[解析搜索结果](/cn/scraping-automation/serp-api/parsing-search-results)


# API 参考
Source: https://docs.brightdata.com/cn/scraping-automation/web-scraper-api/api-reference





# 身份验证指南
Source: https://docs.brightdata.com/cn/scraping-automation/web-scraper-api/authentication-guide



Bright Data API 使用 “API 令牌” 对请求进行身份验证。 您可以在控制面板的 “账户设置” 下查看和管理您的 API 令牌。

## 什么是 Bright Data 的 API 令牌？

Bright Data 的 API 令牌是通过 API 向 Bright Data 发送请求时替换您的证书（即电子邮件地址和密码）的一种安全方法。

<Tip>
  [指南：如何生成 API 令牌？](https://docs.brightdata.com/cn/api-reference/unlocker/api_token#api-token)
</Tip>

<Note>
  只有账户管理员才能为账户用户生成新令牌
</Note>


# 按端点分类的错误代码
Source: https://docs.brightdata.com/cn/scraping-automation/web-scraper-api/error-list-by-endpoint

系统中的错误代码列表，按特定端点分类

## 触发数据采集

`POST` `/datasets/v3/trigger`

`与 "触发数据采集" 端点相关的错误代码`

| `http_status_code` | `message`                                                                   |
| :----------------: | --------------------------------------------------------------------------- |
|         400        | `{validation_errors: [ERRORS]}`                                             |
|                    | `dataset missing` （数据集缺失）                                                   |
|                    | 附件无效                                                                        |
|                    | 此数据集不允许使用 API                                                               |
|                    | 此数据集尚未准备好                                                                   |
|                    | 无可触发的数据                                                                     |
|                    | 输入数据至少应为 `LIMIT` 条                                                          |
|         404        | `dataset does not exist` （数据集不存在）                                           |
|         429        | 您在此数据集中运行的任务过多。请等待一些任务完成，或考虑将多个输入合并为单个请求。当前运行任务数：`RUNNING_JOBS>=JOBS_LIMIT` |
|         500        | 内部服务器错误                                                                     |

## 下载快照

`GET` `/datasets/v3/snapshot/:snapshot_id`

`与 "下载快照" 端点相关的错误代码`

| `http_status_code` | `message`                                           |
| :----------------: | --------------------------------------------------- |
|         202        | `{status: "STATUS", message: "快照尚未准备好，请 10 秒后重试"}`  |
|                    | `{status: "building", message: "快照正在生成，请 10 秒后重试"}` |
|         400        | `{validation_errors: [ERRORS]}`                     |
|                    | 快照已过期                                               |
|                    | 快照为空                                                |
|         404        | 快照不存在                                               |
|         500        | 内部服务器错误                                             |

## 计算交付的分片数量

`GET` `/datasets/v3/snapshot/:snapshot_id/parts`

`与 "计算交付的分片数量" 端点相关的错误代码`

| `http_status_code` | `message`                       |
| :----------------: | ------------------------------- |
|         400        | `{validation_errors: [ERRORS]}` |
|                    | 快照尚未准备好                         |
|         404        | 快照不存在                           |
|         500        | 内部服务器错误                         |

## 获取已触发快照的输入文件

`GET` `/datasets/v3/snapshot/:snapshot_id/input`

`与 "获取已触发快照的输入文件" 端点相关的错误代码`

| `http_status_code` | `message` |
| :----------------: | --------- |
|         400        | 快照输入文件不存在 |
|         404        | 快照不存在     |
|         500        | 内部服务器错误   |

## 取消数据采集

`POST` `/datasets/v3/snapshot/:snapshot_id/cancel`

`与 "取消数据采集" 端点相关的错误代码`

| `http_status_code` | `message` |
| :----------------: | --------- |
|         400        | 快照未在运行    |
|         404        | 快照不存在     |
|         500        | 内部服务器错误   |

## 监控进度

`GET` `/datasets/v3/progress/:snapshot_id`

`与 "监控进度" 端点相关的错误代码`

| `http_status_code` | `message`                                            |
| :----------------: | ---------------------------------------------------- |
|         404        | 快照不存在                                                |
|         500        | 内部服务器错误                                              |
|         200        | `{status: "failed", error_message: "ERROR_MESSAGE"}` |
|                    | 发生错误，我们的团队正在调查                                       |
|                    | 账户已被暂停                                               |
|                    | 账户新注册，请在账户设置中激活（URL）                                 |
|                    | 在数据发现中未找到数据                                          |
|                    | 快照为空                                                 |
|                    | 交付快照失败                                               |
|                    | 下载响应失败                                               |
|                    | 触发采集器失败                                              |
|                    | 内部服务器错误                                              |
|                    | 输入验证失败：`DETAILS`                                     |

## 监控数据交付

`GET` `/datasets/v3/delivery/:delivery_id`

`与 "监控数据交付" 端点相关的错误代码`

| `http_status_code` | `message` |
| :----------------: | --------- |
|         404        | 数据交付不存在   |
|         500        | 内部服务器错误   |

## 将收集的数据传输到存储

`POST` `/datasets/v3/deliver/:snapshot_id`

`与 "将收集的数据传输到存储" 端点相关的错误代码`

| `http_status_code` | `message`                       |
| :----------------: | ------------------------------- |
|         400        | `{validation_errors: [ERRORS]}` |
|                    | 快照尚未准备好                         |
|                    | 快照已过期                           |
|                    | 缺少交付选项                          |
|                    | 快照为空                            |
|                    | 快照过大，无法以单个文件交付                  |
|                    | 批处理大小至少应为 `MIN_BATCH_SIZE`      |
|         404        | 快照不存在                           |
|         500        | 交付快照失败                          |
|                    | 内部服务器错误                         |

## 获取快照列表

`GET` `/datasets/v3/snapshots`

`与 "获取快照列表" 端点相关的错误代码`

| `http_status_code` | `message`                       |
| :----------------: | ------------------------------- |
|         400        | `{validation_errors: [ERRORS]}` |
|         500        | 内部服务器错误                         |


# 网页抓取工具 API 常见问题解答
Source: https://docs.brightdata.com/cn/scraping-automation/web-scraper-api/faqs

Bright Data 的网页抓取工具 API 常见问题解答页面涵盖设置、身份验证、数据格式、定价和大规模数据提取等方面的问题，请查看相关解答，获取所需信息。

<AccordionGroup>
  <Accordion title="什么是网页抓取工具 API？">
    网页抓取工具 API 让用户可以使用预构建的抓取工具，根据自身需要从网站提取最新数据。 它可自动采集数据，并与其他系统集成。
  </Accordion>

  <Accordion title="哪些人使用网页抓取工具 API 可以受益匪浅？">
    任何不想自行开发抓取工具，试图通过其他高效方法采集和分析网页数据，以用于 AI、ML 和大型数据应用程序的数据分析师、科学家、工程师、开发人员和其他个体都能从各种抓取工具 API 中受益，会发现它们大有用处。
  </Accordion>

  <Accordion title="如何开始使用网页抓取工具 API？">
    使用网页抓取工具 API 非常简单，开通 Bright Data 账户后，您需要在“账户设置”中生成一个 API 令牌 。
    获得密钥后，您可参阅我们的 API 文档 ，查看首次调用 API 的详细指引。

    [generate an API key](https://docs.brightdata.com/cn/general/account/api-token#how-to-create-a-bright-datas-api-token), [API documentation](https://docs.brightdata.com/cn/scraping-automation/web-scraper-api/overview)

    <iframe width="640" height="480" src="https://app.arcade.software/share/BPGoTdRmf89Ip1EQuIOW" title="Watch a demo video" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen />
  </Accordion>

  <Accordion title="各种抓取工具之间有何区别？">
    不同的抓取工具可能需要设置不同的输入参数以采集数据。 抓取工具主要分为两类：

    1. **PDP** \
       These scrapers require URLs as inputs. PDP 抓取工具可从网页中提取详细的产品信息，例如规格、定价和功能等

    2. **Discovery/Discovery+PDP** \
       发现型 (Discovery) 抓取工具可让您通过搜索、类别、关键字等探索并查找新的实体/产品。

    <Frame>
            <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-pdp.png?maxW=1456&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5b04b95589ac7acbc5643b8800b0fa24" alt="delivery-pdp.png" width="1456" height="398" data-path="images/scraping-automation/web-scraper-api/faqs/delivery-pdp.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-pdp.png?w=280&maxW=1456&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=10f0c1f651af88ca0726b569dd985b0f 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-pdp.png?w=560&maxW=1456&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ed8f8aaf5b4e540d686df43542fd730e 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-pdp.png?w=840&maxW=1456&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=696d440f37fbddd006dc05f9ffee30d8 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-pdp.png?w=1100&maxW=1456&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=640accebd3dfaed51924f8f367054426 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-pdp.png?w=1650&maxW=1456&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ff7a0f2601d8241aea0404ee426f165a 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-pdp.png?w=2500&maxW=1456&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ab0cf1cd9e5531fc8ce1d5c2787c7005 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>

  <Accordion title="为何同一个域有不同的数据发现 API？">
    各种数据发现 API (Discovery API) 让您可以使用不同的方法查找所需数据，例如按关键字、类别、URL 甚至位置来查找相关数据
  </Accordion>

  <Accordion title="如何使用网页抓取工具 API 进行身份验证？">
    使用 API 令牌即可进行身份验证。 您只需使用以下格式，在请求的 Authorization 标头中包含相关令牌即可：`Authorization: Bearer YOUR_API_KEY`。
  </Accordion>

  <Accordion title="如何自定义我的请求并触发它？">
    选定要运行的 API 后，您可使用我们详细的 API 参数文档自定义您的请求，指定不同的类型以及预期的输入和响应参数。\
    [detailed API parameters documentation](https://docs.brightdata.com/cn/scraping-automation/web-data-apis/web-scraper-api/trigger-a-collection)
  </Accordion>

  <Accordion title="试用版如何运行？">
    您可通过个人账户免费调用 20 次 API 以试用产品，每次调用最多可输入 10 个参数；注意，试用仅针对 PDP 类型的抓取工具（发现型抓取工具不可试用）。

    * 前 1-5 次调用会返回完整结果
    * 后 6-15 次调用将返回审查后的结果，即部分数据会被隐藏，用星号显示（例如，AB\*\*\*\*\*YZ）
  </Accordion>

  <Accordion title="如何测试 API？">
    您可以在控制面板上自定义代码，快速测试产品（[演示视频](https://app.arcade.software/flows/BPGoTdRmf89Ip1EQuIOW/view)）

    <Steps>
      <Step title="从各种 API 中选择所需 API" />

      <Step title="键入输入配置">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/faqs/trigger-a-collection.png?maxW=1122&auto=format&n=ilemiSHw8UogZ13k&q=85&s=cfb275af937ba95b8858af1c812f86e4" alt="trigger-a-collection.png" width="1122" height="804" data-path="images/scraping-automation/web-scraper-api/faqs/trigger-a-collection.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/faqs/trigger-a-collection.png?w=280&maxW=1122&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9979815942125c3c4c82c8584c1c6c3d 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/faqs/trigger-a-collection.png?w=560&maxW=1122&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9f2cb9844c72cf3a84a4dc8d4f33947d 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/faqs/trigger-a-collection.png?w=840&maxW=1122&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3dc523128096cea80462286cf426ada2 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/faqs/trigger-a-collection.png?w=1100&maxW=1122&auto=format&n=ilemiSHw8UogZ13k&q=85&s=7cdbac4535fa7ecebaee3abfaf97b6df 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/faqs/trigger-a-collection.png?w=1650&maxW=1122&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6dd402da8457ac4082787264137ccab9 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/faqs/trigger-a-collection.png?w=2500&maxW=1122&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3ff58683bdc0a30ad770ae0dd905dad8 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>

      <Step title="输入 API 令牌">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/enter-api-token.png?maxW=834&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b39ac61bfaee744c7eb0668853b35ad7" alt="enter-api-token.png" width="834" height="138" data-path="images/scraping-automation/web-scraper-api/faqs/enter-api-token.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/enter-api-token.png?w=280&maxW=834&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ba0e73814825055d8f67c3959f5ee64d 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/enter-api-token.png?w=560&maxW=834&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e7ebd77a759988f91db56d1853d2e9a0 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/enter-api-token.png?w=840&maxW=834&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7dd2a6ce4a7f7243c8ce711357221a37 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/enter-api-token.png?w=1100&maxW=834&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=0d101e6fe2d421af1f8ecd77f3f5bfd8 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/enter-api-token.png?w=1650&maxW=834&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8104a69f26ea3dfdf9a4b3f96c239f2b 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/enter-api-token.png?w=2500&maxW=834&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=31f4ddd2533b6314b92199c3d01b9835 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>

      <Step title="选择首选交付方式">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-method.png?maxW=1306&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=63a5e93dc34ed11d469a372859349929" alt="delivery-method.png" width="1306" height="582" data-path="images/scraping-automation/web-scraper-api/faqs/delivery-method.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-method.png?w=280&maxW=1306&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=aca66b01672f3f5001148b4660e68ef2 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-method.png?w=560&maxW=1306&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d1ea5eb2f56ab1e095da352a20af4d0c 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-method.png?w=840&maxW=1306&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=616acae631344527bc58aa09a894ff54 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-method.png?w=1100&maxW=1306&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=0371603aea7c5cfcd48c288efd6e2f11 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-method.png?w=1650&maxW=1306&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c5205717ac906df450be1c50310ba486 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-method.png?w=2500&maxW=1306&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=de5e74224efdd547ec5f54e6a46c1bec 2500w" data-optimize="true" data-opv="2" />
        </Frame>

        使用 Webhook - 更新 Webhook URL，复制并粘贴“触发数据采集”代码，然后在客户端上运行该代码。

        使用 API - 根据所选特定设置（S3、GCP、pubsub 等）填写所需凭据和信息，然后复制代码并在采集结束后运行代码
      </Step>

      <Step title="复制代码并在客户端上运行">
                <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/code.png?maxW=1056&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=2674b2b205128edf499f69cd2c199da7" alt="code.png" width="1056" height="478" data-path="images/scraping-automation/web-scraper-api/faqs/code.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/code.png?w=280&maxW=1056&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7f5b3f84b1bc1d57c9692480cc43905f 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/code.png?w=560&maxW=1056&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=3401debdaff536f960de95f4a40f8fbe 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/code.png?w=840&maxW=1056&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e527fac0a71bab77bdfcbbbacb1134ba 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/code.png?w=1100&maxW=1056&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ca52a4b438e6ddfe9cfd69aa474e873b 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/code.png?w=1650&maxW=1056&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a0706017880e19aafa86276b12477770 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/code.png?w=2500&maxW=1056&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=59836cbd2bc56dca496e49b0bd7c6ac5 2500w" data-optimize="true" data-opv="2" />
        上述操作也均可通过 [Webhook-site](https://webhook.site/)、[Postman](https://web.postman.co/) 等免费工具完成

        我们还提供其他管理 API，用于获取有关采集状态的信息，并可在“管理 API” 选项卡中获取所有快照的列表
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="网页抓取工具 API 支持哪些数据格式？">
    网页抓取工具 API 支持多种格式的数据提取，包括 JSON、NDJSON、JSONL 和 CSV。您可在请求参数中指定所需格式。
  </Accordion>

  <Accordion title="网页抓取工具 API 的费用是多少？">
    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 our system’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="如果我的 API 令牌过期了，该怎么办？">
    账户管理员：如果 API 令牌过期，则需在“账户设置”中创建一个新的 API 令牌。

    <Frame>
            <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token.png?maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=96c1efb6298a7cf4b969f56f5d5258f2" alt="no-api-token.png" width="2048" height="184" data-path="images/scraping-automation/web-scraper-api/faqs/no-api-token.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token.png?w=280&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f38ceae73a83c38182de75c66a0082b3 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token.png?w=560&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=71df35b53211c66782b036aa900ec571 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token.png?w=840&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=0d64a9f0fccb473b50c8546b82eccebd 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token.png?w=1100&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9d388653127b5deb80f1e3c569fef744 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token.png?w=1650&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9789b4dc9f0f4660f80e8f2c6373ffd8 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token.png?w=2500&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a9e28b88ea184289ec4ffd80b1e3d964 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    账户用户：如果 API 令牌过期，请联系账户管理员，让其发放新令牌。

    <Frame>
            <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token-user.png?maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=bb3e40763a24882b6a4657159e476a63" alt="no-api-token-user.png" width="2048" height="193" data-path="images/scraping-automation/web-scraper-api/faqs/no-api-token-user.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token-user.png?w=280&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=6b46af0df42b0509e92fe35266edc62f 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token-user.png?w=560&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b1184dd673ba4a58933b7bf43df70870 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token-user.png?w=840&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1bb1bba8dd13a83d61fcb7896b98d104 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token-user.png?w=1100&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=4f42fad4ea170263051e9e33e9e7ff60 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token-user.png?w=1650&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=2f68220d060c3674b72fbb0534f113dd 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token-user.png?w=2500&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=cb7b812c25740462b175bdc5365bb756 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>

  <Accordion title="抓取工具 API 如何管理大规模的数据提取任务？">
    抓取工具 API 具有高并发和批处理功能，在大规模数据提取场景中表现出色。 这确保开发人员可以高效扩展其抓取操作，通过高吞吐量满足海量的数据提取请求。
  </Accordion>

  <Accordion title="如何升级订阅的套餐？">
    如想升级订阅的套餐，请访问账户控制面板中的“账单”页面，然后选择所需套餐。 如需更多帮助，请联系我们的支持团队。
  </Accordion>

  <Accordion title="抓取工具 API 针对哪些特定用例进行了优化？">
    网页抓取工具 API 可广泛用于各种使用场景，包括竞争基准测试、市场趋势分析、动态定价算法、情绪提取以及为机器学习管道提供数据。 这些 API 对于电子商务、金融科技和社交媒体分析至关重要，有助开发人员高效执行数据驱动型策略。
  </Accordion>

  <Accordion title="网页抓取工具 API 的响应速度如何？">
    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 网页抓取工具 API 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.
  </Accordion>

  <Accordion title=" How do I cancel an API call?">
    You can cancel a run using the following endpoint:

    curl -H "Authorization: API\_KEY" -H "Content-Type: application/json" -k "[https://api.brightdata.com/datasets/v3/snapshot/SNAPSHOT\_ID/cancel](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](https://docs.brightdata.com/cn/scraping-automation/web-data-apis/web-scraper-api/delivery-apis) options and the snapshot ID
  </Accordion>

  <Accordion title="是否对特定抓取工具或域名设有限制？">
    下列平台存在一定的限制：

    <AccordionGroup>
      <Accordion title="Facebook" icon="facebook">
        |               |                   |
        | ------------- | ----------------- |
        | 帖子（按个人资料 URL） | 每次输入最多采集 900 个帖子  |
        | 评论            | 每次输入最多采集 50 条评论   |
        | Reels 短视频 短视频 | 每次输入最多采集 1600 个视频 |
      </Accordion>

      <Accordion title="Instagram" icon="instagram">
        |               |                |
        | ------------- | -------------- |
        | 帖子（按关键字）      | 最多采集 150,000 个 |
        | 帖子（按个人资料 URL） | 最多采集 43,000 个  |
        | 评论            | 每次输入最多采集 9 条   |
        | Reels 短视频 短视频 | 最多采集 9000 个    |

        <Warning>
          媒体链接将在 24 小时后失效。
        </Warning>
      </Accordion>

      <Accordion title="Pinterest" icon="pinterest">
        |               |                 |
        | ------------- | --------------- |
        | 个人资料          | 每次输入最多采集 1000 条 |
        | 帖子（按关键字）      | 最多采集 1000 个     |
        | 帖子（按个人资料 URL） | 最多采集 5000 个     |
      </Accordion>

      <Accordion title="Reddit" icon="reddit">
        |          |                 |
        | -------- | --------------- |
        | 帖子（按关键字） | 每次输入最多采集 4000 个 |
        | 评论       | 所有第一级评论均无数量限制   |
      </Accordion>

      <Accordion title="TikTok" icon="tiktok">
        |               |                 |
        | ------------- | --------------- |
        | 个人资料（按搜索 URL） | 每次输入最多采集 2000 个 |
        | 评论            | 每次输入最多采集 1000 条 |
        | 帖子（按关键字）      | 每次输入最多采集 200 个  |
        | 帖子（按个人资料 URL） | 每次输入最多采集 5000 个 |
      </Accordion>

      <Accordion title="Quora" icon="quora">
        |    |                 |
        | -- | --------------- |
        | 帖子 | 每次输入最多采集 1000 个 |
      </Accordion>

      <Accordion title="Vimeo" icon="vimeo">
        |           |                 |
        | --------- | --------------- |
        | 帖子（按关键字）  | 每次输入最多采集 4000 个 |
        | 帖子（按 URL） | 每次输入最多采集 9000 个 |
      </Accordion>

      <Accordion title="X (Twitter)" icon="twitter">
        |    |                 |
        | -- | --------------- |
        | 帖子 | 每次输入最多采集 1000 个 |
      </Accordion>

      <Accordion title="YouTube" icon="YouTube">
        |             |                   |
        | ----------- | ----------------- |
        | 个人资料        | 每次输入最多采集 500 条    |
        | 帖子（按关键字）    | 每次输入最多采集 600 个    |
        | 帖子（按 URL）   | 每次输入最多采集 20,000 个 |
        | 帖子（按搜索筛选条件） | 每次输入最多采集 700 个    |
      </Accordion>

      <Accordion title="TikTok" icon="TikTok">
        只有在同一会话中使用生成的令牌才能访问媒体。
      </Accordion>

      <Accordion title="Linkedin" icon="Linkedin">
        采集的帖子数量仅限于在用户在个人资料中公开显示的数量（例如 10 条）
      </Accordion>
    </AccordionGroup>
  </Accordion>
</AccordionGroup>


# Clay 集成
Source: https://docs.brightdata.com/cn/scraping-automation/web-scraper-api/integrations/clay



本文将为您提供将 Clay 集成到 Bright Data 网络抓取 API 的信息。Clay 是一个强大的工具，用于管理和自动化工作流程。通过将您的 Web Scraper API 集成到 Clay，您可以：

* 自动从目标网站抓取数据。

* 在 Clay 工作流中处理和分析收集到的数据。

* 通过 Clay 将抓取的数据流式传输到其他工具或服务。

***

## 前置条件

在开始之前，请确保以下事项：

1. **访问 Clay**：您必须拥有一个具有管理员权限的 Clay 账户。

2. **Web Scraper API 访问权限**：您需要拥有 Bright Data API 令牌，包括身份验证详细信息、所需的端点以及请求/响应结构。

***

## 集成步骤

### 第 1 步：设置 Web Scraper API

1. 从 Bright Data API 提供的多种选项中选择目标网站。

2. 选择您需要的特定爬虫。

3. 通过 JSON 或 CSV 更新所需的输入列表。

4. 启用 “随结果包含错误报告” 切换按钮。

5. 根据您的偏好，启用 “将结果传输到外部存储” 或 “发送到 Webhook” 切换按钮。

***

### 第 2 步：在 Clay 中创建 API 请求工作流

Clay 允许您使用其用户友好的界面创建自动化工作流。要调用 Web Scraper API，请按照以下步骤操作：

1. **登录 Clay**：

   * 登录到您的 Clay 账户。

   * 进入 **“Workflows（工作流）”** 部分。

2. **设置触发器**：

   * 选择触发工作流的方式（例如，手动、定时调度，或基于与 Clay 集成的其他服务中的事件）。

3. **添加 HTTP 请求操作**：

   * 在工作流中添加一个 HTTP 请求模块。

   * 选择 Web Scraper API 支持的 HTTP 方法（POST **"[触发数据采集](https://docs.brightdata.com/scraping-automation/web-scraper-api/delivery-apis/download-snapshot)"**）。

4. **配置请求**：

   * 在 HTTP 请求模块中输入以下内容：

   * **URL**：输入 API 端点（例如：[https://api.brightdata.com/datasets/v3/trigger](https://docs.brightdata.com/scraping-automation/web-scraper-api/trigger-a-collection)）。

   * **Headers（请求头）**：包含所有必需的请求头，例如：

   ```JSON
     {
         "Authorization": "Bearer YOUR_API_KEY",
         "Content-Type": "application/json"
     }
   ```

   * **Body（请求体）**（如有需要）：以 JSON 形式添加所有必要的参数。

5. **测试请求**：

   * 使用 Clay 的测试工具发送测试请求，确保 Web Scraper API 返回预期数据。

***

### 第 3 步：在 Clay 中处理 API 响应

成功连接 Web Scraper API 后，您可以处理返回的数据：

1. **与其他服务集成**：

   * 使用 Clay 将数据发送到数据库、Google Sheets、电子邮件或其他服务。

2. **添加条件/逻辑**：

   * 在工作流中创建条件或过滤规则。例如，仅处理价格高于某个阈值的商品。

***

### 第 4 步：调度或部署您的工作流

您可以根据需要配置工作流，使其按照预定计划（如每小时或每天）自动运行，或者在需要时手动触发它。


# 概述
Source: https://docs.brightdata.com/cn/scraping-automation/web-scraper-api/overview

探索用于简化数据采集和增强数据集生成的网页抓取工具 API。学习如何启动抓取和管理数据，并了解系统限制信息。

我们非常激动地向您介绍我们的新产品网页抓取工具 [API](https://brightdata.com/products/web-scraper)，它可以简化数据采集流程，让您轻松获取更加丰富多元的数据。该款新产品让您可以通过更强大、更简化的方式采集数据，并可根据您的特定需求更有效地生成数据集。

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.

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/overview.png?maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=92d31a08a110fca4509f0853462f4e87" alt="概述" width="2048" height="1196" data-path="images/scraping-automation/web-scraper-api/overview/overview.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/overview.png?w=280&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a79be6f1bd11f42ef97727068c4730b3 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/overview.png?w=560&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=57f31dae150b0400c2c6f56a11f57082 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/overview.png?w=840&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f9703b98767299dad12d88f84b76d582 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/overview.png?w=1100&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=1cab1d7b93dd0e32d65e53c44ce6e950 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/overview.png?w=1650&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=4d35925cde95c3b8f89ba3b0ab1461e2 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/overview.png?w=2500&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=5dedd1d98d16c72605dba42a4964392b 2500w" data-optimize="true" data-opv="2" />
</Frame>

# How To Collect? (High level)

## [触发采集](https://docs.brightdata.com/cn/scraping-automation/web-data-apis/web-scraper-api/trigger-a-collection)

1. 从我们提供的各种 API 中选择目标网站
2. 通过 JSON 或 CSV 更新所需输入列表
3. 选择数据交付方式：通过 Webhook 或通过 API

### 通过 Webhook 交付：

1. 选择首选文件格式（JSON、NDJSON、JSON lines、CSV）
2. 根据需要设置 Webhook URL 和授权标头
3. 选择是否将文件压缩后发送
4. 测试 Webhook 以验证操作能否成功运行（使用样本数据）
5. 复制代码并运行。

<Frame>
    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/delivery-options.png?maxW=529&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=73d2bc45f8e68c7cd5d64f5a7ec4965e" alt="delivery-options.png" width="529" height="295" data-path="images/scraping-automation/web-scraper-api/delivery-options.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/delivery-options.png?w=280&maxW=529&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7901bddf8e639c4c164b33d85483b7f6 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/delivery-options.png?w=560&maxW=529&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=67d07011d89f40ff3360c2814cdc63d1 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/delivery-options.png?w=840&maxW=529&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=63b9b118090b9ca9d9932a17b8a8d1d1 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/delivery-options.png?w=1100&maxW=529&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f32be9adf33abfd8344b04eab63eafdd 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/delivery-options.png?w=1650&maxW=529&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=940388e4e1d039d7a012302f8d059022 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/delivery-options.png?w=2500&maxW=529&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ad74222a614f6849b91ef264a4804515 2500w" data-optimize="true" data-opv="2" />
</Frame>

### Via Deliver to external storage:

1. 选择首选交付平台（S3、Google cloud、Snowflake 或其他可选平台）
2. 根据所选交付平台填写所需凭据
3. 选择首选文件格式（JSON、NDJSON、JSON lines、CSV）
4. 复制代码并运行。

<Frame>
    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/deliver-snapshot.png?maxW=849&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1717e03bb6ae4e5cdc3961c23e754a98" alt="deliver-snapshot.png" width="849" height="715" data-path="images/scraping-automation/web-scraper-api/deliver-snapshot.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/deliver-snapshot.png?w=280&maxW=849&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=795650668e8cfbee0cbebc04048ce6dc 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/deliver-snapshot.png?w=560&maxW=849&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=71a4d883762e892a351455681d49e449 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/deliver-snapshot.png?w=840&maxW=849&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=92ad2463f7448f5f2e293a44850f6b7e 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/deliver-snapshot.png?w=1100&maxW=849&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=fc611bea01469343d989f8ab0f11676f 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/deliver-snapshot.png?w=1650&maxW=849&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f6e9de0fc22b8cbe56ec75bd265c50ad 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/deliver-snapshot.png?w=2500&maxW=849&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=563530285dd2295cd4edf3b2e52dd9c3 2500w" data-optimize="true" data-opv="2" />
</Frame>

### 限制记录

在运行发现型 API 时，您可限制每个输入请求返回的结果数量

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-disabled.png?maxW=1214&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3b95be366a55854c66c0fe1ca3d29423" alt="limit-per-input-disabled.png" width="1214" height="115" data-path="images/scraping-automation/web-scraper-api/overview/limit-per-input-disabled.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-disabled.png?w=280&maxW=1214&auto=format&n=ilemiSHw8UogZ13k&q=85&s=fa618d0457d5fafa5ef286e7f3fcacc2 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-disabled.png?w=560&maxW=1214&auto=format&n=ilemiSHw8UogZ13k&q=85&s=4cde6a05aee0b76f0ff1eea71501dc58 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-disabled.png?w=840&maxW=1214&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e37e0fbc3b0ae4aefc7954eae5e00a51 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-disabled.png?w=1100&maxW=1214&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9b794cea860c2cb490e34cc10a1b3df7 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-disabled.png?w=1650&maxW=1214&auto=format&n=ilemiSHw8UogZ13k&q=85&s=b4336a3d8e390b9358b65ec5d4675436 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-disabled.png?w=2500&maxW=1214&auto=format&n=ilemiSHw8UogZ13k&q=85&s=1ba7b81f875957dfd9efee92aa2e18d8 2500w" data-optimize="true" data-opv="2" />
</Frame>

在下方示例中，我们限制每个输入请求返回的结果数量为 10

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-10.png?maxW=1182&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9b4f3ef533f66d9a43d9827c8dc0c9eb" alt="limit-per-input-10.png" width="1182" height="272" data-path="images/scraping-automation/web-scraper-api/overview/limit-per-input-10.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-10.png?w=280&maxW=1182&auto=format&n=ilemiSHw8UogZ13k&q=85&s=bcb3b343e0631e8faf7406b065dd9922 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-10.png?w=560&maxW=1182&auto=format&n=ilemiSHw8UogZ13k&q=85&s=7fa69b5094bb000c1512f77b7d576996 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-10.png?w=840&maxW=1182&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d6d76b46b6160acc180c1d58fd2b1656 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-10.png?w=1100&maxW=1182&auto=format&n=ilemiSHw8UogZ13k&q=85&s=203dc9755b912292427d2f9b1e90feee 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-10.png?w=1650&maxW=1182&auto=format&n=ilemiSHw8UogZ13k&q=85&s=713d16b0fdd0e4415c9c8a2b116a67f0 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-10.png?w=2500&maxW=1182&auto=format&n=ilemiSHw8UogZ13k&q=85&s=2c82fc02dd783baea89c720f74996bc2 2500w" data-optimize="true" data-opv="2" />
</Frame>

## [管理 API](https://docs.brightdata.com/cn/scraping-automation/web-data-apis/web-scraper-api/management-apis)

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/management-apis.png?maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6f28cb19f12b99a6ac047b771d9bb06a" alt="management-apis.png" width="2048" height="1060" data-path="images/scraping-automation/web-scraper-api/overview/management-apis.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/management-apis.png?w=280&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e8622cddc9914542d94e31d84efdbfa4 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/management-apis.png?w=560&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6e2527a4be6bef852fa2aa0be7ad74c9 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/management-apis.png?w=840&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=60e9560afcc2cf42c490ea63973a7163 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/management-apis.png?w=1100&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=412b211a11728a4aaf6561e2af220c5c 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/management-apis.png?w=1650&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c4bf4eca6007735368c87fe66e989ce4 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/management-apis.png?w=2500&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=2a5f2520633f4216e4cc3d07b4084e5a 2500w" data-optimize="true" data-opv="2" />
</Frame>

### 获取快照列表

您可使用此 API 查看快照历史记录。 它可返回所有可用快照的列表，包括快照 ID、创建日期和状态。

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/get-snapshot-list.png?maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=37994ba57557392490e375940fe0b9b5" alt="get-snapshot-list.png" width="835" height="192" data-path="images/scraping-automation/web-scraper-api/overview/get-snapshot-list.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/get-snapshot-list.png?w=280&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=84fa6f9d2c029be3b03070b2b0d3f0ad 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/get-snapshot-list.png?w=560&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=20dee1e3357982a43ae7da169e53d7eb 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/get-snapshot-list.png?w=840&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f5f7a516418b0e4fd9b44d4bfb8faab6 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/get-snapshot-list.png?w=1100&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d790de479bd29ed27ce9f5f07042d390 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/get-snapshot-list.png?w=1650&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=8074fb2f1afe01802ea5b0f69f50b86b 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/get-snapshot-list.png?w=2500&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f7fba17e40bb3bfa8d8542fab2a7a48d 2500w" data-optimize="true" data-opv="2" />
</Frame>

### 监控进度

您可使用此 API 查看数据采集状态。当它返回 “collecting” 时，表明数据仍在采集中，当返回 “digesting” 时表明数据进入处理阶段，当返回 “ready” 时表明数据处理完毕且已可以交付。

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=094a16f9c012b74bbf13305e7106cb14" alt="monitor-progress.png" width="828" height="151" data-path="images/scraping-automation/web-scraper-api/overview/monitor-progress.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?w=280&maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c7fb11759c6f3047ca3557195c09c9e3 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?w=560&maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=92491a0e9aca4df76035ccd7e3e42f81 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?w=840&maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=eaadc3a1a56a496312ce73ec936faa2e 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?w=1100&maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9b96773331cb32eb567c7573f2f5d30b 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?w=1650&maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=aeb11187056e5e2817ee2db0683f0d75 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?w=2500&maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a533d034f72edf2ff2bb4904389d1080 2500w" data-optimize="true" data-opv="2" />
</Frame>

## 系统限制

### 文件大小

|            |                             |
| ---------- | --------------------------- |
| 输入         | 高达 1GB                      |
| Webhook 交付 | 高达 1GB                      |
| API 下载     | 最大 5GB（对于更大的文件，请使用 API 交付 ） |
| 交付 API     | 无限制                         |


# 网页抓取基础知识
Source: https://docs.brightdata.com/cn/scraping-automation/web-scraper-ide/basics-of-web-scraping

本文介绍了网页抓取中的基本概念，例如导航、解析、工作线程 (Worker) 类型和主要挑战

如果您对 JS 了如指掌，但同时又是网页数据抓取新手，那可能需要学习基本的抓取方法和一两种策略，以便成功抓取到数据。

网页抓取的基本思路包含导航和解析两大步骤，而实现这两大步骤的策略则取决于所选择的技术方法，即是使用浏览器工作线程 (Browser worker) 还是 代码工作线程 (Code worker)。

## 浏览器工作线程 vs. 代码工作线程

浏览器工作线程和代码工作线程是实现数据抓取的两大技术方法，您可根据自己的需求、预算以及抓取相关网站时面临的技术挑战，选择其中一种即可。

浏览器工作线程通过无头浏览器模拟用户与网站的交互，

能够处理复杂的抓取任务，例如抓取用户输入的信息和动态内容加载。 使用浏览器工作线程运行代码需要更高的 CPM，但在某些使用场景中，它是获取数据的唯一可行解决方案。

代码工作线程则在服务器端运行，通过 HTTP 请求执行抓取任务。 您只需通过脚本或程序向目标网站发送请求，即可从各个响应中提取数据，并将其保存至文件或数据库。 使用代码工作线程运行代码的成本更低、速度更快。

您可随时切换各种抓取工具的工作线程类型，因此无需执着于特定的工作线程，但请注意，一些函数（如 “wait” 函数）专为浏览器工作线程设计，只能与后者一起使用。进一步了解工作线程类型:\
[https://docs.brightdata.com/cn/scraping-automation/web-scraper-ide/worker-types](https://docs.brightdata.com/cn/scraping-automation/web-scraper-ide/worker-types)

## 交互和解析

交互和解析是网页抓取过程的两大关键步骤，涉及访问和处理网站的 HTML 内容。

交互是指在网站各个页面或版块之间移动，找到所需数据的过程。此过程通常会涉及以下操作：向网站 URL 发送 GET 或 POST 请求，以及通过链接或提交表单的方式访问各个网页或版块。它还涉及点击、键入和等待等操作/命令。 一旦浏览器页面含有所需数据，抓取工具就会调用 `parse()` 函数获取数据（该步骤会触发解析器代码），然后调用 `collect()` 函数将数据记录添加至您的最终数据集。

例如：

```js
let data = parse();
collect({
    url: new URL(location.href),
    title: data.title,
    links: data.links,
});
```

解析是指从网站的 HTML 内容中提取相关数据的过程。 该过程涉及识别包含所需数据的 HTML 元素，以及使用正则表达式或其他方法从这些元素中提取数据的操作。

例如：

```js
return {
  title: $('h1').text().trim(),
  links: $('a').toArray().map(e=>new URL($(e).attr('href'))),
};
```

例如，假设您想根据搜索词抓取电商网站的数据，并返回每种产品的信息（标题、描述、价格）。

```js
let search_url = `https`:
navigate(search_url)
let max_page = parse().max_page
for (let i = 1; i <= max_page; i++)
{
    let search_page = new URL(search_url)
     if (i>1)
          search_page.searchParams.set('page', i)
     next_stage({search_page})
}
```

```js
navigate(input.search_page)
let listings = parse().listings
for (let listing_url of listings)
     next_stage({listing_url})
```

```scss
navigate(input.listing_url)
collect(parse())
```

1. 使用 GET 或 POST 请求导航至电商网站的搜索页面
2. 找到包含页数的 HTML 元素
3. 解析 HTML，提取搜索结果页数
4. 导航至每个结果页并执行以下操作
5. 找到包含每个搜索结果数据的 HTML 元素
6. 解析每个搜索结果的 HTML 内容，收集每个产品页面的 URL
7. 导航至每个产品页面并执行以下操作
8. 找到包含所需产品数据的 HTML 元素
9. 解析 HTML，提取所需产品数据

## 大规模抓取数据时面临的挑战和阻碍

小范围的数据抓取可能快速又简单，但如果您的项目需要采集大量的数据，则可能不得不应对一些挑战，因为一些网站会采取验证码、IP 封锁等技术来防止爬虫抓取数据。虽然您可以自己动手，想办法克服这些挑战，但整个过程可能会非常复杂、耗时。 为解决这一难题，我们在专有代理基础架构和网络解锁器的基础上构建了 IDE 云服务，让您无需自己动手即可解决相关挑战。


# 网页抓取工具 IDE 最佳实践
Source: https://docs.brightdata.com/cn/scraping-automation/web-scraper-ide/best-practices

学习使用网页抓取工具 IDE 的最佳实践，包括优化性能、处理错误、管理重试和编写高效的抓取工具代码。

## Missing `dead_page` condition.

使用 `navigate` 指令时，应添加 `dead_page` 条件以检查是否未找到该页面。这将防止自动重试。 虽然当响应状态为 404 时，我们会自动处理此问题，但在某些情况下，网站可能会使用其他各种状态代码进行响应：

Here are good and bad practices examples (you can navigate between them by clicking on the "不好" "Good" tabs)

<CodeGroup>
  ```js ❌ 不好
  try {
    // no need to wait 30sec 'ok-selector' in case of dead_page()
    wait('ok-selector');
  } catch(e) {
    // in this case we can't be sure that the page is real dead
    dead_page('Page doesn\'t exist');
  }
  ```

  ```js ✅ Good
  wait('ok-selector, 404-selector');
  if (el_exists('404-selector'))
    dead_page();
  ```
</CodeGroup>

## 尽量减少对浏览器的请求量

一些交互指令，例如点击类型 el\_exists el\_is\_visible wait wait\_visible，会向浏览器发出真实请求，因而可能会增加延迟并降低性能。 建议组合选择器，进行单个调用，而非多个调用。

<CodeGroup>
  ```js ❌ 不好
  if (!(el_exists('#price1')) || el_exists('#price2')
    || el_exists('#price3') || el_exists('#discount'))
  {
      dead_page('No price found');
  }
  ```

  ```js ✅ Good
  if (!el_exists('#price1, #price2, #price3, #discount'))
    dead_page('No price found');
  ```
</CodeGroup>

## Incorrect usage of `rerun_stage()`

当网站在页面上进行分页并且需要所有页面的数据时，则应从根页面为每个页面调用 `rerun_stage()`，而不是从每个页面调用。这使系统能够并行处理请求并提高抓取工具的速度。

<CodeGroup>
  ```js ❌ 不好
  navigate(input.url);
  let $ = html_load(html());
  let next_page_url = $('.next_page').attr('href');
  rerun_stage({url: next_page_url});
  ```

  ```js ✅ Good
  let url = new URL(input.url);
  if (input.page)
      url.searchParams.set('page', input.page);
  navigate(url);
  // The input.page does not exist except on the root page, from which we
  // have already invoked rerun_stage() for each page.
  if (input.page)
      return;

  let $ = html_load(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>

## Use `close_popup()` to close popups

不要花时间等待弹出窗口的出现。 使用 `close_popup('popup_selector', 'close_button_selector')` 关闭弹出窗口。弹出窗口可以随时出现，在大多数情况下，在每个交互指令之前添加验证检查是不可取的。
不好

<CodeGroup>
  ```js ❌ 不好
  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
  // it runs in the background and does not affect the performance.
  // We check if the popup is visible before any interaction like
  // click or type.
  close_popup('.cky-btn-accept', '.cky-btn-accept');
  navigate('https://example.com');
  click('.open-product-full-info');
  ```
</CodeGroup>

## Use `wait_for_parser_value()` with `tag_response()`

在使用 `tag_response` 指令并需要确保在从页面采集数据之前完成请求时，应使用 `wait_for_parser_value()` ：

<CodeGroup>
  ```js ❌ 不好
  tag_response('product', /api\/product/);
  navigate('https://example.com');

  // parser code
  // in this case we can't be sure that the request is finished
  let {product} = parser;
  return product.data;
  ```

  ```js ✅ Good
  tag_response('product', /api\/product/);
  navigate('https://example.com');
  wait_for_parser_value('product');

  // parser code
  let {product} = parser;
  return product.data;
  ```

  ```js ✅ Good
  tag_response('product', /api\/product/);
  navigate('https://example.com');

  // you can also get the data from the response in interaction
  let product = wait_for_parser_value('product');
  navigate(product.reviews_url);
  tag_html('reviews_html');

  // parser code
  let {product, reviews_html} = parser;
  let $ = html_load(reviews_html);
  let reviews = $('.review').toArray().map(v=>$(v).text());
  return {
    ...product.data,
    reviews,
  }
  ```
</CodeGroup>

## 自定义错误消息

尽可能避免使用自定义错误消息。 我们的系统尽最大努力为您提供最准确的错误消息：

<CodeGroup>
  ```js ❌ 不好
  try {
    wait('selector1');
    //some code
    wait('selector2');
    //some code
  } catch(e) {
    throw "Page not loaded properly"
  }
  ```

  ```js ✅ Good
  // Crawler error: waiting for selector "selector1" failed: timeout 30000ms exceeded
  wait('selector1');
  //some code
  wait('selector2');
  //some code
  ```

  ```js ✅ Good
  if (!el_exists('.product-title'))
      throw new Error('Failed to load product page');
  ```
</CodeGroup>

## 网站响应缓慢，超时增加

如果网站无法正常加载，则可能是由于对等连接不良所致。 建议显示错误消息，系统将尝试使用更稳定的对等会话加载页面。

<CodeGroup>
  ```js ❌ 不好
  // 120 sec to long for waiting
  wait('selector', {timeout: 120000});
  ```

  ```js ✅ Good
  wait('selector'); // better to use default timeout (30 sec)
  wait('selector', {timeout: 45000});
  wait('selector', {timeout: 60000});  // 60 sec is ok for slow 网站s
  ```
</CodeGroup>

## 重试机制

抓取工具代码应清晰，仅专注于抓取数据的必要任务。 没有必要白费力气做重复工作。最好强调与代码无关的问题并在系统中报告这些问题。

<CodeGroup>
  ```js ❌ 不好
  let counter = input.counter || 5;
  while (counter > 1) {
    try {
      wait('selector' , {timeout: 500});
      click('selector');
      type('selector');
      //some code
      break;
    } catch(e) {
      // not acceptable use rerun_stage to create new session in case of error
      return rerun_stage({...input, counter: --counter});
    }
  }


  ```

  ```js ✅ Good
  navigate("https://example.com");
  wait('h1');
  ```
</CodeGroup>

## 避免使用 try-catch 块

这有助于开发简洁易读的代码，无需依赖 `try-catch` 块即可有效地管理潜在的 “空”值 或“未定义”值。

<CodeGroup>
  ```js ❌ 不好
  try {
    const example = obj.prop;
  } catch(e) {}
  ```

  ```js ❌ 不好
  // 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
  const example = object?.prop;
  const example2 = object.prop ?? undefined
  const example3 = object.prop ? object.prop : undefined
  ```
</CodeGroup>

## 解析器代码：从元素集中获取值

最佳实践代码采用更简洁、更实用的 `toArray()` 和 `map()` 方法，而非传统的 `each()` 循环。 这可增强代码的可读性并保持声明样式。

<CodeGroup>
  ```js ❌ 不好
  const links = [];
  $('.card.product-wrapper').each(function(i, el) {
    links.push({url: $(this).find('h4 a').attr('href')});
  })
  return links;
  ```

  ```js ✅ Good
  const links = $('.card.product-wrapper').toArray().map(v=>({
    url: $(v).find('h4 a').attr('href'),
  }));
  ```
</CodeGroup>

## 规范化文本

我们在 cheerio prototype \$(selector).text\_sane() 中添加了一个自定义函数，它删除了所有不必要的空白字符并将其替换为单个空格。

<CodeGroup>
  ```js ❌ 不好
  $.prototype.clearText = function () {
    return this.text().replace(/\s+/g, ' ').trim();
  }
  ```

  ```js ✅ Good
  let name = $('a').text_sane();
  or if you need only numbers
  let value= +$('a').text().replace(/\D+/g, '');
  ```
</CodeGroup>


# 编码环境和教程
Source: https://docs.brightdata.com/cn/scraping-automation/web-scraper-ide/coding-environment

探索使用网页抓取工具 IDE 的基本编码指令和最佳实践。 学习如何高效地进行导航、解析数据、与元素交互以及优化抓取任务。

## IDE 交互代码

以下是您可以用 IDE 完成的所有代码

`input` - 可用于交互代码的全局对象。由触发器 `input` 或 `next_stage()` 调用提供

```js
navigate(input.url);
```

***

`navigate` - 将浏览器会话导航到 URL

* `url`: 所要导航到的 URL

```js
navigate([url]);
navigate(input.url);
navigate('https://example.com');
```

`navigate` 选项

```js
// waits until DOM content loaded event is fired in the browser
navigate([url], {wait_until: 'domcontentloaded'});

// adds a referer to the navigation
navigate([url], {referer: [url]});

// the number of milliseconds to wait for. Default is 30000 ms
navigate([url], {timeout: 45000});

// add headers to the navigation
navigate([url], {header : 'accept: text/html'});

// specify browser width/height
navigate([url], {fingerprint: {screen: {width: 400, height: 400}}});
```

***

`parse` - 解析页面数据

```js
let page_data = parse();
```

***

`collect` - 向网络爬虫创建的数据集添加一行数据

* `data_line`: 含有您想采集的字段的对象
* `validate_fn`: 用于验证行数据是否有效的可选函数

```js
collect([data_line] [validate_fn]);
collect({ title: page_data.title price: page_data.price });
collect({ price: data.price });

collect(line, l=>!l && throw new Error('Empty line'));
```

***

`next_stage` - 使用指定的输入运行网络爬虫的下一阶段

* `input`: 所要传递给下一个浏览器会话的输入对象

```js
next_stage({url: 'http://example.com', page: 1});
```

<Frame>
    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/cn/scraping-automation/web-scraper-ide/images/scraping-automation/web-scraping-ide/coding-environment/next-stage.png" alt="" />
</Frame>

***

`rerun_stage` - 使用新的 `input` 再次运行此阶段的网络爬虫

* `input`: 所要传递给下一个浏览器会话的输入对象

```js
rerun_stage({url: 'http://example.com/other-page'});
```

***

`run_stage` - 使用新的浏览器会话运行网络爬虫的特定阶段

* `input`: 所要传递给下一个浏览器会话的输入对象
* `stage`: 将要运行哪个阶段（1 是第一阶段）

```js
run_stage(2, {url: 'http://example.com', page: 1});
```

***

`country` - 将您的抓取配置为从特定国家/地区运行

* `code`: 2 个字符的 ISO 国家/地区代码

```js
country(<code>);
```

***

`wait` - 等待元素出现在页面上

* `selector`: 元素选择器
* `opt`: 等待选项（参见示例）

```js
wait (<selector>);
wait('#welcome-splash');
wait('.search-results .product');
wait('[href^='/product']');
wait(<selector>, {timeout: 5000});
wait(<selector>, {hidden: true});
```

***

`wait_for_text` - 等待页面上的元素包含一些文本

* `selector`: 元素选择器
* `text`: 所要等待的文本

```js
wait_for_text(<selector>, <text>);
wait_for_text('.location', 'New York');
```

***

`click` - 点击一个元素（将等待该元素出现后再点击）

* `selector`: 元素选择器

```js
click(<selector>);
click('#show-more');
```

***

`type` - 在输入框中输入文本（将等待输入出现后再进行输入）

* `selector`: 元素选择器

* `text`: 所要等待的文本

```js
type(<selector>, <text>);
type('#location', 'New York');
type(<selector>, ['Enter']);
type(<selector>, ['Backspace']);
```

***

`select` - 从精选元素中选择一个值

* `selector`: 元素选择器

```js
select(<select>, <value>);
select('#country', 'Canada');
```

***

`URL` - 来自 `NodeJS` 标准 "url" 模块的 `URL` 类

* `url`: URL 字符串

```js
let u = new URL('https://example.com');
```

***

`location` - 含有当前位置信息的对象. 可用字段: `href`

* `url`: URL 字符串

```js
navigate('https://example.com');
location.href;
```

***

`tag_response` - 保存浏览器请求的响应数据

* `name`: 标记字段的名称
* `pattern`: 所要匹配的 URL 模式

```js
tag_response(<field>, <pattern>);
tag_response('teams', /\/api\/teams/);
navigate('https://example.com/sports');

let teams = parse().teams;
for (let team of teams) collect(team);
```

***

`response_header` - 返回最后一次页面加载的响应标头

```js
let headers = response_headers(); 
console.log('content-type', headers['content-type']);
```

***

`console` - 来自交互代码的日志消息

```js
console.log(1, 'luminati', [1, 2], {key: value});
```

***

`load_more` - 滚动到列表底部，触发加载更多项目。适用于延迟加载的无限滚动网站

* `selector`: 元素选择器

```js
load_more(<selector>);
load_more('.search-results');
```

***

`scroll_to` - 滚动页面，从而使元素可见

```js
scroll_to(<selector>);
scroll_to('.author-profile');
```

***

`$` - 类似 jQuery expressions 的助手

* `selector`: 元素选择器

```js
$(<selector>);
wait($('.store-card'))
```

## IDE 解析器代码

以下是您可以用 IDE 完成的所有代码：

`input` - 可用于解析器代码的全局变量

```js
let url = input.url;
```

***

`$` - 一个 cheerio 的实例
<Tip>在 cheerio 网站上查找更多信息: [https://cheerio.js.org/](https://cheerio.js.org/).</Tip>

```js
$('#example').text()
$('$example').attr('href')
```

***

`location` - 可用于解析器代码的全局变量。含有当前位置信息的对象

```js
let current_url = location.href;
```


# 完整的网页抓取工具 IDE 示例
Source: https://docs.brightdata.com/cn/scraping-automation/web-scraper-ide/complete-examples

探索使用网页抓取工具 IDE 进行网页抓取的全面示例，包括交互代码，解析、处理多个结果以及高级技术。

## 简介

采集和解析指令已删除。 数据将作为对象或阵列从解析器代码中返回，并将自动保存到输出中：

<CodeGroup>
  ```js Interaction code
  // 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
  // Old code
  return {
      title: $('h1').text(),
  };

  // New code
  return {
      title: $('h1').text(),
  };

  // or
  let $ = html_load(parser.html_key);
  return {
      title: $('h1').text(),
  };
  ```
</CodeGroup>

添加新的指令以提供对交互代码中数据的访问：`tag_html`、`tag_request`、`tag_graphql`

此外，更新一些现有指令：`tag_response`、`tag_sitemap`、`tag_all_responses`。有关更多详情，请参见IDE 文档: [https://docs.brightdata.com/cn/api-reference/web-scraper-ide-api](https://docs.brightdata.com/cn/api-reference/web-scraper-ide-api)

使用任何标记指令时，您可以提供自定义名称。 然后，您可以在解析器下的解析器代码中使用此名称访问数据。`YOUR_KEY`.

对于 `tag_html`，当前的浏览器位置 `URL` 将保存在解析器下。`YOUR_KEY_url`.

对于只需要一个 `tag_html` 的简单情况，可以跳过，它会自动保存在 `parser.page` 下。

<CodeGroup>
  ```js Interaction code
  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
  {page1, page1_url, page2, page2_url, page3, page3_url} = parser;
  let $ = html_load(page2);
  return {
    title2: $('h1').text(),
  };
  ```
</CodeGroup>

有时，有必要在交互代码中获取经过解析的数据并用其发出请求。查看操作示例：

<CodeGroup>
  ```js Interaction code
  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
  {product_json} = parser;
  return product_json;
  ```
</CodeGroup>

## 多个结果

若要采集多个结果，可以从解析器代码返回阵列。

<CodeGroup>
  ```js Interaction code
  navigate("https://example.com/products");
  ```

  ```js Parser code
  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>

## 重新解析

重新解析是一项新功能，允许重新解析已采集的数据。 当您想在不重新运行整个交互代码的情况下更改解析器代码时，它可能十分有用：

<img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/cn/scraping-automation/web-scraper-ide/images/scraping-automation/web-scraping-ide/complete-examples/reparse_image.png" alt="" />

## `next_stage` and `rerun_stage`

当抓取工具有多个步骤时，解析器代码仅在最后一步中可用。所有其他步骤只能有 `next_stage` 调用。若要解析页面中的某些内容，应使用 `load_html` ：

<CodeGroup>
  ```js Interaction code step 1

  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
  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
  return $('a[data-qa-action="product-click"]').toArray()
    .map(v => ({url: new URL($(v).attr('href'))}));
  ```
</CodeGroup>

## 基本的 PDP 抓取工具

<CodeGroup>
  ```js Interaction code
  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
  const $ = html_load(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_描述,
      "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>

## 多重导航示例

<CodeGroup>
  ```js Interaction code
  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
  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 $ = html_load(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,
                    描述: $(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,
                  描述: 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>

## 多个 `tag_response`

<CodeGroup>
  ```js Interaction code
  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
  let room_id = /([0-9]+)(?:\?|$)/.exec(input.url)?.[1];
  const $ = html_load(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,
    描述: sections.find(v=>v?.sectionId == "DESCRIPTION_MODAL")
      ?.section?.items?.map(v=>((v?.title||'')+' '+v?.html?.htmlText).trim()
    )?.join(', '),
    category: metadata.seo功能.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?.host功能?.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,
    描述_items: sections.find(v=>
        v?.sectionId == "AVAILABILITY_CALENDAR_DEFAULT")?.section
          ?.描述Items.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>


# 使用 IDE 开发自助管理式抓取器
Source: https://docs.brightdata.com/cn/scraping-automation/web-scraper-ide/develop-a-scraper

了解如何使用网络抓取器 IDE 创建自助管理式数据抓取器。 按照步骤编写交互和解析器代码，预览、保存和启动自定义抓取器。

要使用我们的集成开发环境 (IDE) 开发自定义抓取器，您需要插入 URL 并开始使用 Javascript 语言与开发环境进行交互。

<Steps>
  <Step title="从零开始/选择模板">
    您可以从零开始，也可以使用代码模板开始开发。
  </Step>

  <Step title="编写交互代码 交互代码">
    使用交互代码窗口，您可以与目标网站的元素进行交互。
  </Step>

  <Step title="编写解析器代码 解析器代码">
    解析从交互窗口收集的 HTML 结果。
  </Step>

  <Step title="运行预览 预览">
    预览您的互动和收集流程。 要测试您的代码，请点击“播放”图标。
  </Step>

  <Step title="保存您的代码">
    完成编辑后，保存并完成自己的数据抓取器。
  </Step>

  <Step title="设置您的交付偏好">
    设置您的首选交付设置: [https://docs.brightdata.com/cn/scraping-automation/web-scraper-ide/initiate-collection-and-delivery-options#delivery-options](https://docs.brightdata.com/cn/scraping-automation/web-scraper-ide/initiate-collection-and-delivery-options#delivery-options)
  </Step>

  <Step title="启动抓取器运行">
    启动您的抓取器并获取收集结果。
  </Step>
</Steps>

通过在 IDE 中编写代码来创建数据抓取器。 开发环境提供了创建自己的数据抓取器所需的所有工具。


# Web Scraper IDE 常见问题解答
Source: https://docs.brightdata.com/cn/scraping-automation/web-scraper-ide/faqs

查看 Bright Data 的 Web Scraper IDE 常见问题解答，了解设置、故障排除、开发自定义数据抓取工具的最佳实践等信息。

<AccordionGroup>
  <Accordion title="什么是 Bright 数据 网页抓取工具？">
    Bright 数据 网页抓取工具是一种自动化工具，可帮助企业自动大规模采集各类线上公开数据，并大幅减少代理维护和开发方面的内部开销。

    网页抓取工具以结构化格式提供大量原始数据，并可与现有系统集成，立即用于竞争性的数据驱动决策。

    Bright 数据 已开发出数百种针对热门平台的网页抓取工具。
  </Accordion>

  <Accordion title="什么是 Web Scraper IDE？">
    Web Scraper IDE 是一个集成开发环境。 IDE 可以是任何规模的，可轻松获取的公开网络数据库，您可：

    * 在几分钟内构建抓取工具
    * 轻松调试和诊断
    * 快速投入生产
    * 使用简单的 Javascript 编写浏览器脚本
  </Accordion>

  <Accordion title="使用网页抓取工具时的“输入”配置指什么？">
    “输入”配置就是您采集数据时需键入的一系列参数，以运行它们进行数据采集。这可能包括关键词、URL、搜索项目、产品 ID、ASIN、个人资料名称、入住日期和退房日期等。
  </Accordion>

  <Accordion title="使用网页抓取工具时的“输出”配置指什么？">
    “输出”配置就是根据您的输入参数从平台采集的数据。您可以 JSON/NDJSON/CSV/XLSX 的格式接收数据。
  </Accordion>

  <Accordion title="免费试用时，我可免费采集多少条记录？">
    每次免费试用时，您可免费采集 100 条记录（注意：100 条记录并不意味着 100 次页面加载量）。
  </Accordion>

  <Accordion title="为何我收到的统计记录数大于输入参数中设置的记录数？">
    您收到的记录数总是高于您在输入配置中请求的记录数。
  </Accordion>

  <Accordion title="从社交媒体采集到的最常见数据点包括那些？">
    关注者数量、帖子的平均点赞次数、参与度、账户主题、受众的社交和人口统计特征、社交监听：关键词/品牌提及量、情绪、热门话题。
  </Accordion>

  <Accordion title="我可否从多个平台采集数据？">
    是的，我们可同时从各个网站大规模采集数据。
  </Accordion>

  <Accordion title="我可否在网页抓取工具中添加其他信息？">
    可以，您可向客户经理寻求协助，或者进入“报告问题”页面，提交与特定网页抓取工具相关的工单。然后请求在网页抓取工具中添加或删除字段。
  </Accordion>

  <Accordion title="什么是搜索型抓取工具？">
    如您不知道具体的 URL，则可搜索相关术语，然后根据该术语获取数据。
  </Accordion>

  <Accordion title="什么是发现型抓取工具？">
    使用发现型抓取工具时，您可以直接输入 URL 并从相关页面采集所有数据。您无需指定具体的产品或关键词，即可收到数据。
  </Accordion>

  <Accordion title="我可否自行更改 IDE 中的代码？">
    可以，代码是用 JS 编写的，对于自管理抓取工具，您可根据自身需求更改代码。
  </Accordion>

  <Accordion title="可以通过哪些方式发起请求？">
    我们通过 3 种方式供您发起请求：

    * 通过 API 启动 - 常规请求、队列请求和替换请求。
    * 手动启动。
    * 定时模式
  </Accordion>

  <Accordion title="如何开始使用网页抓取工具？">
    您可通过以下两种方式使用数据采集工具：

    * [自行开发一款自管理抓取工具](/cn/scraping-automation/web-scraper-ide/develop-a-scraper)
    * [请求定制数据集](/cn/datasets/custom-datasets/request)

    <Frame>
            <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-two-ways-of-usage.png?maxW=1152&auto=format&n=ilemiSHw8UogZ13k&q=85&s=439313322488a441371a74fdfc7e2fc7" alt="web-scraper-two-ways-of-usage.png" width="1152" height="239" data-path="images/scraping-automation/web-scraping-ide/faqs/web-scraper-two-ways-of-usage.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-two-ways-of-usage.png?w=280&maxW=1152&auto=format&n=ilemiSHw8UogZ13k&q=85&s=fd251e1e74c5a18e2c42e73d82d9f8b4 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-two-ways-of-usage.png?w=560&maxW=1152&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6cdafd96c74ec8d4a611aae5d0d90a68 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-two-ways-of-usage.png?w=840&maxW=1152&auto=format&n=ilemiSHw8UogZ13k&q=85&s=216b9327fb3ade91fdb3430596b5355d 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-two-ways-of-usage.png?w=1100&maxW=1152&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a06decc27b1d73d95cc9d8b8964924b2 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-two-ways-of-usage.png?w=1650&maxW=1152&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6da3e3cd79c6f8c83452a1387b42bdcf 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-two-ways-of-usage.png?w=2500&maxW=1152&auto=format&n=ilemiSHw8UogZ13k&q=85&s=97ae84a924ab348870b4150cd3b6ec21 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>

  <Accordion title="什么是队列请求？">
    当您发送多个 API 请求时，“队列请求”则表示您希望在第一个请求完成后自动启动下一个请求，以此类推，其他请求也是如此。
  </Accordion>

  <Accordion title="什么是 CPM？">
    CPM = 1000 次页面加载
  </Accordion>

  <Accordion title="在构建抓取工具时，哪些事件会被计费？">
    计费事件如下所示：

    * `navigate()`
    * `request()`
    * `load_more()`
    * （后期）媒体文件下载
  </Accordion>

  <Accordion title="如何确认有人正在帮我开发所要求的新的网页抓取工具？">
    您将收到一封电子邮件，告知开发人员正为您开发新的网页抓取工具，当您的抓取工具准备就绪后，您将收到通知。

    您还可以在控制面板上查看请求状态：

        <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-status.png?maxW=560&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d0cac124cfba3775e4953d8659fe7173" alt="web-scraper-status.png" width="560" height="517" data-path="images/scraping-automation/web-scraping-ide/faqs/web-scraper-status.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-status.png?w=280&maxW=560&auto=format&n=ilemiSHw8UogZ13k&q=85&s=4ef8be5b2d795931172421acc0bb36a0 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-status.png?w=560&maxW=560&auto=format&n=ilemiSHw8UogZ13k&q=85&s=4eedf6d8a30da49932c116603e270fc2 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-status.png?w=840&maxW=560&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6fd441be7439834cf1a6f03742bb2b3f 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-status.png?w=1100&maxW=560&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0c14bde611100204592626eadc897c17 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-status.png?w=1650&maxW=560&auto=format&n=ilemiSHw8UogZ13k&q=85&s=775605760cb135c3699df4c0ff8bec3c 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-status.png?w=2500&maxW=560&auto=format&n=ilemiSHw8UogZ13k&q=85&s=cf273e4bedf2fb3701e351c16d7c06ba 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="如何在 Web scraper IDE 上报告问题？">
    您可以使用此表单来沟通您在平台、抓取工具或数据集结果方面遇到的任何问题。

    <Note>
      我们会根据所选问题类型将您的工单分配给各个部门。 请务必选择最相关的问题类型。\*
    </Note>

    <Steps>
      <Step title="选择作业 ID：已发布的数据集">
                <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/job-id.png?maxW=834&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0fac34a4b3eac18bc77c60cb506961e6" alt="job-id.png" width="834" height="353" data-path="images/scraping-automation/web-scraping-ide/faqs/job-id.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/job-id.png?w=280&maxW=834&auto=format&n=ilemiSHw8UogZ13k&q=85&s=5ea673d60298f278c137a00f6ae53f33 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/job-id.png?w=560&maxW=834&auto=format&n=ilemiSHw8UogZ13k&q=85&s=1306839b72cbbdd036c8eb03b86d759e 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/job-id.png?w=840&maxW=834&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0e76b20d85584cd5bb02bad8dcc6deae 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/job-id.png?w=1100&maxW=834&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a953dfd8806b6e4ec32c59709d49df4f 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/job-id.png?w=1650&maxW=834&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0c0d9d7f8d8e416e939557b2a7dcbf84 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/job-id.png?w=2500&maxW=834&auto=format&n=ilemiSHw8UogZ13k&q=85&s=cde88369b15c30e05d487ac5a263a387 2500w" data-optimize="true" data-opv="2" />
      </Step>

      <Step title="选择问题类型">
                <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/issue-category.png?maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=02332d0d4b8d38f721ef9174e3bd149e" alt="issue-category.png" width="835" height="421" data-path="images/scraping-automation/web-scraping-ide/faqs/issue-category.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/issue-category.png?w=280&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c441378b1632f431415c845e69c0e962 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/issue-category.png?w=560&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=97c45a593a49f7941cb6f8dce765a7db 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/issue-category.png?w=840&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6a08f96206bc94653366cd93188172f4 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/issue-category.png?w=1100&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=234b3f416b34dc878139ab912d3ddafc 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/issue-category.png?w=1650&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=760f05a5a1881e80fad7db4892ee9fb9 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/issue-category.png?w=2500&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f45020d5db0412432de4a5a3d16134f6 2500w" data-optimize="true" data-opv="2" />

        <AccordionGroup>
          <Accordion title="数据">
            <Note>
              此选项仅适用于托管型抓取工具。工单将直接发送至您的抓取工具工程师。
            </Note>

            * 字段缺失
            * 记录缺失
            * 值缺失
            * 解析问题：数据集结果不正确
          </Accordion>

          <Accordion title="采集和交付">
            <Note>
              此类工单将发送至我们的支持人员。
            </Note>

            * 交付不完整：交付期间出现问题
            * 抓取工具运行缓慢：抓取工具采集速度慢或被卡住
          </Accordion>

          <Accordion title="其他">
            <Note>
              此类工单将发送至您的客户经理。
            </Note>

            * UI 问题：UI 无法正常运行
            * 产品问题：使用 Web Scraper 产品时遇到的一般性问题
            * 其他问题
          </Accordion>
        </AccordionGroup>
      </Step>

      <Step title="（解析问题）使用红色“故障”图标指明哪些采集结果不正确。" />

      <Step title="（解析问题）输入您期望收到的采集结果" />

      <Step title="描述问题，并填写用于采集数据的 URL" />

      <Step title="如有需要，请附上图片以更直观地展示您报告的问题。">
                <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/add-more-context.png?maxW=1746&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c0d8b6de5d6243322a0efe01184a5088" alt="add-more-context.png" width="1746" height="904" data-path="images/scraping-automation/web-scraping-ide/faqs/add-more-context.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/add-more-context.png?w=280&maxW=1746&auto=format&n=ilemiSHw8UogZ13k&q=85&s=7c437076671c3065d8a25d4782cbe403 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/add-more-context.png?w=560&maxW=1746&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0edb5a2f6fe3348115a21848d0831e8c 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/add-more-context.png?w=840&maxW=1746&auto=format&n=ilemiSHw8UogZ13k&q=85&s=79bb1a28349ebf1e4b0e30e7e7d410e4 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/add-more-context.png?w=1100&maxW=1746&auto=format&n=ilemiSHw8UogZ13k&q=85&s=359c56f90752f3afb4e0b441062beb8d 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/add-more-context.png?w=1650&maxW=1746&auto=format&n=ilemiSHw8UogZ13k&q=85&s=53d936d9262d0a81481df5c3bc24d6f3 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/add-more-context.png?w=2500&maxW=1746&auto=format&n=ilemiSHw8UogZ13k&q=85&s=ad28fe36712a5ce60c792040a4425c83 2500w" data-optimize="true" data-opv="2" />
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="我更新了托管型抓取工具的输入/输出架构。 我可否在 Bright数据 更新我的抓取工具的过程中继续使用它？">
    更新输入/输出架构后，需要更新抓取工具以匹配新架构。如果您在抓取工具尚未更新完毕期间运行它，则会看到“输入/输出架构不兼容”的错误提示。

    <Tabs>
      <Tab title="通过 UI">
                <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/via-ui.png?maxW=413&auto=format&n=ilemiSHw8UogZ13k&q=85&s=48fb33156db3256e1b4435e787bf70a9" alt="via-ui.png" width="413" height="194" data-path="images/scraping-automation/web-scraping-ide/faqs/via-ui.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/via-ui.png?w=280&maxW=413&auto=format&n=ilemiSHw8UogZ13k&q=85&s=5945a90815b17d88a7e91ffcf5202a3e 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/via-ui.png?w=560&maxW=413&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e1c4aeaafc158dac7449199d0ccce9ae 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/via-ui.png?w=840&maxW=413&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6bfa5b1b4601a6c0301516d6c16086dc 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/via-ui.png?w=1100&maxW=413&auto=format&n=ilemiSHw8UogZ13k&q=85&s=fc9b2a4b97f4eba2e80ac6c01a893cb3 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/via-ui.png?w=1650&maxW=413&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d5ba880f2079361a517a8f9e8703b331 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/via-ui.png?w=2500&maxW=413&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a99f387a2b6c5c0e1fa3cd31c1ad15c8 2500w" data-optimize="true" data-opv="2" />
      </Tab>

      <Tab title="通过 API">
        ```json
        {"error":{"code":"input(output)_schema_incompatible" ... }}
        ```
      </Tab>
    </Tabs>

    ***

    如果您想在忽略架构更改的情况下启动抓取工具，则可点击 UI 上的“仍然触发 (Trigger anyway)” 按钮。如想通过 API 启动，您可输入

    * 输出架构不兼容: `override_incopatible_schema=1`
    * 输入架构不兼容: `override_incopatible_input_schema=1`

    触发抓取工具的参数：

    ```sh
    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>

  <Accordion title="如何调试实时抓取工具？">
    我们会在虚拟作业记录中存储最近发生的 1000 个错误，这样您就可以查看错误的输入示例（可通过 CP 按钮在 IDE 中查看这些错误）。

    客户应该知道哪些输入是错误的，因为他们已收到“错误”的响应。您可在 IDE 中通过手动方式重新运行它们，查看会发生的情况。这就好比在解锁器运行出错时提供 CURL 请求示例一样。
  </Accordion>

  <Accordion title="如果在使用网页抓取工具时遇到问题，我该怎么办？">
    请转到 Bright 数据 的控制面板，点击“报告问题”。 我们的 14 位开发人员每天都会监控用户提交的各种工单，一旦您上报问题，系统会自动将您的工单分配给其中一位开发人员。 请务必详细描述遇到的问题，如不确定所遇到的问题，请联系您的客户经理。报告问题后，您无需再执行其他操作，您将会收到一封电子邮件，确认问题已被报告。

        <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/three-dots-report-an-issue.png?maxW=1274&auto=format&n=ilemiSHw8UogZ13k&q=85&s=cb41c36a82764259c5740e6ace5c922f" alt="three-dots-report-an-issue.png" width="1274" height="418" data-path="images/scraping-automation/web-scraping-ide/faqs/three-dots-report-an-issue.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/three-dots-report-an-issue.png?w=280&maxW=1274&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6a88e4bb8cf8e9f9d4ded7fcc0c36fca 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/three-dots-report-an-issue.png?w=560&maxW=1274&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e22d130001fcda98367568904550ddd5 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/three-dots-report-an-issue.png?w=840&maxW=1274&auto=format&n=ilemiSHw8UogZ13k&q=85&s=1d9d6f077f1c5e80b9ffe4df97f32544 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/three-dots-report-an-issue.png?w=1100&maxW=1274&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f87dae259cd5bab41515350ec76f52dc 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/three-dots-report-an-issue.png?w=1650&maxW=1274&auto=format&n=ilemiSHw8UogZ13k&q=85&s=4d4c1d0944c4a49b602ce714d56496c0 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/three-dots-report-an-issue.png?w=2500&maxW=1274&auto=format&n=ilemiSHw8UogZ13k&q=85&s=96982fe12d96bbbe08b012acdad7fc14 2500w" data-optimize="true" data-opv="2" />
        <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/tabs-report-an-issue.png?maxW=1080&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3c36e060a77fbbee0db6a63f94648c2b" alt="tabs-report-an-issue.png" width="1080" height="570" data-path="images/scraping-automation/web-scraping-ide/faqs/tabs-report-an-issue.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/tabs-report-an-issue.png?w=280&maxW=1080&auto=format&n=ilemiSHw8UogZ13k&q=85&s=7c5f57b29fb7c7f246ddfc5a9a00a55c 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/tabs-report-an-issue.png?w=560&maxW=1080&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a1fb7fa6296d677c8303337a2fc825de 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/tabs-report-an-issue.png?w=840&maxW=1080&auto=format&n=ilemiSHw8UogZ13k&q=85&s=fdce9370073b1b9fa18c8b0dc2a0755b 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/tabs-report-an-issue.png?w=1100&maxW=1080&auto=format&n=ilemiSHw8UogZ13k&q=85&s=7b5c238b36a775d85885e70c7d029267 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/tabs-report-an-issue.png?w=1650&maxW=1080&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d8a2d6d80a52d745f46bbb02f7e45be7 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/tabs-report-an-issue.png?w=2500&maxW=1080&auto=format&n=ilemiSHw8UogZ13k&q=85&s=fb3a2c954119f2fe1b4e0c4a5b525ff7 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="“报告问题”时，我该在报告中包含哪些信息？">
    请在报告问题时提供以下信息：

    * 选择遇到的问题类型（例如：获得错误的结果/数据点缺失/结果从未加载/交付问题/ UI 问题/抓取工具运行缓慢/IDE 问题/其他）
    * 请详细描述您遇到的问题
    * 您还可以上传相关文件，展示遇到的问题。

    您报告问题后，系统将自动创建一个工单，我们的研发部门会及时处理它。
  </Accordion>

  <Accordion title="What is a 数据 Collector?">
    In the past, we referred to all of our scraping tools as "Collectors." A Collector is essentially a web scraper that consists of both interaction code and parser code. It can operate as an HTTP request or in a real browser, with all requests routed through our unlocker network to prevent blocking.

    Over time, we developed a 数据set Unit that builds on top of one or more Collectors. For example, with a single Collector (direct request), you can scrape a specific URL—such as a product page from an e-commerce site—and receive the parsed data. In more complex scenarios, multiple Collectors can work together, such as when discovering and scraping categories, followed by collecting data on every product within those categories.
  </Accordion>

  <Accordion title="How to Create a 数据 Collector?">
    You have a few options to create and configure a 数据 Collector:

    1. Using the Web Scraper IDE:
       You can design and structure your parser as individual Collectors or as a single Collector with multiple steps. To get started:

    * Click on the "Web 数据 Collection" icon on the right.
    * Navigate to the "My Scrapers" tab.
    * Select the "Develop a Web Scraper (IDE)" button.

    From here, you can build from scratch or explore available templates for guidance.
    Start here: [Create a 数据 Collector](https://brightdata.com/cp/data_collector/collectors/create)

    2. Requesting a Custom 数据set:
       If you prefer us to handle it, you can request a custom dataset, and we’ll create the 数据 Collectors needed to deliver it.
       To do this, click on the "Request 数据集" button under the "My 数据集" tab and choose the option that best suits your needs.
       Start here: [Request a Custom 数据set](https://brightdata.com/cp/datasets/requests/services)
  </Accordion>
</AccordionGroup>


# 功能
Source: https://docs.brightdata.com/cn/scraping-automation/web-scraper-ide/features



## 数据抓取工具控制面板

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/dashboard.png?maxW=1181&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e52e378de622b154c284a895d3aa3a5a" alt="" width="1181" height="581" data-path="images/scraping-automation/web-scraping-ide/features/dashboard.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/dashboard.png?w=280&maxW=1181&auto=format&n=ilemiSHw8UogZ13k&q=85&s=97c706ed1f15e204ad34c55183c55cb0 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/dashboard.png?w=560&maxW=1181&auto=format&n=ilemiSHw8UogZ13k&q=85&s=816d24839faddcad9790e014b4306a85 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/dashboard.png?w=840&maxW=1181&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d59b2cc84852d6f1e260d1aa87399493 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/dashboard.png?w=1100&maxW=1181&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c9ff944d23ec76b5011185a13974bba0 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/dashboard.png?w=1650&maxW=1181&auto=format&n=ilemiSHw8UogZ13k&q=85&s=82a59c260b1bc69703e78c8190ec360e 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/dashboard.png?w=2500&maxW=1181&auto=format&n=ilemiSHw8UogZ13k&q=85&s=faa64ada4449367c583ea9223e75585c 2500w" data-optimize="true" data-opv="2" />
</Frame>

无论是使用模板创建的抓取工具，还是自定义的抓取工具，都将显示数据抓取工具的控制面板上。

### 概述

* **免费试用**: 在 7 天免费试用期间，您可享受 1,000 次页面加载服务。
* **可用更新**: 提示有新版抓取工具可用。如未显示”更新“按钮，则说明您使用的是最新版本。
* **属性**: 您可在此处查看所有抓取工具的属性。[了解更多](/cn/scraping-automation/web-scraper-ide/features#properties)
* **交付首选项**: 选择所需文件格式、交付方式，并进行通知设置。[了解更多](/cn/scraping-automation/web-scraper-ide/initiate-collection-and-delivery-options#output-schema)
* **输出配置/ 架构**: 您可返回此处编辑输出定义。

***

### 抓取工具操作菜单

抓取工具操作菜单让您可以使用抓取工具执行不同的操作。

* **通过 API 启动** - 无需进入控制面板即可开始数据采集
* **手动启动** - Bright Data 的控制面板使您可以轻松开始采集数据
* **按计划运行** - 精确选择何时采集所需数据
* **版本** - 查看抓取工具的修改版本
* **报告问题** - 您可以使用此表单来沟通您在平台、抓取工具或数据集结果方面遇到的任何问题
* **复制链接** - 复制抓取工具的链接与同事共享
* **工单** - 查看您的工单状态
* **高级选项：**
  * 编辑代码 - 在 IDE 中编辑抓取工具的代码。
  * 禁用抓取工具 - 暂时禁用抓取工具，但是如果需要，您可以将其重新激活。
  * 删除抓取工具 - 永久删除抓取工具。

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/action-menu.png?maxW=1665&auto=format&n=ilemiSHw8UogZ13k&q=85&s=ed4071c3e62eb43ddd83d69b81e57fb7" alt="" width="1665" height="737" data-path="images/scraping-automation/web-scraping-ide/features/action-menu.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/action-menu.png?w=280&maxW=1665&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9f54ba834b78c41d9dff5dc6c92b0180 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/action-menu.png?w=560&maxW=1665&auto=format&n=ilemiSHw8UogZ13k&q=85&s=b3134efe67af086aa1f985ae6e5865bd 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/action-menu.png?w=840&maxW=1665&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3fa654668817e49161c33a804fd6d494 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/action-menu.png?w=1100&maxW=1665&auto=format&n=ilemiSHw8UogZ13k&q=85&s=db77371ecbabf41e32bb21944d7b7990 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/action-menu.png?w=1650&maxW=1665&auto=format&n=ilemiSHw8UogZ13k&q=85&s=81aedd3a1c135d923bff002e32f93526 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/action-menu.png?w=2500&maxW=1665&auto=format&n=ilemiSHw8UogZ13k&q=85&s=2467666049f6eb3f2fd2f2a1b07b7324 2500w" data-optimize="true" data-opv="2" />
</Frame>

***

### 属性：

<img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/properties.png?maxW=1605&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a274c50515a9e46efe738a71a7c49d5f" alt="" width="1605" height="446" data-path="images/scraping-automation/web-scraping-ide/features/properties.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/properties.png?w=280&maxW=1605&auto=format&n=ilemiSHw8UogZ13k&q=85&s=656578d6f08275718187297e5c0d6b73 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/properties.png?w=560&maxW=1605&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e0626ef62e37278cb02aecf787675471 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/properties.png?w=840&maxW=1605&auto=format&n=ilemiSHw8UogZ13k&q=85&s=945ef350b7842ceada1fa32e983d46b1 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/properties.png?w=1100&maxW=1605&auto=format&n=ilemiSHw8UogZ13k&q=85&s=71e433593d1dfbb1139e96447caad7e4 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/properties.png?w=1650&maxW=1605&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6a0b3cf8c191ef02e87399b5605a0fe2 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/properties.png?w=2500&maxW=1605&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0a8b15f67eaa62750bcdc3b98418336a 2500w" data-optimize="true" data-opv="2" />

* 抓取工具的维护者：
  * 自助服务：抓取工具由您自己维护
  * 全套服务：抓取工具由 Bright Data 数据开发人员维护
* 抓取工具的类型：
  * 搜索型：抓取工具的输入参数是一个关键字（例如 iPhone）
  * PDP：抓取工具的输入参数是产品页面 URL
  * 发现型：抓取工具的输入参数是类别 URL
  * 其他
* 抓取工具的用例（社交媒体、电子商务、旅行网站等）
* 上次修改时间：表示上次更新抓取工具的时间
* CPM 价格：1 CPM = 1,000 次页面加载。
* 平均每次输入 的页面加载次数：处理 1 个输入集所需的平均页面加载次数

## 启动抓取工具并获得采集结果

**启动抓取工具**

您可通过以下三种方式启动数据采集，按需选择其中一种即可：

A. [ 通过 API 启动](/cn/scraping-automation/web-scraper-ide/initiate-collection-and-delivery-options#initiate-scraper)\
B. [手动启动](/cn/scraping-automation/web-scraper-ide/initiate-collection-and-delivery-options#initiate-scraper)\
C. [定时启动抓取工具](/cn/scraping-automation/web-scraper-ide/initiate-collection-and-delivery-options#initiate-scraper)

<img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/options.png?maxW=1655&auto=format&n=ilemiSHw8UogZ13k&q=85&s=ce2c93ccebaa9d4dd1de62ad06f38d80" alt="" width="1655" height="561" data-path="images/scraping-automation/web-scraping-ide/features/options.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/options.png?w=280&maxW=1655&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0738fe5f09ba2591d503def6e506cdf2 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/options.png?w=560&maxW=1655&auto=format&n=ilemiSHw8UogZ13k&q=85&s=62e6b8f92689db3db6a927b92ebeca45 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/options.png?w=840&maxW=1655&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0dd889c17534967c90f3088320af264f 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/options.png?w=1100&maxW=1655&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e2ee36e26bffb2e5bd795b8bc4065420 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/options.png?w=1650&maxW=1655&auto=format&n=ilemiSHw8UogZ13k&q=85&s=14d5cf78162677b9be3c3fed6f22092f 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/options.png?w=2500&maxW=1655&auto=format&n=ilemiSHw8UogZ13k&q=85&s=80b0cb30888f3e7f1ed0c346851cad16 2500w" data-optimize="true" data-opv="2" />

**获取采集结果**

数据采集完成后，点击“三个点”图标并选择“统计信息”，即可访问结果并下载数据。

<Note>无法下载实时作业输入和输出数据，因为相关数据并不存储在我们的服务端</Note>

## 统计信息

<img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics.png?maxW=1632&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f524273df5011dfe7fa79c4b00b56bb8" alt="" width="1632" height="571" data-path="images/scraping-automation/web-scraping-ide/features/statistics.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics.png?w=280&maxW=1632&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d4c120a83a9448f490eec57867304ff0 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics.png?w=560&maxW=1632&auto=format&n=ilemiSHw8UogZ13k&q=85&s=8a8141e7267df82a66121eeec9d22c5b 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics.png?w=840&maxW=1632&auto=format&n=ilemiSHw8UogZ13k&q=85&s=22e325b3401ca42d97268dd387fde5ee 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics.png?w=1100&maxW=1632&auto=format&n=ilemiSHw8UogZ13k&q=85&s=789bde4bfe638127f8c7424c69ac9c53 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics.png?w=1650&maxW=1632&auto=format&n=ilemiSHw8UogZ13k&q=85&s=17b58713c82d9cfd20ae29a583adc6e1 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics.png?w=2500&maxW=1632&auto=format&n=ilemiSHw8UogZ13k&q=85&s=ce002b5f24b63f68a8def444c799bf1e 2500w" data-optimize="true" data-opv="2" />
“统计信息”页面会提供一些基本信息，以显示数据采集工作的成功情况。 以下是统计信息表中包含的各种术语列表：

**统计信息操作菜单**
<img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics-action-menu.png?maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=dd1ddbed895013848ee9ffd7cb7c6c8e" alt="" width="1672" height="454" data-path="images/scraping-automation/web-scraping-ide/features/statistics-action-menu.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics-action-menu.png?w=280&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3e2475ca5c43e6cf4f7e0bb428906bef 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics-action-menu.png?w=560&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=b2663d56f5c8f80dcf84f19230b4be06 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics-action-menu.png?w=840&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=8fb326bd678c873fe466e8fe01d31ef5 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics-action-menu.png?w=1100&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0f1bf54fe2bba1f5d89f582a501dc6d9 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics-action-menu.png?w=1650&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=b436ade9b5f944e922114ac59f5181ef 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics-action-menu.png?w=2500&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f178a128fe51af11f6b1f45c7abfe01f 2500w" data-optimize="true" data-opv="2" />

* **三个点**
  您可通过此图标对数据采集作业执行各种功能：
  “统计信息”页面会提供一些基本信息，以显示数据采集工作的成功情况。 以下是统计信息表中包含的各种术语列表：

<img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/collector-runs.png?maxW=1716&auto=format&n=ilemiSHw8UogZ13k&q=85&s=00c048759fe4ace38b3b18f0b18d91aa" alt="" width="1716" height="270" data-path="images/scraping-automation/web-scraping-ide/features/collector-runs.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/collector-runs.png?w=280&maxW=1716&auto=format&n=ilemiSHw8UogZ13k&q=85&s=2a855766643ec351e2c9dad41e86a486 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/collector-runs.png?w=560&maxW=1716&auto=format&n=ilemiSHw8UogZ13k&q=85&s=765222973d85cf4d5b1650e6b50b4cc2 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/collector-runs.png?w=840&maxW=1716&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d5f759e5d6a47df494a81eb7a164ffa4 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/collector-runs.png?w=1100&maxW=1716&auto=format&n=ilemiSHw8UogZ13k&q=85&s=69a350282b1cb7fa550b5f9c29e2e39c 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/collector-runs.png?w=1650&maxW=1716&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3f91838f78bf5ad6b763fdacf3b905d7 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/collector-runs.png?w=2500&maxW=1716&auto=format&n=ilemiSHw8UogZ13k&q=85&s=4415f1869768bdd6e547beada3960660 2500w" data-optimize="true" data-opv="2" />

* **作业 ID** - 采集任务的唯一 ID
* **触发因素** - 启动数据采集的人员和方式（API 启动，手动启动或定时启动）
* **输入** - 采集请求中键入的输入参数量
* **记录** - 采集到的结果数
* **失败** - 抓取失败的页面数
* **成功率** - 成功采集到的结果的占比
* **排队时间** - 队列时间戳
* **开始时间** - 抓取工具开始采集的日期和时间
* **完成时间** - 抓取工具完成采集的日期和时间
* **作业时间** - 完成作业所耗费的时间长度
* **预计剩余时间** - 距离采集完成的剩余时间
* **队列** - 触发行为中给定的作业名称（队列名称）
* **用量** - 所用的页面加载总次数

<img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/three-dots.png?maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3573d2c4bbfd8ef1645557d1738f1ef9" alt="" width="1672" height="454" data-path="images/scraping-automation/web-scraping-ide/features/three-dots.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/three-dots.png?w=280&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=64f0a0a297ae33cb3ea65b159c64e1d5 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/three-dots.png?w=560&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3a142f0d51de4598ed4ef2708e7ed47b 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/three-dots.png?w=840&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e8fbe123e04d78281e7d64bb1ead1a7d 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/three-dots.png?w=1100&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a2eab5e7a5d01ecb89ae9148b6c9f15b 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/three-dots.png?w=1650&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3a4648b5d26fd419ee61e78fd1203606 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/three-dots.png?w=2500&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=2717b8fa55a3fe1dc67657d5bc079bf3 2500w" data-optimize="true" data-opv="2" />


# 函数
Source: https://docs.brightdata.com/cn/scraping-automation/web-scraper-ide/functions



## 交互函数

本文列出并解释了交互代码中用于使用 IDE 编写抓取工具的可用命令。

<Note>
  标有星号 **⭐** 的命令是 Bright Data 开发的专有函数。
</Note>

### `bad_input`

将抓取工具输入标记为不良。将阻止任何抓取重试 `error_code=bad_input`

```js
bad_input();
bad_input('Missing search term');
```

***

### `blocked`

由于网站拒绝访问，将该页面标记为失败（ `error_code=blocked` ）

```js
blocked();
blocked('Login page was shown');
```

***

### ⭐ `bounding_box`

描述元素区域的坐标框（相对于页面，而不是浏览器视口）。仅测量第一个匹配的元素

* `selector`: 元素的有效 CSS 选择器

```js
let box = bounding_box('.product-list');
// box == {
//   top: 10,
//   right: 800,
//   bottom: 210,
//   left: 200,
//   x: 200,
//   y: 10,
//   width: 600,
//   height: 200,
// }
```

***

### ⭐ `browser_size`

返回当前浏览器窗口大小

```js
待定
```

***

### ⭐ `capture_graphql`

捕获并重放具有已更改变量的 graphql 请求

* 选项：用于控制要捕获的 graphql 请求的参数
  * url
  * payload

<CodeGroup>
  ```js Example #1
  let q = capture_graphql({
      payload: {id: 'ProfileQuery'},
      // you may need to pass url opt as RegExp in case when 
      // graphql endpoint is not "*/graphql" which is default value
      // url: /\bgraphql\b/ // default
  });

  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);
  ```

  ```js Example #2
  let q = capture_graphql({
      payload: {id: 'ProfileQuery'},
      // you may need to pass url opt as RegExp in case when 
      // graphql endpoint is not "*/graphql" which is default value
      // url: /\bgraphql\b/ // default
  });

  navigate('https://example.com');

  if (!q.is_captured())
      click('#load_more');

  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);
  ```
</CodeGroup>

***

### ⭐ `click`

点击一个元素（将等待该元素出现后再点击）

* `selector`: 元素选择器

```js
click('#show-more');
$('#show-more').click()
// Click the closest match to the passed coordinates
// (relative to the page).
// For example, clicking the center pin in 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});
```

***

### ⭐ `close_popup`

在抓取过程中，弹窗可能会随时出现，但您并不总是清楚应该何时等待或关闭它们。在代码顶部添加 close\_popup () 以添加后台观察程序，该观察程序将在弹窗出现时将其关闭。如果弹窗多次出现，将始终被关闭

* 弹窗选择器：有效的 CSS 选择器
* 关闭选择器：有效的 CSS 选择器
* 选项：click\_inside：包含关闭按钮选择器的父级 iframe 选择器

```js
close_popup('.popup', '.popup_close');
close_popup('iframe.with-popup', '.popup_close', {click_inside: 'iframe.with-popup'});
```

***

### `collect`

向网络爬虫创建的数据集添加一行数据

**syntax**: `collect(<data_line>[, <validate_fn>]);`

* `data_line`: 包含要收集的字段的对象
* `validate_fn`: 用于验证行数据是否有效的可选函数

```js
collect({price: data.price});
collect(product, p=>{
    if (!p.title)
        throw new Error('Product is missing a title');
})
```

***

### `console`

来自交互代码的日志消息

```js
console.log(1, 'brightdata', [1, 2], {key: value});
console.error(1, 'brightdata', [1, 2], {key: value});
```

***

### `country`

将您的抓取配置为从特定国家/地区运行\
**syntax**: `country(<code>);`

* `code`: 2 个字符的 ISO 国家/地区代码

```js
country('us');
```

***

### `dead_page`

将页面标记为无效链接，以便您可以从未来的收集中过滤掉它 `error_code=dead_page`

```js
dead_page();
dead_page('Product was removed');
```

***

### ⭐ `detect_block`

在页面上检测到一个屏蔽

* `resource`: 指定检测所需资源的对象
  * `selector`
* `condition`: 指定如何处理资源以进行检测的对象
  * `exists`
  * `has_text`

```js
detect_block({selector: '.foo'}, {exists: true});
detect_block({selector: '.bar'}, {has_text: 'text'});
detect_block({selector: '.baz'}, {has_text: /regex_pattern/});
```

***

### ⭐ `disable_event_listeners`

停止页面上的所有事件监听器运行。`track_event_listeners()` 必须先调用

* `event_types`: 应禁用的特定事件类型

```js
disable_event_listeners();
disable_event_listeners(['hover', 'click']);
```

***

### `el_exists`

检查页面上是否存在元素，并相应地返回一个布尔值

* `selector`: 有效的 CSS 选择器
* `timeout`: 等待元素出现在页面上的超时时间

```js
el_exists('#example'); // => true
el_exists('.does_not_exist'); // => false
el_exists('.does_not_exist', 5e3); // => false (after 5 seconds)
```

***

### `el_is_visible`

检查元素在页面上是否可见

* `selector`: 有效的 CSS selector
* `timeout`: 等待元素在页面上可见的超时时间

```js
el_is_visible('#example');
el_is_visible('.is_not_visible', 5e3); // false (after 5 seconds)
```

***

### `embed_html_comment`

在页面 HTML 中添加注释。可用于在 HTML 快照中嵌入元数据。

* comment: 注释的正文

```js
embed_html_comment('trace-id: asdf123');
```

***

### ⭐ `font_exists`

确定浏览器在页面上渲染给定字体系列的能力\
**syntax**: `font_exists(<font-family>);`

```js
font_exists('Liberation Mono');
```

***

### ⭐ `freeze_page`

强制页面停止进行更改。这可以用于将页面保存为特定状态，以便在抓取后运行的页面快照不会看到与现在看到的页面状态不同的页面状态。这个命令是实验性的。如果您发现问题，请向支持部门报告

```js
freeze_page();
```

***

### ⭐ `hover`

悬停在元素上（将等待元素出现后再悬停在它上面）\
**syntax**: `hover(<selector>);`

* `selector`: 元素选择器

```js
hover('#item');
```

***

### ⭐ `html_capture_options`

影响 HTML 捕获的过程

* `options`: 一个接受定义应如何处理 HTML 捕获的选项的对象
  * `coordinate_attributes`

```js
html_capture_options({
    coordinate_attributes: true,
});
```

***

### `Image`

收集图片数据

* `src`: 图片 URL 或 data:image URI 字符串

```js
let i = new Image('https://example.com/image.png');
collect({image: i});
```

***

### `input`

交互代码可用的全局对象。由触发器输入或 `next_stage()` 调用提供

```js
navigate(input.url);
```

***

### `job`

交互代码可用的全局对象。由触发器输入或 `next_stage()` 调用提供

```js
let {created} = job;
```

***

### `load_html`

加载 html 并返回 Cheerio 实例

* html：任何 HTML 字符串

```js
let $$ = load_html('<p id="p1">p1</p><p id="p2">p2</p>');
collect({data: $$('#p2').text()});
```

***

### ⭐ `load_more`

滚动到列表底部以触发加载更多项目。适用于延迟加载的无限滚动网站

* `selector`: 包含延迟加载项的元素的选择器

```js
load_more(<selector>);
load_more('.search-results');
load_more('.search-results', {children: '.result-item', trigger_selector: '.btn-load-more', timeout: 10000});
```

***

### `load_sitemap`

从站点地图 xml 中读取 url 列表（支持站点地图索引和 .gz 压缩站点地图。参见示例。）

```js
let {pages} = load_sitemap({url: 'https://example.com/sitemap.xml.gz'});
let {children} = load_sitemap({url: 'https://example.com/sitemap-index.xml'});
```

***

### `location`

含有当前位置信息的对象。可用字段: href

```js
navigate('https://example.com');
location.href; // "https://example.com/"
```

***

### Money

收集价格/金钱数据

* `value`: 金钱数额
* `currency`: 货币代码

```js
let p = new Money(10, 'USD');
collect({product_price: p});
```

***

### ⭐ `mouse_to`

将鼠标移到指定的 (x,y) 位置\
**syntax**: `mouse_to(<x>, <y>);`

* `x`: 定位 x 位置
* `y`: 定位 y 位置

```js
mouse_to(0, 0);
```

***

### `navigate`

将浏览器导航到 URL\
**syntax**: `navigate(<url>);`

* 默认情况下，404 状态代码会抛出 dead\_page 错误。使用 `opt.allow_status` 来覆盖它
* `url`: 要导航到的 URL
* `opt`: 导航选项（参见示例）

```js
navigate(input.url);
navigate('https://example.com');

// waits until DOM content loaded event is fired in the browser
navigate(`url`, {wait_until: 'domcontentloaded'}); 

// adds a referer to the navigation
navigate(`url`, {referer: `url`}); 

// the number of milliseconds to wait for. Default is 30000 ms
navigate(`url`, {timeout: 45000}); 

// Don't throw an error if this URL sends a 404 status code
navigate(`url`, {allow_status: [404]});

// Specify browser width/height
navigate(`url`, {
    fingerprint: {screen: {width: 400, height: 400}},
});
```

***

### `next_stage`

使用指定的输入运行网络爬虫的下一阶段

* `input`: 要传递给下一个浏览器会话的输入对象

```js
next_stage({url: 'http://example.com', page: 1});
```

***

### `parse`

解析页面数据

```js
let page_data = parse();
collect({
    title: page_data.title,
    price: page_data.price,
});

```

***

### `preserve_proxy_session`

保留此页面子项间的代理会话

```js
preserve_proxy_session();
```

***

### ⭐ `press_key`

在当前聚焦的输入框中输入 Enter 或 Backspace 等特殊字符（通常在搜索框中输入内容后使用）

```js
press_key('Enter');
press_key('Backspace');
```

***

### ⭐ `proxy_location`

将您的抓取配置为从特定位置运行。除非您需要对抓取的运行位置进行高精度控制，否则您可能希望改为使用 country(code)

* `configuration`: 具有所需代理位置的对象，查看示例以获取更多信息

```js
proxy_location({country: 'us'});

// lat in range: [-85, 85], long in range: [-180, 180]
proxy_location({lat: 37.7749, long: 122.4194}); 

// radius in km
proxy_location({lat: 37.7749, long: 122.4194, country: 'US', radius: 100}); 

```

***

### ⭐ `redirect_history`

返回自上次导航以来的 URL 重定向历史记录

```js
navigate('http://google.com');
let redirects = redirect_history();
// returns:
// [
//   'http://google.com',
//   'http://www.google.com',
//   'https://www.google.com/',
// ]
```

***

### `rerun_stage`

使用新的输入再次运行网络爬虫的这一阶段

```js
rerun_stage({url: 'http://example.com/other-page'});
```

***

### `resolve_url`

返回给定 url 参数指向的最终 URL

* `url`: URL 字符串/实例

```js
let {href} = parse().anchor_elem_data;
collect({final_url: resolve_url(href)});
```

***

### `response_headers`

返回最后一次页面加载的响应标头

```js
let headers = response_headers();
console.log('content-type', headers['content-type']);
```

***

### `request`

发出直接 HTTP 请求

* `url` | `options`：向其发出请求的 `url`，或请求选项（参见示例）

```js
let res = request('http://www.example.com');
let res = request({url: 'http://www.example.com', method: 'POST', headers: {'Content-type': 'application/json'}, body: {hello: 'world'}})
```

***

### ⭐ `right_click`

与单击相同，但使用鼠标右键（等待元素出现后再单击）\
**syntax**: `right_click(<selector>);`

* `selector`: 元素选择器

```js
right_click('#item');
```

***

### `run_stage`

使用新的浏览器会话运行网络爬虫的特定阶段

* stage: 将要运行哪个阶段（1 是第一阶段）
* input: 要传递给下一个浏览器会话的输入对象

```js
run_stage(2, {url: 'http://example.com', page: 1});
```

***

### ⭐ `scroll_to`

滚动页面，使元素可见。如果您这样做是为了触发从延迟加载的列表中加载更多元素，请使用 load\_more()。默认为以自然方式滚动，这可能需要几秒钟时间。如果您想要立即跳转，请使用 `{immediate: true}`\
**syntax**: `scroll_to(<selector>);`

* `selector`: 要滚动到的元素的选择器

```js
scroll_to('.author-profile');
scroll_to('top'); // scroll to the top of the page
scroll_to('bottom'); // scroll to the bottom of the page
scroll_to('top', {immediate: true}); // jump to top of page immediately
```

***

### ⭐ `scroll_to_all`

滚动浏览页面，以便与选择器匹配的所有元素都显示在屏幕上\
**syntax**: `scroll_to_all(<selector>);`

* `selector`: 想要滚动浏览的元素的选择权

```js
scroll_to_all('.author-profiles');
```

***

### ⭐ `select`

从选择元素中选择一个值\
**syntax**: `select(<select>, <value>);`

* `selector`: 元素选择器

```js
select('#country', 'Canada');
```

***

### `set_lines`

在本页抓取结束时要添加到数据集的行数组。每次调用 set\_lines() 都会覆盖之前的调用，并且只有最后一组行会被添加到数据集中（按页面抓取进行跟踪）。当设置抓取工具来收集部分错误时，这是一个很好的选择。您可以使用到目前为止收集的数据继续调用 set\_lines()，并且如果页面抓取出现错误，将使用最后一次调用\
**syntax**: `set_lines(<data_line>[, <validate_fn>]);`

* `lines`: 要添加到最终数据集的数据行数组
* `validate_fn`: 用于验证行数据是否有效的可选函数（每行运行一次）

```js
set_lines(products_so_far);
set_lines(products_so_far, i=>{
    if (!i.price)
        throw new Error('Missing price');
});
```

***

### `set_session_cookie`

使用给定的 `cookie` 数据设置 `cookie;` 如果存在等效 `cookie`，可能会覆盖它们

```js
set_session_cookie(`domain`, `name`, `value`);
```

***

### `set_session_headers`

为所有 HTTP 请求设置额外的标头

* `headers`: 具有 key-value 格式额外标头的对象

```js
set_session_headers({'HEADER_NAME': 'HEADER_VALUE'});
```

***

### ⭐ `solve_captcha`

解决页面上显示的所有验证码

```js
solve_captcha();
solve_captcha({type: 'simple', selector: '#image', input: '#input'});
```

***

### `status_code`

返回最后一次页面加载的状态码

```js
collect({status_code: status_code()});
```

***

### ⭐ `tag_all_responses`

保存所有匹配的浏览器请求的响应

* `field`: 标记字段的名称
* `pattern`: 要匹配的 URL 模式
* `options`: 设置 options.jsonp=true 来解析 jsonp 格式的响应主体。

```js
tag_all_responses(<field>, <pattern>, <options>);
tag_all_responses('resp', /url/, {jsonp: true});
tag_all_responses('resp', /url/, {allow_error: true});
tag_all_responses('profiles', /\/api\/profile/);
navigate('https://example.com/sports');
let profiles = parse().profiles;
for (let profile of profiles)
    collect(profile);
```

***

### ⭐ `tag_download`

允许通过浏览器下载文件

* `url`: 用于匹配请求的模式或字符串

```js
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_image`

保存元素中的图片 url

* field: 标记字段的名称
* selector: 有效的 CSS 选择器

```js
tag_image(field, selector);
tag_image('image', '#product-image');
```

***

### ⭐ `tag_response`

保存来自浏览器请求的响应数据\
**syntax**: `tag_response(<field>, <pattern>, <options>);`

* `name`: 标记字段的名称
* `pattern`: 要匹配的 URL 模式
* `options`: 设置 options.jsonp=true 来解析 jsonp 格式的响应主体。在可能的情况下，这将会自动检测到

```js
tag_response('resp', /url/, {jsonp: true});
tag_response('resp', /url/, {allow_error: true});
tag_response('resp', (req, res)=>{
            if (req.url.includes('/api/'))
            {
                let request_body = req.body;
                let request_headers = req.headers;
                let response_body = res.body;
                let 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_screenshot`

保存页面 HTML 的屏幕截图\
**syntax**: `tag_screenshot(<field>, <options>);`

* `field`: 标记字段的名称
* `options`: 下载选项（参见示例）

```js
tag_screenshot('html_screenshot', {filename: 'screen'});
tag_screenshot('view', {full_page: false}); // full_page defaults to true
```

***

### ⭐ `tag_script`

提取页面脚本中保存的一些 JSON 数据

**syntax**: `tag_script(<field>, <selector>);`

* `name`: 标记脚本的名称
* `selector`: 要标记的脚本的选择器

```js
tag_script('teams', '#preload-data');
tag_script('ssr_state', '#__SSR_DATA__');
navigate('https://example.com/');
collect(parse().ssr_state);
```

***

### ⭐ `tag_serp`

将当前页面解析为搜索引擎结果页面

* field: 标记字段的名称
* type: 解析器类型：（例如 bing、google）

```js
tag_serp('serp_bing_results', 'bing')
tag_serp('serp_google_results', 'google')
```

***

### ⭐ `tag_video`

保存元素中的视频 url

* `field`: 标记字段的名称
* `selector`: 有效的 CSS 选择器
* `opt`: 下载选项（参见示例）

```js
tag_video(field, selector);
tag_video('video', '#product-video', {download: true});
```

***

### ⭐ `tag_window_field`

从浏览器页面标记 js 值

* `field`: 相关数据的路径

```js
tag_window_field(field, key);
tag_window_field('initData', '__INIT_DATA__');
```

***

### ⭐ `track_event_listeners`

开始跟踪浏览器创建的事件监听器。稍后需要运行 `disable_event_listeners()`

```js
track_event_listeners();
```

***

### ⭐ `type`

在输入框中输入文本（将等待输入框出现后再进行输入）

* `selector`: 元素选择器
* `text`: 要输入的文本

```js
type(<selector>, <text>);
type('#location', 'New York');

// replacing text in input if it is not empty
type(<selector>, <text>, {replace: true}); 

// type text to an element with id ending "input-box" (e.g. <input id="c2E57-input-box">)
type('[id$=input-box]', <text>); 

// dispatching 'Enter' key press
type(<selector>, ['Enter']); 

// typing text and then dispatching 'Enter' key press
type(<selector>, ['Some text', 'Enter']); 

// deleting 1 char from input
type(<selector>, ['Backspace']); 
```

***

### `URL`

来自 NodeJS 标准“url”模块的 URL 类

* `url`: URL 字符串

```js
let u = new URL('https://example.com');
```

***

### ⭐ `verify_requests`

使用回调函数监控失败的请求

* `callback`：每次请求失败时，都会使用以下格式的对象调用的函数：`{url, error, type, response}`

```js
verify_requests(({url, error, type, response})=>{
    if (response.status!=404 && type=='Font')
        throw new Error('Font failed to load');
});
```

***

### `Video`

收集视频数据

* `src`: 视频 URL

```js
let v = new Video('https://example.com/video.mp4');
collect({video: v});
```

***

### ⭐ `wait`

等待元素出现在页面上

* `selector`: 元素选择器
* `opt`: 等待选项（参见示例）

```js
wait(<selector>);
wait('#welcome-splash');
wait('.search-results .product');
wait('[href^="/product"]');

// the number of milliseconds to wait for. Default is 30000 ms
wait(<selector>, {timeout: 5000}); 

// wait for element to be hidden
wait(<selector>, {hidden: true}); 

// wait for element inside in an iframe
wait(<selector>, {inside: '#iframe_id'}); 
```

***

### ⭐ `wait_any`

等待任何匹配条件成功

```js
wait_any(['#title', '#notfound']);
```

***

### `wait_for_parser_value`

等待解析器字段包含值。在您点击某些内容等待一些数据出现后，这可能会有用

* `field`: 等待的解析器值路径
* `validate_fn`: 可选的回调函数，用于验证值是否正确
* `opt`: 额外选项（例如超时）

```js
wait_for_parser_value(<field>[, <validate_fn>][, opt]);
wait_for_parser_value('profile');
wait_for_parser_value('listings.0.price', v=>{
            return parseInt(v)>0;
        }, {timeout: 5000});
```

***

### ⭐ `wait_for_text`

等待页面上的元素包含一些文本

* `selector`: 元素选择器
* `text`: 要等待的文本

```js
wait_for_text(<selector>, <text>);
wait_for_text('.location', 'New York');
```

***

### ⭐ `wait_hidden`

等待元素在页面上不可见（已删除或隐藏）

* `selector`: 元素选择器

```js
wait_hidden(<selector>);
wait_hidden('#welcome-splash');
wait_hidden(<selector>, {timeout: 5000});
```

***

### ⭐ `wait_network_idle`

等待浏览器网络空闲一段时间

* `timeout`: 等待浏览器网络空闲 X 毫秒
* `options`: 忽略：用于将请求排除在监控超时范围之外的模式数组：网络需要空闲多少毫秒（默认500）

```js
wait_network_idle();
wait_network_idle({
    timeout: 1e3,
    ignore: [/long_request/, 'https://example.com'],
});
```

***

### ⭐ `wait_page_idle`

等待直至给定的时间内 DOM 树没有发生任何更改

* `timeout`: 等待无更改的毫秒数
* `options`: 一个对象，它可以接受忽略参数以将某些元素排除在监控范围之外

```js
wait_page_idle();
wait_page_idle({
    ignore: [<selector1>, <selector2>],
    idle_timeout: 1000,
});
```

***

### ⭐ `wait_visible`

等待元素在页面上可见

* `selector`: 元素选择器

```js
wait_visible(<selector>);
wait_visible('#welcome-splash');
wait_visible(<selector>, {timeout: 5000});
```

***

### `$`

类似 jQuery 的表达式的助手

* `selector`: 元素选择器

```js
$(<selector>);
wait($('.store-card'))
```

***

### ⭐ `emulate_device`

作为移动设备查看页面。此命令将更改用户代理和屏幕参数（分辨率和设备像素比）

* `device`: 包含设备名称的字符串

```js
emulate_device('iPhone X');
emulate_device('Pixel 2');
```

<Accordion title="这是设备名称的完整列表">
  * Blackberry PlayBook
  * Blackberry PlayBook landscape
  * BlackBerry Z30
  * BlackBerry Z30 landscape
  * Galaxy Note 3
  * Galaxy Note 3 landscape
  * Galaxy Note II
  * Galaxy Note II landscape
  * Galaxy S III
  * Galaxy S III landscape
  * Galaxy S5
  * Galaxy S5 landscape
  * Galaxy S8
  * Galaxy S8 landscape
  * Galaxy S9+
  * Galaxy S9+ landscape
  * Galaxy Tab S4
  * Galaxy Tab S4 landscape
  * iPad
  * iPad landscape
  * iPad (gen 6)
  * iPad (gen 6) landscape
  * iPad (gen 7)
  * iPad (gen 7) landscape
  * iPad Mini
  * iPad Mini landscape
  * iPad Pro
  * iPad Pro landscape
  * iPad Pro 11
  * iPad Pro 11 landscape
  * iPhone 4
  * iPhone 4 landscape
  * iPhone 5
  * iPhone 5 landscape
  * iPhone 6
  * iPhone 6 landscape
  * iPhone 6 Plus
  * iPhone 6 Plus landscape
  * iPhone 7
  * iPhone 7 landscape
  * iPhone 7 Plus
  * iPhone 7 Plus landscape
  * iPhone 8
  * iPhone 8 landscape
  * iPhone 8 Plus
  * iPhone 8 Plus landscape
  * iPhone SE
  * iPhone SE landscape
  * iPhone X
  * iPhone X landscape
  * iPhone XR
  * iPhone XR landscape
  * iPhone 11
  * iPhone 11 landscape
  * iPhone 11 Pro
  * iPhone 11 Pro landscape
  * iPhone 11 Pro Max
  * iPhone 11 Pro Max landscape
  * iPhone 12
  * iPhone 12 landscape
  * iPhone 12 Pro
  * iPhone 12 Pro landscape
  * iPhone 12 Pro Max
  * iPhone 12 Pro Max landscape
  * iPhone 12 Mini
  * iPhone 12 Mini landscape
  * iPhone 13
  * iPhone 13 landscape
  * iPhone 13 Pro
  * iPhone 13 Pro landscape
  * iPhone 13 Pro Max
  * iPhone 13 Pro Max landscape
  * iPhone 13 Mini
  * iPhone 13 Mini landscape
  * JioPhone 2
  * JioPhone 2 landscape
  * Kindle Fire HDX
  * Kindle Fire HDX landscape
  * LG Optimus L70
  * LG Optimus L70 landscape
  * Microsoft Lumia 550
  * Microsoft Lumia 950
  * Microsoft Lumia 950 landscape
  * Nexus 10
  * Nexus 10 landscape
  * Nexus 4
  * Nexus 4 landscape
  * Nexus 5
  * Nexus 5 landscape
  * Nexus 5X
  * Nexus 5X landscape
  * Nexus 6
  * Nexus 6 landscape
  * Nexus 6P
  * Nexus 6P landscape
  * Nexus 7
  * Nexus 7 landscape
  * Nokia Lumia 520
  * Nokia Lumia 520 landscape
  * Nokia N9
  * Nokia N9 landscape
  * Pixel 2
  * Pixel 2 landscape
  * Pixel 2 XL
  * Pixel 2 XL landscape
  * Pixel 3
  * Pixel 3 landscape
  * Pixel 4
  * Pixel 4 landscape
  * Pixel 4a (5G)
  * Pixel 4a (5G) landscape
  * Pixel 5
  * Pixel 5 landscape
  * Moto G4
  * Moto G4 landscape
</Accordion>

***

## 解析器函数

本文列出并解释了解析器代码中用于使用 IDE 编写抓取工具的可用命令。

### `input`

可用于解析器代码的全局变量

```js
let url = input.url;
```

***

### `$`

一个 cheerio 实例

```js
$('#example').text();
$('$example').attr('href');
$('#example').text_sane(); /* This is like $().text() but also trims text and replace all space characters with single space "a b \t\n\n c" -> "a b c" */
```

<Tip>在 cheerio 网站上查找更多信息: [https://cheerio.js.org](https://cheerio.js.org).</Tip>

***

### `location`

可用于解析器代码的全局变量。含有当前位置信息的对象

```js
let current_url = location.href; 
```

***

### `Image`

收集图片数据

```js
let i = new Image('https://example.com/image.png');
collect({image: i});
```

***

### `Video`

收集视频数据

```js
let v = new Video('https://example.com/video.mp4');
collect({video: v});
```

***

### `Money`

收集价格/金钱数据

```js
let p = new Money(10, 'USD');
collect({product_price: p});
```


# 了解 IDE 接口
Source: https://docs.brightdata.com/cn/scraping-automation/web-scraper-ide/get-to-know-the-IDE-interface

本文综述了我们专为网页抓取目的而设计的 IDE 接口组件，以及可以用来管理抓取工具的控制面板的接口组件。

## IDE

这是您编写 JavaScript 代码的地方。 详细了解网页抓取的基础知识:\
[https://docs.brightdata.com/cn/scraping-automation/web-scraper-ide/basics-of-web-scraping](https://docs.brightdata.com/cn/scraping-automation/web-scraper-ide/basics-of-web-scraping)

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/ide-interface.png?maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=eade7b9ad79e67e2b94983852ff45e9f" alt="" width="1600" height="883" data-path="images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/ide-interface.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/ide-interface.png?w=280&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=242e5ed9aac718735a0352dc03502882 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/ide-interface.png?w=560&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=bd2c63d8a79037ef1eb8da280bcd7ad5 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/ide-interface.png?w=840&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=5c1c98291ea47c52ad0a571bb54ead78 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/ide-interface.png?w=1100&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=85a5108426392882142e1075bd79e143 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/ide-interface.png?w=1650&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=09bc22e97cfce261cce1cccdbcde6ca3 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/ide-interface.png?w=2500&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=00710e1342c5c41413c7f3cb36d3894e 2500w" data-optimize="true" data-opv="2" />
</Frame>

**A：查看更多示例**

* 我们的抓取工具工程师构建的模板代码示例。

**B：再添加一个步骤（阶段）**

* 当您想从多个页面收集数据时，添加阶段是有用的。 例如，如果您想从亚马逊搜索结果页面收集所有产品以及所有已收集产品的详细信息。 您可以在第一阶段浏览搜索结果页面以收集所有产品 URL，然后将它们传递到第二阶段以浏览每个产品页面。
* `next_stage`、`run_stage` 命令可用于在各个阶段之间进行交互。

**C：帮助**

* 可用函数列表、函数说明和用法示例。 了解有关交互函数和解析器函数的更多信息。

[Interaction functions](/cn/scraping-automation/web-scraper-ide/functions#interaction-functions), [Parser functions](/cn/scraping-automation/web-scraper-ide/functions#parser-functions).

**D：调试选项卡**

* 输入：定义您的输入参数并使用输入集运行测试（预览）
* 输出：所收集数据的列表
* 子级：将成为下一阶段输入集的子级列表
* 运行日志：代码执行日志
* 浏览器控制台：抓取工具浏览器控制台日志 \[浏览器 > 开发工具 > “控制台选项卡”]
* 浏览器网络：抓取工具浏览器网络日志 \[浏览器 > 开发工具 > “网络选项卡”]
* 最后的错误：最新错误信息列表

**E：输入**

* 添加输入参数：定义输入参数，包括其名称和类型
* 添加另一个输入：添加要测试的输入集的值
* 预览：使用选定的输入集运行测试

**F：代码设置**

* 错误模式：设置抓取工具错误案例的代码行为
* 截屏：在预览测试期间截屏。 在测试期间，您将能够检查加载的页面。

## 控制面板 - 抓取工具操作菜单

`collescraperctor` 操作菜单允许使用抓取工具执行不同的操作。

* **由 API 启动** - 无需进入控制面板即可开始数据收集
* **手动启动** - Bright Data 的控制面板使您可以轻松开始收集数据
* **按计划运行** - 精确选择何时收集所需数据
* **版本** - 查看抓取工具的修改版本
* **报告问题** - 您可以使用此表单来沟通您在平台、抓取工具或数据集结果方面遇到的任何问题
* **复制链接** - 复制抓取工具的链接与同事共享
* **工单** - 查看您的工单状态
* 高级选项：
  * 编辑代码 - 在 IDE 中编辑抓取工具的代码。
  * 禁用抓取工具 - 暂时禁用抓取工具，但是如果需要，您可以将其重新激活。
  * 删除抓取工具 - 永久删除抓取工具。

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/dashboard-action-menu.png?maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a04fd69588257256de6fedbe8e1216dd" alt="" width="1600" height="708" data-path="images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/dashboard-action-menu.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/dashboard-action-menu.png?w=280&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=95be121b1714262e24b9b395ad1f0a57 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/dashboard-action-menu.png?w=560&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=8a269cf593d132e9c4631694b728a0bf 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/dashboard-action-menu.png?w=840&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=cb41b91e116766937b7e26d9b05dd845 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/dashboard-action-menu.png?w=1100&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f4b76b18d40da7d6886df528f73781c9 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/dashboard-action-menu.png?w=1650&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=49cebf7aaf70fc42a94eafdef8c51fe9 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/dashboard-action-menu.png?w=2500&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d27ea77c04b50115fcd92f228b2def85 2500w" data-optimize="true" data-opv="2" />
</Frame>


# Initiate Data Collection & Delivery with IDE Scraper
Source: https://docs.brightdata.com/cn/scraping-automation/web-scraper-ide/initiate-collection-and-delivery-options

Learn how to initiate data collection and set up delivery options using the IDE Scraper. Explore manual, API, and scheduled methods for efficient data scraping.

在IDE中编写抓取器代码时，系统会自动将抓取器作为草稿保存到开发环境中。 在IDE内部，您可以逐页运行以了解抓取器的行为。 要进行完整的生产运行，请点击IDE屏幕右上角的“保存到生产环境”按钮，将抓取器保存到生产环境中。所有抓取器都会显示在控制面板中的我的抓取器选项卡下。任何处于非活动状态的抓取器都将以褪色状态显示。

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/my-scrapers.png?maxW=1317&auto=format&n=ilemiSHw8UogZ13k&q=85&s=bccb3a3546657c5159455050c4966696" alt="" width="1317" height="831" data-path="images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/my-scrapers.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/my-scrapers.png?w=280&maxW=1317&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f1969fdc336883c7184a1b5a8844bb96 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/my-scrapers.png?w=560&maxW=1317&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c8b9c251f9910a78be49b6d999eb3b6d 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/my-scrapers.png?w=840&maxW=1317&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6b14ed5ac6f8bf230cc266d21b7b0b69 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/my-scrapers.png?w=1100&maxW=1317&auto=format&n=ilemiSHw8UogZ13k&q=85&s=229fce4f5f50c1275324c29e1707b4f6 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/my-scrapers.png?w=1650&maxW=1317&auto=format&n=ilemiSHw8UogZ13k&q=85&s=89f1063505330b25829a253b96064b43 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/my-scrapers.png?w=2500&maxW=1317&auto=format&n=ilemiSHw8UogZ13k&q=85&s=edea89fe70d3e002fa63ad9f484acf38 2500w" data-optimize="true" data-opv="2" />
</Frame>

## 启动抓取器

要开始收集数据，请从以下三个选项中选择一个：

<Tabs>
  <Tab title="通过API启动">
    您可以通过API开始数据收集，无需访问Bright Data控制面板：[开始使用API文档](https://docs.brightdata.com/cn/api-reference/web-scraper-ide-api/Getting_started_wtih_the_API)

    在启动API请求之前，请创建API令牌。 **要创建API令牌，请转到：**
    [控制面板侧边菜单设置 > 账户设置 > API令牌](https://brightdata.com/cp/setting)

    <Frame>
            <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-by-api.png?maxW=1712&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a8133587fc8638a1ca6c7d80f1a13f77" alt="" width="1712" height="453" data-path="images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-by-api.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-by-api.png?w=280&maxW=1712&auto=format&n=ilemiSHw8UogZ13k&q=85&s=bca31e9ed4b9d1cd5b2209d14537ff13 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-by-api.png?w=560&maxW=1712&auto=format&n=ilemiSHw8UogZ13k&q=85&s=228abcad2308863cad37b6d920de57ab 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-by-api.png?w=840&maxW=1712&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e826707ca8ef44d23a294a2fc2276a7f 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-by-api.png?w=1100&maxW=1712&auto=format&n=ilemiSHw8UogZ13k&q=85&s=50ee15521d7253ccb156161e6bcb1b36 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-by-api.png?w=1650&maxW=1712&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c0310090696a101db8f9612e35cbd77a 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-by-api.png?w=2500&maxW=1712&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e7a0ddbb02fbda8a41c8a6fd19bab4e7 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    1. 手动设置输入 - 手动输入或通过API请求输入数据
    2. 触发行为 - 您可以添加多个并行请求，这些请求将根据定义的顺序激活。您可以将另一个作业添加到队列中，并同时运行两个以上的作业。
    3. API请求预览 - Bright Data为您提供REST API调用，用于启动抓取器。请选择“Linux Bash”查看器以查看CURL命令。发送请求后，您就会立即收到作业ID。

    数据将根据之前定义的交付首选项交付给您。

    <Note>如果交付首选项设置为API下载，则必须具有调用API才能接收数据</Note>
  </Tab>

  <Tab title="手动启动">
    Bright Data's control panel makes it easy to get started collecting data.

    <Frame>
            <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-manually.png?maxW=1718&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c5556f5991b1a69051f11dc015b382c1" alt="" width="1718" height="515" data-path="images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-manually.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-manually.png?w=280&maxW=1718&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c31e806b8b8bc09bc674d9ba791bf734 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-manually.png?w=560&maxW=1718&auto=format&n=ilemiSHw8UogZ13k&q=85&s=b9f79ad4b801cb108eff836880b967df 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-manually.png?w=840&maxW=1718&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3f75c12d7b3efd5029695c341a00ce82 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-manually.png?w=1100&maxW=1718&auto=format&n=ilemiSHw8UogZ13k&q=85&s=269ae884bb7e71d690facbec323f5c45 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-manually.png?w=1650&maxW=1718&auto=format&n=ilemiSHw8UogZ13k&q=85&s=215c92768d282a1c81f4e6a716c5f2ec 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-manually.png?w=2500&maxW=1718&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9d06a2dda6dcb3dea80f6423e3f241e5 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    1. 触发行为 - 您可以添加多个并行请求，这些请求将根据定义的顺序激活。您可以将另一个作业添加到队列中，并同时运行两个以上的作业。
    2. **手动设置输入**
    3. **Upload CSV file** - If you'd like to add a large amount of input, the easiest way is to add them to a CSV file and upload it to the system. For example, a list of URLs.\
       See the example provided for reference.
  </Tab>

  <Tab title="安排抓取器">
    Choose when to initiate the scraper.

    **Step One:**

    1. Choose a date and time for the scraper to start.
    2. Select the frequency it will run (hourly, daily, weekly, etc.)
    3. Set a deadline for when a scraper is complete.
    4. Review your setup.

    <Frame>
            <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/schedule-configuration.png?maxW=1738&auto=format&n=ilemiSHw8UogZ13k&q=85&s=37b27f4139b1331b7d131f4452213562" alt="" width="1738" height="908" data-path="images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/schedule-configuration.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/schedule-configuration.png?w=280&maxW=1738&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a3fb46d7fc8d69ad497668ea33084241 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/schedule-configuration.png?w=560&maxW=1738&auto=format&n=ilemiSHw8UogZ13k&q=85&s=5e922db26e8b135801cf5ce17635b34a 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/schedule-configuration.png?w=840&maxW=1738&auto=format&n=ilemiSHw8UogZ13k&q=85&s=371e74d891ecc71616614280571d8d63 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/schedule-configuration.png?w=1100&maxW=1738&auto=format&n=ilemiSHw8UogZ13k&q=85&s=1999f992f4915c29af4123420b694bf9 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/schedule-configuration.png?w=1650&maxW=1738&auto=format&n=ilemiSHw8UogZ13k&q=85&s=376098e2da0efd0f927257bc95cedce3 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/schedule-configuration.png?w=2500&maxW=1738&auto=format&n=ilemiSHw8UogZ13k&q=85&s=775b1d66e776411f94c7d000bf2aa348 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    **Step Two :**

    1. Add a large number of inputs to a CSV file. For instance, a list of URLs. To upload easily without errors, you can download a template of a CSV structure example.
    2. Set up Inputs manually

    <Frame>
            <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/enter-input.png?maxW=1735&auto=format&n=ilemiSHw8UogZ13k&q=85&s=204e5f96d01c52b7c5b6ec2f82320ddf" alt="" width="1735" height="912" data-path="images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/enter-input.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/enter-input.png?w=280&maxW=1735&auto=format&n=ilemiSHw8UogZ13k&q=85&s=97cfee22387b03504ca89fc4144400bd 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/enter-input.png?w=560&maxW=1735&auto=format&n=ilemiSHw8UogZ13k&q=85&s=8a8d29276c7797fb0feb5b8db1873c9d 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/enter-input.png?w=840&maxW=1735&auto=format&n=ilemiSHw8UogZ13k&q=85&s=392b4527fa4c3178ee5249afaba5e733 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/enter-input.png?w=1100&maxW=1735&auto=format&n=ilemiSHw8UogZ13k&q=85&s=8ea32f21a9e837c1d3a1e6457b6a72a5 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/enter-input.png?w=1650&maxW=1735&auto=format&n=ilemiSHw8UogZ13k&q=85&s=dd9743016e15b45b9d4c573b9e87a69a 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/enter-input.png?w=2500&maxW=1735&auto=format&n=ilemiSHw8UogZ13k&q=85&s=412f43504b37c601893c2aec4809f2ff 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Tab>
</Tabs>

***

## 交付选项

您可以为数据集设置交付首选项。要进行此设置，只需点击“我的抓取器”选项卡中的抓取器行，然后点击“交付首选项”即可

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/delivery-preferences.png?maxW=1253&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c333bfd06d8c9349503c9125487c85fd" alt="" width="1253" height="526" data-path="images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/delivery-preferences.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/delivery-preferences.png?w=280&maxW=1253&auto=format&n=ilemiSHw8UogZ13k&q=85&s=33e8d1e50125dc42dc553eb80c14b905 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/delivery-preferences.png?w=560&maxW=1253&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e739293e448be32becb12feeee0915c7 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/delivery-preferences.png?w=840&maxW=1253&auto=format&n=ilemiSHw8UogZ13k&q=85&s=92e5b11f36b14bf430e8fa2858ac8c4c 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/delivery-preferences.png?w=1100&maxW=1253&auto=format&n=ilemiSHw8UogZ13k&q=85&s=ea64125509a75d4dc5159c9aa4555113 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/delivery-preferences.png?w=1650&maxW=1253&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6f9df800dcc0e574b69f5fb256da8131 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/delivery-preferences.png?w=2500&maxW=1253&auto=format&n=ilemiSHw8UogZ13k&q=85&s=4dbb0eea988a7e997ba2536b37e4ce82 2500w" data-optimize="true" data-opv="2" />
</Frame>

<AccordionGroup>
  <Accordion title="选择何时获取数据">
    * 批量：管理大量数据的有效方式
      * 分批：数据准备好后，立即分小批量交付
    * 实时：快速响应一个请求的理想方式
      * 跳过重试：发生错误时不重试。 可以加快收集速度
  </Accordion>

  <Accordion title="选择文件格式">
    * JSON
    * NDJSON
    * CSV
    * XLSX
  </Accordion>

  <Accordion title="选择如何接收数据">
    * 电子邮件
    * API下载
    * Webhook
    * 云存储提供商：Amazon S3、Google Cloud Storage、Azure
    * SFTP/FTP
      <Note>如果设置为电子邮件或API下载，则媒体文件无法交付</Note>
  </Accordion>

  <Accordion title="选择结果格式">
    * 结果和错误分别存放在不同文件中
    * 结果和错误一起存放在一个文件中
    * 仅包含成功结果
    * 仅包含错误
  </Accordion>

  <Accordion title="定义通知">
    * 在收集完成时发出通知
    * 提供成功率的通知
    * 在发生错误时发出通知
  </Accordion>
</AccordionGroup>

### 输出架构

架构定义了数据点结构以及数据的组织方式。 您可以更改架构结构和修改数据点以满足您的需求，包括重新排序、设置默认值，以及将其他数据添加到输出配置中。 要添加新的字段名称，请进入高级设置并编辑代码。

<img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/output-schema.png?maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=700f3896110c4f6772021e217c63b0bc" alt="" width="1600" height="853" data-path="images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/output-schema.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/output-schema.png?w=280&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=08b8fa98ebae7fcee416f91bdcd67296 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/output-schema.png?w=560&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=254c7fd72597e76b6b2ee18caed3de28 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/output-schema.png?w=840&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=311e480f3b27e63b0c93721b53e64e40 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/output-schema.png?w=1100&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=5afd00000ad079e09f2495666724fc57 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/output-schema.png?w=1650&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=149cfc848cc1f46b4d69467aef818925 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/output-schema.png?w=2500&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=feddaeec2cfe4fbae22b2acd05903ea0 2500w" data-optimize="true" data-opv="2" />

|             |                              |
| ----------- | ---------------------------- |
| **输入/输出架构** | 选择要配置的选项卡                    |
| **自定义验证**   | 验证架构                         |
| **已解析的数据**  | 抓取器收集的数据点                    |
| **添加新字段**   | 如果您需要其他数据点，可以添加字段，并定义字段名称和类型 |
| **附加数据**    | 您可以将附加信息（时间戳、截图等）添加到架构中      |


# 简介
Source: https://docs.brightdata.com/cn/scraping-automation/web-scraper-ide/introduction



# 什么是 Web Scraper IDE？

完全托管的 Javascript 抓取解决方案，专为开发人员设计，用于快速、大规模地构建抓取工具。该 IDE 基于 Bright Data 的解锁技术，包含来自各大主要网站的预构建 Javascript 函数和代码模板，显著缩短抓取工具的开发和维护时间。

# 最佳适用对象

本 IDE 最适合想要自己采集数据，希望在采集过程中尽可能保有自主权、灵活性和可扩展性的企业使用，这可免去他们的后无之忧，让其无需担心基础架构、代理服务器和屏蔽风险。


# Video Tutorials: Mastering Web Scraping with the IDE
Source: https://docs.brightdata.com/cn/scraping-automation/web-scraper-ide/videos

Explore video tutorials showcasing how to use the Web Scraper IDE for various web scraping tasks, including automation, proxy management, and data extraction.

## **从搜索结果中抓取数据**

本视频主要展示了以下三大块内容：如何使用 IDE 从 Amazon 搜索结果中抓取数据、如何构建可从多个搜索结果页面持续抓取数据的抓取工具，以及代理网络如何确保抓取工具快速、轻松地采集数据，不被屏蔽。

<iframe id="youtube-712" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="Player for 🛑 How to Scrape UNSCRAPABLE data! (super simple!) Node.js + API" width="640" height="360" src="https://www.youtube.com/embed/YRRW4o-BjEM?autoplay=0&controls=0&disablekb=1&playsinline=1&cc_load_policy=0&cc_lang_pref=auto&widget_referrer=https%3A%2F%2Fbrightdata.zendesk.com%2Fhc%2Fen-us%2Farticles%2F15054175913745-视频-How-developers-use-Bright-Data&rel=0&showinfo=0&iv_load_policy=3&modestbranding=1&customControls=true&noCookie=false&enablejsapi=1&origin=https%3A%2F%2Fbrightdata.zendesk.com&widgetid=1" />

## **项目设置、代理和自动化工作流**

本视频详细叙述了本平台的基本特征和功能，包括项目设置、代理创建和管理，以及自动化数据采集工作流的设置。

<iframe id="youtube-7609" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="Player for Industrial-scale Web Scraping with AI & 代理网络" width="640" height="360" src="https://www.youtube.com/embed/qo_fUjb02ns?autoplay=0&controls=0&disablekb=1&playsinline=1&cc_load_policy=0&cc_lang_pref=auto&widget_referrer=https%3A%2F%2Fbrightdata.zendesk.com%2Fhc%2Fen-us%2Farticles%2F15054175913745-视频-How-developers-use-Bright-Data&rel=0&showinfo=0&iv_load_policy=3&modestbranding=1&customControls=true&noCookie=false&enablejsapi=1&origin=https%3A%2F%2Fbrightdata.zendesk.com&widgetid=2" />

## **代理管理、API 集成和代码功能**

本视频演示了自动化数据采集工作流。 它讲述了代理管理器和 API 集成等基础知识，展示了使用模板设置基础抓取工具的方法，并且介绍了各种代码函数。 它还解释了使用输入参数抓取特定产品的信息或让抓取工具导航至特定类别的页面的具体操作步骤。 此外，视频还介绍了如何运行代码、如何访问日志和控制台以进行调试的方法。

<iframe id="youtube-6757" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="Player for Basic Data Engineering Project - End-To-End From Web Scraping to Tableau" width="640" height="360" src="https://www.youtube.com/embed/vSgJ3bOyE0w?autoplay=0&controls=0&disablekb=1&playsinline=1&cc_load_policy=0&cc_lang_pref=auto&widget_referrer=https%3A%2F%2Fbrightdata.zendesk.com%2Fhc%2Fen-us%2Farticles%2F15054175913745-视频-How-developers-use-Bright-Data&rel=0&showinfo=0&iv_load_policy=3&modestbranding=1&customControls=true&noCookie=false&enablejsapi=1&origin=https%3A%2F%2Fbrightdata.zendesk.com&widgetid=3" />

## **模板、API 集成和输出配置**

本视频介绍了使用模板节省时间、修改代码和预览搜索结果的方法。 它还介绍了通过 API 启动搜索，以及获取必要的 API 令牌以接收搜索结果的操作。 此外，视频还讲解了输出配置以及将搜索结果集成至代码的方法。

<iframe id="youtube-1328" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="Player for CODE WITH ME: Building A Python Project And Web Scraper" width="640" height="360" src="https://www.youtube.com/embed/7ahUnBhdI5o?autoplay=0&controls=0&disablekb=1&playsinline=1&cc_load_policy=0&cc_lang_pref=auto&widget_referrer=https%3A%2F%2Fbrightdata.zendesk.com%2Fhc%2Fen-us%2Farticles%2F15054175913745-视频-How-developers-use-Bright-Data&rel=0&showinfo=0&iv_load_policy=3&modestbranding=1&customControls=true&noCookie=false&enablejsapi=1&origin=https%3A%2F%2Fbrightdata.zendesk.com&widgetid=4" />

## **使用 for 循环浏览搜索结果**

本视频就如何使用 for 循环浏览数百个搜索结果页面，并提取每个公寓列表的链接，如何使用暂停功能采集数据以及如何使用 collect 函数返回数据三方面内容进行了演示。 它还讨论了一些基础知识，例如代理管理器和 API 集成、使用模板设置基础抓取工具的方法以及使用输入参数精准定位特定产品或页面类别的方法。 最后，视频还演示了如何测试和运行代码，以及如何访问日志和控制台进行调试。

<iframe id="youtube-9362" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="Player for Fastest Way to MASTER Data Science in 2023" width="640" height="360" src="https://www.youtube.com/embed/0w9BAIVGuCA?autoplay=0&controls=0&disablekb=1&playsinline=1&cc_load_policy=0&cc_lang_pref=auto&widget_referrer=https%3A%2F%2Fbrightdata.zendesk.com%2Fhc%2Fen-us%2Farticles%2F15054175913745-视频-How-developers-use-Bright-Data&rel=0&showinfo=0&iv_load_policy=3&modestbranding=1&customControls=true&noCookie=false&enablejsapi=1&origin=https%3A%2F%2Fbrightdata.zendesk.com&widgetid=5" />

## **使用 IDE 模板和代理网络来构建多个网页抓取工具**

本视频演示了构建网页抓取工具和访问 API 集成的方法。 It discusses using the IDE's templates to create web scraper to pull data from Walmart. 视频还介绍了将抓取工具部署到代理网络并将采集的数据汇总至单个响应（通过简单的 API 调用即可访问该响应）的操作。

<iframe id="youtube-3478" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="简介 to Bright Data | Web Scraper IDE" width="640" height="360" src="https://www.youtube.com/embed/Ve04_6gDKvU" />

## **调试和数据交付**

本视频讨论了两大内容：如何使用 IDE 调试抓取工具以及如何交付抓取的数据（例如通过 API 端点或 Amazon S3）。

<iframe id="youtube-3668" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="Player for I Turned AI into a News Reporter" width="640" height="360" src="https://www.youtube.com/embed/BVizDqOfins?autoplay=0&controls=0&disablekb=1&playsinline=1&cc_load_policy=0&cc_lang_pref=auto&widget_referrer=https%3A%2F%2Fbrightdata.zendesk.com%2Fhc%2Fen-us%2Farticles%2F15054175913745-视频-How-developers-use-Bright-Data&rel=0&showinfo=0&iv_load_policy=3&modestbranding=1&customControls=true&noCookie=false&enablejsapi=1&origin=https%3A%2F%2Fbrightdata.zendesk.com&widgetid=7" />

## **使用 Bright Data 的实用程序函数抓取富有挑战性的网站**

本视频聚焦编程层，展示了一个非常动态，极难抓取数据的网站。它详解展示了如何指示抓取工具等待网格可用，从 1 循环至网格单元总数，然后调用下一阶段来采集单个猿猴 NFT 头像数据的过程。 该视频着重介绍了 Bright Data 引入的实用程序函数，以及如何使用这些函数让数据采集变得更轻松。

<iframe id="youtube-7056" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="Player for This A.I. creates infinite NFTs" width="640" height="360" src="https://www.youtube.com/embed/Pm93D8CVlY8?autoplay=0&controls=0&disablekb=1&playsinline=1&cc_load_policy=0&cc_lang_pref=auto&widget_referrer=https%3A%2F%2Fbrightdata.zendesk.com%2Fhc%2Fen-us%2Farticles%2F15054175913745-视频-How-developers-use-Bright-Data&rel=0&showinfo=0&iv_load_policy=3&modestbranding=1&customControls=true&noCookie=false&enablejsapi=1&origin=https%3A%2F%2Fbrightdata.zendesk.com&widgetid=8" />

## **使用 Python 实现 Airbnb 数据采集自动化**

本视频演示了模板的使用方法（模板可量身定制，以获得所需结果），以及使用 Bright Data 的代理网络和解锁工具从难以抓取的站点采集数据的好处。视频还演示了使用 API 启动抓取工具并获取数据的方法。

<iframe id="youtube-7003" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="Player for 使用 Python 实现 Airbnb 数据采集自动化" width="640" height="360" src="https://www.youtube.com/embed/ASWS7eU5ao4?autoplay=0&controls=0&disablekb=1&playsinline=1&cc_load_policy=0&cc_lang_pref=auto&widget_referrer=https%3A%2F%2Fbrightdata.zendesk.com%2Fhc%2Fen-us%2Farticles%2F15054175913745-视频-How-developers-use-Bright-Data&rel=0&showinfo=0&iv_load_policy=3&modestbranding=1&customControls=true&noCookie=false&enablejsapi=1&origin=https%3A%2F%2Fbrightdata.zendesk.com&widgetid=9" />

## **Amazon 网页抓取教程示例**

本视频演示了通过输入特定参数（例如国家/地区、URL、域名、部门、最大页数和其他现成的代码函数）创建抓取工具的过程。 它还展示了如何使用“帮助”部分的文档查找所有可用命令和检查语法的操作。 

<iframe id="youtube-661" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="Player for Amazon 网页抓取教程示例" width="640" height="360" src="https://www.youtube.com/embed/jQzI2ywA988?autoplay=0&controls=0&disablekb=1&playsinline=1&cc_load_policy=0&cc_lang_pref=auto&widget_referrer=https%3A%2F%2Fbrightdata.zendesk.com%2Fhc%2Fen-us%2Farticles%2F15054175913745-视频-How-developers-use-Bright-Data&rel=0&showinfo=0&iv_load_policy=3&modestbranding=1&customControls=true&noCookie=false&enablejsapi=1&origin=https%3A%2F%2Fbrightdata.zendesk.com&widgetid=10" />


# 工作线程类型
Source: https://docs.brightdata.com/cn/scraping-automation/web-scraper-ide/worker-types

本文介绍了各种工作线程 (worker) 之间的行为差异，以及如何为您的项目选择合适的工作线程。

浏览器工作线程和代码工作线程是实现数据抓取的两大技术方法，您可根据自己的需求、预算以及抓取相关网站时面临的技术挑战，选择其中一种即可。

## 浏览器工作线程 vs 代码工作线程

**浏览器工作线程：**

* 可通过无头浏览器模拟用户与网站的交互
* 就 CPM（每千次页面加载成本）而言，浏览器工作线程的使用成本较高
* 用于处理复杂的抓取任务，例如填写表单和动态内容加载。

**代码工作线程：**

* 大致相当于执行 curl 或 Python `requests.get(url)` 请求
* 通过向目标网站发送 HTTP 请求来工作
* 更加经济便宜
* 只能在无需与网站用户界面进行交互的情况下使用

## 选择最佳工作线程

您应根据待抓取网站使用的技术以及抓取数据时所需采取的导航方式来选择适当的工作线程。

最好先使用更便宜的代码工作线程，且仅在发现无法获得所需数据的情况下才更改工作线程类型。

**例如：**

* 如果您需要点击元素以加载更多数据
* 如果您需要通过滚动来加载更多元素
* 如果您需要使用 `tag_script`、`tag_response` （从浏览器内部捕获网络流量）
* 如果您需要键入一些文本来获取网站数据以进行搜索

## 根据工作线程的类型调整代码

我们库中的一些函数仅可在浏览器工作线程中使用，如果您在代码工作线程中使用它们，则会引发错误。

以下列出了仅可在浏览器工作线程中使用的函数：

* `wait_*`（任何等待函数）
* `scroll_*` （任何滚动函数）
* `tag_*`（任何标签函数）
* `type`
* `browser_size`
* `emulate_device`
* `freeze_page`
* `click`
* `hover`
* `right_click`
* `mouse_to`
* `press_key`
* `solve_captcha`
* `capture_graphql`
* `close_popup`


# 网络解锁器 配置
Source: https://docs.brightdata.com/cn/scraping-automation/web-unlocker/configuration

Configure 网络解锁器 with 高级域, Geolocation, and advanced settings for custom headers, cookies, and auto-throttling.

## 高级域

有些域比其他域更难解锁，因此我们为这些域提供单独的高价定价等级:\
[https://docs.brightdata.com/cn/scraping-automation/web-unlocker/features#current-list-of-premium-domains](https://docs.brightdata.com/cn/scraping-automation/web-unlocker/features#current-list-of-premium-domains)

启用后，高价将反映在 “预计成本” 部分。\
<Note>即使启用后，只有针对这些域的特定请求的定价才会有所不同。 对其他域的请求将保持默认的较低级别。</Note>

## 高级选项

### 异步请求

请求在后台无缝处理，使您能够在以后更方便的时间通过指定的端点采集响应，从而提高稳定性、灵活性和效率。

<Tip>
  ### 将我们的 webhook IP 列入白名单

  我们的异步 webhook 交付会从一对稳定的 IP 地址发送通知：

  1. `100.27.150.189`
  2. `18.214.10.85`

  客户可能需要在其一侧将这些 IP 列入白名单。
</Tip>

### Custom 网络解锁器

覆盖自动标头/Cookie，发送您自己的自定义值，以定位网站的特定版本。

<Note>
  启用 自定义标头和 Cookie会产生以下结果

  <AccordionGroup>
    <Accordion title="访问预先批准的标头/Cookie 列表">
      您将获得预先批准的标头和 Cookie 列表的访问权限。您可以浏览此列表，验证目标网站所需的标头和 Cookie 是否已获得批准。
    </Accordion>

    <Accordion title="发送新标头/Cookie 请求">
      如果您所需的标头或 Cookie 不在预先批准的列表中，您可以向我们的合规团队提交表单以供批准。 此流程涉及提供有关标头/Cookie 及其必要性的信息。 在简短的批准流程完成后，我们的合规团队将会通知您。
    </Accordion>

    <Accordion title="对所有请求收费">
      与常规的网络解锁器逻辑（仅对成功的请求收费）不同，启用此功能意味着您将为 100％ 的请求（包括成功和失败的请求）付费。这种变化是由于 Bright Data 无法完全控制其流程和性能。
    </Accordion>
  </AccordionGroup>
</Note>

#### 允许自定义标头和 Cookie

1. 访问您的控制面板：登录到您的 Bright Data 控制面板。
2. 选择您的区域：选择需要启用此功能的特定区域。
3. 启用功能：在 高级选项下，在区域设置中找到并激活 “自定义标头和 Cookie” 权限。

#### 控制自动节流

网络解锁器包括自动节流机制，旨在保持高效的抓取和性能。 此系统的运行方式如下：

<Tabs>
  <Tab title="自动调整">
    系统会自动搜索并实现性能更好的配置。
  </Tab>

  <Tab title="成功率低时">
    If the success rate for any given target site falls below a certain percentage, the system will begin to throttle requests. This is to avoid wasting resources on configurations that are failing.
  </Tab>

  <Tab title="可自定义阈值">
    The default threshold for this mechanism is set at 70%.

    However, with the 'Custom headers & cookies' permission enabled, you have the flexibility to adjust this threshold to any percentage you prefer, especially since you'll be charged for all requests regardless of their success.
  </Tab>
</Tabs>


# 网络解锁器 功能
Source: https://docs.brightdata.com/cn/scraping-automation/web-unlocker/features

Explore 网络解锁器's advanced features like CAPTCHA solving, Premium Domains, Headers & Cookies management, and Browser Rendering for efficient web scraping.

## 禁用验证码解决功能

默认情况下，作为我们完整代理解锁解决方案的一部分，网络解锁器还会解决在返回您的代理请求时遇到的验证码。

禁用验证码解决器时，我们的智能算法仍然会负责寻找最佳代理网络、自定义标头、指纹识别等整个不断变化的流程，但故意不自动解决验证码，从而为您的团队提供轻量级、简化的解决方案，扩大潜在抓取机会的范围。

**最适合：**

* 在不被屏蔽的情况下从网站抓取数据
* 模拟真实用户的网络行为
* 内部没有解锁基础架构且不希望其抓取工具自动解决验证码的团队

<Accordion title="如何开始使用？">
  要禁用验证码解决功能，只需打开相关区域，转到“配置”选项卡并打开高级设置，您将在其中找到“自动验证码解决”控制器。 要禁用验证码解决功能，只需关闭开关。

  <Frame>
        <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/automatic-captcha-solving.png?maxW=641&auto=format&n=ilemiSHw8UogZ13k&q=85&s=aa4d095fa9c18fce9431567328be7dcf" alt="automatic-captcha-solving.png" width="641" height="325" data-path="images/scraping-automation/web-unlocker/features/automatic-captcha-solving.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/automatic-captcha-solving.png?w=280&maxW=641&auto=format&n=ilemiSHw8UogZ13k&q=85&s=73e6e2fc5095e7ba859092515281be5a 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/automatic-captcha-solving.png?w=560&maxW=641&auto=format&n=ilemiSHw8UogZ13k&q=85&s=445c66ea23792faaf804d05957fa693d 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/automatic-captcha-solving.png?w=840&maxW=641&auto=format&n=ilemiSHw8UogZ13k&q=85&s=98dc7b0b67de5a674fc8427f20eec23f 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/automatic-captcha-solving.png?w=1100&maxW=641&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d72e63cb53a636795079a97c756b8d33 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/automatic-captcha-solving.png?w=1650&maxW=641&auto=format&n=ilemiSHw8UogZ13k&q=85&s=bbdbcf1cf27c9918daffb3af1886c4b3 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/automatic-captcha-solving.png?w=2500&maxW=641&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f794f9ed48797cb284185caa4031c8b2 2500w" data-optimize="true" data-opv="2" />
  </Frame>
</Accordion>

## 网络解锁器优质域

优质域是 Bright Data 两层网站分类系统的一部分，这些网站比其他网站更难解锁，需要额外的网络解锁器资源。

在本文中，我们将看到当前的优质域列表，了解如何定位它们，并了解特惠定价。

### 当前的优质域列表

<div id="premium_domains">Loading...</div>

<Note>
  根据我们的网站分类逻辑，此列表经常发生变化。 您可以在代理区域内看到最新的列表.
</Note>

### 启用优质域

当您创建网络解锁器区域时，勾选“特殊功能”下的“优质域”复选框

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/premium-domains.png?maxW=692&auto=format&n=ilemiSHw8UogZ13k&q=85&s=86bc0a8a214124210be7da8fa946771b" alt="启用优质域" width="692" height="901" data-path="images/scraping-automation/web-unlocker/features/premium-domains.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/premium-domains.png?w=280&maxW=692&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e078cee2cf9a56b28f469ce6c8082d65 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/premium-domains.png?w=560&maxW=692&auto=format&n=ilemiSHw8UogZ13k&q=85&s=b642616148ed6cbf2e4e04cd6539aff9 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/premium-domains.png?w=840&maxW=692&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d943446e458229aa3570f212a923dabe 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/premium-domains.png?w=1100&maxW=692&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6100978e8bbe401b70c6e624a60831a3 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/premium-domains.png?w=1650&maxW=692&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9c6011c1e999eaa34b745675e50652ec 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/premium-domains.png?w=2500&maxW=692&auto=format&n=ilemiSHw8UogZ13k&q=85&s=fbc09354d928a3857e32fd85af89a300 2500w" data-optimize="true" data-opv="2" />
</Frame>

### 定价

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>
  即使启用后，也只有针对这些域的特定请求才会按更高的费率定价。 对其他域的请求将按默认的较低层级定价。
</Note>

## Geolocation Targeting `-country-country_code`

<Tip>
  网络解锁器 automatically selects the optimal IP location for targeting your domain, eliminating the need for manual selection in most cases.
</Tip>

If you want to target from a specific **country** in 网络解锁器 refer to [geolocation targeting](https://docs.brightdata.com/cn/api-reference/proxy/geolocation-targeting).

## Mobile User-agent Targeting `-ua-mobile`

By default, 网络解锁器 uses desktop-specific user agents for your requests. To use a **mobile** user agent instead, simply append `-ua-mobile` to your request. 

## Custom 网络解锁器

Gain enhanced control over your requests with flexible options to fine-tune 网站 behavior and optimize request handling.

By default, 网络解锁器 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 网络解锁器 allows you to override the automated parameters and send your own custom values specific to your needs.

#### Custom features:

* [Manual headers & cookies](/cn/scraping-automation/web-unlocker/features#manual-headers-and-cookies)
* [Manual ‘expect’ elements](/cn/scraping-automation/web-unlocker/features#manual-expect-elements)

#### How to enable

In the Control Panel, go to your specific **网络解锁器** zone -> 配置 -> Advanced Settings, and enable the Custom 网络解锁器 feature you want to use.

<img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/custom-expect.png?maxW=696&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6dd81332d89062996bbb4fbec7b349f3" alt="启用优质域" width="696" height="389" data-path="images/scraping-automation/web-unlocker/features/custom-expect.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/custom-expect.png?w=280&maxW=696&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a8227fded8bdf05e5281a2ea55b70380 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/custom-expect.png?w=560&maxW=696&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6fc17ed1e93f0e50c1b5f00697c22157 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/custom-expect.png?w=840&maxW=696&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f608d4d6d6db1c0ab65ab25073b5cba8 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/custom-expect.png?w=1100&maxW=696&auto=format&n=ilemiSHw8UogZ13k&q=85&s=b8cf1c137ff29f9faaf886dd5d3da6f6 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/custom-expect.png?w=1650&maxW=696&auto=format&n=ilemiSHw8UogZ13k&q=85&s=cc782db5a9f5278b5a99911f7a2d8a22 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/custom-expect.png?w=2500&maxW=696&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9515263b191fd63877be39cebd507157 2500w" data-optimize="true" data-opv="2" />

Once enabled, you can now send Custom 网络解锁器 requests in accordance with each [custom feature's](/cn/scraping-automation/web-unlocker/features#custom-features) procedure.

#### Billing

Unlike the regular 网络解锁器 billing logic, which only charges for successful requests, when any of the above Custom 网络解锁器 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>
  **请注意：**

  * 我们不允许 Cookie 用于登录/身份验证目的
  * 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 网站.

<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 请求">
      Unlike the regular 网络解锁器 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

Gives you the ability to pass an ‘expect’ parameter along with your request to wait for specific elements or text on the page (i.e. expect.element, text, body).

You can configure this per request with the `x-unblock-expect` header seen below.

**Add `x-unblock-expect` header**

<CodeGroup>
  ```shell Element must exist
  curl -vk \
      -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:33335 \
      -H 'x-unblock-expect: {"element": ".some-css-selector"}' \
      https://example.com
  ```

  ```shell Page must include text
  curl -vk \
      -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:33335 \
      -H 'x-unblock-expect: {"text": "items in stock"}' \
      https://example.com
  ```
</CodeGroup>

## 监控网络解锁器的使用情况

To review your current 网络解锁器 CPM, navigate to [My Proxies](https://brightdata.com/cp/zones) page, and review the **Traffic** column.

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/Traffic.png?maxW=1450&auto=format&n=ilemiSHw8UogZ13k&q=85&s=2703844db1f3e3f93d91a7f98d0a9f1e" alt="" width="1450" height="676" data-path="images/scraping-automation/web-unlocker/features/Traffic.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/Traffic.png?w=280&maxW=1450&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0b874ba1d9d6c89416ee35f25f3d802d 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/Traffic.png?w=560&maxW=1450&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c50db3514f336bacaf24b893e9836c52 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/Traffic.png?w=840&maxW=1450&auto=format&n=ilemiSHw8UogZ13k&q=85&s=efd5c05f905b45deba3b0e0f9e676399 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/Traffic.png?w=1100&maxW=1450&auto=format&n=ilemiSHw8UogZ13k&q=85&s=58f7b8d5172e225cfe23235fc43552ad 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/Traffic.png?w=1650&maxW=1450&auto=format&n=ilemiSHw8UogZ13k&q=85&s=347a1f281a200d95d28a6d957cf6e2b0 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/Traffic.png?w=2500&maxW=1450&auto=format&n=ilemiSHw8UogZ13k&q=85&s=5764fbfff7089255b7853f3b7fe6dcd2 2500w" data-optimize="true" data-opv="2" />
</Frame>

### 了解使用情况

上方流量列中显示的数字是成功请求的次数。在上面的例子中，115000个请求等于 115 CPM，因此将按照该计费周期内 10 CPM 的费率向您计费。

### 使用量是如何计算的？

您的网络解锁器使用量采用 CPM 衡量。 CPM 是1000次成功请求的费用，表示只有成功的网络解锁器请求才会计入您的账单。

请参阅我们的账单和定价页面以了解更多信息:
[https://docs.brightdata.com/cn/general/account/billing-and-pricing/payment](https://docs.brightdata.com/cn/general/account/billing-and-pricing/payment)

## 网络解锁器目标域层级

网络解锁器允许您在两种模式之间进行选择：

* 默认模式“所有域”，在该模式下可以定位任何网站
* 电子商务模式，您能够以低于标准网络解锁器定价30%的折扣价定位热门电子商务网站的封闭列表。

<Frame>
  <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/target-domain-tiers.png?maxW=902&auto=format&n=ilemiSHw8UogZ13k&q=85&s=964ecf96f03baca30d250d00e51be55f" width="500" width="902" height="834" data-path="images/scraping-automation/web-unlocker/features/target-domain-tiers.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/target-domain-tiers.png?w=280&maxW=902&auto=format&n=ilemiSHw8UogZ13k&q=85&s=734b66a286caf6e21b1f1c73b9a65431 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/target-domain-tiers.png?w=560&maxW=902&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3acec9abd7bcf4d8a6eec850b155d0b2 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/target-domain-tiers.png?w=840&maxW=902&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3ccffb8563c14d7c82d988c616f1bebb 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/target-domain-tiers.png?w=1100&maxW=902&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f33e5c97b036df59148b47482fb594f5 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/target-domain-tiers.png?w=1650&maxW=902&auto=format&n=ilemiSHw8UogZ13k&q=85&s=239a5a9c0bb4f6f7f077d6007f80a4e4 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/target-domain-tiers.png?w=2500&maxW=902&auto=format&n=ilemiSHw8UogZ13k&q=85&s=637d0c5a82a8245767b5486f0300f8e2 2500w" data-optimize="true" data-opv="2" />
</Frame>

<Note>
  ### 定位未包含在层级中的域

  选择电子商务层级时，您可以定位任何包含的域，而尝试定位其他域将导致错误：

  `[domain_name 不是电子商务层级的一部分]`
</Note>

### 运行机制

打开网络解锁器区域时，您可以离开默认的“所有域”模式，也可以切换到电子商务模式，在这种情况下，您的定价将降低30%，并且您将仅限于该模式中包含的网站。 点击“查看可用站点”链接浏览所有包含的网站。

## Debugging 网络解锁器

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` header for this purpose.

To activate the headers, add `-debug-full` to your proxy username.

```shell Enabling debug headers in your request
curl -vk \
    -x brd-customer-$CUSTOMER_ID-zone-$ZONE-debug-full:$PASSWORD@brd.superproxy.io:33335 \
    https://example.com
```

The format of the `x-brd-debug` header looks like this:

```
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              | 描述                                                                                                                                                                      |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| req\_id            | The internal ID of your request into our system. 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 our system recorded while processing this request                                                                                        |
| bytes\_down        | The amount of incoming traffic our system recorded while processing this request                                                                                        |
| billed             | Whether our system considers this a billable request or not                                                                                                             |
| destination\_ip    | The IP address of the remote server used to fetch this data                                                                                                             |
| used\_req\_headers | Which request headers (if any) were used in the final request. This mainly applies when using Custom 网络解锁器                                                              |
| 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                                           |

## 常见错误代码

有时，由于多种原因，您可能会在响应网络解锁器请求时收到意外的错误代码。

以下列表将帮助您更深入地了解问题的根源。

| 错误                                                    | 描述                                                                                                                                                           |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `404`                                                 | 找不到页面。 URL 无效，这表明 URL 可能已损坏或失效。                                                                                                                              |
| [403](/cn/proxy-networks/faqs#what-is-error-code-403) | 您尝试访问的 URL 有效，但您被禁止访问该 URL。                                                                                                                                  |
| [502](/cn/proxy-networks/faqs#what-is-error-code-502) | 错误代码502是网络解锁器用户最常见的错误，描述部分位于 `x-luminati-error-code` 下。                                                                                                      |
| `407`                                                 | 此错误代码表明您的某个账户凭据不正确（密码或区域名称）。                                                                                                                                 |
| `429`                                                 | 此错误代码表示速率限制（罕见）。 在这种情况下，如果响应如下所示，则 Bright Data 正在对请求应用自动限制，您应该创建工单或发送电子邮件至 [support@brightdata.com](mailto:support@brightdata.com) 寻求帮助（您可以在此处查阅有关自动限制的更多信息） |
| `401`<br />`411`<br />`444`                           | 错误的请求，通常发生在 API 请求中，当标头或 Cookie 缺失时。                                                                                                                         |
| `503`                                                 | HTTP 错误代码503表示“服务不可用”。浏览器检查失败或浏览器检查未完成                                                                                                                       |

```js
< 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="联系支持部门以获得更多帮助">
  如果您在使用网络解锁器时遇到问题，在向我们报告之前，请按照以下说明和提示进行测试：

  1. 在控制面板中打开“API 和示例”: [https://brightdata.com/cp/zones/proxy\_examples](https://brightdata.com/cp/zones/proxy_examples)
  2. 选择 `curl` 和您的网络解锁器区域
  3. 将您的目标 URL 粘贴到“URL”框中
  4. 用右边的按钮复制
  5. 将 -v-o test 添加到您的命令中（这将开启详细日志记录，并创建一个名为“test”的输出文件供您与我们的支持代理共享）
  6. 运行命令并检查输出（确保也检查数据的静态源 HTML）

  如果此测试重现了您的问题，请发邮件至 [support@brightdata.com](mailto:support@brightdata.com) 并在电子邮件正文中分享以下内容：

  1. 您为生成结果而发送的 `curl` 请求
  2. 运行命令的完整详细输出
  3. 运行后返回的响应（“test’”文件）
  4. 您是否使用浏览器自动化工具（除了您的代码外，网络解锁器不支持它们或任何第三方集成）。
</Accordion>

## Get Success Rate Statistics Per Domain

The following API endpoint will provide 网络解锁器 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](https://docs.brightdata.com/cn/general/account/api-token#bright-datas-api-token)

**How to get statistics for a single domain?**

<CodeGroup>
  ```shell Request
      curl "https://api.brightdata.com/unblocker/success_rate/example.com" -H "Content-Type: application/json" -H "Authorization: Bearer API_KEY"
  ```

  ```shell Response
      {"amazon.com":0.9835556363554884} 
  ```
</CodeGroup>

**How to get statistics for all monitored top level domains?**

<CodeGroup>
  ```shell Request
      curl "https://api.brightdata.com/unblocker/success_rate/example.*" -H "Content-Type: application/json" -H "Authorization: Bearer API_KEY"
  ```

  ```shell Response
      {{"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>


# 简介 to Bright Data's Unlocker API
Source: https://docs.brightdata.com/cn/scraping-automation/web-unlocker/introduction

See how Bright Data's Unlocker API simplifies data collection with intelligent proxy management, avoiding blocks while delivering clean HTML/JSON responses

Unlocker API是我们的代理解锁解决方案之一，旨在由我们为您全面处理代理工作和基础设施解锁，让您可以专注于数据收集。

您只需向目标网站发送一个代理请求，我们就会将干净的HTML和/或JSON数据交付给您 。就是这么简单！

在幕后，我们的Unlocker API智能算法会处理整个不断变化的流程，包括寻找最佳代理网络、自定义标题、指纹识别、CAPTCHA验证码等。

## 最适用于

* 从任何网站抓取数据，不会被屏蔽
* 模拟真实用户的网络行为，对使用复杂检测方法的网站也能进行抓取
* 内部没有可扩展的解锁基础设施的团队
* 只需为成功的请求付费

<Note>
  Unlocker API不适用于浏览器或Adspower、Puppeteer、Playwright、Multilogin（MLA）等第三方工具。如果您需要与浏览器交互并使用此类工具的解决方案，请查看我们的Browser API解决方案，或查看我们其他可以为您提供完整数据集的网页数据产品 。
</Note>

<Tip>
  如果您在寻找专门用于搜索引擎的解锁解决方案，请查看我们的[SERP API](scraping-automation/serp-api)
</Tip>


# 快速入门 Guide for Bright Data's Unlocker API
Source: https://docs.brightdata.com/cn/scraping-automation/web-unlocker/quickstart

Get started with Bright Data's Unlocker API quickly. Follow our step-by-step guide to set up your proxy and start collecting data today.

<Tip>
  如果您尚未注册Bright Data，可以免费注册 ，在添加付款方式后，即可获得5美元的信用额度以开始使用！\
  [https://brightdata.com/](https://brightdata.com/)
</Tip>

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">登录</a>} />

  <Step title="导航到“我的区域”">
    <Accordion title="在“我的区域”视图中，点击在Unlocker API下的“开始”">
      <Warning>
        如果您已经有正在运行的代理，只需在右上角选择添加即可
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/get-started.png?maxW=1157&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6b1f6e13127d60f09f3810b6d5ea7fba" alt="开始" width="1157" height="888" data-path="images/scraping-automation/web-unlocker/quick-start/get-started.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/get-started.png?w=280&maxW=1157&auto=format&n=ilemiSHw8UogZ13k&q=85&s=57958d0417b522230803021b04464185 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/get-started.png?w=560&maxW=1157&auto=format&n=ilemiSHw8UogZ13k&q=85&s=1fbad7d25bd6f65f8cde5df456317258 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/get-started.png?w=840&maxW=1157&auto=format&n=ilemiSHw8UogZ13k&q=85&s=eb7eb97fc2d2125686a7d45f91992114 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/get-started.png?w=1100&maxW=1157&auto=format&n=ilemiSHw8UogZ13k&q=85&s=37daaf3be28a90210b2e4b30b19d543b 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/get-started.png?w=1650&maxW=1157&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9d32f38d8971dfe50b27336250c4874b 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/get-started.png?w=2500&maxW=1157&auto=format&n=ilemiSHw8UogZ13k&q=85&s=180a557e1014d9575ec0cc83ec1e3996 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="选择Unlocker API名称">
    <Accordion title="输入新Unlocker API的代理名称">
      <Warning>
        请选择一个有意义的名称，因为区域名称在创建后就无法更改。
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/proxy-name.png?maxW=614&auto=format&n=ilemiSHw8UogZ13k&q=85&s=746b3c4a809451b2afe4d2b798512941" alt="代理名称" width="614" height="863" data-path="images/scraping-automation/web-unlocker/quick-start/proxy-name.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/proxy-name.png?w=280&maxW=614&auto=format&n=ilemiSHw8UogZ13k&q=85&s=455ad76f064f991add419988cd2af3a2 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/proxy-name.png?w=560&maxW=614&auto=format&n=ilemiSHw8UogZ13k&q=85&s=19114e7d51e13c1e39649590aaea087d 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/proxy-name.png?w=840&maxW=614&auto=format&n=ilemiSHw8UogZ13k&q=85&s=4e80c8052334e4a750c3d427f5d03f94 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/proxy-name.png?w=1100&maxW=614&auto=format&n=ilemiSHw8UogZ13k&q=85&s=468c95b47b6cd87f00609d914fdd08b1 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/proxy-name.png?w=1650&maxW=614&auto=format&n=ilemiSHw8UogZ13k&q=85&s=7ff17fe620d41cee5d228ca0c584a74f 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/proxy-name.png?w=2500&maxW=614&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c53264642d0299e5d6e370eb3c5c9e6a 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="点击“添加代理”" />
</Steps>

<Accordion title="在继续之前，请验证您的账户">
  如果您尚未添加付款方式，此时系统会提示您添加付款方式以验证您的账户。如果您是第一次使用Bright Data，您还将获得5美元的奖励信用额度，帮助您开始使用！

  <Tip>
    这仅用于验证目的，此时不会向您收取任何费用
  </Tip>
</Accordion>

<Note>
  别担心，我们将在下一节配置中介绍所有配置。

  [配置](/cn/scraping-automation/web-unlocker/configuration).
</Note>


# Send Your First Request with Bright Data's 网络解锁器
Source: https://docs.brightdata.com/cn/scraping-automation/web-unlocker/send-your-first-request

Learn how to send your first API request using Bright Data's 网络解锁器 with easy-to-follow code examples in multiple programming languages.

## Getting access to 网络解锁器

Bright data offers two methods to use Unlocker API in your scraping task:

1. Use an HTTPS proxy access point

2. `New: Beta Release`: Use an HTTPS Web API access point

### Accessing 网络解锁器 as HTTPS proxy

In order to access the Unlocker API you will need to provide credentials which are comprised of:

1. Your customer ID

2. Your Unlocker API zone name

3. Your Unlocker API password

4. Bright Data SSL certificate

#### 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

You zone name and password can be found in the overview tab of your Unlocker API zone in 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](/cn/general/account/ssl-certificate#how-to-download-the-ssl-certificate).

Alternatively, you can  [ignore SSL errors](/cn/general/account/ssl-certificate#how-to-ignore-ssl-errors).

#### 网络解锁器: 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

    curl  "http://lumtest.com/myip.json"  --proxy brd.superproxy.io:33335  --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>

    ```

    ```javascript Node.js

    #!/usr/bin/env node

      

    require('request-promise')({

    url: 'http://lumtest.com/myip.json',

    proxy: 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:33335',

    })

    .then(function (data) {

    console.log(data);

    },

    function (err) {

    console.error(err);

    });

    ```

    ```python Python

    import pprint

    import requests

      
      

    host = 'brd.superproxy.io'

    port = 33335

      

    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://lumtest.com/myip.json"

    response = requests.get(url, proxies=proxies)

    pprint.pprint(response.json())

      

    ```

    ```php PHP

      

    <?php

    echo  'To enable your free eval account and get CUSTOMER, YOURZONE and '

    .'YOURPASS, please contact sales@brightdata.com';

    $curl = curl_init('http://lumtest.com/myip.json');

    curl_setopt($curl, CURLOPT_PROXY, 'http://brd.superproxy.io:33335');

    curl_setopt($curl, CURLOPT_PROXYUSERPWD, 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>');

    curl_exec($curl);

    ?>

      

    ```

    ```ruby Ruby

    #!/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://lumtest.com/myip.json')

    proxy = Net::HTTP::Proxy('brd.superproxy.io', 33335, '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#

    using System;

    using System.Net;

      

    class Example {

    static void Main() {

    var client = new WebClient();

    client.Proxy = new WebProxy("brd.superproxy.io:33335");

    client.Proxy.Credentials = new NetworkCredential(

    "brd-customer-<customer_id>-zone-<zone_name>",

    "<zone_password>"

    );

    Console.WriteLine(client.DownloadString("http://lumtest.com/myip.json"));

    }

    ```

    ```java Java

    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", 33335);

    String res = Executor.newInstance()

    .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")

    .execute(Request.Get("http://lumtest.com/myip.json").viaProxy(proxy))

    .returnContent().asString();

    System.out.println(res);

    }

    }

    ```

    ```perl Perl

    #!/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:33335");

    print  $agent->get('http://lumtest.com/myip.json')->content();

    ```

    ```vb VBA

    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:33335")

    Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")

    Console.WriteLine(Client.DownloadString("http://lumtest.com/myip.json"))

    End Sub

    End Module

    ```
  </CodeGroup>

  上面的代码使用住宅代理向 [http://lumtest.com/myip.json发送请求。](http://lumtest.com/myip.json发送请求。) 它以 JSON 格式返回您的 IP 信息：

  ```json 输出

  {

  "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://lumtest.com/myip.json”](https://lumtest.com/myip.json”) with the website of your choice.
</Accordion>

### Accessing 网络解锁器 as API endpoint - `Beta release`

<Note> Access via API endpoint is a new feature, released as beta </Note>

In order to access the Unlocker API you will need to provide credentials which are comprised of:

1. Your Unlocker API zone name

2. A Bright Data API key

#### Zone name

You zone name can be found in the overview tab of your Unlocker API zone in control panel.

#### Bright Data API Key

Bright Data API key is a generated secret hash which is used to authenticate your access to the Unlocker API service via the web API endpoint.
To generate the API key click here to get to [Account settings](https://brightdata.com/cp/setting/users) , scroll down and click the "Add API key" button, and follow the instructions on screen.

We strongly recommend to have an expiration date set on your API key for increased security.

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

#### 网络解锁器: API Endpoint code examples

To use 网络解锁器 via the API endpoint you should use the following parameters:

1. API Endpoint: [`https://api.brightdata.com/request`](https://api.brightdata.com/request)

2. API Key

3. 网络解锁器 zone name

4. Target URL

5. Response format: `raw`

```sh cURL

curl -H "Content-Type: application/json" -H "Authorization: Bearer [my API key]" -d '{"zone": "[my_webunlocker_zone]","url": "[target URL]", "format": "raw"}' https://api.brightdata.com/request

```


# 网络Unlocker最佳实践 API
Source: https://docs.brightdata.com/cn/scraping-automation/web-unlocker/troubleshooting

了解使用Bright Data的网络Unlocker API定位API端点的最佳实践，包括故障排除技巧和数据提取的替代方法。

## 概述

使用网络Unlocker API时，精准定位产品或其他页面的特定API端点是高效提取所需数据的常用策略。大多数情况下，网络Unlocker API都能成功访问这些API端点。 然而，API端点有时可能很难解锁，而您仍需访问相关主页才能抓取所需数据。

## API端点定位最佳实践

### 直接访问API

首先，尝试使用网络Unlocker API直接定位API端点。 该方法在大多数情况下都能立即使用。

### API解锁失败后的其他抓取途径

如果无法直接定位API端点，请转而访问API所采集数据的原始网页。 网络 Unlocker API 可高效访问并解锁这些网页上的数据。
这可确保您在没有直接访问API的情况下仍能检索到必要的信息。

### 利用Browser API处理复杂案例

如果直接访问API端点至关重要且其他方法成效不大，则可以使用我们的[Browser API](/scraping-automation/scraping-browser)。

使用Browser API加载网页，并在前端发起的API调用中设置请求拦截，即可读取所需的API响应。

### 我能否将网络Unlocker API与浏览器（例如Chrome）或浏览器自动化库（例如Puppeteer、Playwright、Selenium）一起使用？

**不能。** 您不应将网络Unlocker API与浏览器（例如Chrome、Firefox、Edge）、反检测浏览器（例如Adspower、Multilogin）或浏览器自动化库（例如Puppeteer、Playwright、Selenium）一起使用。

网络Unlocker API已经过优化，无需交互即可从网站抓取数据，专注于为单一请求提供干净的HTML/JSON响应，同时管理代理和解锁基础架构。

直接在浏览器上使用网络Unlocker API通常没有效果，即使有效果，也可能导致不必要的成本增加。

如果确实需要与网页交互，您有以下几种选择：

* 对于常规浏览器（例如Chrome、Firefox、Edge）和 反检测浏览器（例如Adspower、Multilogin），您应该使用我们的代理网络（数据中心、ISP、移动、住宅）。这些产品的集成指南参见此处：代理集成 (brightdata.com)

* 对于浏览器自动化库（例如Puppeteer、Playwright、Selenium），您可以使用代理网络；但更好的解决方案是Browser API产品。这类产品提供与网络Unlocker API类似的解锁功能，但设计用于与浏览器自动化无缝协作。有关Browser API的更多信息，请访问：Browser API简介 - Bright Data文档: [https://docs.brightdata.com/scraping-automation/scraping-browser/introduction](https://docs.brightdata.com/scraping-automation/scraping-browser/introduction)


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





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





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





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





# FAQ: Archive API
Source: https://docs.brightdata.com/datasets/archive/faqs

Find answers to common questions about Archive API.

<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 17.5 PB of data, covering 28 billion unique URLs from 40 million domains, in the first 8 months of it's launch alone.

    We continue to add \~1 PB of new data every week, alongside \~2 unique billion 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](https://docs.brightdata.com/scraping-automation/data-snapshots-api). The API allows you to search, retrieve, and filter data snapshots from Archive seamlessly and efficiently.

    * Data from the last 3 days: Will take from within minutes and up to a few hours to deliver (depending on snapshot size)
    * Data older than 3 days: Will take from a few hours and up to 3 days to process and deliver (depending on snapshot size)
  </Accordion>

  <Accordion title="How can my data be delivered?">
    Archive offers two delivery options to ensure seamless integration into your existing workflows:

    * **Amazon S3 bucket:** Have your Data Snapshot delivered directly to your S3 bucket.
    * **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**                  | 17.5 PB collected in 8 months, covering 118 billion pages (28 billion unique URLs from 40 million 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 or webhook.                            | No built-in filtering or delivery. Need to manually process huge raw WARC files.          |
  </Accordion>
</AccordionGroup>


# Overview
Source: https://docs.brightdata.com/datasets/archive/overview

Learn how to use our Archive API for accessing and retrieving data snapshots from Bright Data's cache, with delivery options to Amazon S3 or via webhook.

Our Archive API allows you to access and retrieve Data Snapshots from Bright Data's cached data collections in a seamless and efficient method.

<Note>
  To access this API, you will need a Bright Data [API key](/general/account/api-token)
</Note>

## Run a Search

To initiate a search of our Archive, use the following `/search` endpoint.
**Endpoint**: `POST api.brightdata.com/webarchive/search`

<Tabs>
  <Tab title="Request">
    ```js Request
    POST api.brightdata.com/webarchive/search
    {
        filters: {
            max_age?: Duration,
            min_date?: yyyy-mm-dd,
            max_date?: yyyy-mm-dd,
            domain_whitelist?: ['example.com'],
            domain_blacklist?: ['example.com'],
            domain_regex_whitelist?: ['.*example..*'],
            domain_regex_blacklist?: ['.*example..*'],
            category_whitelist?: ['Automotive'],
            category_blacklist?: ['Automotive'],
            path_regex_whitelist?: ['.*/products/.*'],
            path_regex_blacklist?: ['.*/products/.*'],
            language_whitelist?: ['eng'], // ISO 639-3 letter language codes
            language_blacklist?: ['eng'],
            ip_country_whitelist?: ['us', 'ie', 'in'],
            ip_country_blacklist?: ['mx', 'ae', 'ca'],
            captcha?: true,
            robots_block?: true,
        }
    }
    ```
  </Tab>

  <Tab title="Response">
    <CodeGroup>
      ```js 200 OK
      {search_id: <search_id>}
      ```

      ```js 400 Bad Request
      // Error: example with incorrect filter usage
      {"error": "domain_blacklist cannot be used along with domain_whitelist"}
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Code Example">
    <CodeGroup>
      ```sh Curl
      curl -X POST https://api.brightdata.com/webarchive/search \
        -H "Authorization: Bearer $API_KEY" \
        -H 'Content-Type: application/json' \
        --data '{"filters": {"max_age": "1d", "domain_whitelist": ["example.com"]}}'
      ```

      ```python Python
      import requests
      import json

      # Configuration
      BRIGHT_DATA_API_KEY = '$Enter_API_Key'
      BASE_URL = 'https://api.brightdata.com'
      WEBHOOK_URL = 'https://my-domain/webhook?id=XXX'

      HEADERS = {
          'Content-Type': 'application/json',
          'Authorization': f'Bearer {BRIGHT_DATA_API_KEY}'
      }

      def run_search():
          url = f'{BASE_URL}/webarchive/search'
          payload = {
              'filters': {
                  'max_age': '7d',
                  'language_whitelist': ['jpn'], #ISO 639-3 letter language codes
                  'category': 'Education'
                  'domain_regex_whitelist': ['.*.google..*']
              }
          }
          
          response = requests.post(url, headers=HEADERS, json=payload)
          try:
              response.raise_for_status()
              return response.json()
          except requests.exceptions.HTTPError as http_err:
              print(f"HTTP error occurred: {http_err}")
              print(f"Response Content: {response.text}")
              return None
          except requests.exceptions.RequestException as req_err:
              print(f"Request error occurred: {req_err}")
              print(f"Response Content: {response.text if response else 'No response content'}")
              return None
          except ValueError:
              print("Response content is not valid JSON")
              return None

      def main():
          search_response = run_search()
          if search_response:
              print(f"Search Response: {json.dumps(search_response, indent=2)}")
          else:
              print("Search failed.")

      if __name__ == "__main__":
          main()
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Dictionary">
    Here is a brief explanation of each of the parameters you are able to use in your requests:

    | Parameter              | Description                                                                    |
    | ---------------------- | ------------------------------------------------------------------------------ |
    | max\_age               | Limits results to records collected within a specified time range.             |
    | min\_date              | Returns records collected on or after the specified date.                      |
    | max\_date              | Returns records collected on or before the specified date.                     |
    | domain\_whitelist      | Includes results only from listed domains.                                     |
    | domain\_blacklist      | Excludes results from listed domains.                                          |
    | category\_whitelist    | Includes results only from specified categories.                               |
    | category\_blacklist    | Excludes results from specified categories.                                    |
    | path\_regex\_whitelist | Includes results only matching the specified path regex.                       |
    | path\_regex\_blacklist | Excludes results matching the specified path regex.                            |
    | language\_whitelist    | Includes results only for specific language codes (ISO 639-3).                 |
    | language\_blacklist    | Excludes results for specific language codes.                                  |
    | ip\_country\_whitelist | Includes results collected through IPs or peers only from specified countries. |
    | ip\_country\_blacklist | Excludes results collected through IPs or peers from specified countries.      |
    | captcha                | Return only results with captcha triggered                                     |
    | robots\_block          | Return only results with robots block                                          |
  </Tab>
</Tabs>

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

## Get Search Status

To check the status of a specific query that was made.
**Endpoint**: `GET api.brightdata.com/webarchive/search/<search_id>`

When successful it will retrieve:

* The number of entries for your query
* The estimated size and cost of the full Data Snapshot

<Tabs>
  <Tab title="Request">
    ```js
    GET api.brightdata.com/webarchive/search/<search_id>
    ```
  </Tab>

  <Tab title="Response">
    <Note>
      The status code of all three following responses is `200 OK`
    </Note>

    <CodeGroup>
      ```js Pending
      {
          search_id: "ID",
          status: "in_progress"
      }
      ```

      ```js Success
      {
          search_id: "ID",
          status: "done",
          files_count: 12341294,
          estimate_batch_count: 130,
          estimate_batch_bytes: 153151351,
          cpm_cost_usd: 0.02, // example cost per CPM
          dump_cost_usd: 100 // example total cost 
      }
      ```

      ```js Failed
      {
          search_id: "ID",
          status: "failed",
          error: "Path regex filter caused non-retryable error"
      }
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Code Example">
    <CodeGroup>
      ```sh Curl
      curl https://api.brightdata.com/webarchive/search/$SEARCH_ID \
        -H "Authorization: Bearer $API_KEY"
      ```

      ```python Python
      import requests
      import json

      # Configuration
      BRIGHT_DATA_API_KEY = '$Enter_API_Key'
      BASE_URL = 'https://api.brightdata.com'

      HEADERS = {
          'Authorization': f'Bearer {BRIGHT_DATA_API_KEY}'
      }

      def get_search_status(search_id):
          url = f'{BASE_URL}/webarchive/search/{search_id}'
          response = requests.get(url, headers=HEADERS)
          try:
              response.raise_for_status()
              return response.json()
          except requests.exceptions.HTTPError as http_err:
              print(f"HTTP error occurred: {http_err}")
              return None
          except requests.exceptions.RequestException as req_err:
              print(f"Request error occurred: {req_err}")
              return None
          except ValueError:
              print("Response content is not valid JSON")
              return None

      def main():
          search_id = input("Enter the search ID: ")
          status_response = get_search_status(search_id)
          
          if status_response:
              print(f"Status Response: {json.dumps(status_response, indent=2)}")
          else:
              print("Failed to retrieve search status.")

      if __name__ == "__main__":
          main()
      ```
    </CodeGroup>
  </Tab>
</Tabs>

## Get All Search Statuses

Check the status of all current searches.
**Endpoint**: `GET api.brightdata.com/webarchive/searches`

<Tabs>
  <Tab title="Request">
    ```js
    GET api.brightdat.com/webarchive/searches
    ```
  </Tab>

  <Tab title="Response">
    ```js 200 OK
    [
        {
            search_id: "ID",
            status: "in_progress"
        },
        {
            search_id: "ID",
            status: "done"
        },
        // ... + rest of the searches and status
    }
    ```
  </Tab>

  <Tab title="Code Example">
    ```sh Curl
    curl https://api.brightdata.com/webarchive/searches \
      -H "Authorization: Bearer $API_KEY"
    ```
  </Tab>
</Tabs>

## How data range affects delivery time

If your query is matching data within **last 72h** - your snapshot will start processing/delivering immediately.

If some of your matched data is **older than 72h** - it needs to be retrieved from a colder archive before delivery and it may take **up to 72h**.

<Note>
  We recommend using `max_age` = `1d` for initial testing.
</Note>

## Deliver Snapshot to Amazon S3 Storage

<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 our system delivery role to `AssumeRole` that role.
    * Our system delivery role is: `arn:aws:iam::422310177405:role/brd.ec2.zs-dca-delivery`
</Note>

To deliver a specific Snapshot from a specific `search_id` to S3 storage, use the following `/dump` endpoint.
**Endpoint**: `POST api.brightdata.com/webarchive/dump`

<Tabs>
  <Tab title="Request">
    <CodeGroup>
      ```js POST
      POST api.brightdata.com/webarchive/dump
      {
          search_id: <search_id>,
          max_entries?: 1000000, // (optional) limit how many files you purchase
          delivery: {
              strategy: 's3',
      	    settings: {
                  bucket: <your_bucket_name>,
                  prefix: <your_custom_prefix>, // (optional) Customize top-level export folder
                  assume_role: {
                      role_arn: <role_you_created_above>,
                  },
              },
          },
      }

      ```
    </CodeGroup>
  </Tab>

  <Tab title="Response">
    ```js 200 OK
    {dump_id: <dump_id>}
    ```
  </Tab>

  <Tab title="Code Example">
    <CodeGroup>
      ```sh Curl
      curl -X POST https://api.brightdata.com/webarchive/dump \
        -H "Authorization: Bearer $API_KEY" \
        -H 'Content-Type: application/json' \
        --data @- <<EOF
      {
          "search_id": "$SEARCH_ID",
          "max_entries": 1000000,
          "delivery": {
              "strategy": "s3",
      	    "settings": {
                  "bucket": "$YOUR_BUCKET_NAME",
                  "assume_role": {
                      "role_arn": "$YOUR_DELIVERY_ROLE"
                  }
              }
          }
      }
      EOF
      ```

      ```python Python
      import requests
      import json

      # Configuration
      BRIGHT_DATA_API_KEY = '$Enter_API_Key'
      BASE_URL = 'https://api.brightdata.com'

      HEADERS = {
          'Authorization': f'Bearer {BRIGHT_DATA_API_KEY}',
          'Content-Type': 'application/json'
      }

      def get_search_status(search_id):
          url = f'{BASE_URL}/webarchive/search/{search_id}'
          response = requests.get(url, headers=HEADERS)
          try:
              response.raise_for_status()
              return response.json()
          except requests.exceptions.HTTPError as http_err:
              print(f"HTTP error occurred: {http_err}")
              return None
          except requests.exceptions.RequestException as req_err:
              print(f"Request error occurred: {req_err}")
              return None
          except ValueError:
              print("Response content is not valid JSON")
              return None

      def deliver_snapshot_to_s3(search_id, bucket_name, role_arn, max_entries=1000000):
          url = f'{BASE_URL}/webarchive/dump'
          payload = {
              'search_id': search_id,
              'max_entries': max_entries,
              'delivery': {
                  'strategy': 's3',
                  'settings': {
                      'bucket': bucket_name,
                      'assume_role': {
                          'role_arn': role_arn,
                      },
                  },
              },
          }
          
          response = requests.post(url, headers=HEADERS, data=json.dumps(payload))
          try:
              response.raise_for_status()
              return response.json()
          except requests.exceptions.HTTPError as http_err:
              print(f"HTTP error occurred: {http_err}")
              return None
          except requests.exceptions.RequestException as req_err:
              print(f"Request error occurred: {req_err}")
              return None
          except ValueError:
              print("Response content is not valid JSON")
              return None

      def main():
          search_id = input("Enter the search ID: ")
          bucket_name = 'some-customer-provided-bucket-name-in-us-east-1'
          role_arn = 'some-customer-provided-aws-role-with-write-access-to-s3-bucket'
          
          status_response = get_search_status(search_id)
          
          if status_response:
              print(f"Status Response: {json.dumps(status_response, indent=2)}")
              delivery_response = deliver_snapshot_to_s3(search_id, bucket_name, role_arn)
              if delivery_response:
                  print(f"Delivery Response: {json.dumps(delivery_response, indent=2)}")
              else:
                  print("Failed to deliver snapshot to S3.")
          else:
              print("Failed to retrieve search status.")

      if __name__ == "__main__":
          main()
      ```
    </CodeGroup>
  </Tab>
</Tabs>

## Collect Snapshot via Webhook

Collect a Data Snapshot via webhook from a specific `search_id`
**Endpoint**: `POST api.brightdata.com/webarchive/dump`

<Tabs>
  <Tab title="Request">
    ```js
    {
        search_id: <search_id>,
        max_entries?: 1000000,
        delivery: {
    		strategy: 'webhook',
    		settings: {
                 url: string(),
                 auth?: string(), // will be added as an Authorization header
            },
        }
    }
    ```
  </Tab>

  <Tab title="Response">
    ```js 200 OK
    {"dump_id": <dump_id>}
    ```
  </Tab>

  <Tab title="Code Example">
    <CodeGroup>
      ```sh Curl
      curl -X POST https://api.brightdata.com/webarchive/dump \
        -H "Authorization: Bearer $API_KEY" \
        -H 'Content-Type: application/json' \
        --data @- <<EOF
      {
          "search_id": "$SEARCH_ID",
          "max_entries": 1000000,
          "delivery": {
              "strategy": "webhook",
      	    "settings": {
                  "url": "$YOUR_WEBHOOK_URL"
              }
          }
      }
      EOF
      ```

      ```python Python
      import requests
      import json

      # Configuration
      BRIGHT_DATA_API_KEY = '$Enter_API_Key'
      BASE_URL = 'https://api.brightdata.com'

      HEADERS = {
          'Authorization': f'Bearer {BRIGHT_DATA_API_KEY}',
          'Content-Type': 'application/json'
      }

      def get_search_status(search_id):
          url = f'{BASE_URL}/webarchive/search/{search_id}'
          response = requests.get(url, headers=HEADERS)
          try:
              response.raise_for_status()
              return response.json()
          except requests.exceptions.HTTPError as http_err:
              print(f"HTTP error occurred: {http_err}")
              return None
          except requests.exceptions.RequestException as req_err:
              print(f"Request error occurred: {req_err}")
              return None
          except ValueError:
              print("Response content is not valid JSON")
              return None

      def deliver_snapshot_to_webhook(search_id, webhook_url, max_entries=1000000):
          url = f'{BASE_URL}/webarchive/dump'
          payload = {
              'search_id': search_id,
              'max_entries': max_entries,
              'delivery': {
                  'strategy': 'webhook',
                  'settings': {
                      'url': webhook_url
                  },
              },
          }
          
          response = requests.post(url, headers=HEADERS, data=json.dumps(payload))
          try:
              response.raise_for_status()
              return response.json()
          except requests.exceptions.HTTPError as http_err:
              print(f"HTTP error occurred: {http_err}")
              return None
          except requests.exceptions.RequestException as req_err:
              print(f"Request error occurred: {req_err}")
              return None
          except ValueError:
              print("Response content is not valid JSON")
              return None

      def main():
          search_id = input("Enter the search ID: ")
          webhook_url = 'https://example.com/webhook'
          status_response = get_search_status(search_id)
          if status_response:
              print(f"Status Response: {json.dumps(status_response, indent=2)}")
              delivery_response = deliver_snapshot_to_webhook(search_id, webhook_url)
              if delivery_response:
                  print(f"Delivery Response: {json.dumps(delivery_response, indent=2)}")
              else:
                  print("Failed to deliver snapshot to S3.")
          else:
              print("Failed to retrieve search status.")

      if __name__ == "__main__":
          main()
      ```
    </CodeGroup>
  </Tab>
</Tabs>

If you're running a linux/macos machine, you can simulate one of our delivery webhooks with the code on [this page](./webhook-test).

## Get Status of Data Snapshot

Check the status of a specific Data Snapshot (dump) using the dump\_id.
**Endpoint**: `GET api.brightdata.com/webarchive/dump/<dump_id>`

<Tabs>
  <Tab title="Request">
    ```js
    GET api.brightdata.com/webarchive/dump/<dump_id>
    ```
  </Tab>

  <Tab title="Response">
    <Note>
      The status code of all three following responses is `200 OK`
    </Note>

    <CodeGroup>
      ```js In progress
      {
          dump_id: <id>,
          status: 'in_progress',
          batches_total: 130,
          batches_uploaded: 29,
          files_total: 1241241251,
          estimate_finish: ISODate
      }
      ```

      ```js Finished
      {
          dump_id: <id>,
          status: 'done',
          batches_total: 130,
          files_total: 1241241251,
          files_uploaded: 2412515,
          completed_at: Date
      }
      ```

      ```js Failed
      {
          dump_id: <id>,
          status: 'failed',
          error: 'Designated delivery path not responding'
      }
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Code Example">
    ```sh Curl
    curl https://api.brightdata.com/webarchive/dump/$DUMP_ID \
      -H "Authorization: Bearer $API_KEY"
    ```
  </Tab>
</Tabs>

## Get the Status of all Data Snapshots

**Endpoint**: `GET api.brightdata.com/webarchive/dumps`

<Tabs>
  <Tab title="Response">
    ```js 200 OK
    [
        {
            dump_id: 'ID',
            status: 'in_progress',
            batches_total: 130,
            batches_uploaded: 29,
            files_total: 1241241251,
            estimate_finish: Date
        },
        {
            dump_id: 'ID',
            status: 'done',
            batches_total: 130,
            files_total: 1241241251,
            files_uploaded: 2412515,
            completed_at: Date
        }
        // ... rest of the dumps
    ]
    ```
  </Tab>

  <Tab title="Code Example">
    ```sh Curl
    curl https://api.brightdata.com/webarchive/dumps \
      -H "Authorization: Bearer $API_KEY"
    ```
  </Tab>
</Tabs>

## High-level process flow diagram

<img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/webarchive/webarchive-flow.png?maxW=777&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=da03ee353d3b42f1fe6e8c37bc9fec60" alt="flow diagram" width="777" height="782" data-path="images/api-reference/webarchive/webarchive-flow.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/webarchive/webarchive-flow.png?w=280&maxW=777&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b737b1ca56dcc5dd59ae67b20ae23189 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/webarchive/webarchive-flow.png?w=560&maxW=777&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b1812060d598233a18b22e1913cc0de2 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/webarchive/webarchive-flow.png?w=840&maxW=777&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=54cd34bdd22b3085f07446b781b8528d 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/webarchive/webarchive-flow.png?w=1100&maxW=777&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=8e62fec5fe9023de1c60df566e3d8816 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/webarchive/webarchive-flow.png?w=1650&maxW=777&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=3e1e7f9245566656e3f7f5b7c1c862d1 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/api-reference/webarchive/webarchive-flow.png?w=2500&maxW=777&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=656dd7273351b1310f32b92f0be8f291 2500w" data-optimize="true" data-opv="2" />


# Data validation for Customers
Source: https://docs.brightdata.com/datasets/data-validation/data-validation-for-customers



## Overview

Bright Data’s automated dataset creation platform consists of a verification and approval phase before the dataset delivery. The platform 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 src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/flow-chart.png?maxW=1115&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=12819037e023f4d155f8e5c0c6d439ae" alt="flow-chart.png" width="1115" height="291" data-path="images/datasets/data-validation/data-validation-for-customers/flow-chart.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/flow-chart.png?w=280&maxW=1115&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=41c964dac2c72cb83ad925b42d3d570a 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/flow-chart.png?w=560&maxW=1115&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=8eeaefd7e816d0ffe306350cb9aeb69e 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/flow-chart.png?w=840&maxW=1115&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=430d70df35aae8c11062266a7b9c9988 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/flow-chart.png?w=1100&maxW=1115&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b824e6f8f08ef7b47b1044e5ca2f3b2d 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/flow-chart.png?w=1650&maxW=1115&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=673de1116859748970c4756345eca7f1 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/flow-chart.png?w=2500&maxW=1115&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b831cec2510beb14222e4a2249ad86cf 2500w" data-optimize="true" data-opv="2" />

## 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 platform 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.

## Validation Rules

<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 caption="Overall view of dataset tests (All results, Passed, Failed)">
  <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/overall-view.png?maxW=1210&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=93876c856b319c6fbbe43592f6df6017" alt="overall-view.png" width="1210" height="790" data-path="images/datasets/data-validation/data-validation-for-customers/overall-view.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/overall-view.png?w=280&maxW=1210&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=d08865c5849f3dff464299bf2d3a6c6f 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/overall-view.png?w=560&maxW=1210&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=aed691a69421db2910c6f9c7a2a8532d 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/overall-view.png?w=840&maxW=1210&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=bd9c8f9b6bf1b624102988a7ebcd9277 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/overall-view.png?w=1100&maxW=1210&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=4780add7f22d844702ff69a01c4d90ce 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/overall-view.png?w=1650&maxW=1210&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=d080d331d48ec38150cd93a2a73dd8a4 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/overall-view.png?w=2500&maxW=1210&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=f2d5d06b12289559987d2f852cedf589 2500w" data-optimize="true" data-opv="2" />
</Frame>

### Evaluating the validation test results

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate.png?maxW=1350&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=a46801d3bf21f084a5cb1280eb33a18e" alt="evaluate.png" width="1350" height="1004" data-path="images/datasets/data-validation/data-validation-for-customers/evaluate.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate.png?w=280&maxW=1350&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=7d07bf3c201ae93bddbd5616a06012d8 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate.png?w=560&maxW=1350&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=1a32dbf49d7195020d793722eff908da 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate.png?w=840&maxW=1350&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=70b5b6e0da38ce7a5cfab910fc5a25d1 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate.png?w=1100&maxW=1350&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=d315b716565d270f762682191e0186d7 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate.png?w=1650&maxW=1350&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=f4feebb172924f9eb5e0fe4564c2808f 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate.png?w=2500&maxW=1350&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6cc15544458dab2e98b7834fa7e41d1d 2500w" data-optimize="true" data-opv="2" />
</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.

### Evaluation actions

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 src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate-options.png?maxW=879&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=547a2146b2ead6345ace3859816d70ae" alt="evaluate-options.png" width="500" width="879" height="1232" data-path="images/datasets/data-validation/data-validation-for-customers/evaluate-options.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate-options.png?w=280&maxW=879&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6f71c3eaa75b781b1f95649b6069e4e8 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate-options.png?w=560&maxW=879&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6a1a6441c9f26000b93eaea36cc7de5b 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate-options.png?w=840&maxW=879&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6ea2507acd1499712eec35cd4f2462b1 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate-options.png?w=1100&maxW=879&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=31f8f60a8456e076658b4b410b8b5fed 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate-options.png?w=1650&maxW=879&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=c343b4fd4b53905ba0e3026b6b1b3a27 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/evaluate-options.png?w=2500&maxW=879&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=1b8f3e84dc9f2a067e58fa7a3fe07c77 2500w" data-optimize="true" data-opv="2" />
</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 src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/validations-results.png?maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=94a3afc1c1186f2c496c33a0826eab68" alt="validations-results.png" width="1600" height="565" data-path="images/datasets/data-validation/data-validation-for-customers/validations-results.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/validations-results.png?w=280&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=19dbf11efe7bfcde6ea788cc7b3c15a0 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/validations-results.png?w=560&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=64079c6ab95bef85cd25f7f88c051c39 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/validations-results.png?w=840&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=4029dcf24ca08207c297d49ac1dcf39b 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/validations-results.png?w=1100&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=836d215a871a9dd2fa17d18cce13b66c 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/validations-results.png?w=1650&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=f9eef38db2c23df5f3e6d91dfc37a338 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/validations-results.png?w=2500&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=2fe15504f2cf0400bd4bd9fec4c4a8ed 2500w" data-optimize="true" data-opv="2" />
</Frame>

In case all/some issues are rejected, click on “send back to the developer” to send it back for additional fixes.

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/failed-results.png?maxW=1360&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=9169f93834fd3265cc2cd909b9024dc6" alt="failed-results.png" width="1360" height="978" data-path="images/datasets/data-validation/data-validation-for-customers/failed-results.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/failed-results.png?w=280&maxW=1360&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=7a1964fe89bece10e4f8a6a8ddc850e4 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/failed-results.png?w=560&maxW=1360&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=e531019f227c3e7edcc958061f2e3d82 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/failed-results.png?w=840&maxW=1360&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=3495b4607ea6bb4fbc7df81abde4ebb9 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/failed-results.png?w=1100&maxW=1360&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=838bd3eecd88d145f39edd42462f6cd6 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/failed-results.png?w=1650&maxW=1360&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=49671aceb6f34552b4bdf6622289f732 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-customers/failed-results.png?w=2500&maxW=1360&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=e36b410ed3e3512d8bdbdf432bd3ffbc 2500w" data-optimize="true" data-opv="2" />
</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



## 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 src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/flowchart.png?maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=cd2fbe2d19db86b53a4cdf5647cbc730" alt="flowchart.png" width="1600" height="651" data-path="images/datasets/data-validation/data-validation-for-partners/flowchart.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/flowchart.png?w=280&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=58fd93b36089202ba043484be99a0f28 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/flowchart.png?w=560&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=c0b36d891f08b37b0f5eefb1fe087194 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/flowchart.png?w=840&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=f943bfc5c06f5525e0450e04478f11fa 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/flowchart.png?w=1100&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=a3f8de7e0743a8f6d01e6a327f4fae71 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/flowchart.png?w=1650&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=3c6dae48cd2ab517c2e133694d2ebb02 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/flowchart.png?w=2500&maxW=1600&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=ef4ea8a03826a9d3d5607684e3f137b8 2500w" data-optimize="true" data-opv="2" />

## 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 caption="When clicking on the specific snapshot to review it">
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/snapshots.png?maxW=1093&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=57ca2368ed0415abbadc42aefa6711c2" alt="snapshots.png" width="1093" height="398" data-path="images/datasets/data-validation/data-validation-for-partners/snapshots.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/snapshots.png?w=280&maxW=1093&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=578e26d9b28f7a6368607c8c87421bfd 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/snapshots.png?w=560&maxW=1093&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b8e3833b983ede6a522e7278246a9e4c 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/snapshots.png?w=840&maxW=1093&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=537581cf956eee52f4a5e4682ebd69aa 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/snapshots.png?w=1100&maxW=1093&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=47dfe889b4b92e425c2a35733bf33b78 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/snapshots.png?w=1650&maxW=1093&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=bb728c9bffb3b248968faff00d8fee61 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/snapshots.png?w=2500&maxW=1093&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=5d08159b704f1783b3894e6aa92a36fa 2500w" data-optimize="true" data-opv="2" />
</Frame>

<AccordionGroup>
  <Accordion title="Dataset test view">
    There are three filter options (All results, Passed, Failed) for dataset test view
        <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/dataset-view.png?maxW=1135&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6ac0a97c39a72d78c43310020c4e467f" alt="dataset-view.png" width="1135" height="659" data-path="images/datasets/data-validation/data-validation-for-partners/dataset-view.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/dataset-view.png?w=280&maxW=1135&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=e3c57853319881652224b464350c923d 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/dataset-view.png?w=560&maxW=1135&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=10f134a59ce1ffd48b1dd003c53eb362 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/dataset-view.png?w=840&maxW=1135&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=cfa8debd2b7c0a9b4e11c1a258a9b4b2 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/dataset-view.png?w=1100&maxW=1135&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=d613a92ee82a2ad99d30ddc18d68f84d 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/dataset-view.png?w=1650&maxW=1135&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=00b9bbda4d7c3076f880f710e57effa6 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/dataset-view.png?w=2500&maxW=1135&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=42b0edf16c95f71679694f0c4bd16e01 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="Reparse button">
    This will allow you to reparse the cached data
        <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-button.png?maxW=965&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6b63955022b9731ac3748671474221d4" alt="reparse-button.png" width="965" height="422" data-path="images/datasets/data-validation/data-validation-for-partners/reparse-button.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-button.png?w=280&maxW=965&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=8c7d0e8bd380ab23f608eb8fe8b7743b 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-button.png?w=560&maxW=965&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6c832684af3f8224ccf54297c41932dd 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-button.png?w=840&maxW=965&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=55260279d4c56ed8348759298fb3d29c 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-button.png?w=1100&maxW=965&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=c39e4e9875b26f9d72216761d78b76da 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-button.png?w=1650&maxW=965&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=71cdf20702b467c226558d568ed2d68e 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-button.png?w=2500&maxW=965&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=64b9569f5b3cd2ea572351c763c8faa6 2500w" data-optimize="true" data-opv="2" />
  </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 src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ignore-button.png?maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=5b24b7806978a1983c7c15f0dc389a38" alt="ignore-button.png" width="683" height="326" data-path="images/datasets/data-validation/data-validation-for-partners/ignore-button.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ignore-button.png?w=280&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=4060397d32804058bbb5e7fffda25f42 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ignore-button.png?w=560&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=20bda2bcc06b69cf3f807c57c4d1200b 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ignore-button.png?w=840&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=4c4c25636a607adb50ad9e08412e2847 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ignore-button.png?w=1100&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=8701c77a7410b2b2f581325bdc4253ec 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ignore-button.png?w=1650&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=2cf8cf0df987caecd5201c7e9c8a85d2 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ignore-button.png?w=2500&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=e1c9d06f8f360c5666c0c7b5df726463 2500w" data-optimize="true" data-opv="2" />
            <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/undo-ignore.png?maxW=1052&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=d317ecb60d189f44e149136b10c71630" alt="undo-ignore.png" width="1052" height="248" data-path="images/datasets/data-validation/data-validation-for-partners/undo-ignore.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/undo-ignore.png?w=280&maxW=1052&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=7276d66677de5f0ac428584f0b357de4 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/undo-ignore.png?w=560&maxW=1052&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=0505d53aba55294de0dfb8dd74a02196 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/undo-ignore.png?w=840&maxW=1052&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=9b38b3b8310f8795579f0795edfca336 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/undo-ignore.png?w=1100&maxW=1052&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=432d45cf7415b56584a31a049e95377d 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/undo-ignore.png?w=1650&maxW=1052&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=0e2bf58d813319bf883da01b5f146fcd 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/undo-ignore.png?w=2500&maxW=1052&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=44ccb9d497ae738219a00c86fcc41bd9 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    <Frame>
            <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/confirm-undo.png?maxW=453&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=414e461cff4e625d400c8f40a7fa9247" alt="confirm-undo.png" width="453" height="317" data-path="images/datasets/data-validation/data-validation-for-partners/confirm-undo.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/confirm-undo.png?w=280&maxW=453&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=fd3104aadbed923cf3be323d6321a7cc 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/confirm-undo.png?w=560&maxW=453&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=431a72f7176fd1661775390d97cfbfd9 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/confirm-undo.png?w=840&maxW=453&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6ffa4a9b9a7db5850a919b44cbaa00cf 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/confirm-undo.png?w=1100&maxW=453&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=81c8354f2af53bf6bc59e2435074837e 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/confirm-undo.png?w=1650&maxW=453&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=a31fe388a391df3bdb4676a6898827e1 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/confirm-undo.png?w=2500&maxW=453&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=7bc5bcf4e13aceb0e39229c3c7c8a921 2500w" data-optimize="true" data-opv="2" />
    </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 src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/view-edit-code.png?maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=ff79c4c50f6a8d6fcb136efd328194ae" alt="view-edit-code.png" width="683" height="326" data-path="images/datasets/data-validation/data-validation-for-partners/view-edit-code.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/view-edit-code.png?w=280&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=2cd661dd0f299f61134b7122a3935237 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/view-edit-code.png?w=560&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=af261da0f15d7ae5b1ab5c44a94bc54e 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/view-edit-code.png?w=840&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=7ee0e1c5d7622039df4b2941af1f7677 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/view-edit-code.png?w=1100&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=c905b21f00a280ac5d4af6468b8abd9e 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/view-edit-code.png?w=1650&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=02c44540dfbe78163230227b6df06aba 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/view-edit-code.png?w=2500&maxW=683&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=689cfaf435c8586b8bc11265e95fd9c6 2500w" data-optimize="true" data-opv="2" />
  </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 src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-recrawl.png?maxW=940&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=829de4b8213c4141c7398fc5d371ee4f" alt="reparse-recrawl.png" width="940" height="459" data-path="images/datasets/data-validation/data-validation-for-partners/reparse-recrawl.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-recrawl.png?w=280&maxW=940&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=debf73c716c51536c8bdb37efdc342ff 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-recrawl.png?w=560&maxW=940&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6eb8bc0ef55fe993fa168411dab97f30 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-recrawl.png?w=840&maxW=940&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=31e7ec4ac266216b13341594ac4e284d 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-recrawl.png?w=1100&maxW=940&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=f317d4c6708f67df259f1307cb7748ed 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-recrawl.png?w=1650&maxW=940&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=1965804d321e2b4051b4c4899b9b56eb 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/reparse-recrawl.png?w=2500&maxW=940&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=4cbfd6258effde1ca8bcaeaf6040a692 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="Rerun test">
    This will allow you to run the validation tests again if needed
        <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/rerun-tests.png?maxW=1207&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=176960f70de8124961cf69ff740ef610" alt="rerun-tests.png" width="1207" height="653" data-path="images/datasets/data-validation/data-validation-for-partners/rerun-tests.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/rerun-tests.png?w=280&maxW=1207&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=733dae143970c8be242a8c9d2a55d0de 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/rerun-tests.png?w=560&maxW=1207&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=dd65b2ee14b9f7b98bf366250fade0ef 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/rerun-tests.png?w=840&maxW=1207&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=3381ea5f704c8fa87518e76337fa0076 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/rerun-tests.png?w=1100&maxW=1207&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=41a7c3c57839d6164c4a9849e77f216c 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/rerun-tests.png?w=1650&maxW=1207&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6ed847afd060c1230b735984b9883b4a 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/rerun-tests.png?w=2500&maxW=1207&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=5c8b9ef43cbe0c723294c437ac86babd 2500w" data-optimize="true" data-opv="2" />
  </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 src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ide-button.png?maxW=1191&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=0b173d31228a23553c3f6a8fe68920cf" alt="ide-button.png" width="1191" height="582" data-path="images/datasets/data-validation/data-validation-for-partners/ide-button.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ide-button.png?w=280&maxW=1191&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=5fdf6a41ac0070b6a6a7f1885501edbf 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ide-button.png?w=560&maxW=1191&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=d524e461d15738f2e13c713764bd2322 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ide-button.png?w=840&maxW=1191&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=64ad7a417c84477e25a184a08361a9c4 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ide-button.png?w=1100&maxW=1191&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=9227cc64d4a063a200519d6fd04c3ae0 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ide-button.png?w=1650&maxW=1191&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=a478fad6801ab3b4d6d9a65f0fb5fd62 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/ide-button.png?w=2500&maxW=1191&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=1452cd3bfc20372686eab2b0b06c3319 2500w" data-optimize="true" data-opv="2" />
  </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 src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/deliver-dataset.png?maxW=693&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b60f449494927445cd782e91e830dd47" alt="deliver-dataset.png" width="693" height="219" data-path="images/datasets/data-validation/data-validation-for-partners/deliver-dataset.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/deliver-dataset.png?w=280&maxW=693&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=c248dc71a5b5d1cc390d9099afb38772 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/deliver-dataset.png?w=560&maxW=693&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=cf081898fb26c49387273fbabda3e380 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/deliver-dataset.png?w=840&maxW=693&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=2a3bd5137871f84a53da3daaf6bad781 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/deliver-dataset.png?w=1100&maxW=693&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=fa94cfa2e7bf8440f37ae7898d95a8bf 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/deliver-dataset.png?w=1650&maxW=693&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=112e19ae5636411d844c7d96058646fd 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/deliver-dataset.png?w=2500&maxW=693&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=08b50d2f0b456a0a4fc2ac4b4c7751c3 2500w" data-optimize="true" data-opv="2" />
  </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 src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/failed.png?maxW=1045&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=92197da043c697340ec8326453058902" alt="failed.png" width="1045" height="847" data-path="images/datasets/data-validation/data-validation-for-partners/failed.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/failed.png?w=280&maxW=1045&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=520729e69d38d879e90c628a40c3c931 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/failed.png?w=560&maxW=1045&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=1c8eccc30b4e5e63ef6fe027bc92f551 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/failed.png?w=840&maxW=1045&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=15ac15df25e2d6f76738e03ed371feff 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/failed.png?w=1100&maxW=1045&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=007b98ec1dc8f3a9ab2471d6075476e3 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/failed.png?w=1650&maxW=1045&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=3a506dcccd0c8afcb615e939824f302d 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/data-validation/data-validation-for-partners/failed.png?w=2500&maxW=1045&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=dc977f6d7234eb301cd65b986481742a 2500w" data-optimize="true" data-opv="2" />
  </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


# The Basics of Web Scraping
Source: https://docs.brightdata.com/datasets/functions/basics-of-web-scraping

This article describes the basic concepts in web scraping, like Navigation, Parsing, Worker type, and main Challenges

If you know your way around JS but are new to web data scraping you might need to learn the basic approach and one or two tactics for successful scraping.

The basic idea of web scraping consists of two parts, Navigation and Parsing, and the tactics used to achieve those are depending on the selected technical approach of using Browser worker vs. Code worker.

## Browser Worker vs. Code Worker

Browser worker and code worker are two technical approaches for scraping, and you should choose between them based on your needs and budget, and based on technical challenges you're facing with the website you're scraping.

Browser Workers simulates user interactions with websites through a headless browser,

capable of handling complex scraping tasks such as user input and dynamic content loading. Running your code with a browser worker involves higher CPM, but in some usecases it is the only feasible solution to get the data.

Code Workers, on the other hand, run on the server-side and perform scraping tasks through HTTP requests. A script or program sends requests to the target website, extracts data from the individual responses, and saves it to a file or database. Running your code with a code worker is cheaper and brings faster results.

You can switch between worker types per scraper at any time, so you never commit to any specific worker, but be aware that there are a few functions (like 'wait') that are designed for and limited to work only with a Browser Worker. Lean more about [worker types](/scraping-automation/web-scraper-ide/worker-types)

## Interaction and Parsing

Interaction and parsing are two key steps in web scraping that involve accessing and manipulating the HTML content of a website.

Interaction refers to the process of moving between different pages or sections of a website to locate the data that you want to scrape. This typically involves sending GET or POST requests to the website's URLs, and following links or submitting forms to access different pages or sections. It also involves actions/commands such as click, type, and wait. Once the browser page has the data you want, call parse() to get the data - this will trigger the Parser code, then call collect() to add a record to your final dataset.

For example:

```js
let data = parse();
collect({
    url: new URL(location.href),
    title: data.title,
    links: data.links,
});
```

Parsing refers to the process of extracting the relevant data from the HTML content of a website. This involves identifying the HTML elements that contain the data you want to scrape, and using regular expressions or other techniques to extract the data from those elements.

For example:

```js
return {
  title: $('h1').text().trim(),
  links: $('a').toArray().map(e=>new URL($(e).attr('href'))),
};
```

For instance, let’s say that you would like to scrape an e-commerce website based on a search term, and return the (title, description, price) for each product.

```js
let search_url = `https`:
navigate(search_url)
let max_page = parse().max_page
for (let i = 1; i <= max_page; i++)
{
    let search_page = new URL(search_url)
     if (i>1)
          search_page.searchParams.set('page', i)
     next_stage({search_page})
}
```

```js
navigate(input.search_page)
let listings = parse().listings
for (let listing_url of listings)
     next_stage({listing_url})
```

```scss
navigate(input.listing_url)
collect(parse())
```

1. Navigate to the search page of the ecommerce website using a GET or POST request
2. Locate the HTML elements that contain the number of pages
3. Parse the HTML to extract the number of search results pages
4. Navigate to each result page and do the following
5. Locate the HTML elements that contain each search result data
6. Parse the HTML content of each search results to collect the URLs of each product page
7. Navigate to each product page and do the following
8. Locate the HTML elements that contain the desired product data
9. Parse the HTML to extract the desired product data

## The challenges and barriers of scraping at scale

Scraping can be fast and easy when done on a small scale, but in case your project requires a high volume of data there are a few challenges you might have to deal with as some websites implement technical measures such as CAPTCHAs or IP blocking to prevent scraping.There are ways to overcome those challenges, but doing it by yourself might be too complex and time consuming. To solve those challenges we've built our IDE cloud service on top of our proprietary [proxy infrastructure](/proxy-networks/introduction) and our [Unlocker API](/scraping-automation/web-unlocker), so you won't have to face those challenges.


# Best Practices for Web Scraper IDE
Source: https://docs.brightdata.com/datasets/functions/best-practices

Learn the best practices for using Web Scraper IDE, including optimizing performance, handling errors, managing retries, and writing efficient scraper code.

## Missing `dead_page` condition.

When using `navigate` command, a 'dead\_page' condition should be added to check if the page is not found. This will prevent automatic retries. While we automatically handle this when the response status is 404, in some cases, the website may respond with various other status codes:

Here are good and bad practices examples (you can nevigate between them by clicking on the "Bad" "Good" tabs)

<CodeGroup>
  ```js ❌ Bad
  try {
    // no need to wait 30sec 'ok-selector' in case of dead_page()
    wait('ok-selector');
  } catch(e) {
    // in this case we can't be sure that the page is real dead
    dead_page('Page doesn\'t exist');
  }
  ```

  ```js ✅ Good
  wait('ok-selector, 404-selector');
  if (el_exists('404-selector'))
    dead_page();
  ```
</CodeGroup>

## Minimize amount of requests to the browser

Some interaction commands like click type el\_exists el\_is\_visible wait wait\_visible make real requests to the browser and may increase latency and decrease performance. It is recommended to combine selectors and make a single call instead of multiple calls.

<CodeGroup>
  ```js ❌ Bad
  if (!(el_exists('#price1')) || el_exists('#price2')
    || el_exists('#price3') || el_exists('#discount'))
  {
      dead_page('No price found');
  }
  ```

  ```js ✅ Good
  if (!el_exists('#price1, #price2, #price3, #discount'))
    dead_page('No price found');
  ```
</CodeGroup>

## Incorrect usage of `rerun_stage()`

When a website has pagination on the page and data from all pages is required, `rerun_stage()` should be called for each page from the root page instead of calling it from each page. This allows the system to parallelize the requests and make the scraper faster.

<CodeGroup>
  ```js ❌ Bad
  navigate(input.url);
  let $ = html_load(html());
  let next_page_url = $('.next_page').attr('href');
  rerun_stage({url: next_page_url});
  ```

  ```js ✅ Good
  let url = new URL(input.url);
  if (input.page)
      url.searchParams.set('page', input.page);
  navigate(url);
  // The input.page does not exist except on the root page, from which we
  // have already invoked rerun_stage() for each page.
  if (input.page)
      return;

  let $ = html_load(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>

## Use `close_popup()` to close popups

Do not spend time waiting for popups to appear. Use `close_popup('popup_selector', 'close_button_selector')` to close popups. A popup can appear at any time, and in most cases, adding a check before each interaction command is not desirable.
Bad

<CodeGroup>
  ```js ❌ Bad
  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
  // it runs in the background and does not affect the performance.
  // We check if the popup is visible before any interaction like
  // click or type.
  close_popup('.cky-btn-accept', '.cky-btn-accept');
  navigate('https://example.com');
  click('.open-product-full-info');
  ```
</CodeGroup>

## Use `wait_for_parser_value()` with `tag_response()`

When using tag\_response command and needing to ensure that request is finished before collecting data from the page, `wait_for_parser_value()` should be used:

<CodeGroup>
  ```js ❌ Bad
  tag_response('product', /api\/product/);
  navigate('https://example.com');

  // parser code
  // in this case we can't be sure that the request is finished
  let {product} = parser;
  return product.data;
  ```

  ```js ✅ Good
  tag_response('product', /api\/product/);
  navigate('https://example.com');
  wait_for_parser_value('product');

  // parser code
  let {product} = parser;
  return product.data;
  ```

  ```js ✅ Good
  tag_response('product', /api\/product/);
  navigate('https://example.com');

  // you can also get the data from the response in interaction
  let product = wait_for_parser_value('product');
  navigate(product.reviews_url);
  tag_html('reviews_html');

  // parser code
  let {product, reviews_html} = parser;
  let $ = html_load(reviews_html);
  let reviews = $('.review').toArray().map(v=>$(v).text());
  return {
    ...product.data,
    reviews,
  }
  ```
</CodeGroup>

## Custom error messages

Avoid using custom error messages when possible. Our system does the best to provide you with the most accurate error messages:

<CodeGroup>
  ```js ❌ Bad
  try {
    wait('selector1');
    //some code
    wait('selector2');
    //some code
  } catch(e) {
    throw "Page not loaded properly"
  }
  ```

  ```js ✅ Good
  // Crawler error: waiting for selector "selector1" failed: timeout 30000ms exceeded
  wait('selector1');
  //some code
  wait('selector2');
  //some code
  ```

  ```js ✅ Good
  if (!el_exists('.product-title'))
      throw new Error('Failed to load product page');
  ```
</CodeGroup>

## Slow website response, increasing timeouts

If the website is not loading properly, it may be due to a poor peer connection. It is advisable to display an error message, and the system will attempt to load the page using a more stable peer session.

<CodeGroup>
  ```js ❌ Bad
  // 120 sec to long for waiting
  wait('selector', {timeout: 120000});
  ```

  ```js ✅ Good
  wait('selector'); // better to use default timeout (30 sec)
  wait('selector', {timeout: 45000});
  wait('selector', {timeout: 60000});  // 60 sec is ok for slow websites
  ```
</CodeGroup>

## Retry mechanism

The scraper code should be clear and focus solely on the necessary tasks for scraping data. There is no need to attempt to reinvent the wheel. It's better to emphasize issues unrelated to the code and report them in the system.

<CodeGroup>
  ```js ❌ Bad
  let counter = input.counter || 5;
  while (counter > 1) {
    try {
      wait('selector' , {timeout: 500});
      click('selector');
      type('selector');
      //some code
      break;
    } catch(e) {
      // not acceptable use rerun_stage to create new session in case of error
      return rerun_stage({...input, counter: --counter});
    }
  }


  ```

  ```js ✅ Good
  navigate("https://example.com");
  wait('h1');
  ```
</CodeGroup>

## Avoid using a try-catch block

This facilitates the development of concise and readable code, effectively managing potential 'null' or 'undefined' values without the reliance on a try-catch block.

<CodeGroup>
  ```js ❌ Bad
  try {
    const example = obj.prop;
  } catch(e) {}
  ```

  ```js ❌ Bad
  // 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
  const example = object?.prop;
  const example2 = object.prop ?? undefined
  const example3 = object.prop ? object.prop : undefined
  ```
</CodeGroup>

## Parser code: get values from set of elements

The best practice code employs the more concise and functional toArray() and map() methods instead of the traditional each() loop. This enhances code readability and upholds a declarative style.

<CodeGroup>
  ```js ❌ Bad
  const links = [];
  $('.card.product-wrapper').each(function(i, el) {
    links.push({url: $(this).find('h4 a').attr('href')});
  })
  return links;
  ```

  ```js ✅ Good
  const links = $('.card.product-wrapper').toArray().map(v=>({
    url: $(v).find('h4 a').attr('href'),
  }));
  ```
</CodeGroup>

## Normalizing text

We added a custom function to cheerio prototype `$(selector).text_sane()` that removes all unnecessary whitespace characters and replaces them with a single space.

<CodeGroup>
  ```js ❌ Bad
  $.prototype.clearText = function () {
    return this.text().replace(/\s+/g, ' ').trim();
  }
  ```

  ```js ✅ Good
  let name = $('a').text_sane();
  or if you need only numbers
  let value= +$('a').text().replace(/\D+/g, '');
  ```
</CodeGroup>


# Coding Environment & Tutorials
Source: https://docs.brightdata.com/datasets/functions/coding-environment

Explore essential coding commands and best practices for using the Web Scraper IDE. Learn how to navigate, parse data, interact with elements, and optimize your scraping tasks efficiently.

## IDE Interaction code

These are all of the codes that you can do with the IDE

`input` - Global object available to the interaction code. Provided by trigger `input` or `next_stage()` calls

```js
navigate(input.url);
```

***

`navigate` - Navigate the browser session to a URL

* `url`: A URL to navigate to

```js
navigate([url]);
navigate(input.url);
navigate('https://example.com');
```

`navigate` options

```js
// waits until DOM content loaded event is fired in the browser
navigate([url], {wait_until: 'domcontentloaded'});

// adds a referer to the navigation
navigate([url], {referer: [url]});

// the number of milliseconds to wait for. Default is 30000 ms
navigate([url], {timeout: 45000});

// add headers to the navigation
navigate([url], {header : 'accept: text/html'});

// specify browser width/height
navigate([url], {fingerprint: {screen: {width: 400, height: 400}}});
```

***

`parse` - Parse the page data

```js
let page_data = parse();
```

***

`collect` - Adds a line of data to the dataset created by the crawler

* `data_line`: A object with the fields you want to collect
* `validate_fn`: Optional function to validate that the line data is valid

```js
collect([data_line] [validate_fn]);
collect({ title: page_data.title price: page_data.price });
collect({ price: data.price });

collect(line, l=>!l && throw new Error('Empty line'));
```

***

`next_stage` - Run the next stage of the crawler with the specified input

* `input`: Input object to pass to the next browser session

```js
next_stage({url: 'http://example.com', page: 1});
```

<Frame>
    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/datasets/functions/images/scraping-automation/web-scraping-ide/coding-environment/next-stage.png" alt="" />
</Frame>

***

`rerun_stage` - Run this stage of the crawler again with new `input`

* `input`: Input object to pass to the next browser session

```js
rerun_stage({url: 'http://example.com/other-page'});
```

***

`run_stage` - Run a specific stage of the crawler with a new browser session

* `input`: Input object to pass to the next browser session
* `stage`: Which stage to run (1 is first stage)

```js
run_stage(2, {url: 'http://example.com', page: 1});
```

***

`country` - Configure your crawl to run from a specific country

* `code`: 2-character ISO country code

```js
country(<code>);
```

***

`wait` - Wait for an element to appear on the page

* `selector`: Element selector
* `opt`: wait options (see examples)

```js
wait (<selector>);
wait('#welcome-splash');
wait('.search-results .product');
wait('[href^='/product']');
wait(<selector>, {timeout: 5000});
wait(<selector>, {hidden: true});
```

***

`wait_for_text` - Wait for an element on the page to include some text

* `selector`: Element selector
* `text`: The text to wait for

```js
wait_for_text(<selector>, <text>);
wait_for_text('.location', 'New York');
```

***

`click` - Click on an element (will wait for the element to appear before clicking on it)

* `selector`: Element selector

```js
click(<selector>);
click('#show-more');
```

***

`type` - Enter text into an input (will wait for the input to appear before typing)

* `selector`: Element selector
* `text`: The text to wait for

```js
type(<selector>, <text>);
type('#location', 'New York');
type(<selector>, ['Enter']);
type(<selector>, ['Backspace']);
```

***

`select` - Pick a value from a select element

* `selector`: Element selector

```js
select(<select>, <value>);
select('#country', 'Canada');
```

***

`URL` - URL class from `NodeJS` standard "url" module

* `url`: URL string

```js
let u = new URL('https://example.com');
```

***

`location` - Object with info about current location. Available fields: href

* `url`: URL string

```js
navigate('https://example.com');
location.href;
```

***

`tag_response` - Save the response data from a browser request

* `name`: The name of the tagged field
* `pattern`: The URL pattern to match

```js
tag_response(<field>, <pattern>);
tag_response('teams', /\/api\/teams/);
navigate('https://example.com/sports');

let teams = parse().teams;
for (let team of teams) collect(team);
```

***

`response_header` - Returns the response headers of the last page load

```js
let headers = response_headers(); 
console.log('content-type', headers['content-type']);
```

***

`console` - Log messages from the interaction code

```js
console.log(1, 'luminati', [1, 2], {key: value});
```

***

`load_more` - Scroll to the bottom of a list to trigger loading more items. Useful for lazy-loaded infinite-scroll sites

* `selector`: Element selector

```js
load_more(<selector>);
load_more('.search-results');
```

***

`scroll_to` - Scroll the page so that an element is visible

```js
scroll_to(<selector>);
scroll_to('.author-profile');
```

***

`$` - Helper for jQuery-like expressions

* `selector`: Element selector

```js
$(<selector>);
wait($('.store-card'))
```

## IDE Parser code

These are all of the codes that you can do with the IDE:

`input` - Global variable available to the parser code

```js
let url = input.url;
```

***

`$` - An instance of cheerio\
<Tip>Find more information on the [cheerio website](https://cheerio.js.org/).</Tip>

```js
$('#example').text()
$('$example').attr('href')
```

***

`location` - A global variable available to the parser code. Object with info about current location

```js
let current_url = location.href;
```


# Complete Web Scraper IDE Examples
Source: https://docs.brightdata.com/datasets/functions/complete-examples

Explore comprehensive examples of web scraping using the Web Scraper IDE, including code for interaction, parsing, handling multiple results, and advanced techniques.

## 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
  // 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
  // Old code
  return {
      title: $('h1').text(),
  };

  // New code
  return {
      title: $('h1').text(),
  };

  // or
  let $ = html_load(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](/api-reference/web-scraper-ide-api) 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
  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
  {page1, page1_url, page2, page2_url, page3, page3_url} = parser;
  let $ = html_load(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
  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
  {product_json} = parser;
  return product_json;
  ```
</CodeGroup>

## Multiple results

To collect multiple results, array can be returned from the parser code.

<CodeGroup>
  ```js Interaction code
  navigate("https://example.com/products");
  ```

  ```js Parser code
  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>

## Reparse

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 src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/datasets/functions/images/scraping-automation/web-scraping-ide/complete-examples/reparse_image.png" alt="" />

## `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

  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
  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
  return $('a[data-qa-action="product-click"]').toArray()
    .map(v => ({url: new URL($(v).attr('href'))}));
  ```
</CodeGroup>

## Basic PDP scraper

<CodeGroup>
  ```js Interaction code
  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
  const $ = html_load(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
  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
  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 $ = html_load(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
  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
  let room_id = /([0-9]+)(?:\?|$)/.exec(input.url)?.[1];
  const $ = html_load(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 Self-Managed Scraper with the IDE
Source: https://docs.brightdata.com/datasets/functions/develop-a-scraper

Learn how to create a self-managed data scraper using the Web Scraper IDE. Follow steps to write interaction and parser code, preview, save, and initiate your custom scraper.

To develop a custom scraper using our Integrated development environment (IDE), you will need to insert an URL and start interacting with the development environment using Javascript language.

<Steps>
  <Step title="Start from scratch/choose a template">
    You can start from scratch or use a code template to get started with the development.
  </Step>

  <Step title="Write the interaction code Interaction code">
    Using the interaction code window, you can interact with the elements of the target website.
  </Step>

  <Step title="Write the parser code Parser code">
    Parse the HTML results you gathered from the interaction window.
  </Step>

  <Step title="Run preview Preview">
    Preview your interaction and collection flow. To test your code, click the play icon.
  </Step>

  <Step title="Save your code">
    Save and complete your own data scraper once you've finished editing.
  </Step>

  <Step title="Set your delivery preference">
    Set up your preferred [delivery settings](/scraping-automation/web-scraper-ide/initiate-collection-and-delivery-options#delivery-options).
  </Step>

  <Step title="Initiate the scraper run">
    [Initiate your scraper](/scraping-automation/web-scraper-ide/initiate-collection-and-delivery-options#initiate-scraper) and get collection results.
  </Step>
</Steps>

Create a Data scraper by writing code in the IDE. The development environment provides all the tools you need to create your own data scraper.


# Web Scraper IDE FAQs
Source: https://docs.brightdata.com/datasets/functions/faqs

Find answers to common questions about Bright Data's Web Scraper IDE, including setup, troubleshooting, and best practices for developing custom data scrapers.

<AccordionGroup>
  <Accordion title="What is a Bright Data Web Scraper?">
    Bright Data Web Scrapers are automated tools that enable businesses to automatically collect all types of public online data on a mass scale, while heavily reducing in-house expenses on proxy maintenance and development.

    The Web Scraper delivers enormous amounts of raw data in a structured format, and integrates with existing systems, for immediate use in competitive data-driven decisions.

    Bright Data has developed hundreds of Web Scrapers customized to popular platforms.
  </Accordion>

  <Accordion title="What is Web Scraper IDE?">
    Web Scraper IDE is an integrated development environment. The IDE is a Public web data on any scale at your fingertips, you can:

    * Build your scraper in minutes
    * Debug and diagnose with ease
    * Bring to production quickly
    * Browser scripting in simple Javascript
  </Accordion>

  <Accordion title="What is an “input” when using a Web Scraper?">
    When collecting data, your “input” are the parameters you'll enter to run your collection with. This can include keywords, URL, search items, product ID, ASIN, profile name, check in and check out dates, etc.
  </Accordion>

  <Accordion title="What is an “output” when using a Web Scraper?">
    The output is the data that you've collected from a platform based on your input parameters. You'll receive your data as JSON/NDJSON/CSV/XLSX.
  </Accordion>

  <Accordion title="How many free records are included with my free trial?">
    Each free trial includes 100 records (note: 100 records does not mean 100 page loads).
  </Accordion>

  <Accordion title="Why did I receive more statistic records than inputs?">
    You'll always receive a higher number of records than the inputs you've requested.
  </Accordion>

  <Accordion title="What are the most frequent data points collected from social media?">
    Number of followers, average number of likes for posts, level of engagement, account theme, social and demographic portrait of the audience, social listening: keywords/ brand mentions, sentiments, viral trends.
  </Accordion>

  <Accordion title="Can I collect data from multiple platforms?">
    Yes, we can collect data from large numbers of websites at the same time.
  </Accordion>

  <Accordion title="Can I add additional information to my Web Scraper?">
    Yes you can, you can ask your account manager for help, or you can open a ticket related to the specific Web Scraper by selecting 'Report an issue.' Then request that fields be added or removed from your Web Scraper.
  </Accordion>

  <Accordion title="What is a search scraper?">
    In cases where you don't know a specific URL, you can search for a term and get data based on that term.
  </Accordion>

  <Accordion title="What is a discovery scraper?">
    With a discovery scraper, you enter a URL(s) and collect all data from that page(s). You'll receive data without having to specify a specific product or keyword.
  </Accordion>

  <Accordion title="Can I change the code in the IDE by myself?">
    Yes, the code is in JS, for self-managed scrapers you can change it according to your requirements.
  </Accordion>

  <Accordion title="What are the options to initiate requests?">
    We have 3 option to initiate requests:

    * Initiate by API - regular request, queue request and replace request.
    * Initiate manually.
    * Schedule mode
  </Accordion>

  <Accordion title="How to start using the Web Scraper?">
    There are two ways to use the data collection tool:

    * [Develop a self-managed scraper on your own](/scraping-automation/web-scraper-ide/develop-a-scraper)
    * [Request a custom dataset](/datasets/custom-datasets/request)

    <Frame>
            <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-two-ways-of-usage.png?maxW=1152&auto=format&n=ilemiSHw8UogZ13k&q=85&s=439313322488a441371a74fdfc7e2fc7" alt="web-scraper-two-ways-of-usage.png" width="1152" height="239" data-path="images/scraping-automation/web-scraping-ide/faqs/web-scraper-two-ways-of-usage.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-two-ways-of-usage.png?w=280&maxW=1152&auto=format&n=ilemiSHw8UogZ13k&q=85&s=fd251e1e74c5a18e2c42e73d82d9f8b4 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-two-ways-of-usage.png?w=560&maxW=1152&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6cdafd96c74ec8d4a611aae5d0d90a68 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-two-ways-of-usage.png?w=840&maxW=1152&auto=format&n=ilemiSHw8UogZ13k&q=85&s=216b9327fb3ade91fdb3430596b5355d 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-two-ways-of-usage.png?w=1100&maxW=1152&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a06decc27b1d73d95cc9d8b8964924b2 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-two-ways-of-usage.png?w=1650&maxW=1152&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6da3e3cd79c6f8c83452a1387b42bdcf 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-two-ways-of-usage.png?w=2500&maxW=1152&auto=format&n=ilemiSHw8UogZ13k&q=85&s=97ae84a924ab348870b4150cd3b6ec21 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>

  <Accordion title="What is a queue request?">
    When you are sending more than one API request, a “queue request” means that you'd like your next request to start automatically after your first request is completed, and so on with all other requests.
  </Accordion>

  <Accordion title="What is a CPM?">
    CPM = 1000 page loads
  </Accordion>

  <Accordion title="When building a scraper, what is considered as a billable event?">
    Billable events:

    * `navigate()`
    * `request()`
    * `load_more()`
    * (later) media file download
  </Accordion>

  <Accordion title="How can I confirm that someone is working on the new Web Scraper I requested?">
    You'll receive an email that the developer is working on your new Web Scraper, and you will be notified when your scraper is ready.

    Status of the request can also be found on your dashboard :

        <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-status.png?maxW=560&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d0cac124cfba3775e4953d8659fe7173" alt="web-scraper-status.png" width="560" height="517" data-path="images/scraping-automation/web-scraping-ide/faqs/web-scraper-status.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-status.png?w=280&maxW=560&auto=format&n=ilemiSHw8UogZ13k&q=85&s=4ef8be5b2d795931172421acc0bb36a0 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-status.png?w=560&maxW=560&auto=format&n=ilemiSHw8UogZ13k&q=85&s=4eedf6d8a30da49932c116603e270fc2 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-status.png?w=840&maxW=560&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6fd441be7439834cf1a6f03742bb2b3f 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-status.png?w=1100&maxW=560&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0c14bde611100204592626eadc897c17 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-status.png?w=1650&maxW=560&auto=format&n=ilemiSHw8UogZ13k&q=85&s=775605760cb135c3699df4c0ff8bec3c 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/web-scraper-status.png?w=2500&maxW=560&auto=format&n=ilemiSHw8UogZ13k&q=85&s=cf273e4bedf2fb3701e351c16d7c06ba 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="How to report an issue on the Web scraper IDE?">
    You can use this form to communicate any issues you have with the platform, the scraper, or the dataset results.

    <Note>
      Tickets will be assigned to a different department depending on selected issue type. Please make sure to choose the most relevant type.\*
    </Note>

    <Steps>
      <Step title="Select a job ID : issued Dataset">
                <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/job-id.png?maxW=834&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0fac34a4b3eac18bc77c60cb506961e6" alt="job-id.png" width="834" height="353" data-path="images/scraping-automation/web-scraping-ide/faqs/job-id.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/job-id.png?w=280&maxW=834&auto=format&n=ilemiSHw8UogZ13k&q=85&s=5ea673d60298f278c137a00f6ae53f33 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/job-id.png?w=560&maxW=834&auto=format&n=ilemiSHw8UogZ13k&q=85&s=1306839b72cbbdd036c8eb03b86d759e 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/job-id.png?w=840&maxW=834&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0e76b20d85584cd5bb02bad8dcc6deae 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/job-id.png?w=1100&maxW=834&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a953dfd8806b6e4ec32c59709d49df4f 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/job-id.png?w=1650&maxW=834&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0c0d9d7f8d8e416e939557b2a7dcbf84 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/job-id.png?w=2500&maxW=834&auto=format&n=ilemiSHw8UogZ13k&q=85&s=cde88369b15c30e05d487ac5a263a387 2500w" data-optimize="true" data-opv="2" />
      </Step>

      <Step title="Select a type of the issue">
                <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/issue-category.png?maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=02332d0d4b8d38f721ef9174e3bd149e" alt="issue-category.png" width="835" height="421" data-path="images/scraping-automation/web-scraping-ide/faqs/issue-category.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/issue-category.png?w=280&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c441378b1632f431415c845e69c0e962 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/issue-category.png?w=560&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=97c45a593a49f7941cb6f8dce765a7db 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/issue-category.png?w=840&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6a08f96206bc94653366cd93188172f4 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/issue-category.png?w=1100&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=234b3f416b34dc878139ab912d3ddafc 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/issue-category.png?w=1650&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=760f05a5a1881e80fad7db4892ee9fb9 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/issue-category.png?w=2500&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f45020d5db0412432de4a5a3d16134f6 2500w" data-optimize="true" data-opv="2" />

        <AccordionGroup>
          <Accordion title="Data">
            <Note>
              This option is only available for **managed** scrapers. Tickets will be sent direct to your **scraper engineer**.
            </Note>

            * Missing fields
            * Missing records
            * Missing values
            * Parsing issues: The dataset results are incorrect
          </Accordion>

          <Accordion title="Collection and Delivery">
            <Note>
              This type of tickets will be addressed to our **support agents**.
            </Note>

            * Incomplete delivery: Something went wrong during the delivery
            * Scraper is slow: The scraper is collecting results slowly or stuck
          </Accordion>

          <Accordion title="Other">
            <Note>
              This type of tickets will be addressed to your **account manager**.
            </Note>

            * UI issue : UI does not operate correctly
            * Product question: General questions regarding using Web Scraper product
            * Something else is going wrong
          </Accordion>
        </AccordionGroup>
      </Step>

      <Step title="(Parsing issues) Use the “bug” red icon to indicate where the incorrect results are" />

      <Step title="(Parsing issues) Enter the results you expect to receive" />

      <Step title="Write a description of what went wrong and the URL where the data is collected" />

      <Step title="If needed, attach an image to support your report">
                <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/add-more-context.png?maxW=1746&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c0d8b6de5d6243322a0efe01184a5088" alt="add-more-context.png" width="1746" height="904" data-path="images/scraping-automation/web-scraping-ide/faqs/add-more-context.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/add-more-context.png?w=280&maxW=1746&auto=format&n=ilemiSHw8UogZ13k&q=85&s=7c437076671c3065d8a25d4782cbe403 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/add-more-context.png?w=560&maxW=1746&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0edb5a2f6fe3348115a21848d0831e8c 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/add-more-context.png?w=840&maxW=1746&auto=format&n=ilemiSHw8UogZ13k&q=85&s=79bb1a28349ebf1e4b0e30e7e7d410e4 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/add-more-context.png?w=1100&maxW=1746&auto=format&n=ilemiSHw8UogZ13k&q=85&s=359c56f90752f3afb4e0b441062beb8d 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/add-more-context.png?w=1650&maxW=1746&auto=format&n=ilemiSHw8UogZ13k&q=85&s=53d936d9262d0a81481df5c3bc24d6f3 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/add-more-context.png?w=2500&maxW=1746&auto=format&n=ilemiSHw8UogZ13k&q=85&s=ad28fe36712a5ce60c792040a4425c83 2500w" data-optimize="true" data-opv="2" />
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="I updated input/output schema of my managed scraper. Can I use it while BrightData updates my scraper?">
    When input/output schema is updated, the scraper needs to be updated to match new schema. If the scraper is in work and not updated yet, you'll see 'Incompatible input/output schema' error.

    <Tabs>
      <Tab title="via UI">
                <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/via-ui.png?maxW=413&auto=format&n=ilemiSHw8UogZ13k&q=85&s=48fb33156db3256e1b4435e787bf70a9" alt="via-ui.png" width="413" height="194" data-path="images/scraping-automation/web-scraping-ide/faqs/via-ui.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/via-ui.png?w=280&maxW=413&auto=format&n=ilemiSHw8UogZ13k&q=85&s=5945a90815b17d88a7e91ffcf5202a3e 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/via-ui.png?w=560&maxW=413&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e1c4aeaafc158dac7449199d0ccce9ae 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/via-ui.png?w=840&maxW=413&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6bfa5b1b4601a6c0301516d6c16086dc 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/via-ui.png?w=1100&maxW=413&auto=format&n=ilemiSHw8UogZ13k&q=85&s=fc9b2a4b97f4eba2e80ac6c01a893cb3 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/via-ui.png?w=1650&maxW=413&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d5ba880f2079361a517a8f9e8703b331 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/via-ui.png?w=2500&maxW=413&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a99f387a2b6c5c0e1fa3cd31c1ad15c8 2500w" data-optimize="true" data-opv="2" />
      </Tab>

      <Tab title="via the API">
        ```json
        {"error":{"code":"input(output)_schema_incompatible" ... }}
        ```
      </Tab>
    </Tabs>

    ***

    If you want to initiate it ignoring schema change, you can click 'Trigger anyway' on UI. API, you can add

    * output schema incompatible: `override_incompatible_schema=1`
    * input schema incompatible: `override_incompatible_input_schema=1`

    parameter when triggering the scraper:

    ```sh
    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>

  <Accordion title="How can I debug real time scrapers?">
    We store the last 1000 errors inside the virtual job record so you can see example inputs that were wrong (there's a CP button to view the errors in the IDE).

    The customer should already know which inputs were wrong because they got an 'error' response for them. You can re-run these manually in the IDE to see what happened. This is just like providing a CURL request example when the unblocker isn't behaving right.
  </Accordion>

  <Accordion title="What should I do if I face an issue with a Web Scraper?">
    Select “Report an issue” from the Bright Data Control Panel. Once you report your issue, an automatic ticket will be assigned to one of our 14 developers that monitor all tickets on a dailybasis. Make sure to provide details of what the problem is, and if you are not sure, please contact your account manager. Once you report an issue, you don't need to do anything else, and you'll receive an email confirming that the issue was reported.

        <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/three-dots-report-an-issue.png?maxW=1274&auto=format&n=ilemiSHw8UogZ13k&q=85&s=cb41c36a82764259c5740e6ace5c922f" alt="three-dots-report-an-issue.png" width="1274" height="418" data-path="images/scraping-automation/web-scraping-ide/faqs/three-dots-report-an-issue.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/three-dots-report-an-issue.png?w=280&maxW=1274&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6a88e4bb8cf8e9f9d4ded7fcc0c36fca 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/three-dots-report-an-issue.png?w=560&maxW=1274&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e22d130001fcda98367568904550ddd5 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/three-dots-report-an-issue.png?w=840&maxW=1274&auto=format&n=ilemiSHw8UogZ13k&q=85&s=1d9d6f077f1c5e80b9ffe4df97f32544 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/three-dots-report-an-issue.png?w=1100&maxW=1274&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f87dae259cd5bab41515350ec76f52dc 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/three-dots-report-an-issue.png?w=1650&maxW=1274&auto=format&n=ilemiSHw8UogZ13k&q=85&s=4d4c1d0944c4a49b602ce714d56496c0 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/three-dots-report-an-issue.png?w=2500&maxW=1274&auto=format&n=ilemiSHw8UogZ13k&q=85&s=96982fe12d96bbbe08b012acdad7fc14 2500w" data-optimize="true" data-opv="2" />

        <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/tabs-report-an-issue.png?maxW=1080&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3c36e060a77fbbee0db6a63f94648c2b" alt="tabs-report-an-issue.png" width="1080" height="570" data-path="images/scraping-automation/web-scraping-ide/faqs/tabs-report-an-issue.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/tabs-report-an-issue.png?w=280&maxW=1080&auto=format&n=ilemiSHw8UogZ13k&q=85&s=7c5f57b29fb7c7f246ddfc5a9a00a55c 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/tabs-report-an-issue.png?w=560&maxW=1080&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a1fb7fa6296d677c8303337a2fc825de 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/tabs-report-an-issue.png?w=840&maxW=1080&auto=format&n=ilemiSHw8UogZ13k&q=85&s=fdce9370073b1b9fa18c8b0dc2a0755b 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/tabs-report-an-issue.png?w=1100&maxW=1080&auto=format&n=ilemiSHw8UogZ13k&q=85&s=7b5c238b36a775d85885e70c7d029267 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/tabs-report-an-issue.png?w=1650&maxW=1080&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d8a2d6d80a52d745f46bbb02f7e45be7 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/faqs/tabs-report-an-issue.png?w=2500&maxW=1080&auto=format&n=ilemiSHw8UogZ13k&q=85&s=fb3a2c954119f2fe1b4e0c4a5b525ff7 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

  <Accordion title="When “reporting an issue”, what information should I include in my report?">
    Please provide the following information when reporting an issue:

    * Select the type of problem you're facing (for example: getting the wrong results/missing data points/the results never loaded/delivery issue/ UI issue/scraper is slow/IDE issue/other)
    * Please describe in detail the problem that you are facing
    * You may upload a file that describes the problem

    After reporting an issue, we'll automatically open a ticket that will be promptly handled by our R\&D Department.
  </Accordion>

  <Accordion title="What is a Data Collector?">
    In the past, we referred to all of our scraping tools as "Collectors." A Collector is essentially a web scraper that consists of both interaction code and parser code. It can operate as an HTTP request or in a real browser, with all requests routed through our unlocker network to prevent blocking.

    Over time, we developed a Dataset Unit that builds on top of one or more Collectors. For example, with a single Collector (direct request), you can scrape a specific URL—such as a product page from an e-commerce site—and receive the parsed data. In more complex scenarios, multiple Collectors can work together, such as when discovering and scraping categories, followed by collecting data on every product within those categories.
  </Accordion>

  <Accordion title="How to Create a Data Collector?">
    You have a few options to create and configure a Data Collector:

    1. Using the Web Scraper IDE:
       You can design and structure your parser as individual Collectors or as a single Collector with multiple steps. To get started:

    * Click on the "Web Data Collection" icon on the right.
    * Navigate to the "My Scrapers" tab.
    * Select the "Develop a Web Scraper (IDE)" button.

    From here, you can build from scratch or explore available templates for guidance.
    Start here: [Create a Data Collector](https://brightdata.com/cp/data_collector/collectors/create)

    2. Requesting a Custom Dataset:
       If you prefer us to handle it, you can request a custom dataset, and we’ll create the Data Collectors needed to deliver it.
       To do this, click on the "Request Datasets" button under the "My Datasets" tab and choose the option that best suits your needs.
       Start here: [Request a Custom Dataset](https://brightdata.com/cp/datasets/requests/services)
  </Accordion>

  <Accordion title="Any system limitations?">
    We have a limitation of **100 parallel-running jobs**. When more than 100 jobs are triggered, the additional jobs are placed in a queue and wait until the earlier ones finish.
     
  </Accordion>

  <Accordion title="How do i use the AI code generator?">
    Overview\
    The goal of this feature is to generate a custom code template tailored to your target website. Simply enter the target URL, and we’ll automatically generate a ready-to-use code template that you can edit or run as needed.\
    \
    How does it work?\
    Simply enter your target URL and click "Generate Code." Once the code is ready, it will appear in the IDE tab - no need to wait around while the AI processes your request. You’ll receive an email notification as soon as the code is ready.\
    \
    Note: This feature works on PDP (Product Detail Page) URLs - when you already know your target URL, it generates parser code accordingly. It is not ideally suited for "Discovery" use cases, where the goal is to find those target URLs.
  </Accordion>
</AccordionGroup>


# null
Source: https://docs.brightdata.com/datasets/functions/features



## Data scraper Dashboard

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/dashboard.png?maxW=1181&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e52e378de622b154c284a895d3aa3a5a" alt="" width="1181" height="581" data-path="images/scraping-automation/web-scraping-ide/features/dashboard.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/dashboard.png?w=280&maxW=1181&auto=format&n=ilemiSHw8UogZ13k&q=85&s=97c706ed1f15e204ad34c55183c55cb0 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/dashboard.png?w=560&maxW=1181&auto=format&n=ilemiSHw8UogZ13k&q=85&s=816d24839faddcad9790e014b4306a85 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/dashboard.png?w=840&maxW=1181&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d59b2cc84852d6f1e260d1aa87399493 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/dashboard.png?w=1100&maxW=1181&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c9ff944d23ec76b5011185a13974bba0 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/dashboard.png?w=1650&maxW=1181&auto=format&n=ilemiSHw8UogZ13k&q=85&s=82a59c260b1bc69703e78c8190ec360e 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/dashboard.png?w=2500&maxW=1181&auto=format&n=ilemiSHw8UogZ13k&q=85&s=faa64ada4449367c583ea9223e75585c 2500w" data-optimize="true" data-opv="2" />
</Frame>

Any scraper you create using a template or a custom scraper will appear on your Data scraper dashboard.

### Overview

* **Free trial**: As part of the 7-day free trial, you're entitled to 1,000-page loads

* **Update available**: A new version of the scraper is available. If there is no update button, you have the latest version.

* **Properties**: This is where you'll see all the scraper properties. [Learn more](/scraping-automation/web-scraper-ide/features#properties)

* **Delivery preferences**: Choose your desired file format, delivery method, and notification settings. [Learn more](/scraping-automation/web-scraper-ide/initiate-collection-and-delivery-options#delivery-options)

* **Output configuration/ Schema**: Here, you can go back to edit your output definitions. [Learn more](/scraping-automation/web-scraper-ide/initiate-collection-and-delivery-options#output-schema)

* **Limitations**  - Our collectors have a limitation of **100 parallel-running jobs**. When more than 100 jobs are triggered, the additional jobs are placed in a queue and wait until the earlier ones finish.
   

***

### Scraper action menu

The scraper action menu allows performing different actions with the scraper.

* **Initiate by API** - start a data collection without having to enter the control panel

* **Initiate manually** - Bright Data's control panel makes it easy to get started collecting data

* **Run on schedule** - select precisely when to collect the data you need

* **Versions** - review the modified versions of the scraper

* **Report an issue** - You can use this form to communicate any problems you have with the platform, the scraper, or the dataset results

* **Copy link** - copy the link of the scraper to share it with your colleagues

* **Tickets** - view the status of your tickets

* **Advanced options:**

  * Edit the code - edit the scraper's code within the IDE.

  * Disable scraper - temporarily disable the scraper, but you can reactivate it if needed.

  * Delete scraper - permanently delete the scraper.

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/action-menu.png?maxW=1665&auto=format&n=ilemiSHw8UogZ13k&q=85&s=ed4071c3e62eb43ddd83d69b81e57fb7" alt="" width="1665" height="737" data-path="images/scraping-automation/web-scraping-ide/features/action-menu.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/action-menu.png?w=280&maxW=1665&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9f54ba834b78c41d9dff5dc6c92b0180 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/action-menu.png?w=560&maxW=1665&auto=format&n=ilemiSHw8UogZ13k&q=85&s=b3134efe67af086aa1f985ae6e5865bd 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/action-menu.png?w=840&maxW=1665&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3fa654668817e49161c33a804fd6d494 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/action-menu.png?w=1100&maxW=1665&auto=format&n=ilemiSHw8UogZ13k&q=85&s=db77371ecbabf41e32bb21944d7b7990 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/action-menu.png?w=1650&maxW=1665&auto=format&n=ilemiSHw8UogZ13k&q=85&s=81aedd3a1c135d923bff002e32f93526 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/action-menu.png?w=2500&maxW=1665&auto=format&n=ilemiSHw8UogZ13k&q=85&s=2467666049f6eb3f2fd2f2a1b07b7324 2500w" data-optimize="true" data-opv="2" />
</Frame>

***

### Properties:

<img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/properties.png?maxW=1605&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a274c50515a9e46efe738a71a7c49d5f" alt="" width="1605" height="446" data-path="images/scraping-automation/web-scraping-ide/features/properties.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/properties.png?w=280&maxW=1605&auto=format&n=ilemiSHw8UogZ13k&q=85&s=656578d6f08275718187297e5c0d6b73 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/properties.png?w=560&maxW=1605&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e0626ef62e37278cb02aecf787675471 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/properties.png?w=840&maxW=1605&auto=format&n=ilemiSHw8UogZ13k&q=85&s=945ef350b7842ceada1fa32e983d46b1 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/properties.png?w=1100&maxW=1605&auto=format&n=ilemiSHw8UogZ13k&q=85&s=71e433593d1dfbb1139e96447caad7e4 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/properties.png?w=1650&maxW=1605&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6a0b3cf8c191ef02e87399b5605a0fe2 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/properties.png?w=2500&maxW=1605&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0a8b15f67eaa62750bcdc3b98418336a 2500w" data-optimize="true" data-opv="2" />

* Maintainer of the scraper :

  * Self-serve: scraper is maintained by you

  * Full-service: scraper is maintained by Bright Data Developers

* Type of the scraper :

  * Search : The scraper input is a keyword (i.e., iPhone)

  * PDP : The scraper input is a product page URL

  * Discovery : The scraper input is a category URL

  * Other

* Use case of the scraper (Social media, eCommerce, Travel, etc.)

* Last modified : indicates when the scraper was last updated

* Price of CPM : 1 CPM = 1,000 page loads.

* Avg. Page-load per input : Average number of loaded pages to process 1 input set

## Initiate scraper and get collection results

**Initiate scraper**

To start collecting the data, you have three options:

A. [Initiate by API](/scraping-automation/web-scraper-ide/initiate-collection-and-delivery-options#initiate-scraper)
B. [Initiate manually](/scraping-automation/web-scraper-ide/initiate-collection-and-delivery-options#initiate-scraper)
C. [Schedule a scraper](/scraping-automation/web-scraper-ide/initiate-collection-and-delivery-options#initiate-scraper)

<img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/options.png?maxW=1655&auto=format&n=ilemiSHw8UogZ13k&q=85&s=ce2c93ccebaa9d4dd1de62ad06f38d80" alt="" width="1655" height="561" data-path="images/scraping-automation/web-scraping-ide/features/options.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/options.png?w=280&maxW=1655&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0738fe5f09ba2591d503def6e506cdf2 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/options.png?w=560&maxW=1655&auto=format&n=ilemiSHw8UogZ13k&q=85&s=62e6b8f92689db3db6a927b92ebeca45 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/options.png?w=840&maxW=1655&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0dd889c17534967c90f3088320af264f 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/options.png?w=1100&maxW=1655&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e2ee36e26bffb2e5bd795b8bc4065420 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/options.png?w=1650&maxW=1655&auto=format&n=ilemiSHw8UogZ13k&q=85&s=14d5cf78162677b9be3c3fed6f22092f 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/options.png?w=2500&maxW=1655&auto=format&n=ilemiSHw8UogZ13k&q=85&s=80b0cb30888f3e7f1ed0c346851cad16 2500w" data-optimize="true" data-opv="2" />

**Get collection results**

Once the data collection is completed, click the "three dots" icon and select "Statistics" to access the results and download the data.

<Note>Realtime job input and output cannot be downloaded since it is not stored on our end</Note>

## Statistics

<img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics.png?maxW=1632&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f524273df5011dfe7fa79c4b00b56bb8" alt="" width="1632" height="571" data-path="images/scraping-automation/web-scraping-ide/features/statistics.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics.png?w=280&maxW=1632&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d4c120a83a9448f490eec57867304ff0 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics.png?w=560&maxW=1632&auto=format&n=ilemiSHw8UogZ13k&q=85&s=8a8141e7267df82a66121eeec9d22c5b 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics.png?w=840&maxW=1632&auto=format&n=ilemiSHw8UogZ13k&q=85&s=22e325b3401ca42d97268dd387fde5ee 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics.png?w=1100&maxW=1632&auto=format&n=ilemiSHw8UogZ13k&q=85&s=789bde4bfe638127f8c7424c69ac9c53 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics.png?w=1650&maxW=1632&auto=format&n=ilemiSHw8UogZ13k&q=85&s=17b58713c82d9cfd20ae29a583adc6e1 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics.png?w=2500&maxW=1632&auto=format&n=ilemiSHw8UogZ13k&q=85&s=ce002b5f24b63f68a8def444c799bf1e 2500w" data-optimize="true" data-opv="2" />
The statistics page presents essential information about the success of the data collection. Below is a list of all the terms included in the statistics table:

**Statistics actions menu**
<img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics-action-menu.png?maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=dd1ddbed895013848ee9ffd7cb7c6c8e" alt="" width="1672" height="454" data-path="images/scraping-automation/web-scraping-ide/features/statistics-action-menu.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics-action-menu.png?w=280&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3e2475ca5c43e6cf4f7e0bb428906bef 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics-action-menu.png?w=560&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=b2663d56f5c8f80dcf84f19230b4be06 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics-action-menu.png?w=840&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=8fb326bd678c873fe466e8fe01d31ef5 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics-action-menu.png?w=1100&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0f1bf54fe2bba1f5d89f582a501dc6d9 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics-action-menu.png?w=1650&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=b436ade9b5f944e922114ac59f5181ef 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/statistics-action-menu.png?w=2500&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f178a128fe51af11f6b1f45c7abfe01f 2500w" data-optimize="true" data-opv="2" />

* **3 dots**
  Here you can perform different functions with the data collection job:
  The statistics page presents essential information about the success of the data collection. Below is a list of all the terms included in the statistics table:

<img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/collector-runs.png?maxW=1716&auto=format&n=ilemiSHw8UogZ13k&q=85&s=00c048759fe4ace38b3b18f0b18d91aa" alt="" width="1716" height="270" data-path="images/scraping-automation/web-scraping-ide/features/collector-runs.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/collector-runs.png?w=280&maxW=1716&auto=format&n=ilemiSHw8UogZ13k&q=85&s=2a855766643ec351e2c9dad41e86a486 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/collector-runs.png?w=560&maxW=1716&auto=format&n=ilemiSHw8UogZ13k&q=85&s=765222973d85cf4d5b1650e6b50b4cc2 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/collector-runs.png?w=840&maxW=1716&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d5f759e5d6a47df494a81eb7a164ffa4 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/collector-runs.png?w=1100&maxW=1716&auto=format&n=ilemiSHw8UogZ13k&q=85&s=69a350282b1cb7fa550b5f9c29e2e39c 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/collector-runs.png?w=1650&maxW=1716&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3f91838f78bf5ad6b763fdacf3b905d7 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/collector-runs.png?w=2500&maxW=1716&auto=format&n=ilemiSHw8UogZ13k&q=85&s=4415f1869768bdd6e547beada3960660 2500w" data-optimize="true" data-opv="2" />

* **Job ID** - The unique id of the collection

* **Trigger** - The person who initiated the data collection and how (API, manually or scheduled)

* **Inputs** - The number of inputs inserted into the collection

* **Records** - The number of results collected

* **Failed** - The number of pages failed to be crawled

* **Success rate** - The percentage of the results that were successfully collected

* **Queued at** - The queue timestamp

* **Started at** - The date and time when the scraper began collecting

* **Finished at** - The date and time when the scraper finished collecting

* **Job time** - The length of time it took to complete

* **Estimated time left** - The amount of time left until collection is complete

* **Queue** - The name of the job given in the trigger behavior (Queue name)

* **Usage** - The total amount of page loads used

<img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/three-dots.png?maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3573d2c4bbfd8ef1645557d1738f1ef9" alt="" width="1672" height="454" data-path="images/scraping-automation/web-scraping-ide/features/three-dots.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/three-dots.png?w=280&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=64f0a0a297ae33cb3ea65b159c64e1d5 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/three-dots.png?w=560&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3a142f0d51de4598ed4ef2708e7ed47b 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/three-dots.png?w=840&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e8fbe123e04d78281e7d64bb1ead1a7d 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/three-dots.png?w=1100&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a2eab5e7a5d01ecb89ae9148b6c9f15b 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/three-dots.png?w=1650&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3a4648b5d26fd419ee61e78fd1203606 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/features/three-dots.png?w=2500&maxW=1672&auto=format&n=ilemiSHw8UogZ13k&q=85&s=2717b8fa55a3fe1dc67657d5bc079bf3 2500w" data-optimize="true" data-opv="2" />


# null
Source: https://docs.brightdata.com/datasets/functions/functions



## Interaction Functions

This article lists and explains the available commands within the Interaction code for writing a scraper using the IDE.

<Note>
  Commands marked with a star **⭐** are proprietary functions developed by Bright Data.
</Note>

### `bad_input`

Mark the scraper input as bad. Will prevent any crawl retries `error_code=bad_input`

```js
bad_input();
bad_input('Missing search term');
```

***

### `blocked`

Mark the page as failed because of the website refusing access (error\_code=blocked)

```js
blocked();
blocked('Login page was shown');
```

***

### ⭐ `bounding_box`

The box of coordinates that describes the area of an element (relative to the page, not the browser viewport). Only the first element matched will be measured

* `selector`: A valid CSS selector for the element

```js
let box = bounding_box('.product-list');
// box == {
//   top: 10,
//   right: 800,
//   bottom: 210,
//   left: 200,
//   x: 200,
//   y: 10,
//   width: 600,
//   height: 200,
// }
```

***

### ⭐ `browser_size`

Returns current browser window size

```js
TBD
```

***

### ⭐ `capture_graphql`

Capture and replay graphql requests with changed variables

* options: Params to control graphql request to capture
  * url
  * payload

<CodeGroup>
  ```js Example #1
  let q = capture_graphql({
      payload: {id: 'ProfileQuery'},
      // you may need to pass url opt as RegExp in case when 
      // graphql endpoint is not "*/graphql" which is default value
      // url: /\bgraphql\b/ // default
  });

  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);
  ```

  ```js Example #2
  let q = capture_graphql({
      payload: {id: 'ProfileQuery'},
      // you may need to pass url opt as RegExp in case when 
      // graphql endpoint is not "*/graphql" which is default value
      // url: /\bgraphql\b/ // default
  });

  navigate('https://example.com');

  if (!q.is_captured())
      click('#load_more');

  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);
  ```
</CodeGroup>

***

### ⭐ `click`

Click on an element (will wait for the element to appear before clicking on it)

* `selector`: Element selector

```js
click('#show-more');
$('#show-more').click()
// Click the closest match to the passed coordinates
// (relative to the page).
// For example, clicking the center pin in 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});
```

***

### ⭐ `close_popup`

Popups can appear at any time during a crawl and it's not always clear when you should be waiting for or closing them. Add `close_popup()` at the top of your code to add a background watcher that will close the popup when it appears. If a popup appears multiple times, it will always be closed

* popup selector: A valid CSS selector
* close selector: A valid CSS selector
* options: `click_inside`: selector of parent iframe which contains close button selector

```js
close_popup('.popup', '.popup_close');
close_popup('iframe.with-popup', '.popup_close', {click_inside: 'iframe.with-popup'});
```

***

### `collect`

Adds a line of data to the dataset created by the crawler

**syntax**: `collect(<data_line>[, <validate_fn>]);`

* `data_line`: A object with the fields you want to collect
* `validate_fn`: Optional function to check that the line data is valid

```js
collect({price: data.price});
collect(product, p=>{
    if (!p.title)
        throw new Error('Product is missing a title');
})
```

***

### `console`

Log messages from the interaction code

```js
console.log(1, 'brightdata', [1, 2], {key: value});
console.error(1, 'brightdata', [1, 2], {key: value});
```

***

### `country`

Configure your crawl to run from a specific country
**syntax**: `country(<code>);`

* `code`: 2-character ISO country code

```js
country('us');
```

***

### `dead_page`

Mark a page as a dead link so you can filter it from your future collections `error_code=dead_page`

```js
dead_page();
dead_page('Product was removed');
```

***

### ⭐ `detect_block`

Detects a block on the page

* `resource`: An object specifying the resource required for the detection
  * `selector`
* `condition`: An object specifying how the resource should be processed for detection
  * `exists`
  * `has_text`

```js
detect_block({selector: '.foo'}, {exists: true});
detect_block({selector: '.bar'}, {has_text: 'text'});
detect_block({selector: '.baz'}, {has_text: /regex_pattern/});
```

***

### ⭐ `disable_event_listeners`

Stop all event listeners on the page from running. `track_event_listeners()` must have been called first

* `event_types`: Specific event types that should be disabled

```js
disable_event_listeners();
disable_event_listeners(['hover', 'click']);
```

***

### `el_exists`

Check if an element exists on page, and return a boolean accordingly

* `selector`: Valid CSS selector
* `timeout`: Timeout duration to wait for the element to appear on the page

```js
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 element is visible on page

* selector: Valid CSS selector
* timeout: Timeout duration to wait for the element to be visible on the page

```js
el_is_visible('#example');
el_is_visible('.is_not_visible', 5e3); // false (after 5 seconds)
```

***

### `embed_html_comment`

Add a comment in the page HTML. Can be used to embed metadata inside HTML snapshots.

* `comment`: Body of the comment

```js
embed_html_comment('trace-id: asdf123');
```

***

### ⭐ `font_exists`

Assert the capability of the browser to render the given font family on the page
**syntax**: `font_exists(<font-family>);`

```js
font_exists('Liberation Mono');
```

***

### ⭐ `freeze_page`

Force the page to stop making changes. This can be used to save the page in a particular state so page snapshots that run after crawl won't see a different page state than you see now. This command is experimental. If you see problems, please report them to support

```js
freeze_page();
```

***

### ⭐ `hover`

hover on an element (will wait for the element to appear before hovering on it)
**syntax**: `hover(<selector>);`

* `selector`: Element selector

```js
hover('#item');
```

***

### ⭐ `html_capture_options`

Influence the process of the HTML capturing

* `options`: An object which accepts options defining how HTML capturing should be processed
  * `coordinate_attributes`

```js
html_capture_options({
    coordinate_attributes: true,
});
```

***

### `Image`

Collect image data

* `src`: Image URL or data:image URI string

```js
let i = new Image('https://example.com/image.png');
collect({image: i});
```

***

### `input`

Global object available to the interaction code. Provided by trigger input or `next_stage()` calls

```js
navigate(input.url);
```

***

### `job`

Global object available to the interaction code. Provided by trigger input or `next_stage()` calls

```js
let {created} = job;
```

***

### `load_html`

Load html and return Cheerio instance

* `html`: Any HTML string

```js
let $$ = load_html('<p id="p1">p1</p><p id="p2">p2</p>');
collect({data: $$('#p2').text()});
```

***

### ⭐ `load_more`

Scroll to the bottom of a list to trigger loading more items. Useful for lazy-loaded infinite-scroll sites

* `selector`: Selector for the element that contains the lazy-loaded items

```js
load_more(<selector>);
load_more('.search-results');
load_more('.search-results', {children: '.result-item', trigger_selector: '.btn-load-more', timeout: 10000});
```

***

### `load_sitemap`

Read a list of urls from a sitemap xml (supports sitemap indexes, and .gz compressed sitemaps. see examples.)

```js
let {pages} = load_sitemap({url: 'https://example.com/sitemap.xml.gz'});
let {children} = load_sitemap({url: 'https://example.com/sitemap-index.xml'});
```

***

### `location`

Object with info about current location. Available fields: href

```js
navigate('https://example.com');
location.href; // "https://example.com/"
```

***

### Money

Collect price/money data

* `value`: Amount of money
* `currency`: Currency code

```js
let p = new Money(10, 'USD');
collect({product_price: p});
```

***

### ⭐ `mouse_to`

Move the mouse to the specified (x,y) position
**syntax**: `mouse_to(<x>, <y>);`

* `x`: Target x position
* `y`: Target y position

```js
mouse_to(0, 0);
```

***

### `navigate`

Navigate the browser to a URL
**syntax**: `navigate(<url>);`

* A 404 status code will throw a `dead_page` error by default. Use opt.`allow_status` to override this
* `url`: A URL to navigate to
* `opt`: navigate options (see examples)

```js
navigate(input.url);
navigate('https://example.com');

// waits until DOM content loaded event is fired in the browser
navigate(`url`, {wait_until: 'domcontentloaded'}); 

// adds a referer to the navigation
navigate(`url`, {referer: `url`}); 

// the number of milliseconds to wait for. Default is 30000 ms
navigate(`url`, {timeout: 45000}); 

// Don't throw an error if this URL sends a 404 status code
navigate(`url`, {allow_status: [404]});

// Specify browser width/height
navigate(`url`, {
    fingerprint: {screen: {width: 400, height: 400}},
});
```

***

### `next_stage`

Run the next stage of the crawler with the specified input

* `input`: Input object to pass to the next browser session

```js
next_stage({url: 'http://example.com', page: 1});
```

***

### `parse`

Parse the page data

```js
let page_data = parse();
collect({
    title: page_data.title,
    price: page_data.price,
});
```

***

### `preserve_proxy_session`

Preserve proxy session across children of this page

```js
preserve_proxy_session();
```

***

### ⭐ `press_key`

Type special characters like Enter or Backspace in the currently focused input (usually used after typing something in a search box)

```js
press_key('Enter');
press_key('Backspace');
```

***

### ⭐ `proxy_location`

Configure your crawl to run from a specific location. Unless you need high resolution control over where your crawl is running from, you probably want to use `country(code)` instead

* `configuration`: Object with a desired proxy location, check examples for more info

```js
proxy_location({country: 'us'});

// lat in range: [-85, 85], long in range: [-180, 180]
proxy_location({lat: 37.7749, long: 122.4194}); 

// radius in km
proxy_location({lat: 37.7749, long: 122.4194, country: 'US', radius: 100}); 
```

***

### ⭐ `redirect_history`

Returns history of URL redirects since last navigate

```js
navigate('http://google.com');
let redirects = redirect_history();
// returns:
// [
//   'http://google.com',
//   'http://www.google.com',
//   'https://www.google.com/',
// ]
```

***

### `rerun_stage`

Run this stage of the crawler again with new input

```js
rerun_stage({url: 'http://example.com/other-page'});
```

***

### `resolve_url`

Returns the final URL that the given url argument leads to

* `url`: URL string/instance

```js
let {href} = parse().anchor_elem_data;
collect({final_url: resolve_url(href)});
```

***

### `response_headers`

Returns the response headers of the last page load

```js
let headers = response_headers();
console.log('content-type', headers['content-type']);
```

***

### `request`

Make a direct HTTP request

* `url` | `options`: the url to make the request to, or request options (see examples)

```js
let res = request('http://www.example.com');
let res = request({url: 'http://www.example.com', method: 'POST', headers: {'Content-type': 'application/json'}, body: {hello: 'world'}})
```

***

### ⭐ `right_click`

The same as click but use right mouse button instead (will wait for the element to appear before clicking on it)
**syntax**: `right_click(<selector>);`

* `selector`: Element selector

```js
right_click('#item');
```

***

### `run_stage`

Run a specific stage of the crawler with a new browser session

* stage: Which stage to run (1 is first stage)
* input: Input object to pass to the next browser session

```js
run_stage(2, {url: 'http://example.com', page: 1});
```

***

### ⭐ `scroll_to`

Scroll the page so that an element is visible.If you're doing this to trigger loading some more elements from a lazy loaded list, use `load_more()`. Defaults to scrolling in a natural way, which may take several seconds. If you want to jump immediatley, use `{immediate: true}`
**syntax**: `scroll_to(<selector>);`

* `selector`: Selector of the element you want to scroll to

```js
scroll_to('.author-profile');
scroll_to('top'); // scroll to the top of the page
scroll_to('bottom'); // scroll to the bottom of the page
scroll_to('top', {immediate: true}); // jump to top of page immediately
```

***

### ⭐ `scroll_to_all`

Scroll through the page so that all the elements matching the selector will be visible on screen
**syntax**: `scroll_to_all(<selector>);`

* `selector`: Selector of the elements you want to scroll through

```js
scroll_to_all('.author-profiles');
```

***

### ⭐ `select`

Pick a value from a select element
**syntax**: `select(<select>, <value>);`

* `selector`: Element selector

```js
select('#country', 'Canada');
```

***

### `set_lines`

An array of lines to add to your dataset at the end of this page crawl. Each call to `set_lines()` will override previous ones, and only the last set of lines will be added into the dataset (tracked per page crawl). This is a good fit when the scraper is set to collect partial on errors. You can keep calling `set_lines()` with the data you gathered so far, and the last call will be used if the page crawl throws an error
**syntax**: `set_lines(<data_line>[, <validate_fn>]);`

* `lines`: An array of data lines to add to your final dataset
* `validate_fn`: Optional function to check that the line data is valid (run once per line)

```js
set_lines(products_so_far);
set_lines(products_so_far, i=>{
    if (!i.price)
        throw new Error('Missing price');
});
```

***

### `set_session_cookie`

Sets a cookie with the given cookie data; may overwrite equivalent cookies if they exist

```js
set_session_cookie(`domain`, `name`, `value`);
```

***

### `set_session_headers`

Set extra headers for all the HTTP requests

* `headers`: Object with extra headers in key-value format

```js
set_session_headers({'HEADER_NAME': 'HEADER_VALUE'});
```

***

### ⭐ `solve_captcha`

Solve any captchas shown on the page

```js
solve_captcha();
solve_captcha({type: 'simple', selector: '#image', input: '#input'});
```

***

### `status_code`

Returns the status code of the last page load

```js
collect({status_code: status_code()});
```

***

### ⭐ `tag_all_responses`

Save the responses from all browser request that match

* `field`: The name of the tagged field
* `pattern`: The URL pattern to match
* `options`: Set options.jsonp=true to parse response bodies that are in jsonp format. This will be automatically detected when possible

```js
tag_all_responses(<field>, <pattern>, <options>);
tag_all_responses('resp', /url/, {jsonp: true});
tag_all_responses('resp', /url/, {allow_error: true});
tag_all_responses('profiles', /\/api\/profile/);
navigate('https://example.com/sports');
let profiles = parse().profiles;
for (let profile of profiles)
    collect(profile);
```

***

### ⭐ `tag_download`

Allows to get files downloaded by browser

* `url`: A pattern or a string to match requests against

```js
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_image`

Save the image url from an element

* field: The name of the tagged field
* selector: A valid CSS selector

```js
tag_image(field, selector);
tag_image('image', '#product-image');
```

***

### ⭐ `tag_response`

Save the response data from a browser request
**syntax**: `tag_response(<field>, <pattern>, <options>);`

* `name`: The name of the tagged field
* `pattern`: The URL pattern to match
* `options`: Set options.jsonp=true to parse response bodies that are in jsonp format. This will be automatically detected when possible

```js
tag_response('resp', /url/, {jsonp: true});
tag_response('resp', /url/, {allow_error: true});
tag_response('resp', (req, res)=>{
            if (req.url.includes('/api/'))
            {
                let request_body = req.body;
                let request_headers = req.headers;
                let response_body = res.body;
                let 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_screenshot`

Save a screenshot of the page HTML
**syntax**: `tag_screenshot(<field>, <options>);`

* field: The name of the tagged field
* options: Download options (see example)

```js
tag_screenshot('html_screenshot', {filename: 'screen'});
tag_screenshot('view', {full_page: false}); // full_page defaults to true
```

***

### ⭐ `tag_script`

Extract some JSON data saved in a script on the page

**syntax**: `tag_script(<field>, <selector>);`

* name: The name of the tagged script
* selector: The selector of the script to tag

```js
tag_script('teams', '#preload-data');
tag_script('ssr_state', '#__SSR_DATA__');
navigate('https://example.com/');
collect(parse().ssr_state);
```

***

### ⭐ `tag_serp`

Parse the current page as a search engine result page

* `field`: The name of the tagged field
* `type`: Parser type: (e.g. bing, google)

```js
tag_serp('serp_bing_results', 'bing')
tag_serp('serp_google_results', 'google')
```

***

### ⭐ `tag_video`

Save the video url from an element

* `field`: The name of the tagged field
* `selector`: A valid CSS selector
* `opt`: download options (see example)

```js
tag_video(field, selector);
tag_video('video', '#product-video', {download: true});
```

***

### ⭐ `tag_window_field`

Tag a js value from the browser page

* `field`: The path to the relevant data

```js
tag_window_field(field, key);
tag_window_field('initData', '__INIT_DATA__');
```

***

### ⭐ `track_event_listeners`

Start tracking the event listeners that the browser creates. It's needed to run `disable_event_listeners()` later

```js
track_event_listeners();
```

***

### ⭐ `type`

Enter text into an input (will wait for the input to appear before typing)

* `selector`: Element selector
* `text`: Text to enter

```js
type(<selector>, <text>);
type('#location', 'New York');

// replacing text in input if it is not empty
type(<selector>, <text>, {replace: true}); 

// type text to an element with id ending "input-box" (e.g. <input id="c2E57-input-box">)
type('[id$=input-box]', <text>); 

// dispatching 'Enter' key press
type(<selector>, ['Enter']); 

// typing text and then dispatching 'Enter' key press
type(<selector>, ['Some text', 'Enter']); 

// deleting 1 char from input
type(<selector>, ['Backspace']); 
```

***

### `URL`

URL class from NodeJS standard "url" module

* `url`: URL string

```js
let u = new URL('https://example.com');
```

***

### ⭐ `verify_requests`

Monitor failed requests with a callback function

* `callback`: A function which will be called on each failed request with an object in format: `{url, error, type, response}`

```js
verify_requests(({url, error, type, response})=>{
    if (response.status!=404 && type=='Font')
        throw new Error('Font failed to load');
});
```

***

### `Video`

Collect video data

* `src`: Video URL

```js
let v = new Video('https://example.com/video.mp4');
collect({video: v});
```

***

### ⭐ `wait`

Wait for an element to appear on the page

* `selector`: Element selector
* `opt`: wait options (see examples)

```js
wait(<selector>);
wait('#welcome-splash');
wait('.search-results .product');
wait('[href^="/product"]');

// the number of milliseconds to wait for. Default is 30000 ms
wait(<selector>, {timeout: 5000}); 

// wait for element to be hidden
wait(<selector>, {hidden: true}); 

// wait for element inside in an iframe
wait(<selector>, {inside: '#iframe_id'}); 
```

***

### ⭐ `wait_any`

Wait for any matching condition to succeed

```js
wait_any(['#title', '#notfound']);
```

***

### `wait_for_parser_value`

Wait for a parser field to contain a value. This can be useful after you click something to wait for some data to appear

* `field`: The parser value path to wait on
* `validate_fn`: An optional callback function to validate that the value is correct
* `opt`: Extra options (e.g. timeout)

```js
wait_for_parser_value(<field>[, <validate_fn>][, opt]);
wait_for_parser_value('profile');
wait_for_parser_value('listings.0.price', v=>{
            return parseInt(v)>0;
        }, {timeout: 5000});
```

***

### ⭐ `wait_for_text`

Wait for an element on the page to include some text

* `selector`: Element selector
* `text`: The text to wait for

```js
wait_for_text(<selector>, <text>);
wait_for_text('.location', 'New York');
```

***

### ⭐ `wait_hidden`

Wait for an element to not be visible on the page (removed or hidden)

* `selector`: Element selector

```js
wait_hidden(<selector>);
wait_hidden('#welcome-splash');
wait_hidden(<selector>, {timeout: 5000});
```

***

### ⭐ `wait_network_idle`

Wait the browser network has been idle for a given time

* `timeout`: Wait for browser network to be idle for X milliseconds
* `options`: ignore: an array of patterns to exclude requests from monitoring timeout: how long the network needs to be idle in milliseconds (default 500)

```js
wait_network_idle();
wait_network_idle({
    timeout: 1e3,
    ignore: [/long_request/, 'https://example.com'],
});
```

***

### ⭐ `wait_page_idle`

Wait until no changes are being made on the DOM tree for a given time

* `timeout`: Milliseconds to wait for no changes
* `options`: An object, which can accept a ignore argument to exclude some elements from monitoring

```js
wait_page_idle();
wait_page_idle({
    ignore: [<selector1>, <selector2>],
    idle_timeout: 1000,
});
```

***

### ⭐ `wait_visible`

Wait for an element to be visible on the page

* `selector`: Element selector

```js
wait_visible(<selector>);
wait_visible('#welcome-splash');
wait_visible(<selector>, {timeout: 5000});
```

***

### `$`

Helper for jQuery-like expressions

* `selector`: Element selector

```js
$(<selector>);
wait($('.store-card'))
```

***

### `Clicking on selector based on text`

Helper for jQuery-like expressions

* `selector`: Element selector

```js
$('.selector').filter_includes('text').click()
```

### ⭐ `emulate_device`

View pages as a mobile device. This command will change user agent and screen parameters (resolution and device pixel ratio)

* `device`: A string with the name of device

```js
emulate_device('iPhone X');
emulate_device('Pixel 2');
```

<Accordion title="Here is the full list of device names">
  * Blackberry PlayBook
  * Blackberry PlayBook landscape
  * BlackBerry Z30
  * BlackBerry Z30 landscape
  * Galaxy Note 3
  * Galaxy Note 3 landscape
  * Galaxy Note II
  * Galaxy Note II landscape
  * Galaxy S III
  * Galaxy S III landscape
  * Galaxy S5
  * Galaxy S5 landscape
  * Galaxy S8
  * Galaxy S8 landscape
  * Galaxy S9+
  * Galaxy S9+ landscape
  * Galaxy Tab S4
  * Galaxy Tab S4 landscape
  * iPad
  * iPad landscape
  * iPad (gen 6)
  * iPad (gen 6) landscape
  * iPad (gen 7)
  * iPad (gen 7) landscape
  * iPad Mini
  * iPad Mini landscape
  * iPad Pro
  * iPad Pro landscape
  * iPad Pro 11
  * iPad Pro 11 landscape
  * iPhone 4
  * iPhone 4 landscape
  * iPhone 5
  * iPhone 5 landscape
  * iPhone 6
  * iPhone 6 landscape
  * iPhone 6 Plus
  * iPhone 6 Plus landscape
  * iPhone 7
  * iPhone 7 landscape
  * iPhone 7 Plus
  * iPhone 7 Plus landscape
  * iPhone 8
  * iPhone 8 landscape
  * iPhone 8 Plus
  * iPhone 8 Plus landscape
  * iPhone SE
  * iPhone SE landscape
  * iPhone X
  * iPhone X landscape
  * iPhone XR
  * iPhone XR landscape
  * iPhone 11
  * iPhone 11 landscape
  * iPhone 11 Pro
  * iPhone 11 Pro landscape
  * iPhone 11 Pro Max
  * iPhone 11 Pro Max landscape
  * iPhone 12
  * iPhone 12 landscape
  * iPhone 12 Pro
  * iPhone 12 Pro landscape
  * iPhone 12 Pro Max
  * iPhone 12 Pro Max landscape
  * iPhone 12 Mini
  * iPhone 12 Mini landscape
  * iPhone 13
  * iPhone 13 landscape
  * iPhone 13 Pro
  * iPhone 13 Pro landscape
  * iPhone 13 Pro Max
  * iPhone 13 Pro Max landscape
  * iPhone 13 Mini
  * iPhone 13 Mini landscape
  * JioPhone 2
  * JioPhone 2 landscape
  * Kindle Fire HDX
  * Kindle Fire HDX landscape
  * LG Optimus L70
  * LG Optimus L70 landscape
  * Microsoft Lumia 550
  * Microsoft Lumia 950
  * Microsoft Lumia 950 landscape
  * Nexus 10
  * Nexus 10 landscape
  * Nexus 4
  * Nexus 4 landscape
  * Nexus 5
  * Nexus 5 landscape
  * Nexus 5X
  * Nexus 5X landscape
  * Nexus 6
  * Nexus 6 landscape
  * Nexus 6P
  * Nexus 6P landscape
  * Nexus 7
  * Nexus 7 landscape
  * Nokia Lumia 520
  * Nokia Lumia 520 landscape
  * Nokia N9
  * Nokia N9 landscape
  * Pixel 2
  * Pixel 2 landscape
  * Pixel 2 XL
  * Pixel 2 XL landscape
  * Pixel 3
  * Pixel 3 landscape
  * Pixel 4
  * Pixel 4 landscape
  * Pixel 4a (5G)
  * Pixel 4a (5G) landscape
  * Pixel 5
  * Pixel 5 landscape
  * Moto G4
  * Moto G4 landscape
</Accordion>

***

## Parser Functions

This article lists and explains the available commands within the Parser code for writing a scraper using the IDE.

### `input`

Global variable available to the parser code

```js
let url = input.url;
```

***

### `$`

An instance of cheerio

```js
$('#example').text();
$('$example').attr('href');
$('#example').text_sane(); /* This is like $().text() but also trims text and replace all space characters with single space "a b \t\n\n c" -> "a b c" */
```

<Tip>
  Find more information on the [cheerio website](https://cheerio.js.org/).
</Tip>

***

### `location`

A global variable available to the parser code. Object with info about current location

```js
let current_url = location.href; 
```

***

### `Image`

Collect image data

```js
let i = new Image('https://example.com/image.png');
collect({image: i});
```

***

### `Video`

Collect video data

```js
let v = new Video('https://example.com/video.mp4');
collect({video: v});
```

***

### `Money`

Collect price/money data

```js
let p = new Money(10, 'USD');
collect({product_price: p});
```

###


# Get to know the IDE interface
Source: https://docs.brightdata.com/datasets/functions/get-to-know-the-IDE-interface

This article reviews the interface components of our IDE that is especially designed for web scraping purposes, and the interface components of the control panel (dashboard) from which you can manage your scrapers (scrapers).

## The IDE

This is where you write your JavaScript code. Learn more about [The basics of Web Scraping](/scraping-automation/web-scraper-ide/basics-of-web-scraping).

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/ide-interface.png?maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=eade7b9ad79e67e2b94983852ff45e9f" alt="" width="1600" height="883" data-path="images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/ide-interface.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/ide-interface.png?w=280&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=242e5ed9aac718735a0352dc03502882 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/ide-interface.png?w=560&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=bd2c63d8a79037ef1eb8da280bcd7ad5 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/ide-interface.png?w=840&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=5c1c98291ea47c52ad0a571bb54ead78 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/ide-interface.png?w=1100&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=85a5108426392882142e1075bd79e143 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/ide-interface.png?w=1650&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=09bc22e97cfce261cce1cccdbcde6ca3 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/ide-interface.png?w=2500&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=00710e1342c5c41413c7f3cb36d3894e 2500w" data-optimize="true" data-opv="2" />
</Frame>

**A: See more examples**

* Examples of template code that our scraper engineers built.

**B: Add another step (stage)**

* It is useful to add stages when you want to collect data from multiple pages. For example, in case you want to collect all products from Amazon search result page and details of all collected products. You can navigate the search result page on 1st stage to collect all product URLs and pass them to 2nd stage to navigate each product page.
* `next_stage`, `run_stage` commands are available to interact between stages.

**C: Help**

* List of available functions, functions explanation and examples of usage. Learn more about [Interaction functions](/scraping-automation/web-scraper-ide/functions#interaction-functions) and [Parser functions](/scraping-automation/web-scraper-ide/functions#parser-functions).

{/* TODO: Add this content to current docs */}

**D: Debugging Tabs**

* Input : Define your input parameters and run a test (preview) with an input set
* Output : List of collected data
* Children : List of children which will be input sets of the next stage
* Run log : Code execution log
* Browser console : scraper browser console logs \[browser > developer tool > 'console tab']
* Browser network : scraper browser network logs \[browser > developer tool > 'network tab']
* Last errors : List of latest error information

**E: Input**

* Add input parameter : Define an input parameter including its name and type
* Add another input : Add the value of an input set to test
* Preview : Run a test with a selected input set

**F: Code settings**

* Error mode : Set a code behavior of the scraper error case
* Take screenshot : Take screenshots during preview test. You will be able to check loaded pages during the test.

## Dashboard - scraper action menu

The collescraperctor action menu allows performing different actions with the scraper.

* **Initiate by API** - start a data collection without having to enter the control panel
* **Initiate manually** - Bright Data's control panel makes it easy to get started collecting data
* **Run on schedule** - select precisely when to collect the data you need
* **Versions** - review the modified versions of the scraper
* **Report an issue** - You can use this form to communicate any problems you have with the platform, the scraper, or the dataset results
* **Copy link** - copy the link of the scraper to share it with your colleagues
* **Tickets** - view the status of your tickets
* **Advanced options:**
  * Edit the code - edit the scraper's code within the IDE.
  * Disable scraper - temporarily disable the scraper, but you can reactivate it if needed.
  * Delete scraper - permanently delete the scraper.

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/dashboard-action-menu.png?maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a04fd69588257256de6fedbe8e1216dd" alt="" width="1600" height="708" data-path="images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/dashboard-action-menu.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/dashboard-action-menu.png?w=280&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=95be121b1714262e24b9b395ad1f0a57 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/dashboard-action-menu.png?w=560&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=8a269cf593d132e9c4631694b728a0bf 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/dashboard-action-menu.png?w=840&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=cb41b91e116766937b7e26d9b05dd845 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/dashboard-action-menu.png?w=1100&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f4b76b18d40da7d6886df528f73781c9 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/dashboard-action-menu.png?w=1650&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=49cebf7aaf70fc42a94eafdef8c51fe9 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/get-to-know-the-IDE-interface/dashboard-action-menu.png?w=2500&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d27ea77c04b50115fcd92f228b2def85 2500w" data-optimize="true" data-opv="2" />
</Frame>


# Initiate Data Collection & Delivery with IDE Scraper
Source: https://docs.brightdata.com/datasets/functions/initiate-collection-and-delivery-options

Learn how to initiate data collection and set up delivery options using the IDE Scraper. Explore manual, API, and scheduled methods for efficient data scraping.

When writing a scraper code on the IDE, the system auto-saves the scraper as a draft to the development environment. From inside the IDE, you can run one page at a time to sample how your scraper will behave. To get a full production run, you need to save scraper to production by clicking the 'Save to production' button at the top right corner of the IDE screen. All scrapers will appear under the **My scrapers** tab in the control panel. Any inactive scraper will be shown in a faded state.

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/my-scrapers.png?maxW=1317&auto=format&n=ilemiSHw8UogZ13k&q=85&s=bccb3a3546657c5159455050c4966696" alt="" width="1317" height="831" data-path="images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/my-scrapers.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/my-scrapers.png?w=280&maxW=1317&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f1969fdc336883c7184a1b5a8844bb96 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/my-scrapers.png?w=560&maxW=1317&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c8b9c251f9910a78be49b6d999eb3b6d 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/my-scrapers.png?w=840&maxW=1317&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6b14ed5ac6f8bf230cc266d21b7b0b69 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/my-scrapers.png?w=1100&maxW=1317&auto=format&n=ilemiSHw8UogZ13k&q=85&s=229fce4f5f50c1275324c29e1707b4f6 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/my-scrapers.png?w=1650&maxW=1317&auto=format&n=ilemiSHw8UogZ13k&q=85&s=89f1063505330b25829a253b96064b43 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/my-scrapers.png?w=2500&maxW=1317&auto=format&n=ilemiSHw8UogZ13k&q=85&s=edea89fe70d3e002fa63ad9f484acf38 2500w" data-optimize="true" data-opv="2" />
</Frame>

## Initiate scraper

To start collecting the data, choose one of three options:

<Tabs>
  <Tab title="Initiate by API">
    You can start a data collection through API without accessing the Bright Data control panel : [Getting started with API documentation](/api-reference/web-scraper-ide-api/Getting_started_wtih_the_API)

    Before initiating an API request, please create an API key. **To create an API key, go to:**\
    [Dashboard side menu settings > account settings > API key](https://brightdata.com/cp/setting)

    <Frame>
            <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-by-api.png?maxW=1712&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a8133587fc8638a1ca6c7d80f1a13f77" alt="" width="1712" height="453" data-path="images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-by-api.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-by-api.png?w=280&maxW=1712&auto=format&n=ilemiSHw8UogZ13k&q=85&s=bca31e9ed4b9d1cd5b2209d14537ff13 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-by-api.png?w=560&maxW=1712&auto=format&n=ilemiSHw8UogZ13k&q=85&s=228abcad2308863cad37b6d920de57ab 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-by-api.png?w=840&maxW=1712&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e826707ca8ef44d23a294a2fc2276a7f 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-by-api.png?w=1100&maxW=1712&auto=format&n=ilemiSHw8UogZ13k&q=85&s=50ee15521d7253ccb156161e6bcb1b36 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-by-api.png?w=1650&maxW=1712&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c0310090696a101db8f9612e35cbd77a 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-by-api.png?w=2500&maxW=1712&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e7a0ddbb02fbda8a41c8a6fd19bab4e7 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    1. **Set Up Inputs Manually** - provide input manually or through the API request
    2. **Trigger behavior** - you can add several requests in parallel that are activated according to the order they're defined. You can add another job run to the queue and run more than two jobs simultaneously.
    3. **Preview of the API Request** - Bright Data provides you with a REST API call to initiate the scraper. Please select the "Linux Bash" viewer for CURL commands. As soon as you send the request, you will receive a job id.

    You will receive the data according to the delivery preferences defined earlier.

    <Note>Receive data API call is required in order to receive data when delivery preferences is set to API download</Note>
  </Tab>

  <Tab title="Initiate manually">
    Bright Data's control panel makes it easy to get started collecting data.

    <Frame>
            <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-manually.png?maxW=1718&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c5556f5991b1a69051f11dc015b382c1" alt="" width="1718" height="515" data-path="images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-manually.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-manually.png?w=280&maxW=1718&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c31e806b8b8bc09bc674d9ba791bf734 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-manually.png?w=560&maxW=1718&auto=format&n=ilemiSHw8UogZ13k&q=85&s=b9f79ad4b801cb108eff836880b967df 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-manually.png?w=840&maxW=1718&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3f75c12d7b3efd5029695c341a00ce82 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-manually.png?w=1100&maxW=1718&auto=format&n=ilemiSHw8UogZ13k&q=85&s=269ae884bb7e71d690facbec323f5c45 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-manually.png?w=1650&maxW=1718&auto=format&n=ilemiSHw8UogZ13k&q=85&s=215c92768d282a1c81f4e6a716c5f2ec 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/initiate-manually.png?w=2500&maxW=1718&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9d06a2dda6dcb3dea80f6423e3f241e5 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    1. **Trigger behavior** - you can add several requests in parallel that are activated according to the order they're defined. You can add another job run to the queue and run more than two jobs simultaneously.
    2. **Set up inputs manually**
    3. **Upload CSV file** - If you'd like to add a large amount of input, the easiest way is to add them to a CSV file and upload it to the system. For example, a list of URLs.\
       See the example provided for reference.
  </Tab>

  <Tab title="Schedule a scraper">
    Choose when to initiate the scraper.

    **Step One:**

    1. Choose a date and time for the scraper to start.
    2. Select the frequency it will run (hourly, daily, weekly, etc.)
    3. Set a deadline for when a scraper is complete.
    4. Review your setup.

    <Frame>
            <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/schedule-configuration.png?maxW=1738&auto=format&n=ilemiSHw8UogZ13k&q=85&s=37b27f4139b1331b7d131f4452213562" alt="" width="1738" height="908" data-path="images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/schedule-configuration.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/schedule-configuration.png?w=280&maxW=1738&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a3fb46d7fc8d69ad497668ea33084241 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/schedule-configuration.png?w=560&maxW=1738&auto=format&n=ilemiSHw8UogZ13k&q=85&s=5e922db26e8b135801cf5ce17635b34a 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/schedule-configuration.png?w=840&maxW=1738&auto=format&n=ilemiSHw8UogZ13k&q=85&s=371e74d891ecc71616614280571d8d63 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/schedule-configuration.png?w=1100&maxW=1738&auto=format&n=ilemiSHw8UogZ13k&q=85&s=1999f992f4915c29af4123420b694bf9 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/schedule-configuration.png?w=1650&maxW=1738&auto=format&n=ilemiSHw8UogZ13k&q=85&s=376098e2da0efd0f927257bc95cedce3 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/schedule-configuration.png?w=2500&maxW=1738&auto=format&n=ilemiSHw8UogZ13k&q=85&s=775b1d66e776411f94c7d000bf2aa348 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    **Step Two :**

    1. Add a large number of inputs to a CSV file. For instance, a list of URLs. To upload easily without errors, you can download a template of a CSV structure example.
    2. Set up Inputs manually

    <Frame>
            <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/enter-input.png?maxW=1735&auto=format&n=ilemiSHw8UogZ13k&q=85&s=204e5f96d01c52b7c5b6ec2f82320ddf" alt="" width="1735" height="912" data-path="images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/enter-input.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/enter-input.png?w=280&maxW=1735&auto=format&n=ilemiSHw8UogZ13k&q=85&s=97cfee22387b03504ca89fc4144400bd 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/enter-input.png?w=560&maxW=1735&auto=format&n=ilemiSHw8UogZ13k&q=85&s=8a8d29276c7797fb0feb5b8db1873c9d 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/enter-input.png?w=840&maxW=1735&auto=format&n=ilemiSHw8UogZ13k&q=85&s=392b4527fa4c3178ee5249afaba5e733 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/enter-input.png?w=1100&maxW=1735&auto=format&n=ilemiSHw8UogZ13k&q=85&s=8ea32f21a9e837c1d3a1e6457b6a72a5 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/enter-input.png?w=1650&maxW=1735&auto=format&n=ilemiSHw8UogZ13k&q=85&s=dd9743016e15b45b9d4c573b9e87a69a 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/enter-input.png?w=2500&maxW=1735&auto=format&n=ilemiSHw8UogZ13k&q=85&s=412f43504b37c601893c2aec4809f2ff 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Tab>
</Tabs>

***

## Delivery Options

You can set your delivery preferences for the dataset. To do that simply click on the scraper row from the 'My scrapers' tab and then click on 'Delivery preferences'

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/delivery-preferences.png?maxW=1253&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c333bfd06d8c9349503c9125487c85fd" alt="" width="1253" height="526" data-path="images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/delivery-preferences.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/delivery-preferences.png?w=280&maxW=1253&auto=format&n=ilemiSHw8UogZ13k&q=85&s=33e8d1e50125dc42dc553eb80c14b905 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/delivery-preferences.png?w=560&maxW=1253&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e739293e448be32becb12feeee0915c7 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/delivery-preferences.png?w=840&maxW=1253&auto=format&n=ilemiSHw8UogZ13k&q=85&s=92e5b11f36b14bf430e8fa2858ac8c4c 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/delivery-preferences.png?w=1100&maxW=1253&auto=format&n=ilemiSHw8UogZ13k&q=85&s=ea64125509a75d4dc5159c9aa4555113 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/delivery-preferences.png?w=1650&maxW=1253&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6f9df800dcc0e574b69f5fb256da8131 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/delivery-preferences.png?w=2500&maxW=1253&auto=format&n=ilemiSHw8UogZ13k&q=85&s=4dbb0eea988a7e997ba2536b37e4ce82 2500w" data-optimize="true" data-opv="2" />
</Frame>

<AccordionGroup>
  <Accordion title="Choose when to get the data">
    * Batch : an efficient way of managing large amounts of data
      * Split batch : deliver the data in smaller batches as soon as it's ready
    * Real-time : is an ideal way to get a fast response for one request
      * Skip retries : Do not retry when error occurs. Can speed up collection
  </Accordion>

  <Accordion title="Choose file format">
    * JSON
    * NDJSON
    * CSV
    * XLSX
  </Accordion>

  <Accordion title="Choose how to receive the data">
    * Email
    * API Download
    * Webhook
    * Cloud storage providers : Amazon S3, Google Cloud Storage, Azure
    * SFTP/FTP
      <Note>Media files cannot be delivered when it's set to Email or API download</Note>
  </Accordion>

  <Accordion title="Choose result format">
    * Result and Errors in separate files
    * Result and Errors together in one file
    * Only successful results
    * Only errors
  </Accordion>

  <Accordion title="Define notifications">
    * Notify when the collection is complete
    * Notify success rates
    * Notify when an error occurs
  </Accordion>
</AccordionGroup>

### Output schema

Schema defines the data point structure and how the data will be organized. You can change the schema structure and modify the data points to suit your needs, re-order, set default values, and add additional data to your output configuration. You can add new field names by going into the advanced settings and editing the code.

<img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/output-schema.png?maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=700f3896110c4f6772021e217c63b0bc" alt="" width="1600" height="853" data-path="images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/output-schema.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/output-schema.png?w=280&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=08b8fa98ebae7fcee416f91bdcd67296 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/output-schema.png?w=560&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=254c7fd72597e76b6b2ee18caed3de28 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/output-schema.png?w=840&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=311e480f3b27e63b0c93721b53e64e40 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/output-schema.png?w=1100&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=5afd00000ad079e09f2495666724fc57 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/output-schema.png?w=1650&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=149cfc848cc1f46b4d69467aef818925 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraping-ide/initiate-collection-and-delivery-options/output-schema.png?w=2500&maxW=1600&auto=format&n=ilemiSHw8UogZ13k&q=85&s=feddaeec2cfe4fbae22b2acd05903ea0 2500w" data-optimize="true" data-opv="2" />

|                           |                                                                                      |
| ------------------------- | ------------------------------------------------------------------------------------ |
| **Input / Output schema** | choose the tab you'd like to configure                                               |
| **Custom validation**     | validate the schema                                                                  |
| **Parsed data**           | data points collected by the scraper                                                 |
| **Add new field**         | if you need additional data point, you can add fields and define field name and type |
| **Additional data**       | additional information you can add to the schema (timestamp, screenshot, etc.)       |


# null
Source: https://docs.brightdata.com/datasets/functions/introduction



## What is the Web Scraper IDE?

Fully hosted Javascript scraping solution, designed for developers to build scrapers fast and at scale. Built on Bright Data's unblocking technology, the IDE includes pre-built Javascript functions and code templates from major websites, significantly reducing scraper development and maintenance time.

## Best for

Businesses that prefer to keep their data collection in-house, maintain maximum control and flexibility, and scale without worrying about infrastructure, proxy servers, or getting blocked.


# Video Tutorials: Mastering Web Scraping with the IDE
Source: https://docs.brightdata.com/datasets/functions/videos

Explore video tutorials showcasing how to use the Web Scraper IDE for various web scraping tasks, including automation, proxy management, and data extraction.

## **Scraping Data from Search Results**

The video demonstrates how to scrape data from Amazon search results using the IDE, how to build a scraper that continuously scrape data from multiple pages of search results, and how proxy network enables the scraper to collect data quickly and easily, without being blocked.

<iframe id="youtube-712" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="Player for 🛑 How to Scrape UNSCRAPABLE data! (super simple!) Node.js + API" width="640" height="360" src="https://www.youtube.com/embed/YRRW4o-BjEM?autoplay=0&controls=0&disablekb=1&playsinline=1&cc_load_policy=0&cc_lang_pref=auto&widget_referrer=https%3A%2F%2Fbrightdata.zendesk.com%2Fhc%2Fen-us%2Farticles%2F15054175913745-Videos-How-developers-use-Bright-Data&rel=0&showinfo=0&iv_load_policy=3&modestbranding=1&customControls=true&noCookie=false&enablejsapi=1&origin=https%3A%2F%2Fbrightdata.zendesk.com&widgetid=1" />

## **Project Setup, Proxies, and Automation Workflows**

The video provides a detailed overview of the platform's essential features and functionalities, including project setup, proxy creation and management, and setting up automated data collection workflows.

<iframe id="youtube-7609" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="Player for Industrial-scale Web Scraping with AI & Proxy Networks" width="640" height="360" src="https://www.youtube.com/embed/qo_fUjb02ns?autoplay=0&controls=0&disablekb=1&playsinline=1&cc_load_policy=0&cc_lang_pref=auto&widget_referrer=https%3A%2F%2Fbrightdata.zendesk.com%2Fhc%2Fen-us%2Farticles%2F15054175913745-Videos-How-developers-use-Bright-Data&rel=0&showinfo=0&iv_load_policy=3&modestbranding=1&customControls=true&noCookie=false&enablejsapi=1&origin=https%3A%2F%2Fbrightdata.zendesk.com&widgetid=2" />

## **Proxy Management, API Integration, and Code Functionality**

The video demonstrates automating data collection workflows. It covers essential aspects such as the proxy manager and API integrations, how to set up a basic scraper using a template and provides insights into how the code functions. It explains how to use input for specific products or to have the scraper navigate to a category of pages. Additionally, the video includes information on how to run the code and how to access logs and consoles for debugging purposes.

<iframe id="youtube-6757" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="Player for Basic Data Engineering Project - End-To-End From Web Scraping to Tableau" width="640" height="360" src="https://www.youtube.com/embed/vSgJ3bOyE0w?autoplay=0&controls=0&disablekb=1&playsinline=1&cc_load_policy=0&cc_lang_pref=auto&widget_referrer=https%3A%2F%2Fbrightdata.zendesk.com%2Fhc%2Fen-us%2Farticles%2F15054175913745-Videos-How-developers-use-Bright-Data&rel=0&showinfo=0&iv_load_policy=3&modestbranding=1&customControls=true&noCookie=false&enablejsapi=1&origin=https%3A%2F%2Fbrightdata.zendesk.com&widgetid=3" />

## **Templates, API Integration, and Output Configuration**

This video explains how to use templates to save time, modify the code, and preview search results. It also cover how to initiate the search by API and obtain the necessary API key to receive search results. The video also touches on output configuration and how to integrate the search results into your code.

<iframe id="youtube-1328" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="Player for CODE WITH ME: Building A Python Project And Web Scraper" width="640" height="360" src="https://www.youtube.com/embed/7ahUnBhdI5o?autoplay=0&controls=0&disablekb=1&playsinline=1&cc_load_policy=0&cc_lang_pref=auto&widget_referrer=https%3A%2F%2Fbrightdata.zendesk.com%2Fhc%2Fen-us%2Farticles%2F15054175913745-Videos-How-developers-use-Bright-Data&rel=0&showinfo=0&iv_load_policy=3&modestbranding=1&customControls=true&noCookie=false&enablejsapi=1&origin=https%3A%2F%2Fbrightdata.zendesk.com&widgetid=4" />

## **Navigating search results using for loops**

The video showcases how to utilizing a for loop to navigates through hundreds of search results pages, extracts links to each apartment listing, and collects data using the pause function, and how to return the data using the collect function. It also covers essential topics such as the proxy manager and API integrations, setting up a basic scraper using a template, and how to use input to target specific products or categories of pages. Finally, the video demonstrates how to test and run the code, as well as how to access logs and consoles for debugging purposes.

<iframe id="youtube-9362" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="Player for Fastest Way to MASTER Data Science in 2023" width="640" height="360" src="https://www.youtube.com/embed/0w9BAIVGuCA?autoplay=0&controls=0&disablekb=1&playsinline=1&cc_load_policy=0&cc_lang_pref=auto&widget_referrer=https%3A%2F%2Fbrightdata.zendesk.com%2Fhc%2Fen-us%2Farticles%2F15054175913745-Videos-How-developers-use-Bright-Data&rel=0&showinfo=0&iv_load_policy=3&modestbranding=1&customControls=true&noCookie=false&enablejsapi=1&origin=https%3A%2F%2Fbrightdata.zendesk.com&widgetid=5" />

## **Using IDE Templates and Proxy Networks for Multiple Web Scrapers**

The video demonstrates how to build web scrapers and access API integrations. It discusses using the IDE's templates to create web scraper to pull data from Walmart. It also explains how to deploy the scrapers to the proxy network and collect the data into a single response, which can be accessed through a simple API call.

<iframe id="youtube-3478" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="Introduction to Bright Data | Web Scraper IDE" width="640" height="360" src="https://www.youtube.com/embed/Ve04_6gDKvU" />

## **Debugging and Data Delivery**

This video discusses how to debug a scraper using the IDE, how to choose the method of delivery for the scraped data, such as through an API endpoint or Amazon S3.

<iframe id="youtube-3668" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="Player for I Turned AI into a News Reporter" width="640" height="360" src="https://www.youtube.com/embed/BVizDqOfins?autoplay=0&controls=0&disablekb=1&playsinline=1&cc_load_policy=0&cc_lang_pref=auto&widget_referrer=https%3A%2F%2Fbrightdata.zendesk.com%2Fhc%2Fen-us%2Farticles%2F15054175913745-Videos-How-developers-use-Bright-Data&rel=0&showinfo=0&iv_load_policy=3&modestbranding=1&customControls=true&noCookie=false&enablejsapi=1&origin=https%3A%2F%2Fbrightdata.zendesk.com&widgetid=7" />

## **Scrape challenging websites using Bright Data's utility functions**

The video focuses on the programming layer, show casting a challenging website to scrape because it's very dynamic. It explains how to instruct the scraper to wait for the grid to become available, loop from 1 to the total number of grid cells, and call the next stage to collect individual ape data. The video emphasizes the utility functions introduced by Bright Data and how to use them to make data collection easier.

<iframe id="youtube-7056" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="Player for This A.I. creates infinite NFTs" width="640" height="360" src="https://www.youtube.com/embed/Pm93D8CVlY8?autoplay=0&controls=0&disablekb=1&playsinline=1&cc_load_policy=0&cc_lang_pref=auto&widget_referrer=https%3A%2F%2Fbrightdata.zendesk.com%2Fhc%2Fen-us%2Farticles%2F15054175913745-Videos-How-developers-use-Bright-Data&rel=0&showinfo=0&iv_load_policy=3&modestbranding=1&customControls=true&noCookie=false&enablejsapi=1&origin=https%3A%2F%2Fbrightdata.zendesk.com&widgetid=8" />

## **Automate Airbnb With Python**

The video demonstrates the use of the templates, which can be customized to get the desired results, and the benefits of using Bright Data's proxy network and unlocking tools for data collection from difficult-to-scrape sites. Finally, the video demonstrates how to use the API to initiate the scraper and get the data. 

<iframe id="youtube-7003" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="Player for Automate Airbnb With Python" width="640" height="360" src="https://www.youtube.com/embed/ASWS7eU5ao4?autoplay=0&controls=0&disablekb=1&playsinline=1&cc_load_policy=0&cc_lang_pref=auto&widget_referrer=https%3A%2F%2Fbrightdata.zendesk.com%2Fhc%2Fen-us%2Farticles%2F15054175913745-Videos-How-developers-use-Bright-Data&rel=0&showinfo=0&iv_load_policy=3&modestbranding=1&customControls=true&noCookie=false&enablejsapi=1&origin=https%3A%2F%2Fbrightdata.zendesk.com&widgetid=9" />

## **Web Scraping Tutorial With Amazon Example**

This video demonstrates the process of creating a scraper by inputting certain parameters such as country, URL, domain, department, maximum pages, and other ready-made code functions. It also shows how to use the help section to find all available commands and check syntax. 

<iframe id="youtube-661" frameborder="0" allowfullscreen="" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" title="Player for Web Scraping Tutorial With Amazon Example" width="640" height="360" src="https://www.youtube.com/embed/jQzI2ywA988?autoplay=0&controls=0&disablekb=1&playsinline=1&cc_load_policy=0&cc_lang_pref=auto&widget_referrer=https%3A%2F%2Fbrightdata.zendesk.com%2Fhc%2Fen-us%2Farticles%2F15054175913745-Videos-How-developers-use-Bright-Data&rel=0&showinfo=0&iv_load_policy=3&modestbranding=1&customControls=true&noCookie=false&enablejsapi=1&origin=https%3A%2F%2Fbrightdata.zendesk.com&widgetid=10" />


# WARC files
Source: https://docs.brightdata.com/datasets/functions/warc-ide

Produce WARC files during scraping operations

## How to Get WARC File Output

**Overview**

Web Scraper IDE now supports returning the full HTTP response in WARC (Web ARChive) format. This feature allows you to archive the exact content and metadata of a web page as it was received during scraping.

**What is a WARC File?**

WARC is a standardized file format used to store web crawls and HTTP interactions. It is commonly used in digital preservation, research, and compliance scenarios.

**How to Enable WARC Output**

\
WARC files are available only for browser workers 

To include WARC files in your scraping results:

* Open your Web-Scraper IDE configuration.
* In the Output Schema, under ‘additional\_data’ field, click the eye icon next to warc\_snapshot.

<img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/warc_example.png?maxW=987&auto=format&n=ilemiSHw8UogZ13k&q=85&s=5c0e9478979b709f97416588632519eb" alt="Warc Example Pn" width="987" height="648" data-path="images/warc_example.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/warc_example.png?w=280&maxW=987&auto=format&n=ilemiSHw8UogZ13k&q=85&s=caeac5fbd0203c630d6d1eb0dfe6586b 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/warc_example.png?w=560&maxW=987&auto=format&n=ilemiSHw8UogZ13k&q=85&s=422f5b9c7138663a683a8867c2860cdb 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/warc_example.png?w=840&maxW=987&auto=format&n=ilemiSHw8UogZ13k&q=85&s=b8368ce95f28415e1684f954756ba607 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/warc_example.png?w=1100&maxW=987&auto=format&n=ilemiSHw8UogZ13k&q=85&s=66d22925dbd1d5937fb74e9352e289b7 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/warc_example.png?w=1650&maxW=987&auto=format&n=ilemiSHw8UogZ13k&q=85&s=fb102939e0009d9cbecd77b2d23a4f6c 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/warc_example.png?w=2500&maxW=987&auto=format&n=ilemiSHw8UogZ13k&q=85&s=5ab6080603c3e99eae64181f3005d7e9 2500w" data-optimize="true" data-opv="2" />

* Save and run a job
* Once the job completes, the WARC file(s) will be delivered to you according to the scraper's delivery settings.

\
**Optimal usage**

To ensure the WARC file captures as much of the page content as possible, keep the following in mind:

* WARC capture is limited to browser-side requests only. This includes all network activity initiated by the browser during page load (e.g., HTML, CSS, JS, images, XHR requests).
* Use the wait\_network\_idle() function in your scraping workflow to allow the browser to finish loading all resources before the WARC is finalized. This helps maximize the completeness of the captured data.


# Worker types
Source: https://docs.brightdata.com/datasets/functions/worker-types

This article explains the behavior difference between worker types, how to choose the right one for your project

Browser worker and code worker are two technical approaches for scraping, and you should choose between them based on your needs and budget, and based on technical challenges you're facing with the website you're scraping.

## Browser worker vs Code worker

**Browser Workers:**

* Can simulate a user's interaction with the website via a headless browser
* Browser worker is more expensive to use, in terms of CPM (Cost Per Thousand page loads)
* Handles complex scraping tasks like filling forms, and dynamic content loading.

**Code workers:**

* Roughly equivalent to doing a curl or python `requests.get(url)`
* Work by sending HTTP requests to the target website
* Much cheaper
* Can only work in situations that don't require interacting with the website UI

## Choose the optimal worker type

You should choose the right worker type based on the technology used by the website you want to scrape, and the navigation needed for scraping the data you need.

It's good to start with the cheaper code workers and only change if you find that you cant' get the data you want.

**For example:**

* If you need to click on element to load some more data
* If you need to use scroll for load more elements
* If you need to use `tag_script`, `tag_response` (capture network traffic from inside the browser)
* if you need to type some text to get data on the website to do a search

## Align your code with worker type

Some functions in our library are only available when using browsers and will throw an error if you try to use them from code workers.

Below is a list of function that you can only use from browser workers:

* `wait_*` (any wait function)
* `scroll_*` (any scroll function)
* `tag_*` (any tag function)
* `type`
* `browser_size`
* `emulate_device`
* `freeze_page`
* `click`
* `hover`
* `right_click`
* `mouse_to`
* `press_key`
* `solve_captcha`
* `capture_graphql`
* `close_popup`


# Data Feeds
Source: https://docs.brightdata.com/datasets/introduction

Bright Data’s Data Pipelines offer developers a faster, more efficient way to collect and process web data - without the complexity of managing scraping infrastructure. Integrate pre-built scrapers for 120+ popular websites, deploy custom scrapers as serverless functions, or grab ready-to-use datasets tailored to your needs.

<Card>
  <CardGroup>
    <Card title="Datasets marketplace" href="/datasets/marketplace" icon="store">
      Search, customize, and export high-quality, ethically sourced datasets from 120+ domains—ready for instant use.
    </Card>

    <Card title="Scrapers" href="/datasets/scrapers" icon="spider">
      Access 120+ 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" href="/datasets/archive" icon="box-archive">
      The most cost-effective way to collect data— Access and retrieve data snapshots using Bright Data cached data collections.
    </Card>

    <Card title="Functions" href="/datasets/functions" icon="function">
      Build and run custom JavaScript scrapers at scale—fully hosted, and packed with pre-built templates 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 credits, no credit card required. We’ll match your first account deposit up to \$500 !
</Note>

<Info>
  For billing, settings and user access, visit the [account management](https://docs.brightdata.com/general/account/api-token) section.
</Info>

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


# null
Source: https://docs.brightdata.com/datasets/marketplace/customization-and-filtering



<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-button.png?maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=74d41eaec3585419393963a1e18a1f7c" alt="" width="1920" height="941" data-path="images/datasets/marketplace/customization-and-filtering/customize-button.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-button.png?w=280&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=ff3a6c838c70b119d1f454ab0a0660da 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-button.png?w=560&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=57e3f7b595f14ebb6bf5ba33f24bfb14 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-button.png?w=840&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=4a305394c301d8c4e9e5edcf632b1563 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-button.png?w=1100&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=26c1571610e04131356385e805f47ccd 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-button.png?w=1650&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=a027b0decfcff39476ee17eae8fd5650 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-button.png?w=2500&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=32ee58161e009a94019838ca17c09311 2500w" data-optimize="true" data-opv="2" />
</Frame>

## Customize Fields

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-fields.png?maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=8e9120747dfc36ba132028a32f3608fb" alt="" width="1920" height="941" data-path="images/datasets/marketplace/customization-and-filtering/customize-fields.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-fields.png?w=280&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=8051466e974d7cebd91364fc9cdfb9a4 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-fields.png?w=560&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=8be5057a09e22f149f8dfe13e72f993f 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-fields.png?w=840&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=eae826fc4ae6c93a91c2a4d4c00b50a6 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-fields.png?w=1100&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=370a8e0bf5445c409a4b86a03e16a086 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-fields.png?w=1650&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=ac16e52782bd0652ce918938063c504b 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/customize-fields.png?w=2500&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=82015c8e5ac78e2b700713b0cae42305 2500w" data-optimize="true" data-opv="2" />
</Frame>

## Filter

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/filter.png?maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=7fddcbd41434196e775fd33ac589fb64" alt="" width="1920" height="941" data-path="images/datasets/marketplace/customization-and-filtering/filter.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/filter.png?w=280&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=af00ed80f09a075f51571618e38af256 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/filter.png?w=560&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=f7bc65341dea91730cb6bb65b4539a6d 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/filter.png?w=840&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=a1dc2d0e7708f83739effd531e213b9d 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/filter.png?w=1100&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=fbe3b10254f9060698f3d845e96698f0 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/filter.png?w=1650&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=3806065116b5813f7d924b1441ea167f 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/customization-and-filtering/filter.png?w=2500&maxW=1920&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=9994166384b612d949ad9a724173a557 2500w" data-optimize="true" data-opv="2" />
</Frame>

### Filtering a Dataset Using the UI

1. Start by navigating to the dataset you want to filter.
2. Click on the top right button with the filter icon.
3. A menu will appear where you can add a name for the view to help you identify the query.
4. Choose the appropriate filters under the "Include filters" section, such as country, job title, or date.
5. Click the "create subset" button to create the filtered view.

### Filter Functions

#### **Select**

* Use this function to select one or more exact matches from a predefined list, such as countries or regions. This is useful when dealing with a known set of values.

#### **Boolean**

* Filter by boolean values (true or false) to find specific records meeting criteria, such as verified or unverified social media profiles.

#### **Date**

* Use this filter to specify a date range, with start and end dates, useful for trend analysis or filtering events by date.

#### **Number**

* Options include:
  * **Is:** Matches exact numerical values.
  * **Not:** Excludes specified values.
  * **Exist:** Filters non-empty numerical fields.
  * **List (exact match):** Matches exact values from a list.
  * **Lower than / Lower or equal to:** Filters values below or up to a specific number.
  * **Greater than / Greater or equal to:** Filters values above or up to a specific number.

#### **String**

* Filter by string values using options like exact match, exclusion, list matching, or pattern inclusion to refine searches.

#### **Array**

* Use the "Array includes" filter to check if a value exists within an array field, such as specific tags.

### Creating Rule-Based Group Filters

* Create group filters by clicking on the “+Add filter” dropdown and selecting “Add group.”
* Group filters allow you to set rules, such as filtering a dataset where the category is “Electronics” and the brand is “Dell” or “Apple.”

### Limitations

* Groups cannot be nested, and a maximum of two groups per filter is allowed.

If you require more complex queries, contact your account manager for assistance with custom queries and filters.


# null
Source: https://docs.brightdata.com/datasets/marketplace/dataset-view



## Data sample

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/data-sample.png?maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=9e65f41b597df8f0e4d6109aa8639379" alt="" width="1857" height="920" data-path="images/datasets/marketplace/dataset-view/data-sample.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/data-sample.png?w=280&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=3fb80a6b2fa9db5af4b0753bf6be6fec 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/data-sample.png?w=560&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=9b09cdc29637742a44f105b675c4d64b 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/data-sample.png?w=840&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=fef557e7e9357e5c5f325b73213fbae5 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/data-sample.png?w=1100&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=fc74e331069e03eea7a0dde2c58e4c3e 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/data-sample.png?w=1650&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=a96c9eb701015a701905dd24b4990727 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/data-sample.png?w=2500&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b69508c9f82e2917ed67231559a8882b 2500w" data-optimize="true" data-opv="2" />
</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

### Customize

* Customize - Create a custom subset by hiding/showing and renaming fields and filter the dataset according to your requirements.
* Customize Fields
* Filter

## Dictionary

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/dictionary.png?maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=c94b6e7c28622a3a5c99c094b16499d3" alt="" width="1857" height="920" data-path="images/datasets/marketplace/dataset-view/dictionary.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/dictionary.png?w=280&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=8de81e6ca37e8c0469ebdfb20546946b 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/dictionary.png?w=560&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=58a338a4480ad32b212c0a6fd424152e 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/dictionary.png?w=840&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=336c3fbfc0f3236c810a5cc3cd36519a 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/dictionary.png?w=1100&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=62220f03b546e7bc5dffa48035d03bda 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/dictionary.png?w=1650&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b22f4fe26395dcaad5e5a59416bb7c0b 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/dictionary.png?w=2500&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=cd1a7edc7cc117c156fea18dd3c96820 2500w" data-optimize="true" data-opv="2" />
</Frame>

* Search attribute
* Table
  * Column name
  * Description
  * Data type

## Use-cases

<Frame>
    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/dataset-view/use-cases.png?maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=1db96600c87b4b2a5d5e53dff54176e0" alt="" width="1857" height="920" data-path="images/datasets/marketplace/dataset-view/use-cases.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/dataset-view/use-cases.png?w=280&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f263393dfaca5f3759ca7f46703285b1 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/dataset-view/use-cases.png?w=560&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=28cef98a701461ea6f1b4a1931d2465d 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/dataset-view/use-cases.png?w=840&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=475252be27bc2ead06b7c81c9c8e2857 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/dataset-view/use-cases.png?w=1100&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=e5711bb2dec06923cf2d589e3d876ae3 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/dataset-view/use-cases.png?w=1650&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b12a4a8bd9452d1c1fb225e86a4df1ec 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/dataset-view/use-cases.png?w=2500&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=42e3f14473060bc97543e25b46cdd029 2500w" data-optimize="true" data-opv="2" />
</Frame>

* Case study
* Related subset
* What category it’s related to

## About

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/about.png?maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=f60f8b6ab0bc48a0d8feb0818d222796" alt="" width="1857" height="920" data-path="images/datasets/marketplace/dataset-view/about.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/about.png?w=280&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=fd09be28eff2883e57fe09811f57bce4 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/about.png?w=560&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=63a3510583313a31eafd8f1e922317d9 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/about.png?w=840&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=359171a00159a85e12e9dbf4ee5fc785 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/about.png?w=1100&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=d88339dc5bccf95454285039d80d36cd 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/about.png?w=1650&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=1f90a448ad73ad0bc945b7cc1362e538 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/marketplace/dataset-view/about.png?w=2500&maxW=1857&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=efe3689460b487f3eb898d27bdf0606e 2500w" data-optimize="true" data-opv="2" />
</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


# FAQs
Source: https://docs.brightdata.com/datasets/marketplace/faqs



<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
    * Reuters news
    * 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](https://docs.brightdata.com/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 120 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](https://docs.brightdata.com/datasets/deep-lookup/overview).

    Would you like more information on how to use any of these services?
  </Accordion>
</AccordionGroup>


# Filter dataset by API
Source: https://docs.brightdata.com/datasets/marketplace/filter-dataset-by-api



See [Filter Dataset](/api-reference/marketplace-dataset-api/filter-dataset) API Reference page


# Dataset Marketplace Overview
Source: https://docs.brightdata.com/datasets/marketplace/overview

The Dataset Marketplace is a centralized platform providing regularly updated, ethically sourced datasets from multiple domains, offering flexible solutions for data customization and acquisition.

## Introduction to the Dataset Marketplace

The Dataset Marketplace is a one-stop platform for discovering, customizing, and purchasing high-quality datasets from over 120 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 fields like social media, real estate, B2B data, or AI training—flexible purchase options and comprehensive customization make it easy to get the data you need.

## Get started

<Card>
  <CardGroup>
    <Card title="Explore" href="/datasets/marketplace/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="dataset">
      Examine data samples, data-fields, and customization options before purchase.
    </Card>

    <Card title="Filter Dataset" href="/datasets/dataset-view" icon="filter">
      Refine datasets with advanced filters, hidden fields, and custom subsets.
    </Card>

    <Card title="Download data sample" href="/datasets/dataset-view" icon="download">
      Preview and download a sample of any dataset in multiple formats.
    </Card>

    <Card title="Fill rates and statistics" href="/datasets/dataset-view" icon="statistics">
      Review data completeness and field coverage to ensure accuracy.
    </Card>

    <Card title="Purchase options and pricing" href="/datasets/pricing" icon="price">
      Understand one-time purchases, subscriptions, and other flexible pricing models.
    </Card>

    <Card title="Data delivery and export" href="/datasets/export" icon="export">
      Learn how to receive datasets via email, API, webhooks, and various cloud services.
    </Card>
  </CardGroup>
</Card>


# null
Source: https://docs.brightdata.com/datasets/marketplace/pricing



* Pre-collected records
* Fresh records
* Pricing is determined based on compute cost and record cost to reach and collect the data. There

## Data delivery and export

<Frame>
    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/pricing/delivery.png?maxW=1920&auto=format&n=2RrKkArDJDw55ilE&q=85&s=86c4542c7d0032076b9e61d48934a9c5" alt="" width="1920" height="941" data-path="images/datasets/marketplace/pricing/delivery.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/pricing/delivery.png?w=280&maxW=1920&auto=format&n=2RrKkArDJDw55ilE&q=85&s=dbab3fc91cdc3f280681e90ae5f66710 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/pricing/delivery.png?w=560&maxW=1920&auto=format&n=2RrKkArDJDw55ilE&q=85&s=9d32e31c03aafcaa2c0f4edd8be41b94 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/pricing/delivery.png?w=840&maxW=1920&auto=format&n=2RrKkArDJDw55ilE&q=85&s=6402bad0bac4dc2b1aee8eb678da32c3 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/pricing/delivery.png?w=1100&maxW=1920&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2c30b3d8e13796f2bc6756c13cd46e1a 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/pricing/delivery.png?w=1650&maxW=1920&auto=format&n=2RrKkArDJDw55ilE&q=85&s=528ba89f32c577fcd291bf2dc832ecc4 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/pricing/delivery.png?w=2500&maxW=1920&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a498afe2901fbfa75fdeb49fe35c4a8a 2500w" data-optimize="true" data-opv="2" />
</Frame>

* Email
* API download
* Webhook
* Amazon S3
* Google Cloud storage
* Google Cloud PubSub
* Microsoft Azure
* Snowflake
* SFTP


# null
Source: https://docs.brightdata.com/datasets/marketplace/purchase-options



* 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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/pre-collected-data.png?maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2dbff1e630a4380aa79efc4a36d40897" alt="" width="1857" height="920" data-path="images/datasets/marketplace/purchase-options/pre-collected-data.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/pre-collected-data.png?w=280&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d0499e04d09f8871468ee440006197c4 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/pre-collected-data.png?w=560&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a256806c2049185dc9c7d4c03b1b59ed 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/pre-collected-data.png?w=840&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=489eb3bebaf12d94a42e289e17a85749 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/pre-collected-data.png?w=1100&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=488cd37a64d17f39fa61a1b600cca207 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/pre-collected-data.png?w=1650&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=c35165f1b6835953d81389b9612ac6bd 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/pre-collected-data.png?w=2500&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=6fdb49522cca1563c0ae950be707c9df 2500w" data-optimize="true" data-opv="2" />
  </Frame>
  * Fresh data - Access data that's up-to-date and fresh, available immediately after it's collected.
  <Frame>
      <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/fresh-data.png?maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=76b2fefe24b3b8205b98e2012c18efcc" alt="" width="1857" height="920" data-path="images/datasets/marketplace/purchase-options/fresh-data.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/fresh-data.png?w=280&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=23296b23be933052c590f3bf691fe2a1 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/fresh-data.png?w=560&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=53cc2fd0fde4121c8243e4ccf23fb252 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/fresh-data.png?w=840&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=57b6745919a628eb7708a2fb01a8272b 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/fresh-data.png?w=1100&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=8757f94529ee516472ab56d4a8f1addd 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/fresh-data.png?w=1650&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b1eb9943c3dcb54faaa8af35ef7b065b 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/fresh-data.png?w=2500&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=62e336e90ab94fe8d044d202ac058435 2500w" data-optimize="true" data-opv="2" />
  </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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/specific-time-range.png?maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=088eed35e12c698bbc4f82dc6424e0f3" alt="" width="1857" height="920" data-path="images/datasets/marketplace/purchase-options/specific-time-range.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/specific-time-range.png?w=280&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7fc1c1f51e2b24f731fff06cd2a30794 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/specific-time-range.png?w=560&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=03cd6d2e38086db46d9a9e0d9d922d6b 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/specific-time-range.png?w=840&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=1bf6eef1618c7e1efe45a904a789449a 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/specific-time-range.png?w=1100&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=98977d4d1f610949dee99c4833658f1a 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/specific-time-range.png?w=1650&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=71773932557e2e6f684dc393ff6a08d9 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/specific-time-range.png?w=2500&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=43a37796a6475be2be229630ffa554af 2500w" data-optimize="true" data-opv="2" />
</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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/544m.png?maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=74619f4679cb47e8f5abaa8b52076e4d" alt="" width="1857" height="920" data-path="images/datasets/marketplace/purchase-options/544m.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/544m.png?w=280&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=bc5c6ac88abb2e95e30ee0d81e9a346c 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/544m.png?w=560&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=01513d7688dba8e483da114fd2588c90 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/544m.png?w=840&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=124cbe1a23f29a989fd4c80ff9f0e61b 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/544m.png?w=1100&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=bd752dea74b29422108e9a0649f12bf5 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/544m.png?w=1650&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=96fa7045c2df80c358c76ba151958ffd 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/marketplace/purchase-options/544m.png?w=2500&maxW=1857&auto=format&n=2RrKkArDJDw55ilE&q=85&s=6cb4464c6a6133cd78359d1fd36600f4 2500w" data-optimize="true" data-opv="2" />
</Frame>


# Delivery Options
Source: https://docs.brightdata.com/datasets/scrapers/custom-scrapers/delivery-options

This article describes the options for getting the dataset once the snapshot is ready.

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/custom-datasets/delivery-options#aws-s3-user-role-permissions))

  * Google Cloud Storage ([How to find your google cloud Private Key](/datasets/custom-datasets/delivery-options#how-to-find-your-google-cloud-private-key))

  * Google Cloud PubSub

  * Microsoft Azure Storage

  * SFTP/FTP

  * Snowflake ([Snowflake Delivery Configuration Guide](/datasets/custom-datasets/delivery-options#snowflake-delivery-configuration-guide-only-visible-to-agents-and-admins))

<Frame>
  ![](https://brightdata.zendesk.com/hc/article_attachments/22455157046161)
</Frame>

## AWS S3 User Role Permissions

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/delivery-strategy.png?maxW=723&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=21b0c5e2b8cc8030e01886ff0ce5b606" alt="delivery-strategy.png" width="723" height="244" data-path="images/datasets/delivery-methods/aws-s3-user-role-permissions/delivery-strategy.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/delivery-strategy.png?w=280&maxW=723&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6a5df47b1f4059a0d15ceae954e96046 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/delivery-strategy.png?w=560&maxW=723&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=51537b78351605d01d107b14290a481d 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/delivery-strategy.png?w=840&maxW=723&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=2405d8156de06c69187d5f3df2b5775e 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/delivery-strategy.png?w=1100&maxW=723&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=f9476912ae54bba19efcf4ff87259fb3 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/delivery-strategy.png?w=1650&maxW=723&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=660e2545cbc3725586a00cf5412c96ca 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/delivery-strategy.png?w=2500&maxW=723&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=a03a1c10d1c33580357ba46818827fdf 2500w" data-optimize="true" data-opv="2" />
</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 src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/policies.png?maxW=288&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=4e95269166b4cefd900144742efc420f" alt="policies.png" width="288" height="658" data-path="images/datasets/delivery-methods/aws-s3-user-role-permissions/policies.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/policies.png?w=280&maxW=288&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=bf927dafe709dc36943f4ccbd99d29c8 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/policies.png?w=560&maxW=288&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=240cc5890b4cfa4441ae8f3cec47365a 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/policies.png?w=840&maxW=288&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=f6b47ab3e023975f6db7431a409d6ffe 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/policies.png?w=1100&maxW=288&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=fa47b03430ace9aa5db37f2ed4219a13 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/policies.png?w=1650&maxW=288&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=dfded2d8b8ef9908c46577d6ee52b851 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/policies.png?w=2500&maxW=288&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=91fd0d8bcb15f6817d25418cd5cec680 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    Create a new policy that defines the permissions for the S3 resources you want to grant access to.

    Example of AWS policy:

    ```json
    {
    "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 src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/roles.png?maxW=284&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=92b8c7862eaab7646c716879a46d4bc2" alt="roles.png" width="284" height="654" data-path="images/datasets/delivery-methods/aws-s3-user-role-permissions/roles.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/roles.png?w=280&maxW=284&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=845be6e2c285ec79eccff47e2d6e3b7b 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/roles.png?w=560&maxW=284&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=1dace35b5b278a22656057263429c985 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/roles.png?w=840&maxW=284&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=f59d269ca17006fa581e8c3836500538 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/roles.png?w=1100&maxW=284&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=7ae88810c32341bbcf1eb1d415050a42 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/roles.png?w=1650&maxW=284&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=da6606896bd4e71bdac6350e84ed4282 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/aws-s3-user-role-permissions/roles.png?w=2500&maxW=284&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=78db8e3e76f35e73c2e2904775145710 2500w" data-optimize="true" data-opv="2" />
    </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
    {
    "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 src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/service-accounts.png?maxW=1823&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=023b7f4811117f51dde60a4433e1e84c" alt="service-accounts.png" width="1823" height="900" data-path="images/datasets/delivery-methods/find-your-google-cloud-private-key/service-accounts.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/service-accounts.png?w=280&maxW=1823&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=ded9e62473e0cfc9b2395fbf5fe1a91f 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/service-accounts.png?w=560&maxW=1823&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=bfc3cad7f191b16b4da0e4ef5cfe63c9 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/service-accounts.png?w=840&maxW=1823&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=09491cb3e25392e5ff8d920447e190f3 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/service-accounts.png?w=1100&maxW=1823&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=efdd749bd197d9bdc089cba3dfa97cca 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/service-accounts.png?w=1650&maxW=1823&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=c0a481b9097dd58cc608bb8459729c5f 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/service-accounts.png?w=2500&maxW=1823&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=cc3abe37d68c43b7917d9be657da2955 2500w" data-optimize="true" data-opv="2" />
</Frame>

1. Choose an existing service account from the list or create one.

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-service-account.png?maxW=1824&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=df3f08f9d7fc4df680ee753d68f88637" alt="create-service-account.png" width="1824" height="894" data-path="images/datasets/delivery-methods/find-your-google-cloud-private-key/create-service-account.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-service-account.png?w=280&maxW=1824&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=c0e5f7ed36386f17a923dc97954f2fa5 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-service-account.png?w=560&maxW=1824&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=ae4f0535f72cc564f1a93f89dbce3a19 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-service-account.png?w=840&maxW=1824&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b45cf7751d5262852619583ebedbc1a1 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-service-account.png?w=1100&maxW=1824&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=9e13d23086ebc853ef4e9a01313c3699 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-service-account.png?w=1650&maxW=1824&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=4c441aa6e42087c805c1811a6d3a408b 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-service-account.png?w=2500&maxW=1824&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=4c0b9448d924c064452001732fa673e6 2500w" data-optimize="true" data-opv="2" />
</Frame>

If the button is not visible, create a project first in order to **Create Service Account**.

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-project.png?maxW=1823&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=9113682e182606103b94c12c2ab85aad" alt="create-project.png" width="1823" height="896" data-path="images/datasets/delivery-methods/find-your-google-cloud-private-key/create-project.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-project.png?w=280&maxW=1823&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=1641db38fc39e895765777a78426eb89 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-project.png?w=560&maxW=1823&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=e66cbdc6d937e6024c0ed5ce8cc829e2 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-project.png?w=840&maxW=1823&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b98f04a0290866de49499b017f58871e 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-project.png?w=1100&maxW=1823&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=498448eb6a36c1c43547ec934203937c 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-project.png?w=1650&maxW=1823&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=2291a74415301060f51307c4143966f0 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-project.png?w=2500&maxW=1823&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=866fce91511c5f4bc03e04948547d93b 2500w" data-optimize="true" data-opv="2" />
</Frame>

1. 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 src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/service-account-details.png?maxW=1826&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=f22b06f14e0894b3c9c03ed6728f0d36" alt="service-account-details.png" width="1826" height="905" data-path="images/datasets/delivery-methods/find-your-google-cloud-private-key/service-account-details.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/service-account-details.png?w=280&maxW=1826&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=9a9525c5467cb397d057af773787d89a 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/service-account-details.png?w=560&maxW=1826&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=9fae050b5955f97aaf426a446b6104c8 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/service-account-details.png?w=840&maxW=1826&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=2e51de9e3a2584fdfa3bcfc707a9f37f 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/service-account-details.png?w=1100&maxW=1826&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=1620188e91c51c958cbefda94cb22a73 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/service-account-details.png?w=1650&maxW=1826&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=14e3ad7f1a76ed456b7641a95df74c1d 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/service-account-details.png?w=2500&maxW=1826&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=0b644a80246aa53d7a50b1d07fad38f4 2500w" data-optimize="true" data-opv="2" />
</Frame>

1. Click on Email of the service account.

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/email.png?maxW=1821&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=2cdb8db307477da4f2cd5e0751b0ca18" alt="email.png" width="1821" height="907" data-path="images/datasets/delivery-methods/find-your-google-cloud-private-key/email.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/email.png?w=280&maxW=1821&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=c975955606d24fd90bea2b6f837c3e26 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/email.png?w=560&maxW=1821&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=e22f74cf2cf1ca8076dfdf5b5b539cf3 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/email.png?w=840&maxW=1821&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=134ce098c4be449425b33cccff167606 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/email.png?w=1100&maxW=1821&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b7332b28a3816d569194dc5cb875b551 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/email.png?w=1650&maxW=1821&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=4b2c0023bf37edbfb6f112e250c76367 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/email.png?w=2500&maxW=1821&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=2e7d2111a16e9629503feb357fb2e2a4 2500w" data-optimize="true" data-opv="2" />
</Frame>

1. To access the keys, click on the 'KEYS' tab. Click the "Add Key" dropdown and then select 'Create New Key'.

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-new-key.png?maxW=1822&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=519d6dec54863353cd754fc1cd83774d" alt="create-new-key.png" width="1822" height="911" data-path="images/datasets/delivery-methods/find-your-google-cloud-private-key/create-new-key.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-new-key.png?w=280&maxW=1822&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=8fede11145e61a590c0425c0d251df1b 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-new-key.png?w=560&maxW=1822&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=c827e4b6fcc847fbb66376a5ab8082bd 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-new-key.png?w=840&maxW=1822&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=2c1fdc54709b5348c507b00c39bb6f2d 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-new-key.png?w=1100&maxW=1822&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=16125cee76946b07f1f2978777927be9 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-new-key.png?w=1650&maxW=1822&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=59597f57e40e5f6b9d3c7787c0839caf 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/create-new-key.png?w=2500&maxW=1822&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=2acd6c5de981a3dead13e791b8d13407 2500w" data-optimize="true" data-opv="2" />
</Frame>

1. Choose JSON as the key type.

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/type-json.png?maxW=1820&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=5428d253885f3fb5fb6041885a6309a6" alt="type-json.png" width="1820" height="909" data-path="images/datasets/delivery-methods/find-your-google-cloud-private-key/type-json.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/type-json.png?w=280&maxW=1820&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=93d412a5611079f4c8254541a012da15 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/type-json.png?w=560&maxW=1820&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=138a5d20b1afb12eb12ddd3471819b41 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/type-json.png?w=840&maxW=1820&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=087e48c07014682f9b435054de21bb07 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/type-json.png?w=1100&maxW=1820&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=6736a71335de455b5549e27915c7cc46 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/type-json.png?w=1650&maxW=1820&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=d1d674675cd711d1cbd267052169e2f7 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/type-json.png?w=2500&maxW=1820&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=f0527f36f61311ace12e43ee42450c05 2500w" data-optimize="true" data-opv="2" />
</Frame>

1. The service account key JSON file is automatically downloaded to your local machine.

2. Copy `private_key` from the downloaded JSON file & Paste it to Data Collector delivery settings.

<Frame>
    <img src="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/private-key.png?maxW=1639&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=4e88fb0d6a015228bdac1a62f9082608" alt="private-key.png" width="1639" height="309" data-path="images/datasets/delivery-methods/find-your-google-cloud-private-key/private-key.png" srcset="https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/private-key.png?w=280&maxW=1639&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=446c49c5dfbabddc798097869adf9421 280w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/private-key.png?w=560&maxW=1639&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=b4ca73d1eaca62276fb99e473cc854e3 560w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/private-key.png?w=840&maxW=1639&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=bbbedb9eb0138a2f8d5baa8d64a243e8 840w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/private-key.png?w=1100&maxW=1639&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=660d5735eb19a130513b959bf5b58571 1100w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/private-key.png?w=1650&maxW=1639&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=2efb73269fd0cdc015fb1bb71dfb91fc 1650w, https://mintcdn.com/brightdata/2-G3wocTpDaL5JJE/images/datasets/delivery-methods/find-your-google-cloud-private-key/private-key.png?w=2500&maxW=1639&auto=format&n=2-G3wocTpDaL5JJE&q=85&s=5c3ce28414521db56b216705e05896db 2500w" data-optimize="true" data-opv="2" />
</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
    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
    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
    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
    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
    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
    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
    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
    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
    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
    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 our platform.

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


# Custom Scrapers FAQs
Source: https://docs.brightdata.com/datasets/scrapers/custom-scrapers/faqs



<AccordionGroup>
  <Accordion title="What is Bright Data’s Custom Scrapers product?">
    Custom Scrapers is a tailored web scraping solution that allows you to extract structured data from any website. It’s designed for cases where Bright Data’s generic scrapers don’t meet your specific needs. You can choose to lead the project yourself (Custom Scraper route) or let Bright Data manage everything for you (Fully Managed route).
  </Accordion>

  <Accordion title="Who is Custom Scrapers for?">
    Custom Scrapers is ideal for:

    * Businesses needing data from specific or complex websites
    * Users with unique data requirements not covered by generic scrapers
    * Enterprises looking for scalable, reliable, and accurate data extraction
    * Teams that want either full control or a fully managed experience
  </Accordion>

  <Accordion title="What types of websites can Custom Scrapers handle?">
    Custom Scrapers can extract data from virtually any website, including:

    * E-commerce platforms
    * Real estate portals
    * Job boards
    * Social media sites
    * Travel aggregators
    * Business directories
    * Sites with dynamic content, CAPTCHA, or anti-bot protections
  </Accordion>

  <Accordion title="How much does it cost?">
    We offer 2 pricing options:

    | **Option**       | **Price**                           | **Additional information**                                                                 |
    | :--------------- | :---------------------------------- | :----------------------------------------------------------------------------------------- |
    | One-time Project | \$1200 <br />starts at \$4/CPM      | A single delivery. If more records are needed, you will need to add funds to your balance. |
    | Ongoing Project  | \$400/month <br />starts at \$4/CPM | 3-month minimum commitment                                                                 |
  </Accordion>
</AccordionGroup>

***

## Product Options

<AccordionGroup>
  <Accordion title="What’s the difference between the Custom Scraper and Fully Managed routes?">
    | Feature                  | Custom Scraper (Customer-Led)                     | Fully Managed Solution (Bright Data-Led)      |
    | :----------------------- | :------------------------------------------------ | :-------------------------------------------- |
    | Who defines the project? | You                                               | Bright Data                                   |
    | Who manages development? | Bright Data (based on your specs)                 | Bright Data                                   |
    | Control over schema      | Full control – you define and approve             | Collaborative – we define based on your goals |
    | Setup process            | Submit form → Schedule validation meeting         | Submit form → Bright Data contacts you        |
    | Ideal for                | Users with clear requirements and technical input | Users who want a hands-off experience         |
    | Time to launch           | Depends on complexity and customer readiness      | Typically faster due to internal handling     |
    | Support                  | Ongoing support available                         | Full support and proactive management         |
  </Accordion>

  <Accordion title="How do I choose between the two options?">
    Choose the Custom Scraper route if:

    * You have a clear idea of what data you need
    * You want control over the schema and scraping logic
    * You prefer to be hands-on during the setup

    Choose the Fully Managed route if

    * You want Bright Data to handle everything
    * You prefer a hands-off experience
    * You’re looking for fast, expert-driven delivery
  </Accordion>
</AccordionGroup>

***

## Process & Setup

<AccordionGroup>
  <Accordion title="How do I get started with Custom Scrapers?">
    1. Choose your preferred route (Custom or Fully Managed)
    2. Submit your project details via the request form
    3. For Custom Scraper: Schedule a validation meeting with a Bright Data expert
    4. Bright Data builds and deploys your scraper
    5. Receive your data in your preferred format
  </Accordion>

  <Accordion title="What information do I need to provide?">
    **For Custom Scraper**:

    * Target URLs or domains
    * Scope of the project (e.g., frequency, volume)
    * Desired data schema (fields to extract)
    * Preferred output format (e.g., JSON, CSV)

    **For Fully Managed**:

    * High-level project goals
    * Types of data needed
    * Any specific use cases or business context
  </Accordion>

  <Accordion title="What happens during the validation meeting?">
    In the Custom Scraper route, the validation meeting is where you and a Bright Data representative:

    * Review your request
    * Confirm the scope and complexity
    * Finalize the data schema
    * Align on timelines and next steps
  </Accordion>
</AccordionGroup>

***

## Technical & Delivery

<AccordionGroup>
  <Accordion title="Do I need technical skills to use Custom Scrapers?">
    No. Bright Data’s team handles all the technical aspects—including scraper development, deployment, proxy management, and error handling. You simply define what you need, and we deliver the data.
  </Accordion>

  <Accordion title="What output formats are supported?">
    We support multiple formats, including:

    * JSON
    * CSV
    * Excel
    * API integration (optional)
  </Accordion>

  <Accordion title="Can I schedule recurring data extractions?">
    Yes. Custom Scrapers supports both one-time and recurring scraping jobs. You can define the frequency (e.g., daily, weekly, monthly) based on your needs.
  </Accordion>

  <Accordion title="Is the data validated or cleaned?">
    Yes. We ensure the data is clean, structured, and ready to use. Our scrapers are built to deliver reliable and accurate results.
  </Accordion>
</AccordionGroup>

***

## Performance & Support

<AccordionGroup>
  <Accordion title="How long does it take to build a custom scraper?">
    Timelines vary depending on the complexity of the website and the scope of your request. Simpler projects may be completed in a few days, while more complex ones may take longer. The validation meeting helps clarify timelines.
  </Accordion>

  <Accordion title="What if the website structure changes?">
    Bright Data offers ongoing support and maintenance. If the target website changes, let us know and we can update the scraper to ensure continued data accuracy and functionality.
  </Accordion>

  <Accordion title="Is there a limit to how much data I can extract?">
    Custom Scrapers is built to scale. Whether you need data from a few pages or millions, we can accommodate your volume and frequency requirements.
  </Accordion>
</AccordionGroup>


# Getting Started with BrightData’s Custom Scrapers
Source: https://docs.brightdata.com/datasets/scrapers/custom-scrapers/quickstart

Welcome to Bright Data’s Custom Scrapers! Whether you’re looking for a fully tailored data extraction solution or prefer to let our experts handle everything, we’ve got you covered. Follow the steps below to get started.

<Steps>
  <Step title="Choose Your Engagement Model">
    You have two options:

    * Custom Scraper (Customer-Led): You define the scraping project and control the process.
    * Fully Managed Solution (Bright Data-Led): We handle everything for you, from design to deployment.

    <Frame>
            <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/choose-your-solution.png?maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f6ba48d0d13399a756274973088d1a0c" alt="choose-your-solution" width="624" height="331" data-path="images/scraping-automation/scrapers/custom-scrapers/quickstart/choose-your-solution.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/choose-your-solution.png?w=280&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f9249a7e3fe7a86feb5d70a3bbcd3603 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/choose-your-solution.png?w=560&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e4481df7f0bebf0d793311af13627cc4 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/choose-your-solution.png?w=840&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=6cb8c0c00d0288914937931f12b79dc3 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/choose-your-solution.png?w=1100&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=94656239c812c0678cac5c6984a360bd 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/choose-your-solution.png?w=1650&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=90c3f719fcee4c886c16a152750dd98c 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/choose-your-solution.png?w=2500&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e8571149dadcba6214e5d67db71a85c2 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Submit Your Project Details - custom scrapers">
    * For Custom Scraper:
      * Provide the following information:
        * Target URLs
        <Frame>
            <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/request-a-scraper.png?maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=1ced96082b3be263ae2f2fbd896806ec" alt="request-a-scraper" width="624" height="275" data-path="images/scraping-automation/scrapers/custom-scrapers/quickstart/request-a-scraper.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/request-a-scraper.png?w=280&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=20b31348ebf4b473c07c95fc962c59a3 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/request-a-scraper.png?w=560&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=262a42f5b19878d5545f6628121d2d27 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/request-a-scraper.png?w=840&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a4ed3fdbc968df80fdb64ac75c281982 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/request-a-scraper.png?w=1100&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=633fb03846642a0ce2e0eaf9d2cb497e 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/request-a-scraper.png?w=1650&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c62da2d1c6dc8e34f6871667f1d7d61f 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/request-a-scraper.png?w=2500&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=2f36a59fbb498e00c32e5e13baf3e109 2500w" data-optimize="true" data-opv="2" />
        </Frame>
        * Desired data schema (what fields you want to extract) - Make sure the schema meets your requirements; you can edit/remove/add fields as you want
        <Frame>
            <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/review-and-edit.png?maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=546dfd2c27411e320cd13de3bc28aea6" alt="review-and-edit" width="624" height="324" data-path="images/scraping-automation/scrapers/custom-scrapers/quickstart/review-and-edit.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/review-and-edit.png?w=280&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=598dc963bed922f94842800658bb9cd0 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/review-and-edit.png?w=560&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a7199f58cec73374e26e77900f3e157b 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/review-and-edit.png?w=840&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=0c30f7f365bb797b10e9de71a4702cd6 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/review-and-edit.png?w=1100&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=95f32a7cd3d065d31fd70aaa47af05b1 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/review-and-edit.png?w=1650&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b54c53fca4b2431fc289facd8c8a5269 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/review-and-edit.png?w=2500&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=08013388cad6d8b84bb3c5610e46003f 2500w" data-optimize="true" data-opv="2" />
        </Frame>
        * Scope of the project (e.g., frequency, volume, complexity)
        <Frame>
            <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/data-collection-scope.png?maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=1e91c32011d453de0b605b5254535576" alt="data-collection-scope" width="624" height="319" data-path="images/scraping-automation/scrapers/custom-scrapers/quickstart/data-collection-scope.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/data-collection-scope.png?w=280&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=25c80ce52c8777d0af6f4a4f9396262a 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/data-collection-scope.png?w=560&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=5ce63b81aa7f82abecb46ca259bb3a30 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/data-collection-scope.png?w=840&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b7b561ba9f5e66ab857f3d63ee6d66f4 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/data-collection-scope.png?w=1100&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=2fd9e5976452b1dbb2e11b9acfcfe630 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/data-collection-scope.png?w=1650&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3b16422083c656fb852c5b3c1776883e 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scrapers/custom-scrapers/quickstart/data-collection-scope.png?w=2500&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8d6fda172b939675af9cf68db67ef70f 2500w" data-optimize="true" data-opv="2" />
        </Frame>
  </Step>

  <Step title="Review & Validation">
    * Once your request is done, schedule a meeting with a Bright Data representative.
    * During the meeting, we’ll review your request, validate the scope, and finalize the schema.
    * Once approved, the project moves into development.
  </Step>

  <Step title="Development & Delivery">
    You’ll be updated as we build your scraper according to the approved specifications.
  </Step>

  <Step title="Go Live & Monitor">
    Once the scraper is live, it will be presented on the control panel under the “My scrapers” table, ready for you to start using it. Our support team is here to help.
  </Step>
</Steps>


# Scrape Any Website
Source: https://docs.brightdata.com/datasets/scrapers/custom-scrapers/scrape-any-web



Unlock the Power of Custom Scrapers for Any Website You Want to Extract Data From
When it comes to web data extraction, there’s no one-size-fits-all solution. Every website has its own structure, behavior, and technical challenges. Whether you need to collect data from e-commerce platforms, real estate listings, job boards, social media sites, or any other online source, Bright Data’s Custom Scrapers product is built to meet your exact needs. Here’s why Custom Scrapers is the ultimate solution for tailored web scraping.

## What are Custom Scrapers?

Custom Scrapers is a flexible solution that enables you to extract the exact data you need from any website, no matter how complex or unique your requirements are. With this product, you don’t need to build your own scraper, manage infrastructure, or worry about handling technical hurdles like anti-bot systems or dynamic content.

It’s simple: You provide the target URLs, define the data you want, and choose whether you want to lead the project or let Bright Data manage it for you. Either way, Custom Scrapers is your dedicated, end-to-end web scraping solution.

## Why Use Custom Scrapers for Any Domain or URL?

### Tailored to Your Needs

Every website is different. Custom Scrapers is designed to adapt to the specific structure and behavior of any site. Whether you're extracting product listings, pricing data, customer reviews, or business insights, your scraper is built to match your exact requirements.

### Works with Any Website

From static pages to JavaScript-heavy sites, from public directories to login-protected portals, Custom Scrapers can handle it all. Our technology and expertise allow us to overcome challenges like CAPTCHA, IP blocking, and dynamic content rendering.

### Choose Your Level of Involvement

Want full control over the scraper’s design and schema? Choose the customer-led route. Prefer to hand it off to the experts? Go with the fully managed option. Custom Scrapers gives you the flexibility to work the way you want.

### No Technical Expertise Required

If you pick the fully managed option, you don’t need to be a developer or data engineer. Our team of experts handles everything, from scraper development and deployment to ongoing maintenance, so you can focus on using the data, not collecting it.

### Scalable and Efficient

Whether you need data from a few pages or millions, Custom Scrapers is built to scale. We support one-time extractions, scheduled jobs, and high-frequency crawls—whatever your project demands.

### Reliable and Accurate Data

We deliver clean, structured, and validated data in your preferred format—JSON, CSV, Excel, or direct API integration. You get exactly what you asked for, ready to use.

## How It Works

<Steps>
  <Step title="Submit Your Request">
    Visit Bright Data’s Custom Scrapers page and share the website(s) you want to scrape. Define your data needs, including specific fields, frequency, and output format.

    * If you choose the Custom Scraper (customer-led) route, you’ll provide detailed specs and schedule a validation meeting with our team.
    * If you choose the Fully Managed route, just describe your goals and we’ll take it from there.
  </Step>

  <Step title="We Build and Deploy the Scraper">
    Our team will build a dedicated scraper tailored to your requirements. We handle all the technical complexities—browser automation, proxy management, error handling, and more.
  </Step>

  <Step title="Receive Your Data">
    Once the scraper is live, you’ll receive high-quality, structured data in the format you requested. Use it to power your business decisions, analytics, or automation workflows.
  </Step>
</Steps>

## Why Custom Scrapers is the Best Choice?

When you need to extract data from a specific website, Custom Scrapers is the most reliable and efficient solution. Instead of relying on generic tools or building your own scrapers from scratch, Bright Data gives you a fully customized, production-ready solution—without the hassle.

Whether you're a business analyst, researcher, developer, or enterprise team, Custom Scrapers gives you the power to access any data from any site, exactly the way you need it.

Explore Bright Data’s Custom Scrapers today and bring your data-driven projects to life—faster, smarter, and at scale.


# Overview
Source: https://docs.brightdata.com/datasets/scrapers/overview



Bright Data’s Scrapers Library and Custom Scrapers provide a powerful, flexible solution for extracting structured data from any website—without the hassle of managing proxies, bypassing anti-bot systems, or writing complex scraping code. Accelerate your data collection with our ready-made scrapers, or let us build fully customized scrapers tailored to your exact requirements. Whether you're targeting e-commerce sites, job boards, real estate listings, or any other online source, our tools are designed to streamline the process and deliver reliable, scalable results

<CardGroup>
  <Card title="Scrapers Library" icon="book-open-cover" href="/datasets/scrapers/scrapers-library">
    Access 120+ 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="Custom Scrapers" icon="screwdriver-wrench" href="/datasets/scrapers/custom-scrapers">
    Extract data from any website—your way. Choose a customer-led setup for more control, or let our experts manage everything with a fully managed solution.
  </Card>
</CardGroup>


# AI Web Scrapers Documentation
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/ai-scrapers

This document provides an overview of the AI-powered web scrapers integrated into our system. These scrapers interact with advanced AI models to retrieve structured responses to user prompts, including relevant metadata such as sources, citations, and contextual information.

# Overview

Our platform supports the following AI scrapers:

* [ChatGPT](https://brightdata.com/products/web-scraper/chatgpt)
* [Perplexity](https://brightdata.com/products/web-scraper/perplexity)
* [Gemini](https://brightdata.com/products/web-scraper/gemini)
* [Grok](https://brightdata.com/products/web-scraper/grok)
* [Google - AI Mode](https://brightdata.com/products/web-scraper/google-ai)
* [Copilot](https://brightdata.com/products/web-scraper/microsoft-copilot)

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.

## 1. ChatGPT Scraper

The ChatGPT Scraper interfaces with OpenAI's ChatGPT model to generate detailed responses to user queries. It is optimized for conversational answers and supports a wide range of content types.

**Features:**

* Accepts a natural language prompt
* Returns a comprehensive answer

**Includes:**

* Hyperlinks to referenced content
* Citations (when available)
* Product recommendations
* Embedded map data (e.g., locations, directions)
* Country input - [Available countries](https://github.com/brightdata/answer-engines-country-codes/blob/main/chatgpt_countries.csv)

## 2. Perplexity Scraper

The Perplexity Scraper uses the Perplexity AI engine to return concise and well-sourced answers. It is particularly useful for research and fact-based queries.

**Features:**

* Accepts a natural language prompt
* Returns a direct answer

**Includes:**

* List of sources used to generate the response
* Hyperlinked citations for verification
* Country input - [Available countries](https://github.com/brightdata/answer-engines-country-codes/blob/main/perplexity_countries.csv)

## 3. Copilot Scraper

The Copilot Scraper leverages Microsoft's Copilot AI (based on OpenAI's models) to provide contextual answers with source references. It is ideal for productivity, technical, and business-related queries.

**Features:**

* Accepts a natural language prompt
* Returns a detailed answer

**Includes:**

* Referenced sources
* Hyperlinked citations
* Contextual explanations
* Country input - [Available countries](https://github.com/brightdata/answer-engines-country-codes/blob/main/copilot_countries.csv)

## 4. Gemini Scraper

The Gemini Scraper integrates with Google's Gemini AI (formerly Bard) to process natural language prompts and return informative, conversational responses. Depending on the prompt, Gemini may choose to search the web and include citations or sources in its answer.

**Features**

* Accepts a natural language prompt
* Returns a detailed, conversational answer
* Country targeting (European countries are not available)

**Includes:**

* Web-based citations and sources (if Gemini chooses to search the web)
* Hyperlinked references (when available)
* Country input - [Available countries](https://github.com/brightdata/answer-engines-country-codes/blob/main/gemini_countries.csv)

<Note>
  The decision to search the web is controlled internally by Gemini and cannot currently be forced or disabled via the scraper. Prompt phrasing may influence whether web search is triggered.
</Note>


# API Reference
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/api-reference





# Authentication Guide
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/authentication-guide



Bright Data APIs use an “API key” to authenticate requests. You can view and manage your API keys under “Account settings” in the Control Panel.

## What is Bright Data's API key?

Bright Data's API key is a secure method to replace your credentials (i.e. email address and password) when sending requests to Bright Data via API.

<Tip>
  [Guide: How to generate an API key?](https://docs.brightdata.com/api-reference/unlocker/api_token#api-token)
</Tip>

<Note>
  Only the account admin can generate a new API key for an account user
</Note>


# Error codes by Endpoint
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/error-list-by-endpoint

A list of the error codes in the system, sorted by the specific endpoint

## 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. Our team 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           |


# Web Scraper API FAQs
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/faqs

Find answers to FAQs about Bright Data's Web Scraper API, covering setup, authentication, data formats, pricing, and large-scale data extraction.

<AccordionGroup>
  <Accordion title="What is the Web Scraper API?">
    The Web Scraper API 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 Web scraper API?">
    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 Web Scraper API?">
    Getting started with Scraper APIs is straightforward, once you open your Bright Data account, you will need to [generate an API key](https://docs.brightdata.com/general/account/api-token#how-to-create-a-bright-datas-api-token) from your account settings. Once you have your key, you can refer to our [API documentation](https://docs.brightdata.com/scraping-automation/web-scraper-api/overview) for detailed instructions on making your first API call.

    <iframe width="640" height="480" src="https://app.arcade.software/share/BPGoTdRmf89Ip1EQuIOW" title="Watch a demo video" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen />
  </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 src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-pdp.png?maxW=1456&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5b04b95589ac7acbc5643b8800b0fa24" alt="delivery-pdp.png" width="1456" height="398" data-path="images/scraping-automation/web-scraper-api/faqs/delivery-pdp.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-pdp.png?w=280&maxW=1456&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=10f0c1f651af88ca0726b569dd985b0f 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-pdp.png?w=560&maxW=1456&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ed8f8aaf5b4e540d686df43542fd730e 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-pdp.png?w=840&maxW=1456&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=696d440f37fbddd006dc05f9ffee30d8 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-pdp.png?w=1100&maxW=1456&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=640accebd3dfaed51924f8f367054426 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-pdp.png?w=1650&maxW=1456&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ff7a0f2601d8241aea0404ee426f165a 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-pdp.png?w=2500&maxW=1456&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ab0cf1cd9e5531fc8ce1d5c2787c7005 2500w" data-optimize="true" data-opv="2" />
    </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 Web Scraper API?">
    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](https://docs.brightdata.com/scraping-automation/web-data-apis/web-scraper-api/trigger-a-collection), specifying the different types and expected inputs and responses.
  </Accordion>

  <Accordion title="How does the trial works?">
    You get **20 free API calls** on the account level for experimenting with the product to use for PDP type scrapers with up to 10 inputs on each call, (Discovery type scrapers are not included in the trial).

    * Calls 1-5 will return full results
    * Calls 6-15 will return partially censored results (e.g., AB\*\*\*\*\*YZ)
  </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 src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/faqs/trigger-a-collection.png?maxW=1122&auto=format&n=ilemiSHw8UogZ13k&q=85&s=cfb275af937ba95b8858af1c812f86e4" alt="trigger-a-collection.png" width="1122" height="804" data-path="images/scraping-automation/web-scraper-api/faqs/trigger-a-collection.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/faqs/trigger-a-collection.png?w=280&maxW=1122&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9979815942125c3c4c82c8584c1c6c3d 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/faqs/trigger-a-collection.png?w=560&maxW=1122&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9f2cb9844c72cf3a84a4dc8d4f33947d 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/faqs/trigger-a-collection.png?w=840&maxW=1122&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3dc523128096cea80462286cf426ada2 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/faqs/trigger-a-collection.png?w=1100&maxW=1122&auto=format&n=ilemiSHw8UogZ13k&q=85&s=7cdbac4535fa7ecebaee3abfaf97b6df 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/faqs/trigger-a-collection.png?w=1650&maxW=1122&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6dd402da8457ac4082787264137ccab9 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/faqs/trigger-a-collection.png?w=2500&maxW=1122&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3ff58683bdc0a30ad770ae0dd905dad8 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>

      <Step title="Enter your API key">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/enter-api-token.png?maxW=834&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b39ac61bfaee744c7eb0668853b35ad7" alt="enter-api-token.png" width="834" height="138" data-path="images/scraping-automation/web-scraper-api/faqs/enter-api-token.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/enter-api-token.png?w=280&maxW=834&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ba0e73814825055d8f67c3959f5ee64d 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/enter-api-token.png?w=560&maxW=834&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e7ebd77a759988f91db56d1853d2e9a0 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/enter-api-token.png?w=840&maxW=834&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7dd2a6ce4a7f7243c8ce711357221a37 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/enter-api-token.png?w=1100&maxW=834&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=0d101e6fe2d421af1f8ecd77f3f5bfd8 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/enter-api-token.png?w=1650&maxW=834&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8104a69f26ea3dfdf9a4b3f96c239f2b 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/enter-api-token.png?w=2500&maxW=834&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=31f4ddd2533b6314b92199c3d01b9835 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>

      <Step title="Select your preferred delivery method">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-method.png?maxW=1306&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=63a5e93dc34ed11d469a372859349929" alt="delivery-method.png" width="1306" height="582" data-path="images/scraping-automation/web-scraper-api/faqs/delivery-method.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-method.png?w=280&maxW=1306&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=aca66b01672f3f5001148b4660e68ef2 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-method.png?w=560&maxW=1306&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d1ea5eb2f56ab1e095da352a20af4d0c 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-method.png?w=840&maxW=1306&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=616acae631344527bc58aa09a894ff54 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-method.png?w=1100&maxW=1306&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=0371603aea7c5cfcd48c288efd6e2f11 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-method.png?w=1650&maxW=1306&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c5205717ac906df450be1c50310ba486 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/delivery-method.png?w=2500&maxW=1306&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=de5e74224efdd547ec5f54e6a46c1bec 2500w" data-optimize="true" data-opv="2" />
        </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 src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/code.png?maxW=1056&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=2674b2b205128edf499f69cd2c199da7" alt="code.png" width="1056" height="478" data-path="images/scraping-automation/web-scraper-api/faqs/code.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/code.png?w=280&maxW=1056&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7f5b3f84b1bc1d57c9692480cc43905f 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/code.png?w=560&maxW=1056&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=3401debdaff536f960de95f4a40f8fbe 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/code.png?w=840&maxW=1056&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e527fac0a71bab77bdfcbbbacb1134ba 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/code.png?w=1100&maxW=1056&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ca52a4b438e6ddfe9cfd69aa474e873b 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/code.png?w=1650&maxW=1056&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a0706017880e19aafa86276b12477770 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/code.png?w=2500&maxW=1056&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=59836cbd2bc56dca496e49b0bd7c6ac5 2500w" data-optimize="true" data-opv="2" />

        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 Web Scraper API support?">
    The Web scraper API 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 Web Scraper API?">
    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 our system’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 src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token.png?maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=96c1efb6298a7cf4b969f56f5d5258f2" alt="no-api-token.png" width="2048" height="184" data-path="images/scraping-automation/web-scraper-api/faqs/no-api-token.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token.png?w=280&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f38ceae73a83c38182de75c66a0082b3 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token.png?w=560&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=71df35b53211c66782b036aa900ec571 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token.png?w=840&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=0d64a9f0fccb473b50c8546b82eccebd 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token.png?w=1100&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9d388653127b5deb80f1e3c569fef744 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token.png?w=1650&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9789b4dc9f0f4660f80e8f2c6373ffd8 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token.png?w=2500&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a9e28b88ea184289ec4ffd80b1e3d964 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    For account users: If your API key expires, please contact your account admin to issue a new API key.

    <Frame>
            <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token-user.png?maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=bb3e40763a24882b6a4657159e476a63" alt="no-api-token-user.png" width="2048" height="193" data-path="images/scraping-automation/web-scraper-api/faqs/no-api-token-user.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token-user.png?w=280&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=6b46af0df42b0509e92fe35266edc62f 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token-user.png?w=560&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b1184dd673ba4a58933b7bf43df70870 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token-user.png?w=840&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1bb1bba8dd13a83d61fcb7896b98d104 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token-user.png?w=1100&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=4f42fad4ea170263051e9e33e9e7ff60 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token-user.png?w=1650&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=2f68220d060c3674b72fbb0534f113dd 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/web-scraper-api/faqs/no-api-token-user.png?w=2500&maxW=2048&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=cb7b812c25740462b175bdc5365bb756 2500w" data-optimize="true" data-opv="2" />
    </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 Web Scraper APIs 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 Web Scraper API?">
    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 Web Scraper API 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
    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](https://docs.brightdata.com/scraping-automation/web-data-apis/web-scraper-api/delivery-apis) 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?" defaultOpen="false">
    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 do I start the data collection when I have entered the CSV data?" defaultOpen="false" />

  <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/scraping-automation/web-scraper-api/management-apis/cancel-snapshot](https://docs.brightdata.com/scraping-automation/web-scraper-api/management-apis/cancel-snapshot)
  </Accordion>

  <Accordion title="Which domains do you provide scrapers for?" defaultOpen="false">
    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

    reuters.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?" defaultOpen="false">
    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?" defaultOpen="false">
    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](https://docs.brightdata.com/scraping-automation/web-scraper-api/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.

    Custom Scrapers

    Can’t find your target website in our list of pre-built scrapers? No problem\\! We can create a [custom scraper tailored specifically to your needs](https://docs.brightdata.com/datasets/custom-datasets/Scrape-any-web). Our 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)](https://docs.brightdata.com/scraping-automation/web-scraper-ide/introduction). This gives you full control and flexibility to create a scraper that meets your unique requirements.

    Have questions or need assistance? Our team of experts is always here to help. Let’s get started\\!
  </Accordion>

  <Accordion title="How do I scrape data from google maps?" defaultOpen="false">
    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?" defaultOpen="false">
    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](https://docs.brightdata.com/api-reference/web-scraper-api/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? " defaultOpen="false">
    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 web scraper API?">
    {/*TAGS: "results to storage"; "wsapi"; */}

    Yes, using the web scraper API 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/ ](https://docs.brightdata.com/api-reference/web-scraper-api/trigger-a-collection)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](https://docs.brightdata.com/api-reference/web-scraper-api/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 Web Scraper API 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 our system. 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 the Web Scraper API page for the Scraper you are intrested in under the API Request Builder tab, it will be already inserted in the API request for you 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 Web Scraper API 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>
</AccordionGroup>


# Clay integration
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/integrations/clay



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 Web Scraper API 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. Web Scraper API Access: You should have your Bright Data API key including authentication details, the needed endpoints, and request/response structures in place.

***

## Integration Steps

### Step 1: Set Up the Web Scraper API

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 Web Scraper API, 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 Web Scraper API (POST "T[rigger a collection](https://docs.brightdata.com/scraping-automation/web-scraper-api/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).](https://docs.brightdata.com/scraping-automation/web-scraper-api/trigger-a-collection)

   * Headers: Include any required headers, such as:

   ```JSON
     {
         "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 Web Scraper API responds with the expected data.

***

### Step 3: Process the Response in Clay

Once you’ve successfully connected to the Web Scraper API, 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.


# Overview
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/overview

Discover the Web Scraper API, use our ready-made scrapers designed to streamline data collection and enhance dataset generation. Learn about initiating scrapes, managing data, and system limitations.

The [Web Scraper API](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 up to 20 URL inputs, and batch processing for larger collections, accommodating various scraping requirements.

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/overview.png?maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=92d31a08a110fca4509f0853462f4e87" alt="overview.png" width="2048" height="1196" data-path="images/scraping-automation/web-scraper-api/overview/overview.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/overview.png?w=280&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a79be6f1bd11f42ef97727068c4730b3 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/overview.png?w=560&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=57f31dae150b0400c2c6f56a11f57082 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/overview.png?w=840&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f9703b98767299dad12d88f84b76d582 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/overview.png?w=1100&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=1cab1d7b93dd0e32d65e53c44ce6e950 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/overview.png?w=1650&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=4d35925cde95c3b8f89ba3b0ab1461e2 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/overview.png?w=2500&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=5dedd1d98d16c72605dba42a4964392b 2500w" data-optimize="true" data-opv="2" />
</Frame>

## Scraping methods

### Synchronous scraping (`/scrape`)

[Synchronous scraping](/api-reference/web-scraper-api/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
    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
      (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
      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
  [
    {
      "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/web-scraper-api/trigger-a-collection) 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
  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
      (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
      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
  {
      "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](/cn/api-reference/web-scraper-api/management-apis/monitor-progress) via status checks
* Ideal for large datasets
* Required for "discovery" tasks that need to crawl multiple pages or perform complex data extraction

### Choosing between synchronous and asynchronous scraping

| Use case                                                                    | Recommended method        |
| --------------------------------------------------------------------------- | ------------------------- |
| Quick data checks                                                           | Synchronous (`/scrape`)   |
| Single page extraction                                                      | Synchronous (`/scrape`)   |
| Multiple pages or URLs<br />(For batch processing up to 5K URLs on average) | Asynchronous (`/trigger`) |
| Complex scraping patterns                                                   | Asynchronous (`/trigger`) |
| Large datasets                                                              | Asynchronous (`/trigger`) |

## How To Collect?

## [Trigger a Collection](https://docs.brightdata.com/scraping-automation/web-data-apis/web-scraper-api/trigger-a-collection) ([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](#via-webhook:)

### 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 src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/via-webhook.png?maxW=589&auto=format&n=ilemiSHw8UogZ13k&q=85&s=18c9543946b0f80ccfa50bfc7669e964" alt="via-webhook.png" width="589" height="390" data-path="images/scraping-automation/web-scraper-api/overview/via-webhook.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/via-webhook.png?w=280&maxW=589&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0f6797c5642e24fa86512439779701a4 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/via-webhook.png?w=560&maxW=589&auto=format&n=ilemiSHw8UogZ13k&q=85&s=8ce7f9cffa2e562116344056f3609680 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/via-webhook.png?w=840&maxW=589&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6261918b57685c067795b2165b93f801 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/via-webhook.png?w=1100&maxW=589&auto=format&n=ilemiSHw8UogZ13k&q=85&s=41c63049b7a02487930a91fd2a546317 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/via-webhook.png?w=1650&maxW=589&auto=format&n=ilemiSHw8UogZ13k&q=85&s=fa10c033c45f0042b923782163429266 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/via-webhook.png?w=2500&maxW=589&auto=format&n=ilemiSHw8UogZ13k&q=85&s=12d22be09700b90334d88edb1e2cf03d 2500w" data-optimize="true" data-opv="2" />
</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 src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/via-deliver-to-external-storage.png?maxW=1148&auto=format&n=ilemiSHw8UogZ13k&q=85&s=49b5b78122790a1051491590ca800b0f" alt="via-deliver-to-external-storage.png" width="1148" height="1246" data-path="images/scraping-automation/web-scraper-api/overview/via-deliver-to-external-storage.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/via-deliver-to-external-storage.png?w=280&maxW=1148&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6221e7b0277b8bd92bcd35d5e0dc665f 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/via-deliver-to-external-storage.png?w=560&maxW=1148&auto=format&n=ilemiSHw8UogZ13k&q=85&s=24f17950392c53ca566217c874300562 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/via-deliver-to-external-storage.png?w=840&maxW=1148&auto=format&n=ilemiSHw8UogZ13k&q=85&s=37d9ca290f26dfe45b0c437aa4ef31de 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/via-deliver-to-external-storage.png?w=1100&maxW=1148&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0bdce061eb2766b7094aba4be0fdd149 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/via-deliver-to-external-storage.png?w=1650&maxW=1148&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0b0e6b2118cb09d21864239924146499 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/via-deliver-to-external-storage.png?w=2500&maxW=1148&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3458c4a7636875e00fa374b439125f05 2500w" data-optimize="true" data-opv="2" />
</Frame>

### Limit records

While running a discovery API, you can set a limit of the number of results per input provided

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-disabled.png?maxW=1214&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3b95be366a55854c66c0fe1ca3d29423" alt="limit-per-input-disabled.png" width="1214" height="115" data-path="images/scraping-automation/web-scraper-api/overview/limit-per-input-disabled.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-disabled.png?w=280&maxW=1214&auto=format&n=ilemiSHw8UogZ13k&q=85&s=fa618d0457d5fafa5ef286e7f3fcacc2 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-disabled.png?w=560&maxW=1214&auto=format&n=ilemiSHw8UogZ13k&q=85&s=4cde6a05aee0b76f0ff1eea71501dc58 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-disabled.png?w=840&maxW=1214&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e37e0fbc3b0ae4aefc7954eae5e00a51 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-disabled.png?w=1100&maxW=1214&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9b794cea860c2cb490e34cc10a1b3df7 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-disabled.png?w=1650&maxW=1214&auto=format&n=ilemiSHw8UogZ13k&q=85&s=b4336a3d8e390b9358b65ec5d4675436 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-disabled.png?w=2500&maxW=1214&auto=format&n=ilemiSHw8UogZ13k&q=85&s=1ba7b81f875957dfd9efee92aa2e18d8 2500w" data-optimize="true" data-opv="2" />
</Frame>

In the example below, we’ve set a limitation of 10 results per input

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-10.png?maxW=1182&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9b4f3ef533f66d9a43d9827c8dc0c9eb" alt="limit-per-input-10.png" width="1182" height="272" data-path="images/scraping-automation/web-scraper-api/overview/limit-per-input-10.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-10.png?w=280&maxW=1182&auto=format&n=ilemiSHw8UogZ13k&q=85&s=bcb3b343e0631e8faf7406b065dd9922 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-10.png?w=560&maxW=1182&auto=format&n=ilemiSHw8UogZ13k&q=85&s=7fa69b5094bb000c1512f77b7d576996 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-10.png?w=840&maxW=1182&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d6d76b46b6160acc180c1d58fd2b1656 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-10.png?w=1100&maxW=1182&auto=format&n=ilemiSHw8UogZ13k&q=85&s=203dc9755b912292427d2f9b1e90feee 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-10.png?w=1650&maxW=1182&auto=format&n=ilemiSHw8UogZ13k&q=85&s=713d16b0fdd0e4415c9c8a2b116a67f0 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/limit-per-input-10.png?w=2500&maxW=1182&auto=format&n=ilemiSHw8UogZ13k&q=85&s=2c82fc02dd783baea89c720f74996bc2 2500w" data-optimize="true" data-opv="2" />
</Frame>

## [Management APIs](https://docs.brightdata.com/scraping-automation/web-data-apis/web-scraper-api/management-apis)

Additional actions you can do using our different API endpoints

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/management-apis.png?maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6f28cb19f12b99a6ac047b771d9bb06a" alt="management-apis.png" width="2048" height="1060" data-path="images/scraping-automation/web-scraper-api/overview/management-apis.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/management-apis.png?w=280&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e8622cddc9914542d94e31d84efdbfa4 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/management-apis.png?w=560&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6e2527a4be6bef852fa2aa0be7ad74c9 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/management-apis.png?w=840&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=60e9560afcc2cf42c490ea63973a7163 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/management-apis.png?w=1100&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=412b211a11728a4aaf6561e2af220c5c 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/management-apis.png?w=1650&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c4bf4eca6007735368c87fe66e989ce4 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/management-apis.png?w=2500&maxW=2048&auto=format&n=ilemiSHw8UogZ13k&q=85&s=2a5f2520633f4216e4cc3d07b4084e5a 2500w" data-optimize="true" data-opv="2" />
</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](https://docs.brightdata.com/scraping-automation/web-scraper-api/management-apis/get-snapshots))

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/get-snapshot-list.png?maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=37994ba57557392490e375940fe0b9b5" alt="get-snapshot-list.png" width="835" height="192" data-path="images/scraping-automation/web-scraper-api/overview/get-snapshot-list.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/get-snapshot-list.png?w=280&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=84fa6f9d2c029be3b03070b2b0d3f0ad 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/get-snapshot-list.png?w=560&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=20dee1e3357982a43ae7da169e53d7eb 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/get-snapshot-list.png?w=840&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f5f7a516418b0e4fd9b44d4bfb8faab6 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/get-snapshot-list.png?w=1100&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d790de479bd29ed27ce9f5f07042d390 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/get-snapshot-list.png?w=1650&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=8074fb2f1afe01802ea5b0f69f50b86b 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/get-snapshot-list.png?w=2500&maxW=835&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f7fba17e40bb3bfa8d8542fab2a7a48d 2500w" data-optimize="true" data-opv="2" />
</Frame>

### 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](https://docs.brightdata.com/scraping-automation/web-data-apis/web-scraper-api/management-apis))

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=094a16f9c012b74bbf13305e7106cb14" alt="monitor-progress.png" width="828" height="151" data-path="images/scraping-automation/web-scraper-api/overview/monitor-progress.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?w=280&maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c7fb11759c6f3047ca3557195c09c9e3 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?w=560&maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=92491a0e9aca4df76035ccd7e3e42f81 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?w=840&maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=eaadc3a1a56a496312ce73ec936faa2e 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?w=1100&maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9b96773331cb32eb567c7573f2f5d30b 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?w=1650&maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=aeb11187056e5e2817ee2db0683f0d75 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?w=2500&maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a533d034f72edf2ff2bb4904389d1080 2500w" data-optimize="true" data-opv="2" />
</Frame>

### Cancel 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](https://docs.brightdata.com/scraping-automation/web-scraper-api/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](https://docs.brightdata.com/scraping-automation/web-scraper-api/management-apis/monitor-delivery))

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=094a16f9c012b74bbf13305e7106cb14" alt="monitor-progress.png" width="828" height="151" data-path="images/scraping-automation/web-scraper-api/overview/monitor-progress.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?w=280&maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c7fb11759c6f3047ca3557195c09c9e3 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?w=560&maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=92491a0e9aca4df76035ccd7e3e42f81 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?w=840&maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=eaadc3a1a56a496312ce73ec936faa2e 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?w=1100&maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9b96773331cb32eb567c7573f2f5d30b 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?w=1650&maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=aeb11187056e5e2817ee2db0683f0d75 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-scraper-api/overview/monitor-progress.png?w=2500&maxW=828&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a533d034f72edf2ff2bb4904389d1080 2500w" data-optimize="true" data-opv="2" />
</Frame>

## System limitations

### 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 Web Scraper API 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 Web Scraper API supports the following maximum number of concurrent requests:

| Method                      | Rate-limit                     |
| :-------------------------- | :----------------------------- |
| Up to 20 inputs per request | up to 1500 concurrent requests |
| Over 20 inputs per request  | up to 100 concurrent requests  |

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

### **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.


# Web Scraper API - Quick Start
Source: https://docs.brightdata.com/datasets/scrapers/scrapers-library/quickstart



<Steps>
  <Step title="Prerequisites" stepNumber="0">
    * A Bright Data account (Sign Up → 2 min)
    * An active API Key ([How to get an API Key](https://docs.brightdata.com/api-reference/authentication))
  </Step>

  <Step title="Pick the target site" stepNumber="1">
    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 [Custom Scrapers](https://docs.brightdata.com/datasets/scrapers/custom-scrapers/scrape-any-web) or [Web Scraper IDE](https://docs.brightdata.com/datasets/functions/introduction) products for a solution tailored to your needs!
  </Step>

  <Step title="Choose the scraper endpoint" stepNumber="2">
    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 API Request Builder.

    <Frame>
            <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/scrapers/scraping-library/quickstart/collect-by-url.png?maxW=1507&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5b12bb3bc8c081748d31a734efc79475" alt="collect-by-url" width="1507" height="1229" data-path="images/datasets/scrapers/scraping-library/quickstart/collect-by-url.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/scrapers/scraping-library/quickstart/collect-by-url.png?w=280&maxW=1507&auto=format&n=2RrKkArDJDw55ilE&q=85&s=c7c84e0fb14456aa2a8e61d08a749e3d 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/scrapers/scraping-library/quickstart/collect-by-url.png?w=560&maxW=1507&auto=format&n=2RrKkArDJDw55ilE&q=85&s=6746a8ec8fecfae4ea3b4e5c1f3cdc27 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/scrapers/scraping-library/quickstart/collect-by-url.png?w=840&maxW=1507&auto=format&n=2RrKkArDJDw55ilE&q=85&s=4fc87d71f08753904233d5afd1b7d930 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/scrapers/scraping-library/quickstart/collect-by-url.png?w=1100&maxW=1507&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0af1508345dafebe20ec2e721b90ed5a 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/scrapers/scraping-library/quickstart/collect-by-url.png?w=1650&maxW=1507&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b42809859bef8ee0207df7ada35cb73f 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/scrapers/scraping-library/quickstart/collect-by-url.png?w=2500&maxW=1507&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7700065790ff62e62cd1975c7b3d8e90 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Build the request" stepNumber="3">
    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" stepNumber="4">
    The Code Snippet panel (right side) updates live according to your configuration setup. To run the request you can choose between two endpoints:

    | Mode  | Path                                                                                      | Behaviour                                                                                                                                      | Good For                                        |
    | :---- | :---------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------- |
    | Sync  | [/scrape](https://docs.brightdata.com/api-reference/web-scraper-api/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 | [/trigger](https://docs.brightdata.com/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" stepNumber="5">
    * 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" stepNumber="6">
    1. Scraper page → Logs tab

    <Frame>
            <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/scrapers/scraping-library/quickstart/logs-tab.png?maxW=624&auto=format&n=2RrKkArDJDw55ilE&q=85&s=363d2bce81249152dfbd55d24a0ab7fd" alt="logs-tab" width="624" height="191" data-path="images/datasets/scrapers/scraping-library/quickstart/logs-tab.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/scrapers/scraping-library/quickstart/logs-tab.png?w=280&maxW=624&auto=format&n=2RrKkArDJDw55ilE&q=85&s=8c903d86cd34e49741beac4f23442aa0 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/scrapers/scraping-library/quickstart/logs-tab.png?w=560&maxW=624&auto=format&n=2RrKkArDJDw55ilE&q=85&s=96371fffdb7f3c0c7e10e2a2922ab0d0 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/scrapers/scraping-library/quickstart/logs-tab.png?w=840&maxW=624&auto=format&n=2RrKkArDJDw55ilE&q=85&s=e0567ed5de15c771e5958da1170c64cf 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/scrapers/scraping-library/quickstart/logs-tab.png?w=1100&maxW=624&auto=format&n=2RrKkArDJDw55ilE&q=85&s=e0bcaf9c89cd5330c6c3c6c7ab9ff081 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/scrapers/scraping-library/quickstart/logs-tab.png?w=1650&maxW=624&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d132a7b5872b431a94ced00c6e47d787 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/datasets/scrapers/scraping-library/quickstart/logs-tab.png?w=2500&maxW=624&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0c176f278576c061dd57dfe72f0bccfb 2500w" data-optimize="true" data-opv="2" />
    </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](https://docs.brightdata.com/api-reference/web-scraper-api/management-apis/monitor-progress)
       * Use these endpoints to monitor the snapshot progress.
  </Step>
</Steps>

🎉 You’re now ready to scrape at scale — happy collecting!


# Functions
Source: https://docs.brightdata.com/functions-quickstart





# Billing
Source: https://docs.brightdata.com/general/account/billing-and-pricing/billing



<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 our service.

    <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 automaticlly 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?

    * Our system 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 $
      1\.
    * 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. On the 1st of the month, you will receive an invoice. 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 our service, 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 />
      </Step>

      <Step title="Add name and email address" />

      <Step title="Click on the &#x22;Add&#x22; button">
        <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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=461ba2fad1ade576a4b7636303201a38" alt="suspend-account.gif" width="1636" height="930" data-path="images/general/account/management/suspend-account.gif" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=280&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=ffacd4b65d0bc5d426e83604bed389d8 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=560&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=3671d8c5ac1587c00328d2b1bcc84551 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=840&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=fceba9b829928b927402d4afc8644830 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=1100&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=89cc585e58fbd3508922f8df031b9b74 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=1650&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=8628a80ddde18def9f86207fba43fe89 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=2500&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=9d6d2e3ea432805c6a3cf10ad622b2ec 2500w" data-optimize="true" data-opv="2" />
    </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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0679252187dcfcbbcb7ea6933ff224d3" alt="billing.png" width="1636" height="908" data-path="images/general/account/management/billing.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=280&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=74f77cfe2a0a1b803959f5c91ccf807a 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=560&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=275eefd9fbab4348f48a95acb827cf15 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=840&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a3b0159fb5f9796c846936da4c195c49 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=1100&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=85cac55acaa2cb75b10774b80bab38ed 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=1650&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=68cda9963a09fe6fadb8251c930a42b2 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=2500&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f9f5ac28559057e8bd37f68a7bce4ffc 2500w" data-optimize="true" data-opv="2" />

            <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2cb4c6f0fba79d02253bfc9de5752865" alt="payment-settings.png" width="1636" height="906" data-path="images/general/account/management/payment-settings.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=280&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=be1def4c17998b60ec90db3740a3313d 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=560&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=56277ebb81c6c579adbff893c6ed6be0 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=840&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f85bf08c6412d085c8a2cf3725fa637e 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=1100&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5decdee1951245ce50a78142d82c0a8e 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=1650&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7fbacafe6d64ac4640abf5c80fc88541 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=2500&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=48466fed40c5f77fad47c9b15dee0763 2500w" data-optimize="true" data-opv="2" />

            <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=05fe690214c08c8768ef61f47ce5f129" alt="confirm.png" width="1636" height="930" data-path="images/general/account/management/confirm.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=280&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=1ab229ead7204b277947e50dd95ee6d4 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=560&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f28e922cead5523d167721d41c5d0bd8 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=840&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=551aabe9e218d1d0cb3256a881ad649c 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=1100&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2156e393892f3251923cd07bc6c64c68 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=1650&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=66f6137d8aa5a5241e7e21737bbdc37c 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=2500&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=c8c0ab9aefd38282e9440be3cedd8df1 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>
</AccordionGroup>


# About the Bright Rewards Program
Source: https://docs.brightdata.com/general/account/billing-and-pricing/bright-rewards-program

This program is designed to reward our loyal customers for their continued usage of our services. Eligible users will receive Bright Points on a monthly basis to purchase Bright Data services with.

## 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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/bright-rewards-program/earn-and-redeem-points.png?maxW=1254&auto=format&n=2RrKkArDJDw55ilE&q=85&s=29e1043ab424ddf3baf3a35a9653e032" alt="earn-and-redeem-points.png" width="1254" height="256" data-path="images/general/account/billing-and-pricing/bright-rewards-program/earn-and-redeem-points.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/bright-rewards-program/earn-and-redeem-points.png?w=280&maxW=1254&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5d03468ad368c1f492acc8a1b7674108 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/bright-rewards-program/earn-and-redeem-points.png?w=560&maxW=1254&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5eaff8b9ebdfebdc7a3d2c7537811a64 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/bright-rewards-program/earn-and-redeem-points.png?w=840&maxW=1254&auto=format&n=2RrKkArDJDw55ilE&q=85&s=19fd3326dd0d02285a5242cd1b0759b5 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/bright-rewards-program/earn-and-redeem-points.png?w=1100&maxW=1254&auto=format&n=2RrKkArDJDw55ilE&q=85&s=c49e3eb726d879501cf79fde8ec5a3dc 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/bright-rewards-program/earn-and-redeem-points.png?w=1650&maxW=1254&auto=format&n=2RrKkArDJDw55ilE&q=85&s=548f1e3f35df21fedfaa8e8aafe5672d 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/bright-rewards-program/earn-and-redeem-points.png?w=2500&maxW=1254&auto=format&n=2RrKkArDJDw55ilE&q=85&s=8bf8851c830d35573cd125c4e4d16b74 2500w" data-optimize="true" data-opv="2" />
</Frame>

<Info>
  For more information [please see here](https://brightdata.com/bright-rewards)
</Info>


# Keeping track of your usage: Costs Explorer
Source: https://docs.brightdata.com/general/account/billing-and-pricing/costs-explorer

We understand the importance of transparency and control over your data usage and expenses. That's why we've introduced the Cost Explorer feature, a powerful tool designed to give you detailed insights into your usage statistics and costs

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

### Real-Time Accuracy

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.

### Customization Options

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.


# FAQs
Source: https://docs.brightdata.com/general/account/billing-and-pricing/faqs



<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)

    Once you reach your daily usage the Zone will automatically be suspended.

    <Frame>
            <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/cost-structure/limit-daily-usage.gif?maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=be56f810f1eab8bea9badfb96bd8ee22" alt="limit-daily-usage.gif" width="1636" height="930" data-path="images/general/account/billing-and-pricing/cost-structure/limit-daily-usage.gif" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/cost-structure/limit-daily-usage.gif?w=280&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=4e39c83c4e21fb8df3e54e08b58bbd1d 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/cost-structure/limit-daily-usage.gif?w=560&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b2d2d0dd8db3696efda2212f37d5ee42 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/cost-structure/limit-daily-usage.gif?w=840&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=028d59b763ed6f1b22a4466ea87d6575 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/cost-structure/limit-daily-usage.gif?w=1100&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=de8116411b8a445f3b33715b3d4897d9 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/cost-structure/limit-daily-usage.gif?w=1650&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=740adebd19027140e606e4cf978f5ed9 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/cost-structure/limit-daily-usage.gif?w=2500&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=31082164e1e7cea15eb726ad9f75a84a 2500w" data-optimize="true" data-opv="2" />
    </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.

    For additional details, see [here](https://docs.brightdata.com/general/faqs#what-is-playground-mode).

    <Info>
      to help with trial configurations.
    </Info>
  </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?" defaultOpen="false">
    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? " defaultOpen="false">
    {/* TAGS: Why is my bandwidth like this?; why was I billed this much?; how is my usage 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? " defaultOpen="false">
    {/* TAGS: "Payment Failed. Try again" */}

    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>


# Payment
Source: https://docs.brightdata.com/general/account/billing-and-pricing/payment



<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 sending an email to [sales@brightdata.com](mailto:sales@brightdata.com) or by contacting your account manager directly, Make sure to elaborate on your case in the request.
    Any funds that were added as a promotional bonus are of course not eligible for refund.&#x20;
  </Accordion>
</AccordionGroup>


# Accepted Payment Methods
Source: https://docs.brightdata.com/general/account/billing-and-pricing/payment-methods

We have an automated billing system that supports a host of payment methods

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


# Premium IPs (deprecated)
Source: https://docs.brightdata.com/general/account/billing-and-pricing/premium-ips

Premium IPs have deprecated and Bright Data does no longer offer them. 



# Bright Data Promo Codes
Source: https://docs.brightdata.com/general/account/billing-and-pricing/promo-codes



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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/billing-button.png?maxW=1918&auto=format&n=2RrKkArDJDw55ilE&q=85&s=cadc29f2c1e79ce1de62f75de5c6de5e" alt="billing-button" width="1918" height="911" data-path="images/general/account/billing-and-pricing/promo-codes/billing-button.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/billing-button.png?w=280&maxW=1918&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b1fa062d2bd8a5e51cd7186132a1df35 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/billing-button.png?w=560&maxW=1918&auto=format&n=2RrKkArDJDw55ilE&q=85&s=ca84608e952839da96607da2eb55bc8b 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/billing-button.png?w=840&maxW=1918&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d39cdadfbb19c14b78af185031b02c96 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/billing-button.png?w=1100&maxW=1918&auto=format&n=2RrKkArDJDw55ilE&q=85&s=75c25265e0111fef4d1f8668477c8743 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/billing-button.png?w=1650&maxW=1918&auto=format&n=2RrKkArDJDw55ilE&q=85&s=39dd5d4be1326d376788c19a11d814b1 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/billing-button.png?w=2500&maxW=1918&auto=format&n=2RrKkArDJDw55ilE&q=85&s=87bbc1e74445ed4c4a413180a5f8468e 2500w" data-optimize="true" data-opv="2" />
    </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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/click-on-apply-promo-code.png?maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f398aebb339181ebdca63d9bd982240b" alt="click-on-apply-promo-code" width="3400" height="1708" data-path="images/general/account/billing-and-pricing/promo-codes/click-on-apply-promo-code.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/click-on-apply-promo-code.png?w=280&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=c145858d88881e0f1697de82890e7e7e 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/click-on-apply-promo-code.png?w=560&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b11297a46daa545fed8af4bb293c31a4 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/click-on-apply-promo-code.png?w=840&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=1ba64aea7f03341f07519ca475a5b9ae 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/click-on-apply-promo-code.png?w=1100&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5ea40867ab82a425ea4c7c7b69e88074 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/click-on-apply-promo-code.png?w=1650&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=95b0334d11038627e285ce6f2501d7c9 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/click-on-apply-promo-code.png?w=2500&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=62dae6f153c6612f311ae6b5067f1f84 2500w" data-optimize="true" data-opv="2" />
        </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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/enter-promo-code.png?maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5ed6dc87835e13103858b75cc2c8cd8f" alt="enter-promo-code" width="3400" height="1708" data-path="images/general/account/billing-and-pricing/promo-codes/enter-promo-code.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/enter-promo-code.png?w=280&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=70113e8c1c2572baec7c557a3a7491cd 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/enter-promo-code.png?w=560&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=fd7064eec13daae5fbed76f604f8348c 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/enter-promo-code.png?w=840&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=c077e91aa1b931ed04bc86086c5cece3 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/enter-promo-code.png?w=1100&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=46f356a515ae5533833882c250ade846 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/enter-promo-code.png?w=1650&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=753e82277114d795d2c162c1ac16cb80 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/enter-promo-code.png?w=2500&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b0b38d114461c5e43a156db383780878 2500w" data-optimize="true" data-opv="2" />
        </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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-promo-added.png?maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=bb1db87b6a763b0e48533ba79e6873f8" alt="payg-promo-added.png" width="3400" height="1708" data-path="images/general/account/billing-and-pricing/promo-codes/payg-promo-added.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-promo-added.png?w=280&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=21cf8078bfbfb409cd557d835739c182 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-promo-added.png?w=560&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=12d8c4915fbb4acf576c6a67f6e51a8f 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-promo-added.png?w=840&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=bf922fb888e2624cb7dfdff8c8e1afc7 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-promo-added.png?w=1100&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d9fb67ed453c6d4f567f7a908c6bb1de 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-promo-added.png?w=1650&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=85ac18b6e465fd61be21d84d61a3300c 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-promo-added.png?w=2500&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=14b7c1325767fd763ad68cfee8895286 2500w" data-optimize="true" data-opv="2" />
        </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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-confirm-discount.png?maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f9a9eddd2dfe4a1f67d676bd4a095d3b" alt="payg-confirm-discount" width="3400" height="1708" data-path="images/general/account/billing-and-pricing/promo-codes/payg-confirm-discount.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-confirm-discount.png?w=280&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=72f2ad6fd6c2b363ea867307c412b9fd 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-confirm-discount.png?w=560&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=156e0165d9bceb7a62ea3e74d3e86647 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-confirm-discount.png?w=840&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a74244a0835d825337b3b5d5f3ee0ffb 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-confirm-discount.png?w=1100&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0cf12204c0cba12d08ab1254a8552794 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-confirm-discount.png?w=1650&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=060fd17820243d8d3586ab8650b15ad7 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/payg-confirm-discount.png?w=2500&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=65a24683d7a5adb9175a326811b89301 2500w" data-optimize="true" data-opv="2" />
        </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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/change-plan.png?maxW=1564&auto=format&n=2RrKkArDJDw55ilE&q=85&s=597815599a55f790a694baf952816fd5" alt="change-plan" width="1564" height="837" data-path="images/general/account/billing-and-pricing/promo-codes/change-plan.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/change-plan.png?w=280&maxW=1564&auto=format&n=2RrKkArDJDw55ilE&q=85&s=89ed7bc56f67743ef9452b7680c2d94e 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/change-plan.png?w=560&maxW=1564&auto=format&n=2RrKkArDJDw55ilE&q=85&s=cfef64321dae8b311804d95f49c73353 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/change-plan.png?w=840&maxW=1564&auto=format&n=2RrKkArDJDw55ilE&q=85&s=80413a3fc5036a2198e0e8347770f80c 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/change-plan.png?w=1100&maxW=1564&auto=format&n=2RrKkArDJDw55ilE&q=85&s=23bc23aa16a4d645a2bf84bae1390e7c 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/change-plan.png?w=1650&maxW=1564&auto=format&n=2RrKkArDJDw55ilE&q=85&s=c32f026b14ab39a73940635d5cefb640 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/change-plan.png?w=2500&maxW=1564&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7254fcc54540b8d0b41fd942703e5412 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>

      <Step title="Select the Subscription">
        Select the subscription plan of your choice and click on the "Upgrade" button.

        <Frame>
                    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/subscription-plans.png?maxW=1183&auto=format&n=2RrKkArDJDw55ilE&q=85&s=68290db47b72db2a7dc4fd8d718ae9b0" alt="subscription-plans" width="1183" height="849" data-path="images/general/account/billing-and-pricing/promo-codes/subscription-plans.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/subscription-plans.png?w=280&maxW=1183&auto=format&n=2RrKkArDJDw55ilE&q=85&s=4f48b02eac9532d375d396cf19d5ebc6 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/subscription-plans.png?w=560&maxW=1183&auto=format&n=2RrKkArDJDw55ilE&q=85&s=e9e07a89df85cc3dbe13dcc1c32ad009 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/subscription-plans.png?w=840&maxW=1183&auto=format&n=2RrKkArDJDw55ilE&q=85&s=049d28e8bfa42a104f13453b35bf9794 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/subscription-plans.png?w=1100&maxW=1183&auto=format&n=2RrKkArDJDw55ilE&q=85&s=4626e42d48ddd89692784d0eda08544c 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/subscription-plans.png?w=1650&maxW=1183&auto=format&n=2RrKkArDJDw55ilE&q=85&s=14d54a05f325c27c37cfab202dd14b6a 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/subscription-plans.png?w=2500&maxW=1183&auto=format&n=2RrKkArDJDw55ilE&q=85&s=33d27948a98e5b12aef884a5ee1e6fc1 2500w" data-optimize="true" data-opv="2" />
        </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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/apply-promo-code.png?maxW=1095&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a98b44b79374b40445523adbbd652fe3" alt="apply-promo-code" width="1095" height="699" data-path="images/general/account/billing-and-pricing/promo-codes/apply-promo-code.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/apply-promo-code.png?w=280&maxW=1095&auto=format&n=2RrKkArDJDw55ilE&q=85&s=e8b9287a0b2de53b5b132713dae10aaf 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/apply-promo-code.png?w=560&maxW=1095&auto=format&n=2RrKkArDJDw55ilE&q=85&s=ae2a85f6c1097fb21b32b726e96009ee 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/apply-promo-code.png?w=840&maxW=1095&auto=format&n=2RrKkArDJDw55ilE&q=85&s=8eed4b2bed9a972b01f25b5a76827797 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/apply-promo-code.png?w=1100&maxW=1095&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b770928744d2fdd89a0923665c1bac9c 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/apply-promo-code.png?w=1650&maxW=1095&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0d426b64c09b4b1c7b3d1ad13a676f17 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/apply-promo-code.png?w=2500&maxW=1095&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5f1dd8743e28cfdbc27f9138556f4b37 2500w" data-optimize="true" data-opv="2" />
        </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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-promo-added.png?maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=74643cb19fe2612ff11a61dc984ec515" alt="sub-promo-added.png" width="3400" height="1708" data-path="images/general/account/billing-and-pricing/promo-codes/sub-promo-added.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-promo-added.png?w=280&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f02f6f0d6b7a36537c0b06d5a747b3b6 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-promo-added.png?w=560&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=e393e7f91309d888fc9c00cfc09f4843 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-promo-added.png?w=840&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=eef3682ad9335538aa6bdcb75ae8504a 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-promo-added.png?w=1100&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2095f9e5e7ae9668f9a20edac4ae0997 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-promo-added.png?w=1650&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=3a2439719d4feee8e52f8ba2cf201009 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-promo-added.png?w=2500&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d927a0ebe03ece8368ca0345e5780dbc 2500w" data-optimize="true" data-opv="2" />
        </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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-confirm-discount.png?maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0c916fe5546ab894a17f09ac42e6e40d" alt="sub-confirm-discount" width="3400" height="1708" data-path="images/general/account/billing-and-pricing/promo-codes/sub-confirm-discount.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-confirm-discount.png?w=280&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=ff6b21579efdd7c71260eae9f78dc273 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-confirm-discount.png?w=560&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a4a3d3d0adcad2a4233b4da46ec0bef0 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-confirm-discount.png?w=840&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=ee2208988c734df272ae53d12d17f332 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-confirm-discount.png?w=1100&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a1a0989c388ee60723577317dfd932f4 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-confirm-discount.png?w=1650&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=97389e9d30f0789f7483cbd0864da686 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/billing-and-pricing/promo-codes/sub-confirm-discount.png?w=2500&maxW=3400&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0b72da3b22c8e89c945a757c9f22d9b4 2500w" data-optimize="true" data-opv="2" />
        </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, the dollar-for-dollar matching offer will apply when you make your first deposit into your account, and we will match that deposit up to \$500.

    <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



<AccordionGroup>
  <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="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, or by emailing [sales@brightdata.com](mailto:sales@brightdata.com).
  </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="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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=09367e30af944caf167bf8a0ffc46829" alt="invoice_recipients_1.png" width="1832" height="971" data-path="images/general/account/management/invoice_recipients_1.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?w=280&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=1983cb5945ff947e6c286bc6f8ab99a8 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?w=560&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f54aaa54c041320ada6767706a1e7a5b 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?w=840&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d6a957e29daea06bbe7be8cb79aff3da 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?w=1100&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=80be0487679dc68b41c0737045dd1e9a 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?w=1650&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a8a35399b5b52f88a3d0eb8bf3ed2516 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_1.png?w=2500&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=4866ebbefac11eccf6b9a4a3b629e2ab 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>

      <Step title="Inside the opened &#x22;Invoice recipients&#x22; screen, click on the &#x22;+ Add new recipient&#x22; button button">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0d042c1ea0b4b8dc76fabe7320fe42ca" alt="invoice_recipients_2.png" width="1832" height="971" data-path="images/general/account/management/invoice_recipients_2.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?w=280&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=cb2082331db22e71f5a5a863e091e048 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?w=560&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f6786b1016e02063457c96a60e30b6ea 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?w=840&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2c90a1517e982e3e520ffd65c141875e 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?w=1100&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a1bf6f49b135c41d2560d9e014aa2378 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?w=1650&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=4972f48ab86a5e206659037950091f8f 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_2.png?w=2500&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d8969c06b36840e1fa5e88cb48d77e60 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Step>

      <Step title="Add name and email address" />

      <Step title="Click on the &#x22;Add&#x22; button">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=acbf69c45c0a99e93befee928028833a" alt="invoice_recipients_3.png" width="1832" height="971" data-path="images/general/account/management/invoice_recipients_3.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?w=280&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=048c906142eb824ec76e688b4df60b3c 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?w=560&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=8f4cf055730c467654dc724263359282 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?w=840&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=868c04a24357978015f13017eebe5751 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?w=1100&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b850084212797f6a998b1423cc81d683 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?w=1650&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=363db4ee96f448d3790e8f5e92d0b63a 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/invoice_recipients_3.png?w=2500&maxW=1832&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2bf2b5e12c030cbad5365c9c8aab618d 2500w" data-optimize="true" data-opv="2" />
        </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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=461ba2fad1ade576a4b7636303201a38" alt="suspend-account.gif" width="1636" height="930" data-path="images/general/account/management/suspend-account.gif" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=280&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=ffacd4b65d0bc5d426e83604bed389d8 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=560&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=3671d8c5ac1587c00328d2b1bcc84551 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=840&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=fceba9b829928b927402d4afc8644830 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=1100&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=89cc585e58fbd3508922f8df031b9b74 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=1650&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=8628a80ddde18def9f86207fba43fe89 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/suspend-account.gif?w=2500&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=9d6d2e3ea432805c6a3cf10ad622b2ec 2500w" data-optimize="true" data-opv="2" />
    </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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0679252187dcfcbbcb7ea6933ff224d3" alt="billing.png" width="1636" height="908" data-path="images/general/account/management/billing.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=280&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=74f77cfe2a0a1b803959f5c91ccf807a 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=560&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=275eefd9fbab4348f48a95acb827cf15 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=840&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a3b0159fb5f9796c846936da4c195c49 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=1100&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=85cac55acaa2cb75b10774b80bab38ed 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=1650&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=68cda9963a09fe6fadb8251c930a42b2 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/billing.png?w=2500&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f9f5ac28559057e8bd37f68a7bce4ffc 2500w" data-optimize="true" data-opv="2" />
            <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2cb4c6f0fba79d02253bfc9de5752865" alt="payment-settings.png" width="1636" height="906" data-path="images/general/account/management/payment-settings.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=280&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=be1def4c17998b60ec90db3740a3313d 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=560&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=56277ebb81c6c579adbff893c6ed6be0 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=840&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f85bf08c6412d085c8a2cf3725fa637e 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=1100&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5decdee1951245ce50a78142d82c0a8e 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=1650&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7fbacafe6d64ac4640abf5c80fc88541 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/payment-settings.png?w=2500&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=48466fed40c5f77fad47c9b15dee0763 2500w" data-optimize="true" data-opv="2" />
            <img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=05fe690214c08c8768ef61f47ce5f129" alt="confirm.png" width="1636" height="930" data-path="images/general/account/management/confirm.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=280&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=1ab229ead7204b277947e50dd95ee6d4 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=560&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f28e922cead5523d167721d41c5d0bd8 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=840&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=551aabe9e218d1d0cb3256a881ad649c 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=1100&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2156e393892f3251923cd07bc6c64c68 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=1650&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=66f6137d8aa5a5241e7e21737bbdc37c 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/account/management/confirm.png?w=2500&maxW=1636&auto=format&n=2RrKkArDJDw55ilE&q=85&s=c8c0ab9aefd38282e9440be3cedd8df1 2500w" data-optimize="true" data-opv="2" />
    </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>
</AccordionGroup>


# Account Management Overview
Source: https://docs.brightdata.com/general/account/overview

Explore and manage your account settings, billing, team access, and more.

<Card>
  <CardGroup cols={2}>
    <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

Bright Data’s referral program offers a simple way to earn by recommending our platform to others. Whether you're introducing a colleague or suggesting Bright Data to a business, you can receive up to 50% of the revenue from each customer you bring in. This guide breaks down how the program works, how it differs from the affiliate program, and how you can start earning today.

Bright Data's referral program offers a straightforward way to earn rewards by introducing others to our platform. 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



<Note>
  You can use Bright Data products without the SSL certificate:

  1. Using **Bright Data proxy API**. Read more: [API vs. native Access](https://docs.brightdata.com/api-reference/api-vs-native-access)
  2. Get your account **verified** with our [KYC process](https://docs.brightdata.com/proxy-networks/residential/network-access#kyc-verification)
</Note>

The SSL certificate allows you to establish end-to-end encrypted connections when using [Residential Proxies](https://docs.brightdata.com/proxy-networks/residential/introduction), [Mobile proxies](https://docs.brightdata.com/proxy-networks/mobile/introduction), [Unlocker API](https://docs.brightdata.com/scraping-automation/web-unlocker/introduction) or the [SERP API](https://docs.brightdata.com/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 has a **new** SSL certificate with works with proxy port: `33335`. </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 Certficate

<Warning> Bright Data new SSL certificate support for browser extension is coming soon. **Refrain** from upgrading to the new certificate if you use the Browser Extension </Warning>

Bright data now using an updated SSL Certificate which expires in September 2034. When using this certificate it is essential to configure your native proxy port to be `33335` which is the port serving requests secured by the new certificate.

If you use our old SSL certificate note that it is deprecated and expires in September 2026, and works towards port `22225`. To ensure your smooth and secure operations use the **new** certificate with port `33335`. Read more in: [FAQ: Which port shall I use 22225 or 33335](https://docs.brightdata.com/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
curl --proxy brd.superproxy.io:33335 --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.

### Installation instructions

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, 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 src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/browser-settings.png?maxW=328&auto=format&n=JpbB64sgI_r6D502&q=85&s=791cc2c607d3d13c7464010a67f40bc0" alt="browser-settings.png" width="328" height="639" data-path="images/general/faqs/proxy-networks/browser-settings.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/browser-settings.png?w=280&maxW=328&auto=format&n=JpbB64sgI_r6D502&q=85&s=da13be814c7f4a6ac8acd9035b00189f 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/browser-settings.png?w=560&maxW=328&auto=format&n=JpbB64sgI_r6D502&q=85&s=a129f5a9b8982f68482257e0f258cf8f 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/browser-settings.png?w=840&maxW=328&auto=format&n=JpbB64sgI_r6D502&q=85&s=11ecb004af0076e9e9987c4aef356070 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/browser-settings.png?w=1100&maxW=328&auto=format&n=JpbB64sgI_r6D502&q=85&s=8a67f1905b1e9ce68c795b1983ddbb63 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/browser-settings.png?w=1650&maxW=328&auto=format&n=JpbB64sgI_r6D502&q=85&s=c6373e1dced8b9a7954b6b9149b0ee51 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/browser-settings.png?w=2500&maxW=328&auto=format&n=JpbB64sgI_r6D502&q=85&s=896bd65b7fa149f106c3e86b5c67f34f 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="Go to Privacy and security and click on Security">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/privacy-and-security.png?maxW=1369&auto=format&n=JpbB64sgI_r6D502&q=85&s=97f690f3c265a5b1acb968aeaf63d45b" alt="privacy-and-security.png" width="1369" height="707" data-path="images/general/faqs/proxy-networks/privacy-and-security.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/privacy-and-security.png?w=280&maxW=1369&auto=format&n=JpbB64sgI_r6D502&q=85&s=644e0ec062a92e20d05e07b5f676a620 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/privacy-and-security.png?w=560&maxW=1369&auto=format&n=JpbB64sgI_r6D502&q=85&s=cef7b3e3c88331e2e5c09e3dc0fb000b 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/privacy-and-security.png?w=840&maxW=1369&auto=format&n=JpbB64sgI_r6D502&q=85&s=0973ec2531a5b696aae58fe152730f80 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/privacy-and-security.png?w=1100&maxW=1369&auto=format&n=JpbB64sgI_r6D502&q=85&s=d4e6569f3d55422abf1e6be38e40afaa 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/privacy-and-security.png?w=1650&maxW=1369&auto=format&n=JpbB64sgI_r6D502&q=85&s=d6928e3944cef242b058b24868daf303 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/privacy-and-security.png?w=2500&maxW=1369&auto=format&n=JpbB64sgI_r6D502&q=85&s=a10e6bad30a3d894ab89940388dcfd80 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="Scroll down and click on Manage certificate">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/manage-certificate.png?maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=da9136a6d648f19f3c9c2fc024f3415e" alt="manage-certificate.png" width="1343" height="861" data-path="images/general/faqs/proxy-networks/manage-certificate.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/manage-certificate.png?w=280&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=ebdce8d69ec188e2ed4507c6e03b0055 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/manage-certificate.png?w=560&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=c006b980541d9d75dfed1081df21a50d 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/manage-certificate.png?w=840&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=b4cac3dd309b09e60704021a28f86ac2 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/manage-certificate.png?w=1100&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=f2f747af84f03f6ecef0d3d96406b072 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/manage-certificate.png?w=1650&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=41546fee949a249aaccdabd90c15b342 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/manage-certificate.png?w=2500&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=0406d41abf99fb60312a12005b095ab9 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="Go to Trusted Certification Authorities and click Import">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-certification-authorities.png?maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=ab0a662c80162697e0988842acd4351a" alt="trusted-certification-authorities.png" width="1343" height="861" data-path="images/general/faqs/proxy-networks/trusted-certification-authorities.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-certification-authorities.png?w=280&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=7ca0d49f5b9001e05016f7a3ce7e0bc4 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-certification-authorities.png?w=560&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=2105a367cfd0b693ce93945eeb956f4d 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-certification-authorities.png?w=840&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=2f1ec81b7f93534adac69b4a4f9d2c24 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-certification-authorities.png?w=1100&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=91f1e1ad49f8782cd0a87eaf100c10a4 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-certification-authorities.png?w=1650&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=e034b275b06d1299e368d5681abd7805 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-certification-authorities.png?w=2500&maxW=1343&auto=format&n=JpbB64sgI_r6D502&q=85&s=8b308a5a086c744f352c948915f6deb9 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="Click on Next">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-next.png?maxW=553&auto=format&n=JpbB64sgI_r6D502&q=85&s=a9f53ab37b9dc202212a04e2e9030cd9" alt="click-next.png" width="553" height="532" data-path="images/general/faqs/proxy-networks/click-next.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-next.png?w=280&maxW=553&auto=format&n=JpbB64sgI_r6D502&q=85&s=fb76e6c3b9a8982728e4b5699dee7b69 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-next.png?w=560&maxW=553&auto=format&n=JpbB64sgI_r6D502&q=85&s=f212b587109e40d7032a7dba5a877631 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-next.png?w=840&maxW=553&auto=format&n=JpbB64sgI_r6D502&q=85&s=46c867b652531473aac6c2820ea17bb8 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-next.png?w=1100&maxW=553&auto=format&n=JpbB64sgI_r6D502&q=85&s=5fc698a062b6ab6854dd79aab5b4b4be 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-next.png?w=1650&maxW=553&auto=format&n=JpbB64sgI_r6D502&q=85&s=b8fd509f8b98a2f7b0b01480a1fdad1e 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-next.png?w=2500&maxW=553&auto=format&n=JpbB64sgI_r6D502&q=85&s=37e9b04a20bba1f232923f00596c340d 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="Click Browse and select the certificate you just downloaded, and click Next">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-browse.png?maxW=562&auto=format&n=JpbB64sgI_r6D502&q=85&s=5330686f6d054f65065c4be2cdfc9ab0" alt="click-browse.png" width="562" height="545" data-path="images/general/faqs/proxy-networks/click-browse.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-browse.png?w=280&maxW=562&auto=format&n=JpbB64sgI_r6D502&q=85&s=f7e03faa14f92d14e278f7b90f7e92a9 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-browse.png?w=560&maxW=562&auto=format&n=JpbB64sgI_r6D502&q=85&s=0126983fff8924b669995a1175c138e2 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-browse.png?w=840&maxW=562&auto=format&n=JpbB64sgI_r6D502&q=85&s=3a960c899b1b3359b87ae4b6c0696f6b 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-browse.png?w=1100&maxW=562&auto=format&n=JpbB64sgI_r6D502&q=85&s=311d5c3b8b925be7e862e44a53e26073 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-browse.png?w=1650&maxW=562&auto=format&n=JpbB64sgI_r6D502&q=85&s=4aa11d3ce811ec01cf88ec4491ee4a11 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-browse.png?w=2500&maxW=562&auto=format&n=JpbB64sgI_r6D502&q=85&s=6a4aaf09034242ced058b9e74cf0a8f7 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="Select &#x22;Place all certificates in the following store&#x22; and click Next">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/place-all-certificates.png?maxW=556&auto=format&n=JpbB64sgI_r6D502&q=85&s=e6449d7344f1cf708cbdc330ca1adf57" alt="place-all-certificates.png" width="556" height="537" data-path="images/general/faqs/proxy-networks/place-all-certificates.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/place-all-certificates.png?w=280&maxW=556&auto=format&n=JpbB64sgI_r6D502&q=85&s=298a1a0ac77519bed737312ae5ae752f 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/place-all-certificates.png?w=560&maxW=556&auto=format&n=JpbB64sgI_r6D502&q=85&s=e2a67c5f0ba88ee103b362e6fa56e9dd 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/place-all-certificates.png?w=840&maxW=556&auto=format&n=JpbB64sgI_r6D502&q=85&s=62307d9e73281f5447161ca657f9aa23 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/place-all-certificates.png?w=1100&maxW=556&auto=format&n=JpbB64sgI_r6D502&q=85&s=b646d7e9eda18f7e2efa77a762a575da 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/place-all-certificates.png?w=1650&maxW=556&auto=format&n=JpbB64sgI_r6D502&q=85&s=0bef55d69e75134d8aa2b6d7b66e2e59 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/place-all-certificates.png?w=2500&maxW=556&auto=format&n=JpbB64sgI_r6D502&q=85&s=6aa41eec506e7eb7df7f604bbc1e05bc 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="Make sure Certificate Store Selected by User is &#x22;Trusted Root Certification Authorities&#x22;, and click Finish">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-root-certification-authorities.png?maxW=663&auto=format&n=JpbB64sgI_r6D502&q=85&s=af610b6c52d0ebf46fdf84c80f08d4a1" alt="trusted-root-certification-authorities.png" width="663" height="639" data-path="images/general/faqs/proxy-networks/trusted-root-certification-authorities.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-root-certification-authorities.png?w=280&maxW=663&auto=format&n=JpbB64sgI_r6D502&q=85&s=c7a326326da1fc85642f5520f3a86271 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-root-certification-authorities.png?w=560&maxW=663&auto=format&n=JpbB64sgI_r6D502&q=85&s=fd57e8a6ae17bc7f0ce18b265b680af2 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-root-certification-authorities.png?w=840&maxW=663&auto=format&n=JpbB64sgI_r6D502&q=85&s=9b4243f81a313185d61cc065a6986ddb 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-root-certification-authorities.png?w=1100&maxW=663&auto=format&n=JpbB64sgI_r6D502&q=85&s=2ebfbfc02fc120f574f7a81b1d9d95d8 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-root-certification-authorities.png?w=1650&maxW=663&auto=format&n=JpbB64sgI_r6D502&q=85&s=cbb06c02fed98838e7616f4dec7d6f2e 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/trusted-root-certification-authorities.png?w=2500&maxW=663&auto=format&n=JpbB64sgI_r6D502&q=85&s=f772fe90bc0ead58d4c0ee9126dac944 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="Click OK">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-ok.png?maxW=509&auto=format&n=JpbB64sgI_r6D502&q=85&s=9beb536fe2c8fb80f5449142a25319e2" alt="click-ok.png" width="509" height="352" data-path="images/general/faqs/proxy-networks/click-ok.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-ok.png?w=280&maxW=509&auto=format&n=JpbB64sgI_r6D502&q=85&s=1397b8d76af694e0dadad7a0d262102a 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-ok.png?w=560&maxW=509&auto=format&n=JpbB64sgI_r6D502&q=85&s=7bc85bb25b2306a54283d34cc63bf4e5 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-ok.png?w=840&maxW=509&auto=format&n=JpbB64sgI_r6D502&q=85&s=462ea18abe143161024f6f30727bac22 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-ok.png?w=1100&maxW=509&auto=format&n=JpbB64sgI_r6D502&q=85&s=198c15d82b2dbbc068e09d62085f0307 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-ok.png?w=1650&maxW=509&auto=format&n=JpbB64sgI_r6D502&q=85&s=efa5546f697e486acef9e10cf92d7c7f 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/proxy-networks/click-ok.png?w=2500&maxW=509&auto=format&n=JpbB64sgI_r6D502&q=85&s=531122bc17c891b5e9ccf9f813c73f65 2500w" data-optimize="true" data-opv="2" />
        </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
  # Add -k to ignore ssl errors
  curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> -k "http://lumtest.com/myip.json"
  ```

  ```js NodeJS
  #!/usr/bin/env node
  /*This sample code assumes the request-promise package is installed. If it is not installed run: "npm install request-promise"*/
  require('request-promise')({
      url: 'http://lumtest.com/myip.json',
      proxy: 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:33335',

      // Make sure you set reject rejectUnauthorized to false
      rejectUnauthorized: false,
  })
  .then(function(data){ console.log(data); },
      function(err){ console.error(err); });
  ```

  ```python Python
  #!/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:33335',
              'https': 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:33335'}))
      print(opener.open('http://lumtest.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:33335',
              'https': 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:33335'}))
      print(opener.open('http://lumtest.com/myip.json').read())

  ```

  ```cs C#
  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:33335");
          client.Proxy.Credentials = new NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>");
          Console.WriteLine(client.DownloadString("http://lumtest.com/myip.json"));
      }
  }
  ```

  ```ruby Ruby
  #!/usr/bin/ruby

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

  uri = URI.parse('http://lumtest.com/myip.json')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 33335, '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
  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", 33335);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("http://lumtest.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", 33335));
          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
  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:33335")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("http://lumtest.com/myip.json"))
      End Sub
  End Module

  ```

  ```php PHP
  <?php
  $curl = curl_init('http://lumtest.com/myip.json');
  curl_setopt($curl, CURLOPT_PROXY, 'http://brd.superproxy.io:33335');
  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
  #!/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:33335");
  $agent->ssl_opts(verify_hostname => 0, SSL_verify_mode => SSL_VERIFY_NONE);
  print $agent->get('http://lumtest.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.


# Users Management
Source: https://docs.brightdata.com/general/account/users-management

Manage users and permissions for Bright Data access

# 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                                                                                                                                                                                                                                                     |

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


# How to set up Entra ID (formerly Azure Active Directory) SSO and provisioning with Bright Data
Source: https://docs.brightdata.com/general/authentication/How_to_set_up_Azure_SSO_Entra_ID_with_Bright_Data



* Prepare application

* Setup SSO

* Setup SCIM provisioning

## Prepare Application

* Go to [https://entra.microsoft.com/](https://entra.microsoft.com/) and log in to your account.

* Create Enterprise application:

<img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_1.png?maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7c781eab79b502213685134dfd66657a" alt="" width="1827" height="928" data-path="images/general/authentication/entra-sso/entra_1.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_1.png?w=280&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=518cc0d79f171b143a7e095ce727b785 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_1.png?w=560&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=577f6864bfbd49269cf9b1cc6d08d887 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_1.png?w=840&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=e5dbdedb23c82c3f21ecf8bcba6f6c19 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_1.png?w=1100&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=1b1683299c81a04771ccc819a24d33c7 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_1.png?w=1650&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=27be4bca87ccd3a9d110d39d52be71dc 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_1.png?w=2500&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=efe4ebdb265f10d0e194e1c9abcf0dc5 2500w" data-optimize="true" data-opv="2" />

* 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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_2.png?maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=ffb8097c7f7f59a9548a9303294a6682" alt="" width="1827" height="929" data-path="images/general/authentication/entra-sso/entra_2.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_2.png?w=280&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0c4365117da440ead7953b8992ce6287 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_2.png?w=560&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=711812b184191d7490e40217f0221796 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_2.png?w=840&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=3d183b141b50736d8136acf876a0c618 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_2.png?w=1100&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a60ff56640f6a6592f6fbc3ed1f78942 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_2.png?w=1650&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7c53bb8094d7432f03695e2430aa70e2 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_2.png?w=2500&maxW=1827&auto=format&n=2RrKkArDJDw55ilE&q=85&s=9cdaaa0efdd51bb0467a895485c5efb0 2500w" data-optimize="true" data-opv="2" />

## Setup SSO

* 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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_3.png?maxW=1727&auto=format&n=2RrKkArDJDw55ilE&q=85&s=363633e6e17e1d1f1c1180cc59ecefd0" alt="" width="1727" height="919" data-path="images/general/authentication/entra-sso/entra_3.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_3.png?w=280&maxW=1727&auto=format&n=2RrKkArDJDw55ilE&q=85&s=04953f0002f7cc1bf28618d71e5a2b51 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_3.png?w=560&maxW=1727&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a0ed1108cd80ca62fbab74c59b175ad7 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_3.png?w=840&maxW=1727&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d2522a453f511f999d66e50598964d6b 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_3.png?w=1100&maxW=1727&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b643cfe8fbabff8ffb6bfa5633e52a99 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_3.png?w=1650&maxW=1727&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7101953c6cbbf5ea85d90c9fa916b30b 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_3.png?w=2500&maxW=1727&auto=format&n=2RrKkArDJDw55ilE&q=85&s=e8e845da6721f74fddd1ba342459006c 2500w" data-optimize="true" data-opv="2" />

* 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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_4.png?maxW=1824&auto=format&n=2RrKkArDJDw55ilE&q=85&s=1d06803a840bc4734d40613910bfaf95" alt="" width="1824" height="930" data-path="images/general/authentication/entra-sso/entra_4.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_4.png?w=280&maxW=1824&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b7f84eeedc3e4f5aec737b4bb9687398 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_4.png?w=560&maxW=1824&auto=format&n=2RrKkArDJDw55ilE&q=85&s=092e3201624675bba4eb74e18a41a692 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_4.png?w=840&maxW=1824&auto=format&n=2RrKkArDJDw55ilE&q=85&s=975c78d657edd45dabc3c838af0d9b9c 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_4.png?w=1100&maxW=1824&auto=format&n=2RrKkArDJDw55ilE&q=85&s=30b4b064f0d7edfa51b54aedb3c70a91 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_4.png?w=1650&maxW=1824&auto=format&n=2RrKkArDJDw55ilE&q=85&s=2a73baf65dc8f14af213f046d66c8d1f 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_4.png?w=2500&maxW=1824&auto=format&n=2RrKkArDJDw55ilE&q=85&s=bedfd481f0ac0f3a7a1be3578bccfc6a 2500w" data-optimize="true" data-opv="2" />

* At secrets screen click “New client secret”

* Fill Description

* Click “Add”

<img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_5.png?maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=fdb841efb69d0190c0a0f769e7b7afb4" alt="" width="1823" height="930" data-path="images/general/authentication/entra-sso/entra_5.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_5.png?w=280&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=42d9eb4314c394071e7927353f964db4 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_5.png?w=560&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b046bda1e7ed6fa50b81715d97b52666 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_5.png?w=840&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=6a2d7532308c47e5668c42571e667417 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_5.png?w=1100&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=a5a25d7d3a19440de457a7cd2660b891 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_5.png?w=1650&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=c9e98348663be1e47a1e5d7b84f29dcf 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_5.png?w=2500&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=3f7223efafc591f24f27881db2d45a39 2500w" data-optimize="true" data-opv="2" />

* Once secret is created copy secret value to “Client secret”.

* Copy “Sign-in redirect URI” to be used at next step

<img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_6.png?maxW=1828&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7acde46086998d4ffe8e63199af3c502" alt="" width="1828" height="929" data-path="images/general/authentication/entra-sso/entra_6.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_6.png?w=280&maxW=1828&auto=format&n=2RrKkArDJDw55ilE&q=85&s=827c8773ff259635ebd8207ad15c2074 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_6.png?w=560&maxW=1828&auto=format&n=2RrKkArDJDw55ilE&q=85&s=6772611b247c8b501dd0db869fc0c940 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_6.png?w=840&maxW=1828&auto=format&n=2RrKkArDJDw55ilE&q=85&s=070d753ddbb6c3174598f96f2c113377 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_6.png?w=1100&maxW=1828&auto=format&n=2RrKkArDJDw55ilE&q=85&s=e6959021f4ddd0b3a08a8c165e222e93 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_6.png?w=1650&maxW=1828&auto=format&n=2RrKkArDJDw55ilE&q=85&s=61937846fce6ca3e7ab43c8880c15c7b 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_6.png?w=2500&maxW=1828&auto=format&n=2RrKkArDJDw55ilE&q=85&s=22a6d6ee5ce54aa56fe55f48347404c9 2500w" data-optimize="true" data-opv="2" />

* At “Authentication” screen click “Add platform” and select “Web”

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_7.png?maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=e212dca82b1761ef3537e4b4f1770708" alt="" width="1825" height="930" data-path="images/general/authentication/entra-sso/entra_7.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_7.png?w=280&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=eb1b61ff9ed8231765e72510d97c9e61 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_7.png?w=560&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=4c6e9c0919e1b9593d84607ef3122d06 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_7.png?w=840&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=724e25ab8c4ee221916a0ba3e7cf42c7 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_7.png?w=1100&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=812b12a73f2fb1dc8da3c81061b18240 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_7.png?w=1650&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=38ce36d237db1fd420e239287dcb491a 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_7.png?w=2500&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=ba6d7e78c17715cb9d0bca05914bf4fd 2500w" data-optimize="true" data-opv="2" />

* Paste previously copied “Sign-in redirect URI” to the “Redirect URIs” and save settings by clicking “Configure”:

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_8.png?maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=93443c8fb1040fad609f8d00dedbc68c" alt="" width="1825" height="930" data-path="images/general/authentication/entra-sso/entra_8.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_8.png?w=280&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=5960b1c7f0f02b4a5aaa40cbbf332f94 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_8.png?w=560&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=5bfb191f8c32af6a98809f11dd774b35 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_8.png?w=840&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=4faa15ad81cefdfc33957529a984fbd4 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_8.png?w=1100&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=2d827a282c58f244d759af7574010c72 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_8.png?w=1650&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=eadd58fe4061e429d8494719a0a88dec 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_8.png?w=2500&maxW=1825&auto=format&n=JpbB64sgI_r6D502&q=85&s=bd691f17d8548fdecf653aef7f831f6b 2500w" data-optimize="true" data-opv="2" />

* Activate EntraID integration at BrighData control panel and test login:

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_9.png?maxW=892&auto=format&n=JpbB64sgI_r6D502&q=85&s=ff616537b6a6403b0b95caaa215e156f" alt="" width="892" height="916" data-path="images/general/authentication/entra-sso/entra_9.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_9.png?w=280&maxW=892&auto=format&n=JpbB64sgI_r6D502&q=85&s=61e9654c0cad5fd14e47a0c8168188d2 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_9.png?w=560&maxW=892&auto=format&n=JpbB64sgI_r6D502&q=85&s=78a0549f631a9d3f662d5014f0c0aad8 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_9.png?w=840&maxW=892&auto=format&n=JpbB64sgI_r6D502&q=85&s=347b3d46c0edd1c42699e27499325b15 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_9.png?w=1100&maxW=892&auto=format&n=JpbB64sgI_r6D502&q=85&s=2ee5db05c558a36af2fc81007d7dc946 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_9.png?w=1650&maxW=892&auto=format&n=JpbB64sgI_r6D502&q=85&s=0245a00dc737ed717a2f9dded73c5cb5 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/entra-sso/entra_9.png?w=2500&maxW=892&auto=format&n=JpbB64sgI_r6D502&q=85&s=fe8648ab67e63bf7fc85efa4ecb94805 2500w" data-optimize="true" data-opv="2" />

## Setup SCIM provisioning

* Copy “Auth token” from SCIM section of BrightData EntraID settings:

<img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_10.png?maxW=671&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5493e28779dc051ca21b5fec20377b3c" alt="" width="671" height="878" data-path="images/general/authentication/entra-sso/entra_10.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_10.png?w=280&maxW=671&auto=format&n=2RrKkArDJDw55ilE&q=85&s=b1b5c0020ad168f43195a994b807e61e 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_10.png?w=560&maxW=671&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7bf2d3aa73728c33a16ed70ac44e5b34 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_10.png?w=840&maxW=671&auto=format&n=2RrKkArDJDw55ilE&q=85&s=db2ec194ca9473c0cf74114d283eb748 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_10.png?w=1100&maxW=671&auto=format&n=2RrKkArDJDw55ilE&q=85&s=42311e9ed64b710c09690e90fee21fbf 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_10.png?w=1650&maxW=671&auto=format&n=2RrKkArDJDw55ilE&q=85&s=bd4135886d9a0576addea1b71f192e70 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_10.png?w=2500&maxW=671&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5e4c6f8ed8e08d3090ced82990921b24 2500w" data-optimize="true" data-opv="2" />

* Select your application from “Enterprise Applications” view and go to “Provisioning” settings:

<img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_11.png?maxW=1559&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0dbfb546a11c25b7f2adbe41b552fbd7" alt="" width="1559" height="930" data-path="images/general/authentication/entra-sso/entra_11.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_11.png?w=280&maxW=1559&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d9a7d3a0caf1ddab2271663c9c63dffc 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_11.png?w=560&maxW=1559&auto=format&n=2RrKkArDJDw55ilE&q=85&s=e9f45f0272fde8b1ad3b83a4e2ecf967 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_11.png?w=840&maxW=1559&auto=format&n=2RrKkArDJDw55ilE&q=85&s=82b37917db490de806834f3655e8e588 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_11.png?w=1100&maxW=1559&auto=format&n=2RrKkArDJDw55ilE&q=85&s=ecf3a064ff8c3c8df73bb678e8ab441f 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_11.png?w=1650&maxW=1559&auto=format&n=2RrKkArDJDw55ilE&q=85&s=93c9e44daaada6f5f7bad08084839928 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_11.png?w=2500&maxW=1559&auto=format&n=2RrKkArDJDw55ilE&q=85&s=05e1f78d3c70f266edfc050d1f4eab58 2500w" data-optimize="true" data-opv="2" />

* Select “Provisioning” under “Manage” menu:

<img src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_12.png?maxW=1557&auto=format&n=2RrKkArDJDw55ilE&q=85&s=11e02485b11bc5994cd0abd9282f5682" alt="" width="1557" height="931" data-path="images/general/authentication/entra-sso/entra_12.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_12.png?w=280&maxW=1557&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d1ded1d4b7afc0a5ff6149dbdcc54e67 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_12.png?w=560&maxW=1557&auto=format&n=2RrKkArDJDw55ilE&q=85&s=0457c4c5f8e5d823b93f9cd26ae737ca 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_12.png?w=840&maxW=1557&auto=format&n=2RrKkArDJDw55ilE&q=85&s=3600cda8335e4ae6706c7b847546ca74 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_12.png?w=1100&maxW=1557&auto=format&n=2RrKkArDJDw55ilE&q=85&s=14881715d8228591f30346859f21892d 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_12.png?w=1650&maxW=1557&auto=format&n=2RrKkArDJDw55ilE&q=85&s=4df5a4838b27f1e77062e58748eeb1a3 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_12.png?w=2500&maxW=1557&auto=format&n=2RrKkArDJDw55ilE&q=85&s=514f5acb683eddf7b373f7e7500ac1dc 2500w" data-optimize="true" data-opv="2" />

* 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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_13.png?maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=ea06d9313586f183538bc02643a49867" alt="" width="1823" height="931" data-path="images/general/authentication/entra-sso/entra_13.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_13.png?w=280&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=5485262e009cb27470e7367ffb3f8657 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_13.png?w=560&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=07678a643a6f1b25fe24f3b6eda51663 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_13.png?w=840&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=f631d3aa1f03b9c2e1f983b25ba97486 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_13.png?w=1100&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=7580495adba255f8e2ebe48219b57895 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_13.png?w=1650&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=3ffdab48f7851520624c7842f13a8f33 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_13.png?w=2500&maxW=1823&auto=format&n=2RrKkArDJDw55ilE&q=85&s=3cd4b119fb86714bf8fa28704446e12f 2500w" data-optimize="true" data-opv="2" />

* 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 src="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_14.png?maxW=1825&auto=format&n=2RrKkArDJDw55ilE&q=85&s=436dd154728b89ce4b900c0c7acd1eb0" alt="" width="1825" height="930" data-path="images/general/authentication/entra-sso/entra_14.png" srcset="https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_14.png?w=280&maxW=1825&auto=format&n=2RrKkArDJDw55ilE&q=85&s=306072b2d536772a21ca3faffebb4840 280w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_14.png?w=560&maxW=1825&auto=format&n=2RrKkArDJDw55ilE&q=85&s=d63f2130805df0aa615874128f7ce144 560w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_14.png?w=840&maxW=1825&auto=format&n=2RrKkArDJDw55ilE&q=85&s=03ac11f933f5f6b76fa906814cd1df60 840w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_14.png?w=1100&maxW=1825&auto=format&n=2RrKkArDJDw55ilE&q=85&s=69cdc18175bef45bfae49a83fdda8605 1100w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_14.png?w=1650&maxW=1825&auto=format&n=2RrKkArDJDw55ilE&q=85&s=cd6b83aa615e8077992891b43add0072 1650w, https://mintcdn.com/brightdata/2RrKkArDJDw55ilE/images/general/authentication/entra-sso/entra_14.png?w=2500&maxW=1825&auto=format&n=2RrKkArDJDw55ilE&q=85&s=dcb30338fd4f3f62e9a6fd2a9f829eaa 2500w" data-optimize="true" data-opv="2" />


# How to set up SSO with Okta in Bright Data?
Source: https://docs.brightdata.com/general/authentication/How_to_set_up_SSO_with_Okta_in_Bright_Data



**Requirements**

* An Okta organization account with admin permission
* A Bright Data account with admin permission

**Steps:**

1. On your Okta admin dashboard, choose '**Applications > Applications**'

```sh
https://[your_domain]-admin.okta.com/admin/apps/active
```

2. Click '**Create App Integration**'

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_1.png?maxW=612&auto=format&n=JpbB64sgI_r6D502&q=85&s=b768bf0a8ce3c3f63b99bef61ca50293" alt="mceclip0.png" width="612" height="234" data-path="images/general/authentication/okta_1.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_1.png?w=280&maxW=612&auto=format&n=JpbB64sgI_r6D502&q=85&s=3f037236806b42db852f042e4dbc2fb0 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_1.png?w=560&maxW=612&auto=format&n=JpbB64sgI_r6D502&q=85&s=cc3a014ced6d9f77b0b638ceefb5ad98 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_1.png?w=840&maxW=612&auto=format&n=JpbB64sgI_r6D502&q=85&s=fc172737ab0c032023edde212af2d837 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_1.png?w=1100&maxW=612&auto=format&n=JpbB64sgI_r6D502&q=85&s=cb8e33d4ff35a1543f2b26470ad828a7 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_1.png?w=1650&maxW=612&auto=format&n=JpbB64sgI_r6D502&q=85&s=c6b9af552cbde5062b4e0872036814ce 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_1.png?w=2500&maxW=612&auto=format&n=JpbB64sgI_r6D502&q=85&s=0b9e2082dc797dcba597ab71f7c618cf 2500w" data-optimize="true" data-opv="2" />

3. Select '**OIDC - OpenID Connect**' as the Sign-in method,

4. Select'**Web Application**' as the Application type and click '**Next**'

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_2.png?maxW=853&auto=format&n=JpbB64sgI_r6D502&q=85&s=220370677e6254f725419f453e1f1174" alt="mceclip1.png" width="853" height="739" data-path="images/general/authentication/okta_2.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_2.png?w=280&maxW=853&auto=format&n=JpbB64sgI_r6D502&q=85&s=c180f9271f2a815d68be63e203250830 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_2.png?w=560&maxW=853&auto=format&n=JpbB64sgI_r6D502&q=85&s=578632f8d2e6ec4c172d9d8a6afe2eaf 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_2.png?w=840&maxW=853&auto=format&n=JpbB64sgI_r6D502&q=85&s=ead0c37dbaa255359bb24ba95ec1e895 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_2.png?w=1100&maxW=853&auto=format&n=JpbB64sgI_r6D502&q=85&s=31635abcd8308f915e796e9246ac193a 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_2.png?w=1650&maxW=853&auto=format&n=JpbB64sgI_r6D502&q=85&s=64d1719f4cf901142b21045fcd004568 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_2.png?w=2500&maxW=853&auto=format&n=JpbB64sgI_r6D502&q=85&s=3b3dae426f963d0d4011a58769f3f861 2500w" data-optimize="true" data-opv="2" />

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 src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_3.png?maxW=932&auto=format&n=JpbB64sgI_r6D502&q=85&s=5375f8bc4b277cfd7f2c50ab8728ba0d" alt="mceclip0.png" width="932" height="554" data-path="images/general/authentication/okta_3.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_3.png?w=280&maxW=932&auto=format&n=JpbB64sgI_r6D502&q=85&s=286521949a838d01c27b36051ccc741b 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_3.png?w=560&maxW=932&auto=format&n=JpbB64sgI_r6D502&q=85&s=db76aeb62fa97afc98148e57bf981807 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_3.png?w=840&maxW=932&auto=format&n=JpbB64sgI_r6D502&q=85&s=6086f64b53703187dff7eaaa5649b7fb 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_3.png?w=1100&maxW=932&auto=format&n=JpbB64sgI_r6D502&q=85&s=72759b53fe4e36c4847df501570b9729 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_3.png?w=1650&maxW=932&auto=format&n=JpbB64sgI_r6D502&q=85&s=4a2dae5694e197672673ee366e2efef3 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_3.png?w=2500&maxW=932&auto=format&n=JpbB64sgI_r6D502&q=85&s=264618b0d9cbcc3311111f9e9a09f15f 2500w" data-optimize="true" data-opv="2" />

7. Go to Bright Data [Control Panel](https://brightdata.com/cp/setting)

8. Open OKTA configuration dialog

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_4.png?maxW=460&auto=format&n=JpbB64sgI_r6D502&q=85&s=81e9f6c3b293a8adb5ec4e9938d61bee" alt="mceclip1.png" width="460" height="420" data-path="images/general/authentication/okta_4.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_4.png?w=280&maxW=460&auto=format&n=JpbB64sgI_r6D502&q=85&s=19aff0df2d573e7cfedb73f3a74c596c 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_4.png?w=560&maxW=460&auto=format&n=JpbB64sgI_r6D502&q=85&s=58155b30cd71ff97527db70de5c5cd59 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_4.png?w=840&maxW=460&auto=format&n=JpbB64sgI_r6D502&q=85&s=a717a394c52bb1bd2ff420d3a1b4810d 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_4.png?w=1100&maxW=460&auto=format&n=JpbB64sgI_r6D502&q=85&s=b87c69d864d1d7db5c68c1582fc68597 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_4.png?w=1650&maxW=460&auto=format&n=JpbB64sgI_r6D502&q=85&s=450fa4066b0b76820be3ce3d84071c7f 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_4.png?w=2500&maxW=460&auto=format&n=JpbB64sgI_r6D502&q=85&s=f9f70a604e8e0d897868a1ffa9924745 2500w" data-optimize="true" data-opv="2" />

9. Copy **"Sign-in redirect URI"**

**<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_5.png?maxW=630&auto=format&n=JpbB64sgI_r6D502&q=85&s=59813ea2ccb44a857bfe4d1ca4987b7a" alt="mceclip2.png" width="630" height="630" data-path="images/general/authentication/okta_5.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_5.png?w=280&maxW=630&auto=format&n=JpbB64sgI_r6D502&q=85&s=687e98e67e65f940ee875cf27271539a 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_5.png?w=560&maxW=630&auto=format&n=JpbB64sgI_r6D502&q=85&s=b47fa9f3195e261b9269d49d81ca23e6 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_5.png?w=840&maxW=630&auto=format&n=JpbB64sgI_r6D502&q=85&s=ffaba70438529845ee133ee8fddafbd6 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_5.png?w=1100&maxW=630&auto=format&n=JpbB64sgI_r6D502&q=85&s=043c0c2de1034d7df5f7e321e0ec6c8e 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_5.png?w=1650&maxW=630&auto=format&n=JpbB64sgI_r6D502&q=85&s=5f809409000fdbbe5500890cb10f0aa7 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_5.png?w=2500&maxW=630&auto=format&n=JpbB64sgI_r6D502&q=85&s=a95f902f57af0ed794b53d981fa00f41 2500w" data-optimize="true" data-opv="2" />**

10. Paste it to according field in New App setup in OKTA

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_6.png?maxW=964&auto=format&n=JpbB64sgI_r6D502&q=85&s=cefc6b273911636e036b58ebf4b1585b" alt="mceclip3.png" width="964" height="625" data-path="images/general/authentication/okta_6.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_6.png?w=280&maxW=964&auto=format&n=JpbB64sgI_r6D502&q=85&s=59072ad41d4a78ba044a9ba64e67690e 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_6.png?w=560&maxW=964&auto=format&n=JpbB64sgI_r6D502&q=85&s=06878d2024635818fba8164a23e5c970 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_6.png?w=840&maxW=964&auto=format&n=JpbB64sgI_r6D502&q=85&s=3c6427c82c066fffe48da91edbb7dcf3 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_6.png?w=1100&maxW=964&auto=format&n=JpbB64sgI_r6D502&q=85&s=88f0b70c76d0d7b3a6a3dc92d57f94de 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_6.png?w=1650&maxW=964&auto=format&n=JpbB64sgI_r6D502&q=85&s=ec7f4d53571189933b04e3af9de6a6d6 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_6.png?w=2500&maxW=964&auto=format&n=JpbB64sgI_r6D502&q=85&s=6814c9a78d84c22680fe917d668202da 2500w" data-optimize="true" data-opv="2" />

11. Repeat the same for **"Sign-out URI"**

12. At ‘Assignments’, select an access level as you want

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_7.png?maxW=894&auto=format&n=JpbB64sgI_r6D502&q=85&s=e7474bba0735eccd8390823ceb708497" alt="mceclip6.png" width="894" height="291" data-path="images/general/authentication/okta_7.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_7.png?w=280&maxW=894&auto=format&n=JpbB64sgI_r6D502&q=85&s=155ce53b704ac84870a6ff34d5223657 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_7.png?w=560&maxW=894&auto=format&n=JpbB64sgI_r6D502&q=85&s=228b73c8af168fd39403e11befeb9231 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_7.png?w=840&maxW=894&auto=format&n=JpbB64sgI_r6D502&q=85&s=505fe2382afbfd31a1c92716a4db21ba 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_7.png?w=1100&maxW=894&auto=format&n=JpbB64sgI_r6D502&q=85&s=da51040eb1269a07503637e0541e0238 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_7.png?w=1650&maxW=894&auto=format&n=JpbB64sgI_r6D502&q=85&s=3fb76d422d6a9332288111acde398cd0 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_7.png?w=2500&maxW=894&auto=format&n=JpbB64sgI_r6D502&q=85&s=d8169b852ea0cec13c60515badf67763 2500w" data-optimize="true" data-opv="2" />

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 src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_8.png?maxW=769&auto=format&n=JpbB64sgI_r6D502&q=85&s=6bccd18bedfeea6768d60fffdaf741c7" alt="mceclip4.png" width="769" height="582" data-path="images/general/authentication/okta_8.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_8.png?w=280&maxW=769&auto=format&n=JpbB64sgI_r6D502&q=85&s=25c9f971b216ff19b18bccc1cb7cd11b 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_8.png?w=560&maxW=769&auto=format&n=JpbB64sgI_r6D502&q=85&s=bd2ce353401e999b9676edd5ed84fe8a 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_8.png?w=840&maxW=769&auto=format&n=JpbB64sgI_r6D502&q=85&s=078c57004e58871499ff19b37fc86735 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_8.png?w=1100&maxW=769&auto=format&n=JpbB64sgI_r6D502&q=85&s=d645961a97a217fc950103d6346e47e1 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_8.png?w=1650&maxW=769&auto=format&n=JpbB64sgI_r6D502&q=85&s=a47ef4b76f7903a117abdc533702b9a7 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_8.png?w=2500&maxW=769&auto=format&n=JpbB64sgI_r6D502&q=85&s=b78d4b563cdcb8fda6f9afee78351e5e 2500w" data-optimize="true" data-opv="2" />

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_9.png?maxW=613&auto=format&n=JpbB64sgI_r6D502&q=85&s=978fc36deae8b4496b6d76a1fb26ecf8" alt="mceclip5.png" width="613" height="630" data-path="images/general/authentication/okta_9.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_9.png?w=280&maxW=613&auto=format&n=JpbB64sgI_r6D502&q=85&s=2e56a4c2369b52a3a0598f46af66c707 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_9.png?w=560&maxW=613&auto=format&n=JpbB64sgI_r6D502&q=85&s=5030a2ce747b1aaa4f4f7cabd22d2d24 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_9.png?w=840&maxW=613&auto=format&n=JpbB64sgI_r6D502&q=85&s=9112962386abb34e4c467eb3dd8d051e 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_9.png?w=1100&maxW=613&auto=format&n=JpbB64sgI_r6D502&q=85&s=7c14e8d77f4dc62c5cec360e5fb8fbf3 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_9.png?w=1650&maxW=613&auto=format&n=JpbB64sgI_r6D502&q=85&s=d229d61c4371285c2801ce487b221239 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_9.png?w=2500&maxW=613&auto=format&n=JpbB64sgI_r6D502&q=85&s=a38d882b56a1973c8a22e57af3d9d93f 2500w" data-optimize="true" data-opv="2" />

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 src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_10.png?maxW=767&auto=format&n=JpbB64sgI_r6D502&q=85&s=83afcce0cd4d66f576121268ef6724e4" alt="mceclip6.png" width="767" height="721" data-path="images/general/authentication/okta_10.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_10.png?w=280&maxW=767&auto=format&n=JpbB64sgI_r6D502&q=85&s=21b79f6aed1c320e314e10a54262b43f 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_10.png?w=560&maxW=767&auto=format&n=JpbB64sgI_r6D502&q=85&s=f180e1c26153aef0dc0fb4f4d23a12ce 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_10.png?w=840&maxW=767&auto=format&n=JpbB64sgI_r6D502&q=85&s=68ef36920a9c87b0adc8b6dc93fb7e7a 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_10.png?w=1100&maxW=767&auto=format&n=JpbB64sgI_r6D502&q=85&s=d121eff0b679609db48115d98e7e46ef 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_10.png?w=1650&maxW=767&auto=format&n=JpbB64sgI_r6D502&q=85&s=1fe7ccc486937c2ca28b0589573c094a 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_10.png?w=2500&maxW=767&auto=format&n=JpbB64sgI_r6D502&q=85&s=d0b69772191b7b4de81bc6af2e79319d 2500w" data-optimize="true" data-opv="2" />

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 src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_11.png?maxW=829&auto=format&n=JpbB64sgI_r6D502&q=85&s=0db1bcf7715180ccaddb84bc501cf161" alt="mceclip7.png" width="829" height="547" data-path="images/general/authentication/okta_11.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_11.png?w=280&maxW=829&auto=format&n=JpbB64sgI_r6D502&q=85&s=f86760c1885bad5169dceab88b576668 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_11.png?w=560&maxW=829&auto=format&n=JpbB64sgI_r6D502&q=85&s=4fc0c0784f0e62d8798d7b566ed48c1b 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_11.png?w=840&maxW=829&auto=format&n=JpbB64sgI_r6D502&q=85&s=41d3263f50313e067e414076a12c82f9 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_11.png?w=1100&maxW=829&auto=format&n=JpbB64sgI_r6D502&q=85&s=5f342cd494866b977b7d101e829e39b8 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_11.png?w=1650&maxW=829&auto=format&n=JpbB64sgI_r6D502&q=85&s=b71db0156db0fb7490b22dcd4b54a1d0 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_11.png?w=2500&maxW=829&auto=format&n=JpbB64sgI_r6D502&q=85&s=ee44da33ede423215008fd3c09b40f83 2500w" data-optimize="true" data-opv="2" />

***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 src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_12.png?maxW=619&auto=format&n=JpbB64sgI_r6D502&q=85&s=d5e402a75faae98d784bfa7b4982ae71" alt="mceclip8.png" width="619" height="632" data-path="images/general/authentication/okta_12.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_12.png?w=280&maxW=619&auto=format&n=JpbB64sgI_r6D502&q=85&s=3055e7f4588fbe0b55a96351fdeba556 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_12.png?w=560&maxW=619&auto=format&n=JpbB64sgI_r6D502&q=85&s=12fe3c4b301827d15bc6a1bcdbaedde8 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_12.png?w=840&maxW=619&auto=format&n=JpbB64sgI_r6D502&q=85&s=d0d968e0d4af9942019f2252ff8faf3b 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_12.png?w=1100&maxW=619&auto=format&n=JpbB64sgI_r6D502&q=85&s=f7a5676cd966b865dc18690e232d72e3 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_12.png?w=1650&maxW=619&auto=format&n=JpbB64sgI_r6D502&q=85&s=e570e8282662bc842f371dd3c8f9fab5 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_12.png?w=2500&maxW=619&auto=format&n=JpbB64sgI_r6D502&q=85&s=4d3793d27c17feb442526bb40cb12ae5 2500w" data-optimize="true" data-opv="2" />

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_13.png?maxW=771&auto=format&n=JpbB64sgI_r6D502&q=85&s=aa33e957fdbc71a15456ed458407ae5a" alt="mceclip9.png" width="771" height="609" data-path="images/general/authentication/okta_13.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_13.png?w=280&maxW=771&auto=format&n=JpbB64sgI_r6D502&q=85&s=a3acf0dae024ba03e1f09d2e92895454 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_13.png?w=560&maxW=771&auto=format&n=JpbB64sgI_r6D502&q=85&s=cca23929e4428ce70952f532ff4929cb 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_13.png?w=840&maxW=771&auto=format&n=JpbB64sgI_r6D502&q=85&s=26e8a3a0cd136b63bb22c0a0ee4b4adc 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_13.png?w=1100&maxW=771&auto=format&n=JpbB64sgI_r6D502&q=85&s=66d91741a9bd6e26a1d17ec04b12994c 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_13.png?w=1650&maxW=771&auto=format&n=JpbB64sgI_r6D502&q=85&s=0fd63b33d180d2f2c419860bd67a617b 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/authentication/okta_13.png?w=2500&maxW=771&auto=format&n=JpbB64sgI_r6D502&q=85&s=f65e4d3d99c49b789794f87a8406e3a2 2500w" data-optimize="true" data-opv="2" />

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


# Snowflake Delivery Configuration Guide
Source: https://docs.brightdata.com/general/cloud-providers/snowflake



<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:

    ```sql
    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
    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
    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
    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
    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
    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
    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
    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
    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
    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 our platform.

    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>


# FAQs
Source: https://docs.brightdata.com/general/faqs



<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, 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](https://docs.brightdata.com/api-reference/api-vs-native-access).

    #### Proxy port transition

    Bright data now serving requests over native proxy port 33335. In the past, we served requests over port 22225 which is now phasing out. Bright data has updated its current SSL certificate which will expire in September, 2026 to a new certificate which will expire in September 2034.

    For proxy zones of types **Residential, Mobile, Unlocker API and SERP API** which require either [KYC](https://docs.brightdata.com/proxy-networks/residential/network-access#kyc-verification) or [SSL Certificate](https://docs.brightdata.com/general/account/ssl-certificate) it is essential to install the correct certificate which complies with port used.

    If you are already using the old SSL certificate in your code or installed on your machine, we strongly rcommend plan the transition to new port `33335` at your earliest convenience.

    #### Supported settings

    | Port    | Certificate     | Expiration     |
    | ------- | --------------- | -------------- |
    | `22225` | Old certificate | September 2026 |
    | `33335` | New certificate | September 2034 |

    #### Working in Tandem

    As two certificates operate in tandem and differ by port, you can gracefully migrate your proxy and scraping tools to the new port and certificate. As long as you use the correct certificate towards the correct port (new -> `33335` and old -> `22225`) it should work.

    ### Transition steps

    To transition from port 22225 to 33335 you should:

    1. Inform your network administrator or security administrator to open the domain `brd.superproxy.io` on port `33335` for outgoing communication.
    2. If you are using certificate: install the new certificate. See instructions on certificate installtion here: [SSL Certificate](https://docs.brightdata.com/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 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 a 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 src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/review-allocated-ips.gif?maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=4ac48f6f03794d299cb4405f79915c43" alt="review-allocated-ips.gif" width="1600" height="734" data-path="images/general/faqs/review-allocated-ips.gif" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/review-allocated-ips.gif?w=280&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=845ba00d00aa919393dc8d51e12325bb 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/review-allocated-ips.gif?w=560&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=56d29c0e699219ac8c349fd5f28f3ad9 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/review-allocated-ips.gif?w=840&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=1395a6218866308015019c02566e5f70 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/review-allocated-ips.gif?w=1100&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=d23d6a84dca5587c47d9e3eca8be2639 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/review-allocated-ips.gif?w=1650&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=e32cc8e442cf29d2603377850484a98f 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/review-allocated-ips.gif?w=2500&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=5f231fd9046bea17dcc7c4efa15575e4 2500w" data-optimize="true" data-opv="2" />
  </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 src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/statistics-via-control-panel.png?maxW=1827&auto=format&n=JpbB64sgI_r6D502&q=85&s=0a452c8f98f958c1e589d9b5c6f2a39c" alt="statistics-via-control-panel.png" width="1827" height="977" data-path="images/general/faqs/statistics-via-control-panel.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/statistics-via-control-panel.png?w=280&maxW=1827&auto=format&n=JpbB64sgI_r6D502&q=85&s=370d9c0870beab0d7ea6e70632aed187 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/statistics-via-control-panel.png?w=560&maxW=1827&auto=format&n=JpbB64sgI_r6D502&q=85&s=1622618370f5886a0e7e0d1df90ad56b 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/statistics-via-control-panel.png?w=840&maxW=1827&auto=format&n=JpbB64sgI_r6D502&q=85&s=99254d5a5d07f3359023ac59a71fab87 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/statistics-via-control-panel.png?w=1100&maxW=1827&auto=format&n=JpbB64sgI_r6D502&q=85&s=e122ba52a02442b1a13ea43122edf155 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/statistics-via-control-panel.png?w=1650&maxW=1827&auto=format&n=JpbB64sgI_r6D502&q=85&s=679cf990fb003bd3bfa727068ba991f1 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/statistics-via-control-panel.png?w=2500&maxW=1827&auto=format&n=JpbB64sgI_r6D502&q=85&s=63b01636438fc0226434d9f920e6b94c 2500w" data-optimize="true" data-opv="2" />
        * 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 src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/specific-zone-statics.gif?maxW=1828&auto=format&n=JpbB64sgI_r6D502&q=85&s=8d9b0b7803937295dfa88f65f1a61c3d" alt="specific-zone-statics.gif" width="1828" height="978" data-path="images/general/faqs/specific-zone-statics.gif" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/specific-zone-statics.gif?w=280&maxW=1828&auto=format&n=JpbB64sgI_r6D502&q=85&s=dd16979adfc4c479392498c5beb7d333 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/specific-zone-statics.gif?w=560&maxW=1828&auto=format&n=JpbB64sgI_r6D502&q=85&s=1304ce4d2fb7d36de3b43a272d9ec191 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/specific-zone-statics.gif?w=840&maxW=1828&auto=format&n=JpbB64sgI_r6D502&q=85&s=84ffe3178008e4254082790d85155ba4 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/specific-zone-statics.gif?w=1100&maxW=1828&auto=format&n=JpbB64sgI_r6D502&q=85&s=d6210af7402afb17dd681a72965b5b69 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/specific-zone-statics.gif?w=1650&maxW=1828&auto=format&n=JpbB64sgI_r6D502&q=85&s=99b14ee687827f061b61570f687c575f 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/specific-zone-statics.gif?w=2500&maxW=1828&auto=format&n=JpbB64sgI_r6D502&q=85&s=e9f0787e2ffe657df061d04d05b4ad8c 2500w" data-optimize="true" data-opv="2" />
      </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 src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/access-parameters.png?maxW=677&auto=format&n=JpbB64sgI_r6D502&q=85&s=ad5851a40f1682ebaea99ebdcb76bfb5" alt="access-parameters.png" width="677" height="159" data-path="images/general/faqs/access-parameters.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/access-parameters.png?w=280&maxW=677&auto=format&n=JpbB64sgI_r6D502&q=85&s=5f253ab6f22fc1e00d85996877a0e4bb 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/access-parameters.png?w=560&maxW=677&auto=format&n=JpbB64sgI_r6D502&q=85&s=f6c0770efec376a1b83568073112cd28 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/access-parameters.png?w=840&maxW=677&auto=format&n=JpbB64sgI_r6D502&q=85&s=efc6b3ea5efe39c2386a6c850c536650 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/access-parameters.png?w=1100&maxW=677&auto=format&n=JpbB64sgI_r6D502&q=85&s=92177767e6ccb273df48eb59be751b0b 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/access-parameters.png?w=1650&maxW=677&auto=format&n=JpbB64sgI_r6D502&q=85&s=4249286cbaadc7cd111065c4baa66a0a 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/access-parameters.png?w=2500&maxW=677&auto=format&n=JpbB64sgI_r6D502&q=85&s=9030a70dddaa719da958a7db8d7fbf42 2500w" data-optimize="true" data-opv="2" />
      </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 src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/edit-limit.png?maxW=760&auto=format&n=JpbB64sgI_r6D502&q=85&s=480e8cf3e0e398f883060e49997cfbd4" alt="edit-limit.png" width="760" height="914" data-path="images/general/faqs/edit-limit.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/edit-limit.png?w=280&maxW=760&auto=format&n=JpbB64sgI_r6D502&q=85&s=d858e2ed0dc784f0ea045d24f46584c2 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/edit-limit.png?w=560&maxW=760&auto=format&n=JpbB64sgI_r6D502&q=85&s=e1646ebeecf9062e56d1e867ece660d5 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/edit-limit.png?w=840&maxW=760&auto=format&n=JpbB64sgI_r6D502&q=85&s=f8e462850ca5c1a9e52f0cbb0e69273f 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/edit-limit.png?w=1100&maxW=760&auto=format&n=JpbB64sgI_r6D502&q=85&s=f60b727398e1e6d5f41e38860b67a290 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/edit-limit.png?w=1650&maxW=760&auto=format&n=JpbB64sgI_r6D502&q=85&s=93fa8e96a98de6bde5a95b4a81174470 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/edit-limit.png?w=2500&maxW=760&auto=format&n=JpbB64sgI_r6D502&q=85&s=6091b8915d838870a857e7af22ee0bb8 2500w" data-optimize="true" data-opv="2" />
      </Step>

      <Step title="Enable the &#x22;spend limit&#x22; option.">
                <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/spend-limit-toggle.png?maxW=647&auto=format&n=JpbB64sgI_r6D502&q=85&s=538be0ae45872d54c0e04b66f86a4b02" alt="spend-limit-toggle.png" width="647" height="353" data-path="images/general/faqs/spend-limit-toggle.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/spend-limit-toggle.png?w=280&maxW=647&auto=format&n=JpbB64sgI_r6D502&q=85&s=3c349d0ed961b11d0a15deb59de18fa8 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/spend-limit-toggle.png?w=560&maxW=647&auto=format&n=JpbB64sgI_r6D502&q=85&s=62bf1bb05d536e612da8c4b28209c15f 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/spend-limit-toggle.png?w=840&maxW=647&auto=format&n=JpbB64sgI_r6D502&q=85&s=696869723d255a0042ac06252ce4727e 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/spend-limit-toggle.png?w=1100&maxW=647&auto=format&n=JpbB64sgI_r6D502&q=85&s=7aa3c5e067a2d79fd14bb8a1d0597b53 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/spend-limit-toggle.png?w=1650&maxW=647&auto=format&n=JpbB64sgI_r6D502&q=85&s=803b5006aacf617c7c759b84e57c5c22 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/spend-limit-toggle.png?w=2500&maxW=647&auto=format&n=JpbB64sgI_r6D502&q=85&s=3c13b6c017bbdec90e3d5dd332ea0e7a 2500w" data-optimize="true" data-opv="2" />
      </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 src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/cost-limits-table.png?maxW=680&auto=format&n=JpbB64sgI_r6D502&q=85&s=f6e33fce8ba7d3fd4d545118219311a3" alt="cost-limits-table.png" width="680" height="369" data-path="images/general/faqs/cost-limits-table.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/cost-limits-table.png?w=280&maxW=680&auto=format&n=JpbB64sgI_r6D502&q=85&s=9c5c12beaa3e8465e0c5f440ef76a15e 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/cost-limits-table.png?w=560&maxW=680&auto=format&n=JpbB64sgI_r6D502&q=85&s=103bfaa9572b82ce6c8ed44fc6c1a827 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/cost-limits-table.png?w=840&maxW=680&auto=format&n=JpbB64sgI_r6D502&q=85&s=d749da83e1fb01277f17292163d45a59 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/cost-limits-table.png?w=1100&maxW=680&auto=format&n=JpbB64sgI_r6D502&q=85&s=be46e176b51c935021854bdce4bc41f0 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/cost-limits-table.png?w=1650&maxW=680&auto=format&n=JpbB64sgI_r6D502&q=85&s=66f1328446b561ff0a044fdae6a229f1 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/faqs/cost-limits-table.png?w=2500&maxW=680&auto=format&n=JpbB64sgI_r6D502&q=85&s=2a7d0087bb879d9abfe5b724f7d35b7d 2500w" data-optimize="true" data-opv="2" />

    **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 an average of 3 million residential IPs available each day, 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 access from anauthorized 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
    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
    "token":"<API_KEY>"
    ```

    Now you can simply send a request using the API key you just created:

    ```sh
    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.

    You can extend this free trial. To test or use Bright Data's proxy solutions without any kind of limitations 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.

    Submitting a KYC verification form or a port request form is not available during Playground mode. To start the KYC or ports request process you will need to deposit at least \$10 to your account.

    <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>
  </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 free credits will expire (if not already used) and you will need to add funds to your account to continue using our platform.

    #### 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           |
    | Russian Federation (the)                                   | ru           |
    | 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, and does not even require you to open an account, ensuring complete anonymity.
  </Accordion>

  <Accordion title="Can I use direct BrightData API to manage my account?">
    Yes, we he an extensive coverage of actions that can be performed programatically 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 or API documentation section -
    [Account Managment API Documentation](https://docs.brightdata.com/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 adress on my account?">
    You cannot directly "change" or "update" the email adress in your account.
    But, you *can* create a new user with the new email adress, and then delete the "old" user - this would achieve the same desired result as updating/changing/replacing your email adress.
  </Accordion>

  <Accordion title="How to access proxies with IP allowlist only? (IP:PORT method)" defaultOpen="false">
    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](https://docs.brightdata.com/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 documentaiton 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?" defaultOpen="false">
    No, only company email addresses are accepted for KYC verification.
  </Accordion>

  <Accordion title="Where can I see the legal restrictions and policies of BrightData?" defaultOpen="false">
    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? " defaultOpen="false">
    {/* tags: What support options are available for Bright Data services?; support; contact support; help me; real human; human assistant; support agent;  account manager; sales representative; account owner; live assitance; compliance officer; */}

    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? " defaultOpen="false">
    zproxy.lum-superproxy.io is a deprecated proxy integration endpoint that was used by BrightData 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?" defaultOpen="false">
    \*\*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">
    {/*tags: "DELETE ACCOUNT"; "DISABLE ACCOUNT"; "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 platform
  </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 supper engineer can provide propper 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 wll be required to provide proof of identity, business identity and ownership/role as well as your business use cases.
  </Accordion>
</AccordionGroup>


# How do Consumers join the Bright Data Peers Network
Source: https://docs.brightdata.com/general/policy/How_do_consumers_join_the_Bright_Data_network_of_peers_



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.


# null
Source: https://docs.brightdata.com/general/policy/Privacy_Policy



<sub>*Last Updated December 7, 2021*</sub><br />
<sub>*Last Reviewed October 31, 2022*</sub>

At Bright Data, we are in the business of data and it's precisely because of this that we take data privacy so seriously. Our customers entrust us to empower their businesses with clean, compliant, and ethically sourced data whilst retaining the highest standards of privacy. Our products and services operate on a global scale and as such we continuously monitor the dynamic global privacy landscape and adapt accordingly to ensure complete compliance with privacy laws including the European Union's GDPR and California's CCPA. If you are a resident of California, we refer you to our CCPA Privacy Notice, found at the end of this policy.

This Privacy Policy addresses both users who actively choose to use our services, as described below and also to individuals whose personal data we may process as part of our operation.

Please feel free to read on for a detailed breakdown of our privacy policy or contact us with any questions regarding our policy or data legislation compliance.

Bright Data ("**Bright Data**", "**we**", or "**us**") is the owner of the website brightdata.com ("**the Site**"), the Bright Data software ("**the Software**"), the Bright Data SDK ("**the SDK**") and any accompanying services, features, content, and applications offered by us (collectively referred herein as "**the Services**"). We are concerned about your privacy and have designed this Privacy Policy in order to help you decide whether to use the Services and to provide all required information about our privacy practices. If applicable to you, by accessing and using the Services, or providing information to us in other formats, you agree and accept the terms of this Privacy Policy as amended from time to time and consent to the collection and use of information in the manner set out in this Privacy Policy. We encourage you to review this Privacy Policy carefully and to periodically refer to it so that you understand it and any subsequent changes made to it. IF YOU DO NOT AGREE TO THE TERMS OF THIS PRIVACY POLICY, PLEASE STOP USING THE SERVICES IMMEDIATELY AND UNINSTALL WHERE RELEVANT.

### [What types of information do we collect?](https://brightdata.com/privacy#info-types)

We collect the following types of data from you when you use the Services ("**User Data"**):

* Non-Personal Information. This is information that is un-identified and non-identifiable, which is generated by a user's activity. Such non-personal information may include the following information - browser type, web pages you visit, time spent on those pages, access times and dates.
* Personal Information. Personal information is information that identifies you or may identify you. The Personal Information we collect and retain includes your IP address, your name and email address, identifying documents (driver license/ID/passport), office/home address, screen name, payment and billing information or other information we may ask from time to time as will be required for the on-boarding process and services provisioning. In some cases, we may record audio or video calls with you, in order to comply with User compliance evaluation requirements we are subject to and our internal guidelines. When you create an account on the Services you are able to do so by using your credentials with a designated third party website or service ("**Third Party Account**") such as Gmail®. Doing so will enable you to link your account and your Third Party Account. If you choose this option, a Third Party Account pop-up box will appear that you will need to approve in order to proceed, and which will describe the types of information that we will obtain. This information includes your Personal Information stored on your Third Party Account, such as user-name, email address, profile picture, birthday, gender and preferences. Any Anonymous Information that is specifically connected or linked to any Personal Information, is treated by us as Personal Information, as long as such connection or linkage exists.
* Registering through social network account: When you register or sign-in to the Services via your social network account (e.g., Facebook, Google+), we will have access to basic information from your social network account, such as your full name, home address, email address, birthdate, profile picture, friends list, personal description, as well as any other information you made publicly available on such account or agreed to share with us. At all times, we will abide by the terms, conditions and restrictions of the social network platform.

If we combine non-personal information with personal information we will treat the combined information as personal information.

We may also collect publicly posted personal data from various online sources. Such information will include, in most cases, basic contact information, such as name, email and job title ("**Public Data**").

### [Legal basis for processing](https://brightdata.com/privacy#info-processong)

Processing of User Data is necessary for the performance of our contractual obligations towards you and providing you with our services, to protect our legitimate interests and to comply with our legal obligations.

Processing of Public Data is done in accordance with our legitimate interest, as long as such interest does not override your fundamental rights and freedom.

### [How do we use your information?](https://brightdata.com/privacy#info-use)

We use User Data in order to provide you with the Service and to comply with our legal requirements and internal guidelines. This means that we will use the information to set up your account, provide you with support regarding the Service, communicate with you for updates, marketing offers or concerns you may have and conduct statistical and analytical research to improve the Service. We may use Public Data in order to provide our users with our Services.

We do not rent or sell any User Data. We may share Public Data with our users in order to provide our Services.

We may disclose Personal Information to other trusted third party service providers or partners for the purposes of providing you with the Services, storage and analytics and to comply with our legal requirements and internal guidelines. We may also transfer or disclose Personal Information to our subsidiaries and affiliated companies.

Notwithstanding the paragraph above, we will not disclose your IP address to other customers. However, when other customers (e.g. other peers in the network) access the web using your IP address, the IP address may be visible to them, for example by way of looking up their current IP address.

We may also share your Personal Information and other information in special cases if we have good reason to believe that it is necessary to: (1) comply with law, regulation, subpoena or court order; (2) detect, prevent or otherwise address fraud, security, violation of our policies or technical issues; (3) enforce the provisions of this Privacy Policy or any other agreements between you and us, including investigation of potential violations thereof; (4) protect against harm to the rights, property or safety of us, our partners, our affiliates, users, or the public.

### [Processing of data outside the EEA](https://brightdata.com/privacy#data-outside-eea)

Note that we are based in Israel and some of the data recipients listed above may be located outside the European Economic Area (EEA). In such cases we will share your data only with recipients located in such countries as approved by the European Commission as providing adequate level of data protection, or enter into legal agreements ensuring an adequate level of data protection.

### [Security and Confidentiality](https://brightdata.com/privacy#security)

We use industry-standard information, security tools, and measures, as well as internal procedures and strict guidelines to prevent information misuse and data leakage. Our employees are subject to confidentiality obligations. We use measures and procedures that substantially reduce the risks of data misuse, but we cannot guarantee that our systems will be absolutely safe. If you become aware of any potential data breach or security vulnerability, you are requested to contact us immediately. We will use all measures to investigate the incident, including preventive measures, as required.

### [Your Choices and Rights](https://brightdata.com/privacy#rights)

We strive to give you ways to update your information quickly or to delete it - unless we have to keep that information for legitimate business or legal purposes. When updating your personal information, we may ask you to verify your identity before we can act on your request.

If you are a resident of the European Union, note that the following rights specifically apply regarding your personal information: (1) Receive confirmation as to whether or not personal information concerning you is being processed, and access your stored personal information, together with supplementary information; (2) Receive a copy of personal information you directly volunteer to us in a structured, commonly used and machine-readable format; (3) Request rectification of your personal information that is in our control; (4) Request erasure of your personal information; (5) Object to the processing of personal information by us; (6) Request to restrict processing of your personal information by us; (7) Lodge a complaint with a supervisory authority.

However, note that these rights are not absolute, and may be subject to our own legitimate interests and regulatory requirements.

To exercise such right, you may contact us at: [privacy@brightdata.com](mailto:privacy@brightdata.com)

### [Retention](https://brightdata.com/privacy#retention)

We will retain your personal information for as long as necessary to provide the Service, and as necessary to comply with our legal obligations, resolve disputes, and enforce our policies. Retention periods shall be determined taking into account the type of information collected and the purpose for which it is collected, bearing in mind the requirements applicable to the situation and the need to destroy outdated, unused information at the earliest reasonable time.

We may rectify, replenish or remove incomplete or inaccurate information, at any time and at our own discretion.

### [Information Warranty Disclaimer](https://brightdata.com/privacy#warranty)

Notwithstanding anything else in this Policy, we are not responsible for the accuracy, correctness, and security of any of the information we gather, store, and disclose to you or to anyone else.

Our policy only addresses the use and disclosure of information we collect from you. To the extent you disclose your information to other parties or sites throughout the internet, different rules may apply to their use or disclosure of the information you disclose to them. Accordingly, we encourage you to read the terms and conditions and privacy policy of each third party that you choose to disclose information to.

### [Change of Ownership](https://brightdata.com/privacy#change-ownership)

In the event of a change of ownership or control of all or a part of Bright Data, including without limitation through acquisition, merger, or sale, we reserve the right to transfer all or part of the User Data and Public Data we store in our systems. You acknowledge that in the event of bankruptcy, insolvency, or receivership, we may have no control over the use and transfer of your personal information.

### [Changes to this Privacy Policy](https://brightdata.com/privacy#privacy-change)

This Policy may be revised from time to time at our sole discretion, so check it regularly. The last revision will be reflected in the "Last Updated" heading. Any change of this policy will be posted on the Site. Your continued use of the Services following any such changes will be considered as you consent to the amended Privacy Policy.

### [Contact Us](https://brightdata.com/privacy#contact-us)

If you feel that your privacy was not treated in accordance with our Privacy Policy, or if you believe that your privacy has been compromised by any person in the course of using the Services, contact Bright Data at: [privacy@brightdata.com](mailto:privacy@brightdata.com) and our Privacy Officer shall promptly investigate.

We have also appointed GDPR representatives in the EU and the UK. You can contact the representatives regarding matters pertaining to the GDPR:

GDPR - European Representative:

Pursuant to Article 27 of the GDPR, Bright Data has appointed European Data Protection Office (EDPO) as its GDPR Representative in the EU. You can contact EDPO regarding matters pertaining to the GDPR:

* by using EDPO's online request form: [https://edpo.com/gdpr-data-request/](https://edpo.com/gdpr-data-request/)
* by writing to EDPO at Avenue Huart Hamoir 71, 1030 Brussels, Belgium

UK General Data Protection Regulation (GDPR) - UK Representative:

Pursuant to Article 27 of the UK GDPR, Bright Data has appointed EDPO UK Ltd as its UK GDPR representative in the UK. You can contact EDPO UK regarding matters pertaining to the UK GDPR:

* by using EDPO's online request form: [https://edpo.com/uk-gdpr-data-request/](https://edpo.com/uk-gdpr-data-request/)
* by writing to EDPO UK at 8 Northumberland Avenue, London WC2N 5BY, United Kingdom

### [Privacy notice for California Residents](https://brightdata.com/privacy#privacy-california)

This notice addresses the specific disclosure requirements under the California Consumer Privacy Act of 2018 (Cal. Civ. §§ 1798.100–1798.199) and the California Consumer Privacy Act Regulations by the Attorney General (collectively, "**CCPA**").

If you have a disability, you may access this Privacy Policy in an alternative format by contacting [privacy@brightdata.com](mailto:privacy@brightdata.com)

In the 12 preceding months, we have collected and disclosed the following categories of Personal Information:

<table>
  <tbody>
    <tr>
      <th>Category of Personal Information Collected</th>
      <th>Personal Information Collected</th>
      <th>Categories of service providers to whom Personal Information was disclosed</th>
    </tr>

    <tr>
      <td>A. Identifiers.</td>
      <td>B. Full name, email address, device identifiers, including certain software and hardware information (e.g. IP address, internet service provider, domain server, type of computer, browser type and language and operating system).</td>
      <td>C. Cloud services.<br />D. Website analysis.<br />E. Affiliated companies.</td>
    </tr>

    <tr>
      <td>F. Personal Information Categories listed in the California Customer Records Statute (Cal. Civ. Code § 1798.80(e)).</td>
      <td>G. Address, telephone number, financial information (e.g. credit card number).</td>
      <td>H. Cloud services.<br />I. Affiliated companies.</td>
    </tr>

    <tr>
      <td>J. Commercial Information.</td>
      <td>K. Feedback of users.</td>
      <td>L. Cloud services.<br />M. Affiliated companies.</td>
    </tr>

    <tr>
      <td>N. Internet or Other Electronic Network Activity Information.</td>
      <td>O. Information regarding the user's interaction with the website.</td>
      <td>P. Cloud services.<br />Q. Website analysis.<br />R. Affiliated companies.</td>
    </tr>

    <tr>
      <td>S. Geolocation Data.</td>
      <td>T. Geolocation data based on device identifiers.</td>
      <td>U. Cloud services.<br />V. Affiliated companies.</td>
    </tr>

    <tr>
      <td>W. Professional or<br />Employment-related Information.</td>
      <td>X. Current or past job history.</td>
      <td>Y. Cloud services.<br />Z. Affiliated companies.</td>
    </tr>
  </tbody>
</table>

### [Sources of Personal Information](https://brightdata.com/privacy#sources-of-info)

In the 12 preceding months, we have collected the above-mentioned categories of Personal Information from the following categories of sources:

* Consumers directly, through the Services;
* Operating systems.
* Publicly available information collected from online sources.

### [Selling Personal Information](https://brightdata.com/privacy#selling-info)

In the preceding twelve (12) months, we may have sold the following categories of Personal Information to third parties or businesses for commercial purposes:

* Identifiers;

### [User Rights under the CCPA](https://brightdata.com/privacy#undefined)

### [Access to Personal Information](https://brightdata.com/privacy#access-info)

You may request, up to two times each year, that we disclose to you the categories and specific pieces of Personal Information that we have collected about you, the categories of sources from which your Personal Information is collected, the business or commercial purpose for collecting your Personal Information, the categories of Personal Information that we disclosed for a business purpose, any categories of Personal Information about you that we sold, the categories of third-parties with whom we have shared your Personal Information, and the business or commercial purpose for selling your Personal Information, if applicable.

### [Deletion Requests](https://brightdata.com/privacy#deletion-request)

You have the right to request that we delete any Personal Information collected from you and retained, unless an exception applies.

Once we receive and confirm your verifiable consumer request, we will delete (and direct our service providers, subcontractors, and consultants to delete) your Personal Information, unless an exception applies.

### [Exercising Your Rights](https://brightdata.com/privacy#exercise-rights)

You can exercise your rights (such as access and deletion) by submitting a verifiable consumer request to our email address: [privacy@brightdata.com](mailto:privacy@brightdata.com) or by the toll-free number 1-888-538-9204. You can also send us a mail to our physical address specified in this policy.\
Only you or a person authorized to act on your behalf may make a consumer request related to your Personal Information.

The request must:

* Provide sufficient information to allow us to reasonably verify you are the person about whom we collected Personal Information or an authorized representative.
* Describe your request with sufficient details to allow us to properly understand, evaluate, and respond to it.
* We cannot respond to your request or provide you with Personal Information if we cannot verify your identity or authority to make the request and confirm the Personal Information relates to you. Making a verifiable consumer request does not require you to create an account with us. We will only use Personal Information provided in a verifiable consumer request to verify the requestor's identity or authority to make the request. We will only use Personal Information provided in a verifiable consumer request to verify the requestor's identity or authority to make the request.

You may only request a copy of your data twice within a 12-month period.

If you have any general questions about the Personal Information that we collect about you how we use it, please contact us at [privacy@brightdata.com](mailto:privacy@brightdata.com)

### [Response Timing and Format](https://brightdata.com/privacy#response-time)

Our goal is to respond to a verifiable consumer request within 45 days of its receipt. If we require more time, we will inform you of the reason and extension period in writing within the first 45 days period. We will deliver our written response, by mail or electronically, at your option. Any disclosures we provide will cover only the 12-month period preceding the request. If reasonably possible, we will provide your Personal Information in a format that is readily useable and should allow you to transmit the information without hindrance.

We do not charge a fee to process or respond to your verifiable consumer request unless it is excessive, repetitive, or manifestly unfounded. If we determine that the request warrants a fee, we will tell you why we made that decision and provide you with a cost estimate before completing your request.

In case of rejection, the response we provide will explain the reasons for which we cannot comply with your request.

Please note that these CCPA rights are not absolute and requests are subject to any applicable legal requirements, including legal and ethical reporting or document retention obligations.

### [Designating Agents](https://brightdata.com/privacy#designating-agents)

You can designate an authorized agent to make a request under the CCPA on your behalf if:

* The authorized agent is a natural person or a business entity registered with the Secretary of State of California; and
* You sign a written declaration that you authorize the authorized agent to act on your behalf.

If you use an authorized agent to submit a request to exercise your right to know or your right to request deletion, please mail a certified copy of your written declaration authorizing the authorized agent to act on your behalf using the contact information below.

If you provide an authorized agent with power of attorney pursuant to Probate Code sections 4000 to 4465, it may not be necessary to perform these steps and we will respond to any request from such authorized agent in accordance with the CCPA.

### [Non-Discrimination](https://brightdata.com/privacy#non-discrimination)

We will not discriminate against you if you exercise any of your privacy rights as a California Consumer. Unless permitted by the CCPA, we will not:

* Deny you goods or services.
* Charge you different prices or rates for goods or services, including through granting discounts or other benefits, or imposing penalties.
* Provide you a different level or quality of goods or services.
* Suggest that you may receive a different price or rate for goods or services or a different level or quality of goods or services.


# What is Bright Data Platform?
Source: https://docs.brightdata.com/general/policy/What_is_Bright_Data_platform



The Bright Data Network provides you with the public web data you need to make the difference to your business, project research, or initiative.


# Bright Data Master Service Agreement
Source: https://docs.brightdata.com/general/policy/license

_Last Updated July 12, 2023_

<img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/policy/license/service_agreement.svg?maxW=667&auto=format&n=JpbB64sgI_r6D502&q=85&s=a6761f35d151007003afbd68eb9beeef" alt="service_agreement.svg" width="667" height="233" data-path="images/general/policy/license/service_agreement.svg" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/policy/license/service_agreement.svg?w=280&maxW=667&auto=format&n=JpbB64sgI_r6D502&q=85&s=753e87622769ff43a0d16a8aedd4a7d9 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/policy/license/service_agreement.svg?w=560&maxW=667&auto=format&n=JpbB64sgI_r6D502&q=85&s=994829ace63d4abb34a8353fea5067f7 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/policy/license/service_agreement.svg?w=840&maxW=667&auto=format&n=JpbB64sgI_r6D502&q=85&s=e131a3779647843d37308de3d977e75e 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/policy/license/service_agreement.svg?w=1100&maxW=667&auto=format&n=JpbB64sgI_r6D502&q=85&s=39a8f1b618622d33e752e2c379e10391 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/policy/license/service_agreement.svg?w=1650&maxW=667&auto=format&n=JpbB64sgI_r6D502&q=85&s=17d84cd6960d94b6560b2cda5c50ad66 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/policy/license/service_agreement.svg?w=2500&maxW=667&auto=format&n=JpbB64sgI_r6D502&q=85&s=135d879ec4d5fecbb22a2a5d40f7ffe8 2500w" data-optimize="true" data-opv="2" />

This Master Service Agreement (the “**Agreement**”) is an agreement between Bright Data Ltd., (“**Bright Data**”) with address at 4 Hamahshev St., Netanya 4250714, Israel, and you or the entity you represent (“**Client**”). This Agreement takes effect when you sign up to Bright Data or, if earlier, when you access or use the Bright Data services, as defined below (the “**Effective Date**”). If you are using the Bright Data services on behalf of an entity, you represent to us that you are lawfully able to enter into this Agreement on behalf of the Client.

## Bright Data Responsibilities

1. Bright Data will make any of the services detailed in this Agreement or otherwise offered on the Bright Data platforms (“**the Services**”) available to Client in accordance with the provisions of this Agreement, including Bright Data’s [Service Level Agreement](https://brightdata.com/sla), if applicable. Bright Data shall have the right, but not the obligation, to monitor Client’s use of the Service for billing purposes and to verify no misuse or network abuse. Bright Data may share the Client’s relevant information with any authority in case of a complaint, investigation or a lawsuit, if Bright Data determines that it is necessary to comply with any subpoena, judicial or governmental requirement, or order.
2. Certain Services will be made available subject to Bright Data’s completion of a successful compliance review process of the Client. Such review may include a Know Your Client process, video calls with the Client and any other measures that Bright Data decides, at its sole discretion, are necessary to approve Client’s use of the Service. Client will cooperate with Bright Data and provide it with any information reasonably required as part of the compliance review process.

## Temporary Suspension

Bright Data in its sole discretion and at any time, may suspend Client’s right to access or use the Service immediately upon notice to Client if Bright Data, at its sole discretion, determines that:

1. Client’s use of or registration to the Service (i) poses a security risk to Bright Data or its Service or any third party, (ii) may adversely impact Bright Data or any of its clients, including by way of causing a user to be blocked from certain websites, networks or services, (iii) may subject Bright Data, its affiliates, or any third party to liability, or is in breach under any applicable laws or regulations, (iv) may be fraudulent, or (v) may disparage or devalue Bright Data’s reputation or goodwill; or
2. Client is in breach of this Agreement, including if Client is delinquent on payment obligations; or
3. Client has violated any of its representations and warranties under this Agreement or any other representation and warranties provided to Bright Data associated with Client’s use of the Service.

## Client Warranties and Representations

The Client warrants, represents and covenants to Bright Data that:

General

1. It is aware that the Services may only be used by individuals that are at least 18 years old and at least the legal age allowed for by the applicable jurisdiction. The Client represents and warrants that, to the extent it is an individual, it is of legal age, as described above. Client further acknowledges that Bright Data may require proof of age as a condition for the provision of the Service.
2. To the extent that the use of the Service will contain any personal information, that is intended for processing by Bright Data as a “processor” (as the term is defined in the applicable privacy legislation) then the provision of the Service will also be subject to [Data Protection Addendum](https://brightdata.com/wp-content/uploads/2023/07/Bright-Data-Data-Protection-Agreement.pdf).
3. The Client will be solely responsible for any actions it performs based on the use of the Service.
4. The Client is responsible for protecting its personal username and/or password to the Service. The Client may not share its account privileges with anyone or knowingly permit any unauthorized access to the Service. The accounts of those involved will be disabled if sharing is detected.
5. The Client shall not use the Services in violation of applicable law or regulations or any third party rights (including intellectual property rights) and not use the Service in any manner or for any purpose other than as stated in the intended use case provided to Bright Data, if applicable.
6. Without derogating from the generality of the above, the Client will only use the Service in accordance with the [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy), as may be amended from time to time.
7. <u>Specific terms for the Proxy Services<br /></u> When using the Proxy Services, the Client shall:\
   I. Not use the Service to: (i) distribute cracking, warez, ROM, virus, adware, worms, trojan horses, malware, spyware or any other similar malicious activities and products or any other computer code, files or programs designed to interrupt, hijack, destroy, limit or adversely affect the functionality of any computer software, hardware, network or telecommunications equipment; (ii) cause any network resource to be unavailable to its intended users, including, without limitation, via “Denial-of-Service (DoS)” or “Distributed Denial-of-Service (DDoS)” attack; (iii) distribute any unlawful content or encourage any unlawful activity; (iv) cause any damage or service disruption to any third party computers or service; or (v) enhance or operate a service that competes with the Services, or assist any other party to do so.\
   II. Not use other systems, products or services that infringe upon the patents and other intellectual property rights of Bright Data.\
   III. Not engage in any reselling of the Service in whole or in part, without Bright Data’s prior written authorization.\
   IV. Not, and not enable others to, copy, decompile, reverse engineer, disassemble, attempt to derive the source code of, decrypt, modify, or create derivative works of the Service or any services provided by Bright Data, or any part thereof, including without limitation by using the Service in order to perform mapping of the IP addresses used by Bright Data in the provision of the Service, without Bright Data’s prior written approval. It is hereby clarified that IP addresses used as part of the provision of the Service are personal and confidential information, and any unauthorized use of such information is strictly prohibited and may be considered breach of applicable law and/or third party rights.
8. <u><span>Specific terms for the Data Services (including without limitation Datasets, Web Scraper IDE and Bright Insights)</span><br /></u>I. When using the Data Services, the Client shall not distribute, transmit, reproduce, publish, license, transfer, or sell any Data in order to offer a similar or competitive product.

## Consideration

1. Following the free trial period (if granted by Bright Data), Client will enter a valid payment method as a condition for further use or access to the Service, at the consideration stated in the Client’s dashboard or in a specific insertion order or other statement of work (the **“Subscription Fees”**). The Subscription Fees are non-cancelable and non-refundable.
2. Prices are net of any withholding or other taxes and the Client shall be responsible for payment of all such applicable taxes, levies, or duties.
3. Client consents to receive electronic invoices and receipts from Bright Data.
4. In the event of non-payment of the Subscription Fees in accordance with the terms hereof, the Client agrees to pay for the costs and expenses of collection of any unpaid deficiency in the Client’s account, including, but not limited to, attorney’s fees, court costs and any other costs incurred or paid by Bright Data.

## Confidential Information

If a Party (the **“Receiving Party”**) obtains access to Confidential Information (as defined below) of the other Party (the **“Disclosing Party”**) in connection with the negotiation of or performance under this Agreement, the Receiving Party agrees that:

1. The Disclosing Party shall retain ownership of the Confidential Information and that the Receiving Party shall not acquire any rights therein, except the right to use such Confidential Information to the extent provided in this Agreement;
2. The Receiving Party shall use at least the same degree of care to protect the Confidential Information from unauthorized disclosure or access that the Receiving Party uses to protect its own Confidential Information, but not less than reasonable care, including measures to protect against the unauthorized use, access, destruction, loss and alteration of such Confidential Information;
3. Except as otherwise provided in this Agreement, no Confidential Information disclosed pursuant to this Agreement shall be made available by the Receiving Party to any third party for any purpose, except to a consultant, attorney, subcontractor, or potential subcontractor who needs to know the Confidential Information for the performance of this Agreement and provided that they agree to be bound by the terms and conditions of this Article or another written agreement sufficient to require them to treat Confidential Information in accordance with this Agreement. The Receiving Party agrees to indemnify the Disclosing Party for any violation or breach of such restrictions.

**“Confidential Information”** shall mean all information disclosed by the Disclosing Party to the Receiving Party in connection with the Agreement, whether in oral form, visual form or in writing, including but not limited to: all specifications, formulas, prototypes, computer programs and any and all records, data, ideas, methods, techniques, processes and projections, plans, marketing information, materials, creatives, scripts and storyboards, financial statements, memoranda, analyses, notes, legal documents and other data and information (in whatever form), as well as improvements, patents (whether pending or duly registered), trade secrets, any know-how, customer lists, customer information, end-user information, and any information provided to the Disclosing Party by a third party under a confidentiality agreement or which the Disclosing Party is otherwise legally obligated to keep in confidence, relating to the Disclosing Party, and information learned by the Receiving Party from the Disclosing Party through inspection of Disclosing Party’s property, that relates to the Disclosing Party’s products, designs, business plans, business opportunities, finances, research, development, know-how or personnel. The Subscription Fees under this Agreement, shall be considered as Confidential Information.\
Confidential Information will not include:

1. Information that the Receiving Party received rightfully from a third party who has the right to transfer or disclose it, without default or breach of this Agreement; or
2. Information that was previously rightfully known by the Receiving Party free of any obligation to keep it confidential; or
3. Information that becomes publicly known through no wrongful act of the Receiving Party; or
4. Information that is independently developed by the Receiving Party without reference to, use of, or access to the Confidential Information of the Disclosing Party.

The Receiving Party may disclose Confidential Information pursuant to a subpoena, judicial or governmental requirement, or order, and the Receiving Party shall not be liable in damages for any such disclosure of Confidential Information.\
The confidentiality obligations under this Agreement will survive any expiration or termination of this Agreement.

## Disclaimer of Warranties

BRIGHT DATA IS PROVIDING THE USE OF THE SERVICE AND ANY ACCOMPANYING DATA ON “AS IS” BASIS AND IT EXPRESSLY DISCLAIMS ANY AND ALL REPRESENTATIONS AND WARRANTIES, WHETHER EXPRESS OR IMPLIED TO THE CONDITION, VALUE OR QUALITY OF THE SERVICE OR ANY ACCOMPANYING DATA, INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, SUITABILITY OR FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, SECURITY, ACCURACY, ABSENCE OF VIRUSES OR ANY DEFECT THEREIN, WARRANTIES ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE. BRIGHT DATA FURTHER EXPRESSLY DISCLAIMS ANY REPRESENTATIONS OR WARRANTIES THAT THE USE OF THE SERVICE WILL BE CONTINUOUS, UNINTERRUPTED OR ERROR-FREE, OR THAT ANY INFORMATION CONTAINED THEREIN WILL BE ACCURATE OR COMPLETE.

## Limitation of Liability

In no event will Bright Data be liable under this Agreement for any consequential, special, indirect or punitive damages or for any loss, profits or revenue (whether in contract, tort, negligence or any other legal theory) in any way relating to this Agreement (“**Event**”), even if Bright Data had been informed in advance of the possibility of such damages. Bright Data’s aggregated liability under this Agreement for any claim or damage or series of such is limited to the amount of fees actually received by Bright Data from Client under this Agreement during the one month period prior to the Event.

## Indemnification

Client will defend Bright Data against any claim, demand, suit or proceeding made or brought against Bright Data by a third party alleging that the Client’s use of any Service infringes or misappropriates such third party’s intellectual property rights or breaches applicable privacy laws or any other applicable law or causes damage to such third party (a “**Claim Against Bright Data**”), and will indemnify Bright Data from any direct damages, attorney fees and costs finally awarded against Bright Data as a result of, or for any amounts paid by Bright Data under a court-approved settlement of, a Claim Against Bright Data, provided Bright Data (a) promptly gives Client written notice of the Claim Against Bright Data, (b) gives Client sole control of the defense and settlement of the Claim Against Bright Data (except that Client may not settle any Claim against Bright Data unless it unconditionally releases Bright Data of all liability), (c) gives Client all reasonable assistance, at Client’s expense, and (d) Bright Data shall not negotiate or enter into any settlement for this matter without Client’s prior written consent. Client’s obligations above do not apply to a Claim Against Bright Data which is based only on Bright Data’s breach of this Agreement.

## Term and Termination

1. This Agreement commences on the Effective Date and shall continue until terminated in accordance with the terms of this Agreement.
2. Unless a separate schedule or statement of work agreed upon between the Parties has set a pre-determined period for the provision of the Services, either party shall have the right to terminate this Agreement immediately at any time by providing the other party an advance written notice until the end of that calendar month. The Agreement will terminate at the end of the calendar month at which the written notice was received, without the party incurring any liability towards the other party by virtue of such termination.
3. Bright Data shall be entitled to terminate this Agreement immediately for “cause” by written notice to the Client if (a) any act or omission by Client entitles Bright Data to suspend its access or use of the System (as defined below) or Service as described in Section 2; (b) the Client is in breach of any representation or warranty found in this Agreement or any other representation and warranties provided to Bright Data associated with Client’s use of the System or Service; (c) the Client engages in any action or activity that, in Bright Data’s sole discretion, places Bright Data at risk under any applicable laws or regulations. Bright Data shall not be liable to the Client or any third party for the termination of this Agreement.
4. Upon termination, any outstanding consideration amounts shall immediately become due and payable (including without limitation, for Data collected, even if not yet provided to the Client), the license granted herein shall be terminated and the Client shall immediately stop using the System or Service.

## Specific Service Terms

Without derogating from the **generality** of other provisions of the Agreement, the following terms shall apply to the specific Services the Client wishes to obtain from Bright Data:

1. **Proxy Services and Browser API API**.\
   I. Bright Data has developed, owns and offers a service which enables browsing the internet anonymously by redirecting users’ communication through other users’ devices (the **“System”**). This use of the System is available for commercial use under this Agreement.\
   II. During the term of this Agreement Bright Data grants the Client a limited, revocable and non-transferable license (with no right to sublicense) to access and use the System solely for the purpose of Client’s internal business operations.\
   III. Bright Data reserves any and all rights not expressly granted in this Agreement, including, without limitation, any and all rights to the System.\
   IV. Bright Data may retain data Client has collected and may use it for its own purposes in its sole discretion.\
   V. The Clients may choose to increase data retrieval performance by implementing a “cache proxy” solution. In this case, the Client acknowledges and agrees that the data retrieved may not be the most recent data available.
2. **Web Scraper IDE.**\
   I. Bright Data has developed, owns and offers a data collector service which collects and delivers publicly available data to its users, subject to the terms in this Agreement.\
   II. Bright Data will not provide the Service or Data where such provision may, in Bright Data’s sole discretion, infringe or violate any applicable laws or regulations or any other third party rights.\
   III. Client’s use of the data collector service is subject to all applicable laws, including without limitation data protection and privacy laws. To the extent applicable to processing of personal data, Client is solely responsible for determining the lawful grounds, providing notices, respecting data subject rights and all other related obligations.\
   IV. Bright Data may retain data it has collected or delivered to its Clients and may use it for its own purposes in its sole discretion.
3. **Dataset Service**.\
   I. Bright Data may offer, from time to time, for various fees, digital data sets of information on various categories (**“Datasets”**).\
   II. The Datasets may only be used for legally valid purposes and in accordance with all applicable laws which may apply, both domestic and international, including without limitation applicable privacy and marketing communications legislation.\
   III. The Datasets may contain additional terms and conditions governing the use of such Datasets.\
   IV. For subscription purchases of Datasets, updates will be provided if and when available.\
   V. Any requests for changes in Datasets will be subject to Bright Data’s prior approval, and may incur additional charges, as will be agreed between the Client and Bright Data.
4. **Data Insights**\
   I. Bright Data may offer a service that is intended to produce various data insights based on pre-determined datasets provided by Bright Data.\
   II. The provisions of this Agreement, including without limitation, the provisions concerning Disclaimer of Warranties and Limitation of Liability, will govern the offering and possible use of such insights.\
   III. The insights do not constitute legal, financial, commercial, or other advice and any reliance on such insights is done solely in the Client’s discretion and its own risk.\
   IV. The information contained in the Bright Data Insights may not be shared with third parties without Bright Data’s prior written approval.

## Miscellaneous

1. This Agreement constitutes the entire understanding between the parties with respect to the matters referred to herein.
2. All notices or other communications hereunder shall be given by email to the email address provided by the parties as part of the registration to the Service.
3. To the extent not prohibited by applicable law, the Customer waives the right to litigate in court or an arbitration proceeding any dispute related to this Agreement as a class action, either as a member of a class or as a representative.
4. This Agreement shall be governed by the laws of the State of Israel, excluding its conflict of law rules, and the courts of Tel-Aviv-Jaffa shall have exclusive jurisdiction over the parties.
5. If any provision of this Agreement will be held by a court of competent jurisdiction to be contrary to any law, the remaining provisions will remain in full force and effect as if said provision never existed.
6. No failure or delay on the part of any party hereto in exercising any right, power or remedy hereunder shall operate as a waiver thereof.
7. Bright Data may, at any time, and at its sole discretion, modify this Agreement, with or without notice to the Client. Any such modification will be effective immediately upon public posting. Client’s continued use of the Systems and Service following any such modification constitutes acceptance of the modified Agreement.
8. Bright Data may use Client’s name and/or logo in promotional materials and on Bright Data’s website.

Service Agreement

* [Bright Data Responsibilities](https://brightdata.com/license#toc_1_2)
* [Temporary Suspension](https://brightdata.com/license#toc_1_3)
* [Client Warranties and Representations](https://brightdata.com/license#toc_1_4)
* [Consideration](https://brightdata.com/license#toc_1_5)
* [Confidential Information](https://brightdata.com/license#toc_1_6)
* [Disclaimer of Warranties](https://brightdata.com/license#toc_1_7)
* [Limitation of Liability](https://brightdata.com/license#toc_1_8)
* [Indemnification](https://brightdata.com/license#toc_1_9)
* [Term and Termination](https://brightdata.com/license#toc_1_10)
* [Specific Service Terms](https://brightdata.com/license#toc_1_11)
* [Miscellaneous](https://brightdata.com/license#toc_1_12)


# Does Bright Data collection activities breach domestic copyright and cyber security laws
Source: https://docs.brightdata.com/general/privacy/copyright-and-cyber-security-laws



> **No.**

Bright Data serves the leading copyright protection and cyber security companies in the world.\
Bright Data works closely with experts and law firms to confirm every use case and make sure we don't allow the collection of copyrighted material nor the breach of any cyber security laws.\
Some of the things we do that no regular ISP ever does:

* We don't allow logins into any web service with any type of credentials, fake or real, assuming that everything behind a login is either private or copyrighted.
* We rate limit the collection activity to always be a small percentage of the website's organic traffic
* We allow webmasters to have some block and rate limit control over Bright Network collector traffic


# How does Bright Data ensure the Privacy & Security of the User that install its Apps?
Source: https://docs.brightdata.com/general/privacy/privacy-and-security-for-apps



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


# How does Bright Data protect End User's resources?
Source: https://docs.brightdata.com/general/privacy/protect-end-users-resources



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



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.


# Denylisting or Allowlisting IPs and Domains
Source: https://docs.brightdata.com/general/security/allowlist-denylist-ips-domains



## Definitions

* Allowlist is the ist 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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/editAllowlist.png?maxW=1321&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=53a350fd8fc3efad350585963ba0663b" alt="editAllowlist.png" width="1321" height="578" data-path="images/proxy-networks/faqs/editAllowlist.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/editAllowlist.png?w=280&maxW=1321&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b2d97a1dfb854e33480dfdebf3f131db 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/editAllowlist.png?w=560&maxW=1321&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=72f751b0a7e57affb109ebb8fb949d18 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/editAllowlist.png?w=840&maxW=1321&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a778ab497c083ad0c0b0e72af2f31b81 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/editAllowlist.png?w=1100&maxW=1321&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2ec73c2d1a4231040f2101b63201c897 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/editAllowlist.png?w=1650&maxW=1321&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5e396a29406608c8250b42538ab7952d 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/editAllowlist.png?w=2500&maxW=1321&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=962c22eb9cb27df7a639e4d6e6afea8a 2500w" data-optimize="true" data-opv="2" />

5. This will get you to the configuration tab, under security settings, to edit the lists:

<img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d438296191d4567832ffc1428804bf2e" alt="whitelist-blacklist.png" width="557" height="490" data-path="images/proxy-networks/faqs/whitelist-blacklist.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=280&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=363f6c345e5393a22de1c06867bf6d0d 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=560&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a3aae6a92643ae783a957a726c662310 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=840&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a98a1d5655cc162f1378621db15aa53c 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=1100&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=bb65479ef65304ad7f8b3fdf0bc1ea31 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=1650&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9aca6308d18a97a6d7c9281068888f0c 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=2500&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a2866c8436989541f0510a76667fffa5 2500w" data-optimize="true" data-opv="2" />

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`                                           |


# How does Bright Data ensure Network Security?
Source: https://docs.brightdata.com/general/security/network-security



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>


# null
Source: https://docs.brightdata.com/general/security/security-overview



Every company, organization, research institute or public body needs data. More specifically, they need direct access to the largest database in the world - the World Wide Web. For this reason. we have established Bright Data\`s online data collection network, which will allow every business or organization to easily and efficiently tap into the power that public web-based information provides. weather it is for market research, to establish a pricing strategy, to conduct academic research, or even to decide on a companys investment moves, among other initiatives. online data provides all the credible information needed to improved decision-making, as it accurately reflects your industry or market reality. To put it simply, online data is any organizations best performing and most reliant adviser for any decision – no matter how big or critical. However, tapping into that large-scale all-knowing source of information is not easy.


# null
Source: https://docs.brightdata.com/general/usage-monitoring/Event_log



For a quick overview of your usage, go to the event sign in your Zones page:

<Frame>
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-1.png?maxW=1644&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=e0dc9b1c870de186660cff56e47d1ba5" alt="event-log-1.png" width="1644" height="214" data-path="images/general/usage-monitoring/event_log/event-log-1.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-1.png?w=280&maxW=1644&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=6076eef1b09d5c83102485771284ad01 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-1.png?w=560&maxW=1644&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=db06ad60a1d49df67e822801e8fd4011 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-1.png?w=840&maxW=1644&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=673c4a85056d28a3f29a87bb4813d220 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-1.png?w=1100&maxW=1644&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=5e3296d6a4f06f65084f0a54deed2e3d 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-1.png?w=1650&maxW=1644&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a29803ca72b8d2cfcb0357d71e6dc3e1 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-1.png?w=2500&maxW=1644&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=b96bedb6f3aaa4705aa2ef1143e6779d 2500w" data-optimize="true" data-opv="2" />
</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 src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-2.png?maxW=1066&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=4e5a9f4e1a6639fd9942af87e659491b" alt="event-log-2.png" width="1066" height="403" data-path="images/general/usage-monitoring/event_log/event-log-2.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-2.png?w=280&maxW=1066&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=8072ce2470705d0988125cbf5e7d599d 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-2.png?w=560&maxW=1066&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=d228e3e2292b820148d94c068943240e 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-2.png?w=840&maxW=1066&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=e5de0adb4f7b45e7e1d96d5eab7faeb8 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-2.png?w=1100&maxW=1066&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=89a84e34fa8ab7b53418716059afd7f9 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-2.png?w=1650&maxW=1066&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=17da1b407e365cd4a390071e9007e0e8 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/event_log/event-log-2.png?w=2500&maxW=1066&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c8a19a5f3be2a2331112d51c19b93bec 2500w" data-optimize="true" data-opv="2" />
</Frame>


# Monitor your Usage
Source: https://docs.brightdata.com/general/usage-monitoring/Monitoring_Residential_Network_Usage



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 src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/Monitoring_Residential_Network_Usage/monitor-your-usage.gif?maxW=1600&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=fc4b011d10766bb6ca11493d455495bb" alt="monitor-your-usage.gif" width="1600" height="734" data-path="images/general/usage-monitoring/Monitoring_Residential_Network_Usage/monitor-your-usage.gif" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/Monitoring_Residential_Network_Usage/monitor-your-usage.gif?w=280&maxW=1600&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=df836aba9a1831a66d13de88d9a397c4 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/Monitoring_Residential_Network_Usage/monitor-your-usage.gif?w=560&maxW=1600&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=5ce218907c520e4de14304192925d76e 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/Monitoring_Residential_Network_Usage/monitor-your-usage.gif?w=840&maxW=1600&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f6b61bc10465557b8df7395c3320acb4 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/Monitoring_Residential_Network_Usage/monitor-your-usage.gif?w=1100&maxW=1600&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=6f6a7804850b07f91b6a2f2bab25281c 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/Monitoring_Residential_Network_Usage/monitor-your-usage.gif?w=1650&maxW=1600&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=e8a8035a267678c27f985c199acddbc0 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/Monitoring_Residential_Network_Usage/monitor-your-usage.gif?w=2500&maxW=1600&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f151911f9d943cf58e0d292e7d1880f2 2500w" data-optimize="true" data-opv="2" />
</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



<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)

    Once you reach your daily usage the Zone will automatically be suspended.

    <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 src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/usage/daily-limit.gif?maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f61284113dc3954f75455efde81961d2" alt="usage-monitor.gif" width="1636" height="930" data-path="images/general/usage-monitoring/usage/daily-limit.gif" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/usage/daily-limit.gif?w=280&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=88a561f927e91a783a73afccb772fd13 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/usage/daily-limit.gif?w=560&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=e8f9038b58f285a48b6d6ce36b6471b6 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/usage/daily-limit.gif?w=840&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=bd9c1e8fed9aa5b4d6edbf7e4aaba654 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/usage/daily-limit.gif?w=1100&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=2cbcbc946c554525836e4bc33146fea4 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/usage/daily-limit.gif?w=1650&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=8402319df5b7cecbe97ddfe784cf716b 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/usage-monitoring/usage/daily-limit.gif?w=2500&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=506f12bdfff99068911e4eb4f9870030 2500w" data-optimize="true" data-opv="2" />

    <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



<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
      curl "https://api.brightdata.com/zone/bw?zone=ZONE" -H "Authorization: Bearer API_KEY"
      ```

      ```js Node.js
      #!/usr/bin/env node

      require('request-promise')({
          url: 'https://api.brightdata.com/zone/bw?zone=ZONE',
          headers: {
              'Authorization': 'Bearer API_KEY'
          },
      }).then(function(data) {
              console.log(data);
          },
          function(err) {
              console.error(err);
          });
      ```

      ```java Java
      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#
      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
      #!/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
    {
      "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
      curl "https://api.brightdata.com/customer/bw" -H "Authorization: Bearer API_KEY"
      ```

      ```js Node.js
      #!/usr/bin/env node
      require('request-promise')({
       url: 'https://api.brightdata.com/customer/bw',
       headers: {'Authorization': 'Bearer API_KEY'},
      }).then(function(data){ console.log(data); },
       function(err){ console.error(err); });
      ```

      ```java Java
      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#
      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
      #!/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
      curl "https://api.brightdata.com/zone/cost?zone=ZONE" -H "Authorization: Bearer API_KEY"
      ```

      ```js Node.js
      #!/usr/bin/env node
      require('request-promise')({
       url: 'https://api.brightdata.com/zone/cost?zone=ZONE',
       headers: {'Authorization': 'Bearer API_KEY'},
      }).then(function(data){ console.log(data); },
       function(err){ console.error(err); });
      ```

      ```java Java
      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#
      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
      #!/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
    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

In DC & ISP unlimited zones, fair use allowance is applied to prevent abuse

<Note> **Fair use policy updated on 1-Aug-2025** </Note>

#### Fair use

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.

### Fair use scope

Fair use for unlimited proxies is calculated on the zone level.

#### How do we calculate fair use?

We sum up all the unlimited proxies of the same zone, and calculate the total fair use \*\*for that specific zone. \*\*

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,000 GB for `datacenter_zone1` and 500GB for `datacenter_zone2`.

### Is fair use 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?

No. Each zone carries their own fair use and it is not shared across zones.

#### 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 use automatically on the date of the zone's renewal. Renewal date is the day of the month you have setup the zone.

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


# Webhook Notifications
Source: https://docs.brightdata.com/general/webhook_notifications



<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>Unlocker API service disruption started</td>
      <td>Unlocker API</td>
      <td>Unlocker API is currently performing at a lower success rate for your targeted domains.</td>
      <td>4000 - Unlocker API service disruption start</td>
    </tr>

    <tr>
      <td>Network Health</td>
      <td>Unlocker API service disruption ended</td>
      <td>Unlocker API</td>
      <td>We have resolved the issue and Unlocker API is now showing high performance for your target domains.</td>
      <td>4001 - 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>


# How do I scrape site XYZ?
Source: https://docs.brightdata.com/general/websites

This section will give you tips and tricks on how you can get information from specific websites that you are interested in.

<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: Unlocker API or Browser API**

    The third option is to actively scrape the data using either the Unlocker API or the Browser API to gather LinkedIn data on your own. This approach allows for more flexibility and customization. With 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\&id=all)

    Information is readily available for Instagram people profiles, posts and more.

    **Option 3: Unlocker API or Browser API**

    The second option is to actively scrape the data using either the 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 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](https://docs.brightdata.com/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 [Unlocker API](https://docs.brightdata.com/scraping-automation/web-unlocker/introduction)

    2. Buy a Dataset from the [Datasets marketplace](https://brightdata.com/cp/datasets/browse/gd_lk122xxgf86xf97py).

    ### Using the Unlocker API

    The most effective way to collect real-time data from Shopee is by using the 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 Unlocker API and the customisation options in the [Unlocker API documentation](https://docs.brightdata.com/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: Unlocker API or Browser API**

    The second option is to actively scrape the data using either the 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 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\&id=all)

    Information is ready available for HomeDepot Canada and United States.

    **Option 3: Unlocker API or Browser API**

    The second option is to actively scrape the data using either the 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 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\&id=all)

    Information is readily available for Amazon domains from Canada, Germany, United States and all other amazon country stores.

    **Option 3: Unlocker API or Browser API**

    The second option is to actively scrape the data using either the 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 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?id=all\&search=facebook)

    Information is readily available for Facebook domains from Canada, Germany, United States and all other Facebook localities.

    **Option 3: Unlocker API or Browser API**

    The second option is to actively scrape the data using either the 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 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: Unlocker API or Browser API**

    The second option is to actively scrape the data using either the 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 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\&id=all)

    Information is readily available for Shein products and categories.

    **Option 3: Unlocker API or Browser API**

    The second option is to actively scrape the data using either the 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 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\&id=all)

    Information is readily available for G2 product reviews.

    **Option 3: Unlocker API or Browser API**

    The second option is to actively scrape the data using either the 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 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 AdsPower
Source: https://docs.brightdata.com/integrations/adspower

Boost your web scraping and multi-account management with Bright Data and AdsPower. Stay secure and undetectable as you manage multiple accounts effortlessly.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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?

Take control of your multi-account management with AdsPower! This versatile browser is perfect for marketers, e-commerce businesses, and social media managers who need a secure, efficient way to handle multiple accounts at once. Each profile runs in its own isolated environment, keeping your activities discreet and safe from account suspensions or flags.

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 scaling your e-commerce business, running social media campaigns, or working with affiliate marketing, AdsPower makes managing multiple accounts smooth and secure.

<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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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 as="div">
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower1.png?maxW=1016&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=08ba2036e97be3f658bc723b38b6e49f" alt="" width="1016" height="508" data-path="images/integrations/adspower1.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower1.png?w=280&maxW=1016&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=29355437effd7a9f16ce187aae4d1c47 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower1.png?w=560&maxW=1016&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=2dad2ba94f5cbdf7e4f247fe509f7062 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower1.png?w=840&maxW=1016&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=393692f884654859010985e7c144653b 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower1.png?w=1100&maxW=1016&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=e11bfcde2efb1fc7bebd05ef62b70c64 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower1.png?w=1650&maxW=1016&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=bd5e9d6775a22813da9aedf9438aab20 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower1.png?w=2500&maxW=1016&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=d95b874e7d7183fddde9d8a3cfcd5f27 2500w" data-optimize="true" data-opv="2" />
</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**: 33335

* **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](https://docs.brightdata.com/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 4. **Launch the Browser**. Click **Open** under **Tags** to launch your browser with the configured proxy.

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower4.png?maxW=1310&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=1ade62625dc17d22ff302bd3822de43d" alt="" width="1310" height="273" data-path="images/integrations/adspower4.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower4.png?w=280&maxW=1310&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c904bce08c44a90c86d0abcff99f4d79 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower4.png?w=560&maxW=1310&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=3f33facd4a428ee2c3bd2758f106146e 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower4.png?w=840&maxW=1310&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c4d81e2860bd5960d245d46857301ae0 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower4.png?w=1100&maxW=1310&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=9f4fa64b2eb15c2aeba8df504408b325 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower4.png?w=1650&maxW=1310&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f9ec356a70d3826f4a050a4104f49e01 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adspower4.png?w=2500&maxW=1310&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c694b6b7ea5780fc67a3d544218e6916 2500w" data-optimize="true" data-opv="2" />
</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

Enhance your anonymity and streamline your online tasks with Bright Data in Aezakmi. Follow this guide to configure secure and reliable proxy connections for your browser profiles.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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 as="div">
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi1.png?maxW=1080&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=7ccfcee54726fdd1bc510511fc4df0c1" alt="" width="1080" height="643" data-path="images/integrations/aezakmi1.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi1.png?w=280&maxW=1080&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=3f88c09e3de1f17f5a327d417b405727 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi1.png?w=560&maxW=1080&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=1d72e45239d071ef92e7d85bc943e7df 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi1.png?w=840&maxW=1080&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=730b9dee1f5a3628d5936df6f9652421 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi1.png?w=1100&maxW=1080&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=0f212f9ea34a6ec4c7c887d16c83f7ef 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi1.png?w=1650&maxW=1080&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=26fe31afb4770c458f4c767e5a05d00c 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi1.png?w=2500&maxW=1080&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=6c207b77d1359fbf7f2beefecddc9965 2500w" data-optimize="true" data-opv="2" />
</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 as="div">
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi2.png?maxW=1099&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=47a1b8a9903b225eb4af73d16e276b57" alt="" width="1099" height="182" data-path="images/integrations/aezakmi2.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi2.png?w=280&maxW=1099&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=4dd9faae2e03628d094daad918c22443 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi2.png?w=560&maxW=1099&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=4415989171dadbd10f8ac55a3f69776b 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi2.png?w=840&maxW=1099&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=2f8be488e9bb3b54817161c1d9c9c302 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi2.png?w=1100&maxW=1099&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=5fdaed477238b0c60841ec43bd1d5e68 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi2.png?w=1650&maxW=1099&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=417604b5865656de9df42e3ae7b3a5ce 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/aezakmi2.png?w=2500&maxW=1099&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=0aa2f7b5691fd58cf9317b0fb11d6dec 2500w" data-optimize="true" data-opv="2" />
</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**:  33335

* **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 managing multiple accounts, scraping data, 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 Agno
Source: https://docs.brightdata.com/integrations/agno



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 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](https://docs.brightdata.com/general/account/api-token#generate-a-new-api-key-from-the-settings-page) 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
      pip install agno
      ```
    </Note>
  </Step>

  <Step title="Set the environment variable">
    Set your Bright Data API key as an environment variable:

    ```python
    import os


    os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"
    ```
  </Step>

  <Step title="Example usage">
    ```python
    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

Bright Data delivers an AI-ready web data infrastructure that powers your models and agents with real-time, high‑quality web access. Whether you’re feeding data into RAG pipelines, enabling agent-driven search, or harvesting structured data, Bright Data offers seamless compatibility with common AI/ML workflows using both pre-built integrations, flexible API options, and an MCP server.

## Supported Integrations

<CardGroup cols={3}>
  <Card title="Agno" href="/integrations/agno" cta="Learn more" icon="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/agno.png?maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=8163e3d46efec29839e3f2360a570eec" width="200" height="200" data-path="images/integrations/ai-integrations/agno.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/agno.png?w=280&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=86f387b7113450f5569e28bcd6128f66 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/agno.png?w=560&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=5a6fada7153ad429735df3a4a118b100 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/agno.png?w=840&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=8c74367887b54c96090be6db72227621 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/agno.png?w=1100&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=e0e9f9fed2d0d2d46f7ee4e16c9ed544 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/agno.png?w=1650&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=dcd7f708182260de8e07dc01037a0cbe 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/agno.png?w=2500&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f2a45f54cf0816b3b9085ca23dd71952 2500w" data-optimize="true" data-opv="2">
    Build memory-powered, multimodal AI agents with Agno
  </Card>

  <Card title="Crew AI" href="/integrations/crew-ai" cta="Learn more" icon="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/crew-ai.png?maxW=460&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=8766d76bda16a500446c3efbf301805f" width="460" height="460" data-path="images/integrations/ai-integrations/crew-ai.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/crew-ai.png?w=280&maxW=460&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=1299704cc29968f32fb103a26dae25a6 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/crew-ai.png?w=560&maxW=460&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=1f7f55ef101821bf5d126a25a22d9512 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/crew-ai.png?w=840&maxW=460&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=868e7c11184fd18f03123b6b5f75a2ab 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/crew-ai.png?w=1100&maxW=460&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=e0c181839a649c2f1adcf0b822ded1fa 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/crew-ai.png?w=1650&maxW=460&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=407083a8f00c3ecd63b9a196ac45a7fc 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/crew-ai.png?w=2500&maxW=460&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=34dc65fda2fda3190ed2e062e922a6c6 2500w" data-optimize="true" data-opv="2">
    Build and scale AI workflows with Crew AI.
  </Card>

  <Card title="Dify" href="/integrations/dify" cta="Learn more" icon="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/dify.png?maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c56e1550f400b30e1df623d89eb71154" width="1024" height="1024" data-path="images/integrations/ai-integrations/dify.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/dify.png?w=280&maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=6f71a746053ebc7b77cca7af3449663b 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/dify.png?w=560&maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=318e618eedc3d9aae988852d1cd51858 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/dify.png?w=840&maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=53d1ce75cc4f0f79c992718f9a7a43c7 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/dify.png?w=1100&maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c07d96c634a1dae81716050716b1fe4c 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/dify.png?w=1650&maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=3e7d25116b2f33ed1916ce7f681f9634 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/dify.png?w=2500&maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=8f3a73393a6207c691e2d5a318ab826b 2500w" data-optimize="true" data-opv="2">
    Access real-time web data in Dify with Bright Data
  </Card>

  <Card title="LangChain" href="/integrations/langchain" cta="Learn more" icon="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/langchain.png?maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=74e968638219af181786ba33287603f6" width="200" height="200" data-path="images/integrations/ai-integrations/langchain.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/langchain.png?w=280&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=9b2d9ca869a7087759f8cdc19924e80e 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/langchain.png?w=560&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=7f25112c09a62ca937da88c32f5a00cd 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/langchain.png?w=840&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f1c68b3230a8329be8d60bda86a45606 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/langchain.png?w=1100&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=93540676839629343f5b90bf51403c0c 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/langchain.png?w=1650&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=7e4a1953d4523b974938766a478d2408 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/langchain.png?w=2500&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a67f10c70c22f6a4675fa776a26a5627 2500w" data-optimize="true" data-opv="2">
    Connect LLMs with external data and agents using LangChain.
  </Card>

  <Card title="Lindy.ai" href="/integrations/lindy-ai" cta="Learn more" icon="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/lindy-ai.webp?maxW=256&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=df54252439245684cf0576d4e527096f" width="256" height="256" data-path="images/integrations/ai-integrations/lindy-ai.webp" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/lindy-ai.webp?w=280&maxW=256&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=e4e1626d2f878436c8edb9fb49a7efc0 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/lindy-ai.webp?w=560&maxW=256&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=955bed7dcc80a0d7318a7682f7bd76c0 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/lindy-ai.webp?w=840&maxW=256&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=81a2f8cabaead4b3c3ed9eea32925d54 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/lindy-ai.webp?w=1100&maxW=256&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=5ded35c6636e348e69ece6e23baab411 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/lindy-ai.webp?w=1650&maxW=256&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=06b706a7259747202a397ce4f23b9a61 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/lindy-ai.webp?w=2500&maxW=256&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f669c0a2ca9c6d929dfbb7c37352855d 2500w" data-optimize="true" data-opv="2">
    Enhance your AI applications with Lindy.ai's powerful features.
  </Card>

  <Card title="LlamaIndex" href="/integrations/llamaindex" cta="Learn more" icon="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/integrations/ai-integrations/llamaindex.png">
    Simplify data retrieval and management for LLMs with LlamaIndex.
  </Card>

  <Card title="make.com" href="/integrations/make" cta="Learn more" icon="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/make.com.png?maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=dda6d3f41a62044a1ca9f5d9c42e7e67" width="1024" height="1024" data-path="images/integrations/ai-integrations/make.com.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/make.com.png?w=280&maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=ee018d6492527088ef85c2f3e69cd82a 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/make.com.png?w=560&maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=92cc91a3d14677ee1b276e2079fc2a41 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/make.com.png?w=840&maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c336de60bb5e71b2d0710feaffe54582 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/make.com.png?w=1100&maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=01ea303f3e547f1a63997b7549ba0c06 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/make.com.png?w=1650&maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=2bdece3ef55fb19cc332ab87de64c9f0 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/make.com.png?w=2500&maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=d959d4f1d90a2260f0919285050c4987 2500w" data-optimize="true" data-opv="2">
    Automate workflows and connect apps with make.com.
  </Card>

  <Card title="n8n" href="/integrations/n8n" cta="Learn more" icon="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/n8n.png?maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=dd8bad2233d455aa6e841c0e99e33198" width="1024" height="1024" data-path="images/integrations/ai-integrations/n8n.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/n8n.png?w=280&maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=1c8d031403ce6995dcb747da1e003589 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/n8n.png?w=560&maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=67e3fa58f0e3092b61a20a0ed50ee303 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/n8n.png?w=840&maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=5ff0a97ab34a10d980a0494804c622a6 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/n8n.png?w=1100&maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=d35ac6503481092955d0729f5036ccf9 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/n8n.png?w=1650&maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=6627f29ac8c68114deccebccedff0549 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/n8n.png?w=2500&maxW=1024&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=fa3bcba459472be0b82020f1d28fa6da 2500w" data-optimize="true" data-opv="2">
    Create and automate workflows with n8n's powerful features.
  </Card>

  <Card title="Pica" href="/integrations/pica" cta="Learn more" icon="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/picaos.jpeg?maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=840d834c5681ececa69e2b1d57598e91" width="200" height="200" data-path="images/integrations/ai-integrations/picaos.jpeg" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/picaos.jpeg?w=280&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a6295185896e1ee569cea67a7060f718 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/picaos.jpeg?w=560&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=0aa98fabdd5ff6bec3e07b185b887e97 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/picaos.jpeg?w=840&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f7b9d125c6fe9766e94478e8369d6e71 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/picaos.jpeg?w=1100&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=0b40411677a3ea94a859e7d2ad9e0b2b 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/picaos.jpeg?w=1650&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=876e730e0a6e7538e93093430f6563c0 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/picaos.jpeg?w=2500&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=e159950953a1ee135d0adb25735a3e3c 2500w" data-optimize="true" data-opv="2">
    Build and scale AI workflows with Pica.
  </Card>

  <Card title="xpander.ai" href="/integrations/xpander-ai" cta="Learn more" icon="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/xpander-ai.jpeg?maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=d220062528aec2b1fc4d3bcb2befb704" width="200" height="200" data-path="images/integrations/ai-integrations/xpander-ai.jpeg" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/xpander-ai.jpeg?w=280&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=418abb581e6f7e1661ae0b4bcb89265e 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/xpander-ai.jpeg?w=560&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=4aa3bef60ad97baf853c3ba0880f4b15 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/xpander-ai.jpeg?w=840&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=cfa37cf75b8069ca1044e58bab82bfbd 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/xpander-ai.jpeg?w=1100&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=be4a028c8ad6f681fdf125774410f432 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/xpander-ai.jpeg?w=1650&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f004386b02d754b83601df236d23a717 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/ai-integrations/xpander-ai.jpeg?w=2500&maxW=200&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a44ce4ee624786ec6e5c098635d97e28 2500w" data-optimize="true" data-opv="2">
    Enhance your AI applications with xpander.ai's powerful features.
  </Card>
</CardGroup>

***

<Card title="MCP Clients" href="/mcp-server/integrations" cta="Explore MCP Clients" icon="server">
  <p>Connect to our MCP clients for seamless integration.</p>
</Card>


# How to Set Up a Bright Data on Android
Source: https://docs.brightdata.com/integrations/android

Get started with Bright Data on your Android device in no time! The process is straightforward, with only minor variations depending on your device.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 a proxy server on Android is simple and flexible. You can configure it for mobile data or Wi-Fi. Just choose your network type and follow these steps to get started!

## Configuring a Proxy for a Mobile Network

Step 1. **Access Network Settings**.\
Open **Settings**, then go to **Network & Internet** (or **Connections**, depending on your device).

Step 2. **Find APN Settings**.\
Tap **Mobile Networks** and select **Access Point Names (APNs)**.

<Frame as="div" style={{width:"50%", height:"auto"}}>
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android3.png?maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=2d03047bc61a86090486da361efe875c" alt="" width="300" height="525" data-path="images/integrations/android3.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android3.png?w=280&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=adfe432341ed9772d4954ae69540b449 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android3.png?w=560&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=56e4262df2623b9ce040abc67b124b5e 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android3.png?w=840&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8036da15ac3f2fa9ac0d722d45154766 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android3.png?w=1100&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=5a26c186a7244476cca191ad8426137c 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android3.png?w=1650&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c31e2b57d2b849c6265f766c69688170 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android3.png?w=2500&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d741c9936c56e730c2b0a686f5a350f9 2500w" data-optimize="true" data-opv="2" />
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android4.png?maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=09ba55dab05eb02352fece1cc58c3576" alt="" width="300" height="349" data-path="images/integrations/android4.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android4.png?w=280&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=fd1f0180285e5e61781f52ff263707f0 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android4.png?w=560&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=43c0f9aa4903108c73564d7071ac1281 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android4.png?w=840&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=99366e3c711668f83100f1dcb22dfb92 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android4.png?w=1100&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d27956ab0d5f43035d98704755c0dd73 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android4.png?w=1650&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=7667572b4ed8e458fd2e88ce507b0bf6 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android4.png?w=2500&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=6b4c900c045848236437957b09278f50 2500w" data-optimize="true" data-opv="2" />
</Frame>

Step 3. **Modify APN Details**.\
Choose your active APN and complete the following fields:

<Frame as="div" style={{width:"50%", height:"auto"}}>
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android5.png?maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=4f4d16e35e876e5c9bbcb0df04243f9a" alt="" width="300" height="156" data-path="images/integrations/android5.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android5.png?w=280&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c7f0f9c8bf1e86b5c8cd36a4e3c246bb 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android5.png?w=560&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=999c4054a36b20741001fb53c1cdc65c 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android5.png?w=840&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=b6a3268600c6ccf85850da63828f31c2 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android5.png?w=1100&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c722528da84440b83088b561c4fda0ba 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android5.png?w=1650&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d40fe59dedb4d34e35df32802c070716 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android5.png?w=2500&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=4fd90a837bc6e018dbdadf22b91e1bf8 2500w" data-optimize="true" data-opv="2" />
</Frame>

* **Proxy**: Input [`http://brd.superproxy.io/`.](http://brd.superproxy.io/.)

* **Port**: 33335

* **Username**: Enter your Bright Data proxy username.

* **Password**: Enter your Bright Data proxy password.

<Frame as="div" style={{width:"50%", height:"auto"}}>
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android6.png?maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=648d0d652ff3ea60866bcb8f449724f1" alt="" width="300" height="398" data-path="images/integrations/android6.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android6.png?w=280&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d42e85e2e7873dd783571d775c15e6fe 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android6.png?w=560&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=26d53da8cde4e77056f4eedf25f48ef3 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android6.png?w=840&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d3097f47f992670506e258f13be88720 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android6.png?w=1100&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=b330a986d618fb823c4fca235ffe9a8a 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android6.png?w=1650&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9b52c549686d1ce5f6939a8bb2b38191 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/android6.png?w=2500&maxW=300&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=3fe1c9a34e56b35452e3c55bdf995ec7 2500w" data-optimize="true" data-opv="2" />
</Frame>

Step 4. **Save and Reconnect**.\
Save your changes and refresh your mobile data connection by toggling it off and back on.

## Configuring a Proxy for a Wi-Fi Network

Step 1. **Access Network Settings**.\
Open **Settings**, then go to **Network & Internet (or Connections)** > **Wi-Fi**.

<Frame as="div" style={{width:"50%", height:"auto"}}>
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android1.png?maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=4b579d95b3ac79c69c7bc5ee20c572f4" alt="" width="300" height="534" data-path="images/integrations/android1.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android1.png?w=280&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=00a2c5fd1636a7431bce269df2c5435b 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android1.png?w=560&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=7f9485f110b5806f5077deb68443ec70 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android1.png?w=840&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=cc7b937a2e49f048e51d39440f7faf06 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android1.png?w=1100&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=9bb9780532f56a1eb6eff5ab7501632d 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android1.png?w=1650&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=aa89da33591f05d7e4987b17611d75ae 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android1.png?w=2500&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c5fb44fdb021c9bc480ef9505a3f39c3 2500w" data-optimize="true" data-opv="2" />
</Frame>

Step 2. **Select Your Wi-Fi Network**.\
Tap on your connected network and select the **Settings** (or **Edit**) icon.

<Frame as="div" style={{width:"50%", height:"auto"}}>
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android2.png?maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=7002b6f6e3ff36a260438d687008b549" alt="" width="300" height="210" data-path="images/integrations/android2.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android2.png?w=280&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=d319c747384e128f6ea9d33ce7aef6ee 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android2.png?w=560&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=4cdbc3bccc692cf84c105e45c0593502 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android2.png?w=840&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f02bf42b6713741eb64979561c7adf78 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android2.png?w=1100&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=3bab880a42990becee2d32c278a53747 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android2.png?w=1650&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=15c95e492992aff9e4789035054632b5 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/android2.png?w=2500&maxW=300&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=b368f1798cd372c4c9b54d41f8555b6b 2500w" data-optimize="true" data-opv="2" />
</Frame>

Step 3. **Enable Manual Proxy Configuration**.\
Scroll down to **Advanced options** and set the Proxy setting to **Manual**.

Step 4. **Modify Proxy Details**.\
Provide the following details:

* **Host**: Enter [`http://brd.superproxy.io/`.](http://brd.superproxy.io/.)

* **Port**: 33335

Tap **Save** to apply the configuration and ensure the changes take effect.

You’re ready to roll! With **Bright Data** configured on your Android device, enjoy private, secure, and hassle-free browsing—perfect for accessing blocked sites or staying safe online.


# How to Set Up Bright Data With Antik
Source: https://docs.brightdata.com/integrations/antik

Integrate Bright Data with Antik to enhance your online anonymity, streamline your tasks, and securely manage browser profiles. Follow this step-by-step guide to configure Bright Data with Antik for efficient and private browsing.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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 as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik1.png?maxW=1418&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=6a260647a83a2433b1a2b8c16ce3b7e4" alt="" width="1418" height="197" data-path="images/integrations/antik1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik1.png?w=280&maxW=1418&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e898e52e06fa94392c2d3d8ebe6516a4 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik1.png?w=560&maxW=1418&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=844c191576752d3592a403c073e5b9e8 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik1.png?w=840&maxW=1418&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=22a006cb62f481398ea3d50909f88b3f 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik1.png?w=1100&maxW=1418&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=7cddb706d8410e71e0f1fb0097083c4a 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik1.png?w=1650&maxW=1418&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=7f03cba50ed940aac49b016a7f97d220 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik1.png?w=2500&maxW=1418&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=329a98c5d19aa862083849fe7dd9e008 2500w" data-optimize="true" data-opv="2" />
</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 as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik2.png?maxW=951&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=31ce21ecd4ad690e10f4cecfd874871f" alt="" width="951" height="573" data-path="images/integrations/antik2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik2.png?w=280&maxW=951&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d5a00d2bc179f6f6d0d6e59680fa4c1e 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik2.png?w=560&maxW=951&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=33838ac9877d080f37ebed4f19aee66e 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik2.png?w=840&maxW=951&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=1bdb0ae3ce02d112abc650340378f482 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik2.png?w=1100&maxW=951&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=0601aa9190eaa37ac79b0ede9107ddd2 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik2.png?w=1650&maxW=951&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=76fb8b22f294059c2f3dfb7ee029b4b4 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik2.png?w=2500&maxW=951&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=b8d83b0bbab2da5848052193e62365d6 2500w" data-optimize="true" data-opv="2" />
</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 as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik3.png?maxW=1216&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=428ac035b6d5c5ac1ff8396666671db6" alt="" width="1216" height="244" data-path="images/integrations/antik3.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik3.png?w=280&maxW=1216&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f03c9079272cad045ae07089dff9a466 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik3.png?w=560&maxW=1216&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=2fab2360016db14ce2f42ece28a1cfe2 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik3.png?w=840&maxW=1216&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c6e4aa0c20e42cded00c79241e3dba91 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik3.png?w=1100&maxW=1216&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=847b57da1884ca4c39cc9f279f90df30 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik3.png?w=1650&maxW=1216&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=b082c61475ef1d1597524dbfba23785e 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/antik3.png?w=2500&maxW=1216&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=b19e85e424b88595b10bbd36be6d9ef3 2500w" data-optimize="true" data-opv="2" />
</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

Web scraping made seamless! Integrating Oculus Proxies with Apify ensures smoother, anonymous, and efficient scraping workflows, helping you bypass challenges like IP bans, geo-restrictions, and CAPTCHAs. Follow this guide to set up Oculus Proxies with Apify for enhanced performance and reliability.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify2.png?maxW=1485&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=cc8e557770d8c485a9d01c3ad0c948ae" alt="" width="1485" height="365" data-path="images/integrations/apify2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify2.png?w=280&maxW=1485&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=418b8df14022f463004762e359092f78 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify2.png?w=560&maxW=1485&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=17f40d3f770fabe2d74c82e47f59da68 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify2.png?w=840&maxW=1485&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8025128319a33a066445f7f8dbeed8a6 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify2.png?w=1100&maxW=1485&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ca5803dd1d1f83a8b0fdb8f6b1220a21 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify2.png?w=1650&maxW=1485&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=4b20468f6262f187d6a15d988a7c1628 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify2.png?w=2500&maxW=1485&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=aa4dae4576d635d38f2cb0694f7b858b 2500w" data-optimize="true" data-opv="2" />
</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 as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify3.png?maxW=858&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=1dbab9eb89a39f2fe5cf9cf1d3af3e0e" alt="" width="858" height="519" data-path="images/integrations/apify3.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify3.png?w=280&maxW=858&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=cccd2c60ff6827073dd63574e01241ff 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify3.png?w=560&maxW=858&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9ab7a00f038157d93117e3a81f443ebd 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify3.png?w=840&maxW=858&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=eaf136f6d87ca97905678d81e24f4ff3 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify3.png?w=1100&maxW=858&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f3b27fcf353eb02812feaa9e42635bb1 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify3.png?w=1650&maxW=858&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=34a15062efc05f319b1bbe33bab9b98d 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify3.png?w=2500&maxW=858&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=5deadcbffb13276b0de0ede6d85d34be 2500w" data-optimize="true" data-opv="2" />
</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
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 as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify4.png?maxW=833&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=089cf11a5f2011c2080a9cb28df5f46b" alt="" width="833" height="401" data-path="images/integrations/apify4.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify4.png?w=280&maxW=833&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=db5d337c66c0a274a169ff278ba7ebc7 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify4.png?w=560&maxW=833&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=1a531746bcdf6312fbb19e3dab87f7f8 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify4.png?w=840&maxW=833&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a53d9ecc38f0d6ab7247d723290709b5 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify4.png?w=1100&maxW=833&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=807946426bed1209d0a31376204df199 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify4.png?w=1650&maxW=833&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9d36e0db88b464aba4052d5f45ab1b52 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify4.png?w=2500&maxW=833&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=3b36b288becec1909e9d48c419d24b41 2500w" data-optimize="true" data-opv="2" />
</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 as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify5.png?maxW=828&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8fb602ea7af7830a7ea177fa7c2a7314" alt="" width="828" height="283" data-path="images/integrations/apify5.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify5.png?w=280&maxW=828&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=52146bfc1c4ad5894c2a2118f3f77203 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify5.png?w=560&maxW=828&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=333a0adc4645448aeb24b0821eeac10a 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify5.png?w=840&maxW=828&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=890f5be92f9df3a5d86a304df8cd815a 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify5.png?w=1100&maxW=828&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d3ccc77a72484b6ba3a6179c1f1c4891 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify5.png?w=1650&maxW=828&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=59ca41f71b5261b1890bb55e29f2717b 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/apify5.png?w=2500&maxW=828&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=2959f6953a843f9cfb9dc677065280c7 2500w" data-optimize="true" data-opv="2" />
</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

Enhance your web scraping workflows with Bright Data and BeautifulSoup. This guide walks you through integrating Bright Data proxies into your Python scripts to ensure secure, reliable, and anonymous data collection.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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
     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**: 33335

   * **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
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
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
{
  "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

Streamline your multi-profile browsing with Bright Data and BitBrowser. This guide walks you through integrating Bright Data proxies into BitBrowser to ensure secure, private, and efficient browsing across all your profiles.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</Tip>

## 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 as="div" style={{width:"50%", height:"auto"}}>
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser1.png?maxW=202&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=7dcfe67975660a2a687b533a6d5e6510" alt="" width="202" height="324" data-path="images/integrations/bitbrowser1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser1.png?w=280&maxW=202&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=22f703b83eaee870de5e85fd62072526 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser1.png?w=560&maxW=202&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=35c3b610a3e69b317483c90befffcd8d 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser1.png?w=840&maxW=202&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f55affdb22903bcc5c9769cd26f68d4c 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser1.png?w=1100&maxW=202&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=1b568b78c4fe42063520e9ad57a6cd24 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser1.png?w=1650&maxW=202&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8418b7ca8fe005f22a62d82ca14d9a1e 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser1.png?w=2500&maxW=202&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=935e515d99c679b2d89e253ff80c0386 2500w" data-optimize="true" data-opv="2" />
</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 as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser2.png?maxW=1263&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=0b3ed88527c088fdea83a8a213a921ad" alt="" width="1263" height="324" data-path="images/integrations/bitbrowser2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser2.png?w=280&maxW=1263&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=494d91add63529adc3be8e139236d45a 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser2.png?w=560&maxW=1263&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=eb1cd7dffe7330dc6c26abb1b74fccf0 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser2.png?w=840&maxW=1263&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a09f926ef605b43c0bc04361470bb85b 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser2.png?w=1100&maxW=1263&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=0999999528bc1104bbb8850e5ef6eba0 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser2.png?w=1650&maxW=1263&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=7bf79df109beb513e970213d08fefcfb 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser2.png?w=2500&maxW=1263&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=85b7a2d473e07a8ac7f448e8d4b83fc1 2500w" data-optimize="true" data-opv="2" />
</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**: 33335

* **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 as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser3.png?maxW=1259&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=112a1219819874b5fe4eb440955d75fc" alt="" width="1259" height="324" data-path="images/integrations/bitbrowser3.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser3.png?w=280&maxW=1259&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=4d57456c65cd2f47185666a0cc86c42b 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser3.png?w=560&maxW=1259&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=461a218279fb653f3d29f7039a8fab7f 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser3.png?w=840&maxW=1259&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=37b4b4fb656936f39729ef922d82b5f8 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser3.png?w=1100&maxW=1259&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=5f49f1a2cd700ae93cec958b4f040516 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser3.png?w=1650&maxW=1259&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=155574f41f30b1e5d597e3318f88fdc7 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/bitbrowser3.png?w=2500&maxW=1259&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e920dde2b117cad4305fdd5f09b7877a 2500w" data-optimize="true" data-opv="2" />
</Frame>

By integrating **Bright Data** proxies with **BitBrowser**, you’re equipped to manage multiple online identities securely and efficiently. Whether you’re handling social media accounts, e-commerce operations, or research tasks, Bright Data ensures stable, private, and geo-flexible browsing. Enjoy smooth workflows and enhanced anonymity with Bright Data on BitBrowser!


# How to Set Up Bright Data With Capsolver
Source: https://docs.brightdata.com/integrations/capsolver

Integrate Bright Data with Capsolver to enhance your CAPTCHA-solving workflows. Follow this guide to securely configure proxies for efficient and uninterrupted automation.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 designed to automate the process of bypassing CAPTCHA challenges. By integrating Bright Data, you can solve CAPTCHAs securely, maintain anonymity, and access region-specific content with ease.

## Why Use Bright Data With Capsolver?

* **Anonymity**: Protect your IP address during CAPTCHA-solving tasks.

* **Geo-Targeting**: Access location-specific CAPTCHA solutions using country-specific proxies.

* **Reliable Connections**: Ensure uninterrupted service for seamless workflows.

## How to Integrate Bright Data With Capsolver

**Step 1. Log In to Capsolver**

* Visit the [Capsolver website](https://www.capsolver.com/) and log in to your account.

**Step 2. Open Proxy Configuration**

1\. Open the **Capsolver Extension** and go to the **Settings** section.

2\. Locate the **Proxy** option and toggle it to *On* to enable proxy settings.

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/capsolver1.png?maxW=460&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=46babca6bdb5357f3c6590ad6ee47043" alt="" width="460" height="643" data-path="images/integrations/capsolver1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/capsolver1.png?w=280&maxW=460&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=185235b9f3defc8db0704b38ae8a9504 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/capsolver1.png?w=560&maxW=460&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d13ee89a82f36554ce1244a0aa132825 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/capsolver1.png?w=840&maxW=460&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=580ad44a8f1cd838e24e0107ffd96820 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/capsolver1.png?w=1100&maxW=460&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=761f0465505436ac86ef4ccc5c2470dd 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/capsolver1.png?w=1650&maxW=460&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9ad419aa8ac9e648d69167b38b0e0478 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/capsolver1.png?w=2500&maxW=460&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=0437468b76f929867d59ba21a337787b 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 3. Add Your Bright Data Details**

In the proxy configuration section, input your Bright Data credentials:

* **Host**: [`http://brd.superproxy.io/`](http://brd.superproxy.io/)

* **Port**: 33335

* **Username**: Enter your Bright Data username.

* **Password**: Enter your Bright Data password.

<Note>
  For country-specific proxies, format the username as `your-username-country-XX` (e.g., `your-username-country-US`) to select a specific location.
</Note>

Integrating Bright Data with Capsolver enables secure and efficient CAPTCHA-solving workflows. Whether tackling bulk CAPTCHAs or navigating geo-restricted tasks, Bright Data ensures a seamless experience. Set up your integration today for privacy and reliability in every step.


# How to Set Up Bright Data With ChangeDetection
Source: https://docs.brightdata.com/integrations/changedetection

Monitor websites securely and anonymously with ChangeDetection and Bright Data. By integrating Bright Data, you can track website updates while ensuring your activities remain private and undetectable.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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

Transform your browsing with proxies in Chrome! They’re perfect for safeguarding your privacy, accessing restricted sites, and juggling multiple accounts. In this guide, we’ll walk you through the setup and help you make the most of Chrome proxies.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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 as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome1.png?maxW=336&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e4d064e5ec0281faeea7683fc4133253" alt="" width="336" height="801" data-path="images/integrations/chrome1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome1.png?w=280&maxW=336&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=378890d0d4a2cb8fee0bd0958a8940a8 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome1.png?w=560&maxW=336&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=93f5ec7013ebf00b5b7cdd16b2e7c20b 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome1.png?w=840&maxW=336&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ebfb0c1eae66c0762ef52997835c2a7f 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome1.png?w=1100&maxW=336&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e613a61bed0fb11ec5206f136fd47fad 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome1.png?w=1650&maxW=336&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=2438bdc31ffea93e1df76ad193c92b7d 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome1.png?w=2500&maxW=336&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=b5d8b284a54e4124d4452c4cccac72a5 2500w" data-optimize="true" data-opv="2" />
</Frame>

### Step 2. **Open System Proxy Settings**.

Navigate to the **System** section and select **Open your computer’s proxy settings** to proceed.

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome2.png?maxW=1276&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=0c4992274e92d404332b8b96bb4f96ef" alt="" width="1276" height="724" data-path="images/integrations/chrome2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome2.png?w=280&maxW=1276&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8792b3601745b9e60f927c3bc49bfac8 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome2.png?w=560&maxW=1276&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=328c3323ac9a286b1317cf05a8e5870b 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome2.png?w=840&maxW=1276&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d6c9702a9d6488e2519a07d9f2fbabbe 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome2.png?w=1100&maxW=1276&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=13d4a606ff60a377f7b9c27938d32908 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome2.png?w=1650&maxW=1276&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=51c1c8f5cfa26922a72aca2b74522a5e 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/chrome2.png?w=2500&maxW=1276&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=78eb3ce4d361b7275f1c8b17817dca08 2500w" data-optimize="true" data-opv="2" />
</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.


# How to Integrate Bright Data With ClonBrowser
Source: https://docs.brightdata.com/integrations/clonbrowser

Secure your browsing and automation workflows with Bright Data on ClonBrowser. This guide will walk you through the setup process, ensuring private and seamless browsing.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</Tip>

## 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 as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser1.png?maxW=913&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=dcdc16a54ae5220899242bb46e88b48e" alt="" width="913" height="276" data-path="images/integrations/clonbrowser1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser1.png?w=280&maxW=913&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=116a6bd7432791eb3963d35c788bbbbf 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser1.png?w=560&maxW=913&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d32308f20b4f627badc2bbe25d8e4d04 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser1.png?w=840&maxW=913&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=0fcbf20cd5033fc12f8f9cc87534e343 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser1.png?w=1100&maxW=913&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=dcd90f08e9268f79ca63530f827d9682 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser1.png?w=1650&maxW=913&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=14fa400a721d098e7e9ff983ae25f4ff 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser1.png?w=2500&maxW=913&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=904adc8b09ec4152998db4a86f713eec 2500w" data-optimize="true" data-opv="2" />
</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 as="div">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser2.png?maxW=1892&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a74288d7814e5e1e70023ee3ab36fec0" alt="" width="1892" height="222" data-path="images/integrations/clonbrowser2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser2.png?w=280&maxW=1892&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=138dedc739579aa2d58b50e370857019 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser2.png?w=560&maxW=1892&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=90640b0c6e6ad524bf6bc301920a67cb 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser2.png?w=840&maxW=1892&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=896c5994e8b397ce57c5fb9d982ce37d 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser2.png?w=1100&maxW=1892&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=62d1b4fbf812b59d14f9b3ea9f7ed9ff 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser2.png?w=1650&maxW=1892&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=3cdcd35b52a2a1546bfafda13c281c7d 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/clonbrowser2.png?w=2500&maxW=1892&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=369a41b577f06dc9a4993bc47699eb46 2500w" data-optimize="true" data-opv="2" />
</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 Integrate Bright Data With CrewAI
Source: https://docs.brightdata.com/integrations/crew-ai

Integrate Bright Data with CrewAI for powerful web scraping, data extraction, and search capabilities.

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:

### BrightDataDatasetTool

Extract structured data from popular data feeds (Amazon, LinkedIn, Instagram, etc.) using pre-built datasets

### BrightDataSearchTool

Perform web searches across multiple search engines with geo-targeting and device simulation

### 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](https://docs.brightdata.com/general/account/api-token#generate-a-new-api-key-from-the-settings-page) 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
    pip install crewai[tools] aiohttp requests
    ```
  </Step>

  <Step title="Set the environment variable">
    Set your Bright Data API key as an environment variable:

    ```bash
    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
      # 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
      # 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
      # 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 enterprise-grade 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 DICloak
Source: https://docs.brightdata.com/integrations/dicloak



# 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 over 72 million IPs worldwide for seamless 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, account management, 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 src="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/download-dicloak.png?maxW=1880&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=a6b831b00668cc6efe75555adce19573" alt="download-dicloak" width="1880" height="863" data-path="images/integrations/dicloak/download-dicloak.png" srcset="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/download-dicloak.png?w=280&maxW=1880&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=f1b4c78883e2e5fda3b04cecc8b8b843 280w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/download-dicloak.png?w=560&maxW=1880&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=c2a4cb368cc965de268c73192ff90339 560w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/download-dicloak.png?w=840&maxW=1880&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=034ef79f10d41f73f39252036bf5891b 840w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/download-dicloak.png?w=1100&maxW=1880&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=a41a07c54239f8289ca46bad38e6c6c3 1100w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/download-dicloak.png?w=1650&maxW=1880&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=e6aa2147f1cfd8e758671df903f7ec7e 1650w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/download-dicloak.png?w=2500&maxW=1880&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=23da7415d185d134ec6ed68e9fc88d17 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    2. Install DICloak and launch the app.

    <Frame>
            <img src="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/launch-dicloak.png?maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=3d68a125b41093399c1a44786443d959" alt="launch-dicloak" width="1999" height="1250" data-path="images/integrations/dicloak/launch-dicloak.png" srcset="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/launch-dicloak.png?w=280&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=35d640f9c6eb56b92dc83c4d9a7d8cc6 280w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/launch-dicloak.png?w=560&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=57933b866e4f024e068dcd4e3a5a6193 560w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/launch-dicloak.png?w=840&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=a4328517580f339768bcb4f9c18170fc 840w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/launch-dicloak.png?w=1100&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=8e6eec9ec1199a937b9dd7a0afd2b6aa 1100w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/launch-dicloak.png?w=1650&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=6817061c8cdc5d72b789e4080d431c70 1650w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/launch-dicloak.png?w=2500&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=8449e5ee93331be94e63b681244901a5 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Create a New Profile">
    1. Click on the **+ Create Profile** button.

    <Frame>
            <img src="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/create-profile.png?maxW=1785&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=f37182cc9e48c95ef4ef860955fc03c3" alt="create-profile" width="1785" height="903" data-path="images/integrations/dicloak/create-profile.png" srcset="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/create-profile.png?w=280&maxW=1785&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=1e0f8a16d979bab627a2517e9fb0d693 280w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/create-profile.png?w=560&maxW=1785&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=97a7e4f7040730ed4431da03006bb539 560w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/create-profile.png?w=840&maxW=1785&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=347325eacf5004046b9140c7a6224882 840w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/create-profile.png?w=1100&maxW=1785&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=c4f8efcf7eb93586df89b9d05af05cb0 1100w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/create-profile.png?w=1650&maxW=1785&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=533017503bf45da3e2698946bb98892f 1650w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/create-profile.png?w=2500&maxW=1785&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=c195d8836f8dfe5f04237c48c807e15c 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    2. Set up the basic profile:

    * Enter a **Profile Name**.
    * Choose the browser and operating system.

    <Frame>
            <img src="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/setup-basic-profile.png?maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=2f352805e96962e50d8174e78650657e" alt="setup-basic-profile" width="1999" height="1250" data-path="images/integrations/dicloak/setup-basic-profile.png" srcset="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/setup-basic-profile.png?w=280&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=4d1ac18dd07fbff4c76a853ecd25297c 280w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/setup-basic-profile.png?w=560&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=5d787e2e742e46dd5e540152a273597a 560w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/setup-basic-profile.png?w=840&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=72cbdb98575da48731fa1018003c4d2f 840w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/setup-basic-profile.png?w=1100&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=80efcc2b445053efc61ca4541a6b7e23 1100w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/setup-basic-profile.png?w=1650&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=d0369e0fad8de49032421425c86b2566 1650w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/setup-basic-profile.png?w=2500&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=773cf5faad072bd5d13d903e29dc769f 2500w" data-optimize="true" data-opv="2" />
    </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 src="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-config.png?maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=a1b2c1f0a06ab2f2b4fcf48f50269bc8" alt="proxy-config" width="1999" height="1250" data-path="images/integrations/dicloak/proxy-config.png" srcset="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-config.png?w=280&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=f11e3c3f2956616c340c21b15f1f0ae9 280w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-config.png?w=560&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=b4549a9d221d4b621d02fde0815baaea 560w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-config.png?w=840&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=577db463a0427a784ba7e6e87c502892 840w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-config.png?w=1100&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=1522af45cb3d6bad1d26ae5c95f026d1 1100w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-config.png?w=1650&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=312588a54103b6cb8c9804b7a108b2d2 1650w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-config.png?w=2500&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=cd9c661fb03e48b107aa91f4d760734d 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    2. Enter the following details:

       * **Host:** `brd.superproxy.io`
       * **Port:** `33335`
       * **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 src="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-connection.png?maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=d93e529544f13caf2235aeba568f979e" alt="proxy-connection" width="1999" height="1250" data-path="images/integrations/dicloak/proxy-connection.png" srcset="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-connection.png?w=280&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=d379d90e73381f4184e08b6399b56139 280w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-connection.png?w=560&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=ec4c3f2204277721cc410dcf6e7c243a 560w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-connection.png?w=840&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=56ba90a3fed690099df5abd94fbc10c9 840w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-connection.png?w=1100&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=a974ce079a53d8e4ef99163fcc0298bd 1100w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-connection.png?w=1650&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=d3d1427c9675272d4202ab333c8db458 1650w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-connection.png?w=2500&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=50f40a4a1340ea3b24de2dfcc9f652b9 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Test your Proxy">
    1. Click on the **Check Proxy** button to test the connection.

    <Frame>
            <img src="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/check-proxy.png?maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=6ea6d266a61c101dc2a232e250b33d37" alt="check-proxy" width="1999" height="1250" data-path="images/integrations/dicloak/check-proxy.png" srcset="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/check-proxy.png?w=280&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=0e1b25d553e20037f3255b88a689d92f 280w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/check-proxy.png?w=560&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=994aed33a39946b6fe7044fb0dd1d06f 560w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/check-proxy.png?w=840&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=02ba4de3935c78c73beafacc7882d5b3 840w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/check-proxy.png?w=1100&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=c0f405de745bbbe2354585da190d6396 1100w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/check-proxy.png?w=1650&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=7808b1ba5b1feb7f643d5202dbc15d8e 1650w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/check-proxy.png?w=2500&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=8584dbd6c07b13ae938fc76477bca008 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    2. Ensure the connection test is successful and confirm the settings.

    <Frame>
            <img src="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-test-success.png?maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=744ea4252359b26b6833605746a23e88" alt="proxy-test-success" width="1999" height="1250" data-path="images/integrations/dicloak/proxy-test-success.png" srcset="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-test-success.png?w=280&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=1c3e135ea4f8f319acfbf6141880d1f0 280w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-test-success.png?w=560&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=9c07dc3d68d5623618e3ea0434eda42e 560w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-test-success.png?w=840&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=418a117c71dd341bf3dfe7dd305dea3f 840w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-test-success.png?w=1100&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=eed0323bc9b29396ad6d9a82e830b729 1100w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-test-success.png?w=1650&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=e64e53424ec75e87126748fdee2a4e96 1650w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/proxy-test-success.png?w=2500&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=44e7c6ff09fb0530892b59f3a599c14c 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Start Browsing">
    1. To use the proxy, click on the **Open** button.

    <Frame>
            <img src="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/open-browser.png?maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=9dee50e27be63bc7d539e5b37a1334e6" alt="open-browser" width="1999" height="1250" data-path="images/integrations/dicloak/open-browser.png" srcset="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/open-browser.png?w=280&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=fbb7e632bbef4d59882fde02bde1b69d 280w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/open-browser.png?w=560&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=ba0c385c00d649b4498864d888bc56a5 560w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/open-browser.png?w=840&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=3df67ef5d06d729f10b437f1cded0d86 840w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/open-browser.png?w=1100&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=1312d908ec87552c06cae2a2f78f2cd3 1100w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/open-browser.png?w=1650&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=9af1c825469d6585d84c1950bbe2b889 1650w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/open-browser.png?w=2500&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=b72fe309660b21b9ac870383ff41c400 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    2. A browser will open with your preferred settings and the configured proxy.

    <Frame>
            <img src="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/browser-open.png?maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=f7d7133d361196dcdc11ccd137f6d0f6" alt="browser-open" width="1999" height="1250" data-path="images/integrations/dicloak/browser-open.png" srcset="https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/browser-open.png?w=280&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=513ce26984f66bcd0dffc00240025f3b 280w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/browser-open.png?w=560&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=6974aa3d1e825c1dd846f0cce3ea2465 560w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/browser-open.png?w=840&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=34ace9017224f5acc2c1fac1fda0ba7c 840w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/browser-open.png?w=1100&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=7fa51fba67b56acfadb205c34c67005a 1100w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/browser-open.png?w=1650&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=440b28751e38517ce7e1375f30c74b6b 1650w, https://mintcdn.com/brightdata/Wl7FaVrr89gzDnYW/images/integrations/dicloak/browser-open.png?w=2500&maxW=1999&auto=format&n=Wl7FaVrr89gzDnYW&q=85&s=35392b00650af0b0bfadbe3ea6ddbfc6 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>
</Steps>

***

## Additional Tips

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


# How to Set Up Bright Data With Dify
Source: https://docs.brightdata.com/integrations/dify



A comprehensive web scraping and data extraction plugin powered by Bright Data's enterprise-grade infrastructure with intelligent auto-detection. Supports 50+ platforms including Amazon, LinkedIn, Instagram, YouTube, and more.

<Frame>
  ![image](https://github.com/user-attachments/assets/5825d274-d47b-4fed-950f-65e6b7c63e58)
</Frame>

<Note>
  For the most up-to-date updates, please refer to this [Repository](https://github.com/brightdata/brightdata-dify-plugin/blob/main/BrightData/brightdata-dify-plugin/README.md)
</Note>

## Available Tools

### 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 & Reviews**: Google Maps, booking sites
* **News**: Reuters and other news sources

### Scrape As Markdown

Convert any webpage into clean, readable markdown format perfect for:

* Content analysis
* Documentation extraction
* Article processing

### Search Engine

Get search results from major search engines:

* Google
* Bing
* Yandex, etc.

## 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

## How to Integrate Bright Data With Dify

<Steps>
  <Step title="Install the plugin">
    Install Bright Data Plugin from [Dify Marketplace](https://marketplace.dify.ai/plugins/idanvilenski/brightdata)
  </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](https://docs.brightdata.com/api-reference/authentication#api-key) if you haven't already done so.
  </Step>

  <Step title="Create Your First Workflow">
    1. Go to **Dify Studio** → **Workflow**
    2. Add one of the **Bright Data Web Scraper** tools:

    * **Structured Data Feeds** - Extract structured data from 20+ platforms
    * **Scrape As Markdown** - Convert any webpage to clean markdown
    * **Search Engine** - Get search results from Google, Bing, Yandex

    3. Enter your Bright Data API key when prompted
    4. You can connect an **LLM node** to process and summarize the scraped data
  </Step>

  <Step title="Example Workflow">
    <Tip>
      see workflow in banner image
    </Tip>

    **Sample Use Case**: Extract Amazon product information and create a summary

    1. **START** → Input: **Product** URL
    2. **STRUCTURED DATA FEEDS** → Extract product details
    3. **LLM** → Summarize into easy-to-read text
    4. **END** → Output: Clean product summary

    <Note>
      ### Important tips

      * Reference every stage of the workflow to the output of the previous stage
      * Set a high character limit in input fields (for the URL input field choose the "short paragraph" var option)
    </Note>
  </Step>
</Steps>

### Advanced Option: Use Bright Data MCP

While the Bright Data plugin for Dify uses hosted APIs, advanced users can also integrate directly with [**Bright Data MCP (Model Context Protocol)**](https://docs.brightdata.com/mcp-server/overview#configuration) — a local server that exposes Bright Data’s full scraping and automation toolset via HTTP.

You can call MCP tools from Dify using custom HTTP requests or external service nodes to unlock advanced capabilities like browser automation, structured data extraction, 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 Dolphin Anty
Source: https://docs.brightdata.com/integrations/dolphin-anty

Enhance your web scraping and multi-account management with Dolphin Anty and Bright Data proxies. Enjoy secure, efficient data extraction and powerful anti-detection features.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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, social media managers, and e-commerce professionals who need to manage multiple accounts without being flagged. It creates unique digital fingerprints for each profile—like IP addresses and device types—so platforms can’t link multiple accounts to the same user. With Dolphin Anty, you can securely run social media campaigns, manage affiliate marketing, and handle e-commerce tasks—all without worrying about account bans.

<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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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.


# How to Set Up Bright Data With Easync
Source: https://docs.brightdata.com/integrations/easync

Enhance your automation workflows with Bright Data on Easync. Follow this guide to configure Bright Data for seamless and secure operations.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 designed for e-commerce businesses. It helps users streamline order fulfillment, inventory updates, and price tracking across multiple platforms. By integrating **Bright Data**, you can enhance Easync’s performance by maintaining anonymity, accessing region-specific data, and reducing the risk of IP bans.

## How to Integrate Bright Data With Easync

### **Step 1. Log In to Easync**

To enable Bright Data with Easync, you first need to configure them on your operating system. Follow the appropriate guide below based on your OS:

* [How to Set Up Bright Data on Windows](https://docs.brightdata.com/integrations/windows)
* [How to Set Up Bright Data on macOS](https://docs.brightdata.com/integrations/macos)

Once completed, your system will be ready to route traffic through Bright Data.

### **Step 2. Open Proxy Configuration**

1\. Visit the [Easync website](https://easync.io/) and log in to your account.\
2\. Easync automatically detects and uses the proxy settings configured on your operating system.\
3\. Test the integration by performing a simple action in Easync, such as:

* Fetching product details.
* Placing a test order.

This ensures that your tasks are being routed securely through Bright Data.

### **Step 3. Verify and Monitor the Setup**

1\. Open a browser or use a service like [httpbin.org/ip](http://httpbin.org/ip) to verify your proxy IP is active.
2\. In Easync, monitor the performance to confirm that your proxies are functioning as expected during tasks.

With Bright Data integrated into Easync, you can confidently automate tasks, ensuring secure and efficient operations. Whether you're processing orders or analyzing data, your connections are protected and optimized for performance.


# How to Configure Proxy Settings in Firefox
Source: https://docs.brightdata.com/integrations/firefox

Take charge of your online experience! Setting up a proxy in Firefox gives you a secure shield for your browsing—ideal for boosting privacy, bypassing limits, or handling multiple accounts with ease. Follow this guide to set up proxies and unleash the full power of Firefox.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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)

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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 src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox1.png?maxW=414&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=26976e24585c72939bbf91d7ea1133a5" alt="" width="414" height="954" data-path="images/integrations/firefox1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox1.png?w=280&maxW=414&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=4192fd43881bc4590318a69540393760 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox1.png?w=560&maxW=414&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=96e29a98d3d000392812d22ff6517047 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox1.png?w=840&maxW=414&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c4ab4e5d2e2d1d7bfc3be442e83b9093 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox1.png?w=1100&maxW=414&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=1fb7023fbf49075ebe9c9613c1dfbc00 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox1.png?w=1650&maxW=414&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=377dd701b9d9a1d9a53da38351f012ea 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox1.png?w=2500&maxW=414&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=047db2e2df13603355a805862f3872fa 2500w" data-optimize="true" data-opv="2" />
    </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 src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox2.png?maxW=1571&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ab5318ca9efa623f9a3e290f391d519c" alt="" width="1571" height="867" data-path="images/integrations/firefox2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox2.png?w=280&maxW=1571&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e65ecd9373726bbe210c86f604fc0f66 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox2.png?w=560&maxW=1571&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=3f7a99dce9ad0c0195d721dab8e6e3e7 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox2.png?w=840&maxW=1571&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=3c63b00f2158a58b1114d298784cf8d1 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox2.png?w=1100&maxW=1571&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=72e2a77a60830eadc45e50f27c8f77a1 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox2.png?w=1650&maxW=1571&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f68eccf83287a353b1da1d969a8ebaba 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/firefox2.png?w=2500&maxW=1571&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=70ae4e7bc99541de6845c5d0203fe1eb 2500w" data-optimize="true" data-opv="2" />
    </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

Effortlessly enhance your browsing with FoxyProxy! By integrating Bright Data, you can securely manage and switch between proxy servers for smooth and efficient web scraping, secure browsing, and application testing. Use this guide to set up Bright Data with FoxyProxy and streamline your online operations.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy1.png?maxW=317&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=dfcce6a0df97e27236c11a5ecdabf062" alt="" width="317" height="402" data-path="images/integrations/foxyproxy1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy1.png?w=280&maxW=317&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=280cc0bcfd12f960edf5f1a821422732 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy1.png?w=560&maxW=317&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=93f28e373dad9ffa406b3cd3f0ee1e4b 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy1.png?w=840&maxW=317&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9fd3f14756f2e0283a5ca2d01cbe8bdd 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy1.png?w=1100&maxW=317&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=1ac2e09e441c359fa46731f5eeadeb9a 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy1.png?w=1650&maxW=317&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=6109e87c5377620574f2c786ea005e68 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy1.png?w=2500&maxW=317&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=88ce4a85a661fa5bb78fe2da0a8a900b 2500w" data-optimize="true" data-opv="2" />
    </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 src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy2.png?maxW=1243&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=dd30eacea344c27deec2be417f01c8bb" alt="" width="1243" height="218" data-path="images/integrations/foxyproxy2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy2.png?w=280&maxW=1243&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=404b7dd7698082b7955989650dd8933c 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy2.png?w=560&maxW=1243&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=327aa9170982b35641b2fd3fd5752e7f 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy2.png?w=840&maxW=1243&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=fbf378f794d9d294f1df7d5aee11c507 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy2.png?w=1100&maxW=1243&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=fdca569d91f7d8f8625bb0e1a90ce4a9 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy2.png?w=1650&maxW=1243&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d79abd8c77095436ba62dc98656a8e28 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy2.png?w=2500&maxW=1243&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9e9681ac142d5eb2ad969e5ed3db1043 2500w" data-optimize="true" data-opv="2" />
    </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 src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy3.png?maxW=314&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=740220c85ff6cf69281e002d5f7a8c86" alt="" width="314" height="405" data-path="images/integrations/foxyproxy3.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy3.png?w=280&maxW=314&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=929eaddf4928c34e03e591802e054007 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy3.png?w=560&maxW=314&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c715100fb62aa1ec5e7e60ffbbbe2999 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy3.png?w=840&maxW=314&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=af011b198e6e8318428c19f5f71558bf 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy3.png?w=1100&maxW=314&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f56e8e408aad33bd2577c5168fa8d503 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy3.png?w=1650&maxW=314&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=733dff03150965bc21464edfe55cb1bf 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/foxyproxy3.png?w=2500&maxW=314&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=61678235b73b76d6e1348aff0b647185 2500w" data-optimize="true" data-opv="2" />
    </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 with Geelark to maximize your privacy and efficiency. This guide walks you through configuring Bright Data proxies for secure and anonymous browsing using Geelark.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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 accounts, and customize browsing profiles 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 as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark1.png?maxW=761&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=fe13042b382c7dc07b6c18789749a00f" alt="" width="761" height="239" data-path="images/integrations/geelark1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark1.png?w=280&maxW=761&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=82b87bbf184ae0a5156578c83d33f2f8 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark1.png?w=560&maxW=761&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a25532494bb89fb12e0ff314672b304d 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark1.png?w=840&maxW=761&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=4f16cc763c47a140f69dbe26f554dd7c 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark1.png?w=1100&maxW=761&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=2dcbe8876f74f0f8644c764350cf8861 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark1.png?w=1650&maxW=761&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=bafb9e78255dcca16faa50a2c705cd90 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark1.png?w=2500&maxW=761&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=3574bad9cf6095cad11d3fa05f3f144a 2500w" data-optimize="true" data-opv="2" />
    </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 as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark2.png?maxW=1198&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c4f9df13be920994f0aa5a0a9dc7ee1b" alt="" width="1198" height="241" data-path="images/integrations/geelark2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark2.png?w=280&maxW=1198&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a54ead932411bd6706922186f0f0b5ab 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark2.png?w=560&maxW=1198&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=96917a94a49e871c10c310ff061abcd3 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark2.png?w=840&maxW=1198&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=77c8a2331b88c26c33809d9b16bd7d3e 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark2.png?w=1100&maxW=1198&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=80dee206f2526964cf08728272ec8a78 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark2.png?w=1650&maxW=1198&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=910006d55a3247712b9d3c804f834d08 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/geelark2.png?w=2500&maxW=1198&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9a4b7c936c46c69592d776abbd78f3e5 2500w" data-optimize="true" data-opv="2" />
    </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

Securely manage multiple browser profiles with Bright Data and GenLogin. This guide will walk you through the steps to integrate Bright Data with GenLogin for anonymous and efficient browsing.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</Tip>

**GenLogin** is an advanced browser profile management tool designed for professionals handling multiple accounts 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 as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin1.png?maxW=1319&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=49b29d553377feef4f19b35aec0600f4" alt="" width="1319" height="285" data-path="images/integrations/genlogin1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin1.png?w=280&maxW=1319&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8694e3a48f79738b387ba10824aaaff9 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin1.png?w=560&maxW=1319&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=3072aa74f4c4c2d689577f429255d0d5 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin1.png?w=840&maxW=1319&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=900af6349beb259a91e499ee5b01216f 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin1.png?w=1100&maxW=1319&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=804635ad6ff50e48f2ecc39a516293cb 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin1.png?w=1650&maxW=1319&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=62ce3c1b5dbb881f0d01851aa10587e3 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin1.png?w=2500&maxW=1319&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8296669b34c96d616c44e229367539d3 2500w" data-optimize="true" data-opv="2" />
    </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 as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin2.png?maxW=1900&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8745257ec0e2f52e2168f6626eb9eaf1" alt="" width="1900" height="307" data-path="images/integrations/genlogin2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin2.png?w=280&maxW=1900&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=4e09d04673218a3974035a22eb63a2a4 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin2.png?w=560&maxW=1900&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f3afe32c51cec5f3f30c711187c02c8a 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin2.png?w=840&maxW=1900&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d06087845cc27f9884a38073a75b5336 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin2.png?w=1100&maxW=1900&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=34eefbb26f5577fa43bf82111e0f9538 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin2.png?w=1650&maxW=1900&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ed663b439faee0b8289451344a5fc474 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/genlogin2.png?w=2500&maxW=1900&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=505b022a2ba95fe961c8614624c3a270 2500w" data-optimize="true" data-opv="2" />
    </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!


# How to Set Up Bright Data With Ghost Browser
Source: https://docs.brightdata.com/integrations/ghost-browser

Streamline multi-account management with Bright Data and Ghost Browser, ensuring secure and anonymous browsing while boosting your productivity.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</Tip>

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 as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser1.png?maxW=525&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=7a6c3b1fa27990a81662b047375facfe" alt="" width="525" height="246" data-path="images/integrations/ghostbrowser1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser1.png?w=280&maxW=525&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=fe5bd9e4b21c23075cc96c2038183768 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser1.png?w=560&maxW=525&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9642c1053d876a4eb11439ee89c0978d 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser1.png?w=840&maxW=525&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=488cf52c621f832afcab89c34122ed86 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser1.png?w=1100&maxW=525&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=cc5c00ec580e67066a5872e4f6c8c01f 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser1.png?w=1650&maxW=525&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f996f393994d669bd12430b8afa9a491 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser1.png?w=2500&maxW=525&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c8ec24da9d719fd9dc11e62357566c78 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Add a New Proxy">
    In the **Proxy Manager**, select the option to **Add a Single Proxy**.

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser2.png?maxW=970&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=dcac3b9f100ee07833fde3c6a0e0464b" alt="" width="970" height="413" data-path="images/integrations/ghostbrowser2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser2.png?w=280&maxW=970&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9854d2b1e4a2f5095e586b5d36d52218 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser2.png?w=560&maxW=970&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e8f32a4f299f24e9229da434e12e9cbb 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser2.png?w=840&maxW=970&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=388450a166b2110aef8b339e14dd460f 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser2.png?w=1100&maxW=970&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=bd2885ae887a13f55c29912e724ef44e 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser2.png?w=1650&maxW=970&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d37db68bd7334fd4191402f6f8f387d0 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/ghostbrowser2.png?w=2500&maxW=970&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d755b250861ab011fc9dfdddbb7c4aa1 2500w" data-optimize="true" data-opv="2" />
    </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

Boost your web scraping and multi-account management with GoLogin and Bright Data, offering robust anti-detection and flexible proxy control.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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, e-commerce businesses, and anyone managing several accounts on platforms that track user behavior.

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 keeping accounts safe, 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 as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin1.png?maxW=1164&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e213c3dcf3bb5b2d021e410b442c8a74" alt="" width="1164" height="126" data-path="images/integrations/gologin1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin1.png?w=280&maxW=1164&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ebef2a93e4e67bbdbab98463e68c28f4 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin1.png?w=560&maxW=1164&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=547736416946f365f360523fd4cfbc8d 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin1.png?w=840&maxW=1164&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=44ade8b10be352c95707fe6766bbcea5 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin1.png?w=1100&maxW=1164&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a5d70e7e915942b1e68d5c5dd20eddef 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin1.png?w=1650&maxW=1164&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a63596d2255d54c2a85734a58e4482da 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin1.png?w=2500&maxW=1164&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=db9059cb180eb7ca6c3f9ba851d04bfa 2500w" data-optimize="true" data-opv="2" />
    </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 as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin2.png?maxW=687&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c49c80a133b4641a0ef22a9c4be75471" alt="" width="687" height="633" data-path="images/integrations/gologin2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin2.png?w=280&maxW=687&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=0707e891ff2490b1518cfc32d651b49e 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin2.png?w=560&maxW=687&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e45593f2d45de0643d048a329606d670 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin2.png?w=840&maxW=687&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=831afc4dc2fac360b5a4e4483b1ebce4 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin2.png?w=1100&maxW=687&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=03c5e75e6ef525a27d990ca869300bc9 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin2.png?w=1650&maxW=687&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=5e965f84aaf69f9ceff597b749afdb4e 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin2.png?w=2500&maxW=687&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ec965940644bb8bcf64baa1fd43f1aae 2500w" data-optimize="true" data-opv="2" />
    </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 as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin3.png?maxW=640&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=7c9305a1bdeae2564f8862e456dab4d3" alt="" width="640" height="109" data-path="images/integrations/gologin3.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin3.png?w=280&maxW=640&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9e24757185d1c705bbac15992ab9315a 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin3.png?w=560&maxW=640&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=5086cd7463d9994ed7048925507195d1 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin3.png?w=840&maxW=640&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=4ec10c2b95cef5a60f44af52cb0c1aa4 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin3.png?w=1100&maxW=640&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=b44dc47f60443fca7bfbd7f6bf4af57f 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin3.png?w=1650&maxW=640&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c4f27c6bfcb19e65e3e9118c1e5c06a3 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/gologin3.png?w=2500&maxW=640&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ae5b8b15f7d4515fd991afb70b9efc7e 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>
</Steps>

**And that's it!** You've now successfully integrated Bright Data proxies with GoLogin.


# How to Set Up Bright Data With Helium Scraper
Source: https://docs.brightdata.com/integrations/helium-scraper

Integrate Bright Data with Helium Scraper for secure, efficient, and anonymous web scraping with flexible proxy management.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 the tool 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 as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper1.png?maxW=200&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a2fb6264e20bc89d80909231bad028f1" alt="" width="200" height="248" data-path="images/integrations/helium-scraper1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper1.png?w=280&maxW=200&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=4c8fcdac736164d2fc506a7dfd85e38e 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper1.png?w=560&maxW=200&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=2c2a83686e9c2bdba35ae268fbefd55d 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper1.png?w=840&maxW=200&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=2779f0da6ae9910bf999559b78c9cfed 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper1.png?w=1100&maxW=200&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=5c3de4bb2ae4359acc086258aa820d87 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper1.png?w=1650&maxW=200&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=6fbcaab8a2ec5cb273d4507985c66833 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper1.png?w=2500&maxW=200&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ff5b465dde2a35e41c6012a48e51c22b 2500w" data-optimize="true" data-opv="2" />
    </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 as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper2.png?maxW=199&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=206ce4bfb680299ed536f03b4e274b24" alt="" width="199" height="104" data-path="images/integrations/helium-scraper2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper2.png?w=280&maxW=199&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=48c5098adb48197aa4bca1b7137e7e63 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper2.png?w=560&maxW=199&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=6096763690a7fbcaffa9958a812c05e4 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper2.png?w=840&maxW=199&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=052a94e8b16fdb0becb6bd823be8d58e 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper2.png?w=1100&maxW=199&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=6e79f96c682976dda59bc4a6d3ccce1a 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper2.png?w=1650&maxW=199&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=0fc2b2a4bb1ff70952990069ae1d5946 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper2.png?w=2500&maxW=199&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=31124a59d3e22793124c9db47250138a 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    2. In the settings window, set **Enable Proxies** to **True**.

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper3.png?maxW=350&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=3bb8b9f6671d9e98d7b94da51f9cd006" alt="" width="350" height="554" data-path="images/integrations/helium-scraper3.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper3.png?w=280&maxW=350&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=94a8f4a656cf55c6386683d41d3cbc32 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper3.png?w=560&maxW=350&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=2b0b50fbe2f8ea456c4c85a02388627a 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper3.png?w=840&maxW=350&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=21efb8fcebadfc60db402de9f0765ab5 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper3.png?w=1100&maxW=350&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f94df6360378f151482b42a9e835fb43 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper3.png?w=1650&maxW=350&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ba9341ad2796d819027a488536316cc9 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/helium-scraper3.png?w=2500&maxW=350&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=808cbb0360404516a18b7e24ae8ba74d 2500w" data-optimize="true" data-opv="2" />
    </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.


# How to Integrate Bright Data With HideMyAcc
Source: https://docs.brightdata.com/integrations/hidemyacc

Secure and streamline your browsing with Bright Data and HideMyAcc. This guide walks you through configuring Bright Data within HideMyAcc for private, reliable, and efficient account management.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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 as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc1.png?maxW=1349&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a5d0e3df251cf74693d1740b002097c4" alt="" width="1349" height="535" data-path="images/integrations/hidemyacc1.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc1.png?w=280&maxW=1349&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8adba7e2e9abf25baa997016274e080a 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc1.png?w=560&maxW=1349&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=2d5bde79d79b8a85b599bc2efcde60c3 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc1.png?w=840&maxW=1349&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=8263c682e178e2888c3737e7a76dd878 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc1.png?w=1100&maxW=1349&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=20f451b78afeb9cd26ccdc682b72e987 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc1.png?w=1650&maxW=1349&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=cf507686d2b5e2647450e9571eb9f74e 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc1.png?w=2500&maxW=1349&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=fd3bab82d8c5807ab4e2b69157a45f95 2500w" data-optimize="true" data-opv="2" />
    </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 as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc2.png?maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d26b1eb7167b7a5bf6ec1f35a0abf2bc" alt="" width="1331" height="254" data-path="images/integrations/hidemyacc2.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc2.png?w=280&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e5ab4e624a7a47203c6ceb1dc4ddf921 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc2.png?w=560&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d1db0609edf24322ee73dbf0d9cb2be5 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc2.png?w=840&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=287bcd5cfa6716da6048c4f9acc6a4c5 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc2.png?w=1100&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=7ed73d00f9efd143cd48b158b01cad16 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc2.png?w=1650&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e7940dd3b34f2810a52e9083d85d830b 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc2.png?w=2500&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=706a050f357e396629df9add60d83a54 2500w" data-optimize="true" data-opv="2" />
    </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 as="div">
            <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc3.png?maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=5b407cd4b5f76df00b1368d35e022186" alt="" width="1331" height="135" data-path="images/integrations/hidemyacc3.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc3.png?w=280&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=0cadb6b52888b57a45cce80f09a995eb 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc3.png?w=560&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=28ca1c95e2ba786cf9071c364de76012 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc3.png?w=840&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=785ddc9f888b2c8164f381acafb5d2a7 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc3.png?w=1100&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=00340e83b51eab6bc1570236202e4864 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc3.png?w=1650&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=aec8562e8086aa2fcfc921cef6b2c2a3 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/hidemyacc3.png?w=2500&maxW=1331&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=825359e63287aa7ec891342689f8c6a5 2500w" data-optimize="true" data-opv="2" />
    </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 seamless multi-account management, offering secure and anonymous browsing with enhanced protection against detection and bans.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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 businesses who need to manage multiple accounts on platforms like social media or e-commerce sites without raising any red flags. It’s also great for web scraping and testing, mimicking human browsing behavior while keeping your activities secure and private.

## 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

Using Bright Data proxies with Insomniac boosts your automation efforts by providing secure, anonymous connections, reducing the risk of detection and ensuring smoother operations.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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)

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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 managing social media accounts, 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 src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_1.png?maxW=1615&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=9f320346621afa7c9d6ffba484ff353c" alt="Insomniac_setup_1.png" width="1615" height="651" data-path="images/integrations/Insomniac_setup_1.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_1.png?w=280&maxW=1615&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=0f892699cfd125cf9fe95026efbedaea 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_1.png?w=560&maxW=1615&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=9da43804799c7014ea83cd91224e3f9b 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_1.png?w=840&maxW=1615&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=ccb48fa2e24ca7498d1c34374bdcd0fc 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_1.png?w=1100&maxW=1615&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a76e8f9e6539e3d9a82db9b3bfe419b9 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_1.png?w=1650&maxW=1615&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c69db330b4f892b8ec98bb9cf800bac6 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_1.png?w=2500&maxW=1615&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=14df635875ba0b184abf5248669ace57 2500w" data-optimize="true" data-opv="2" />
</Frame>

* Click on "Proxy List"

<Frame>
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_2.png?maxW=1389&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=48178e7b341f455697af7571d6380e6b" alt="Insomniac_setup_2.png" width="1389" height="652" data-path="images/integrations/Insomniac_setup_2.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_2.png?w=280&maxW=1389&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=653b48dbd293fbfdbfe5d68857a73653 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_2.png?w=560&maxW=1389&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=3a0bd89cf1d8224f38a3ceac5d8563bb 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_2.png?w=840&maxW=1389&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=1d630b259b78a6efefb8c9519330f8d7 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_2.png?w=1100&maxW=1389&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=ad9d10805d86bd1f7f58148dde3e0579 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_2.png?w=1650&maxW=1389&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=ebc2a2c41296ff63256384a81da90ade 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_2.png?w=2500&maxW=1389&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=78198998e642d5b2eb781ea369122dd9 2500w" data-optimize="true" data-opv="2" />
</Frame>

* This setup window will open, requiring you to paste your proxy configuration here.

<Frame>
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_3.png?maxW=1404&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=7903b247d13708aa2611f739893ca6d7" alt="Insomniac_setup_3.png" width="1404" height="829" data-path="images/integrations/Insomniac_setup_3.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_3.png?w=280&maxW=1404&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=4aeefa9a3ad41757a5ac2d60b1f44076 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_3.png?w=560&maxW=1404&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=140d80cc75f69aba0f5f0caec3736224 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_3.png?w=840&maxW=1404&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=d36c8b2641fff8562c47146439aef364 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_3.png?w=1100&maxW=1404&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=40d1abb6bfafe09c66986db1beaaa3a9 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_3.png?w=1650&maxW=1404&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=d8e5731c012ae96b6a66ba99e8e5ac1d 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_3.png?w=2500&maxW=1404&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=0ac3adeb34c536b3706e3d695121557b 2500w" data-optimize="true" data-opv="2" />
</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 src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_4.png?maxW=1444&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=2616d693af063f9846bf21e4d0d7ab30" alt="Insomniac_setup_4.png" width="1444" height="690" data-path="images/integrations/Insomniac_setup_4.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_4.png?w=280&maxW=1444&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=97e42fbe9df989a129b8a298a8d6d69e 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_4.png?w=560&maxW=1444&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=7a0f1501b6f3a252bcbd9c23d232c9df 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_4.png?w=840&maxW=1444&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=61fa662b3f1a2deb72a810d7e5a52178 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_4.png?w=1100&maxW=1444&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=398184d1a293cdad58a53601d83d8ea1 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_4.png?w=1650&maxW=1444&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f50405d42cf595ae074aeb07b7c5e4c3 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_4.png?w=2500&maxW=1444&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=b3d03ccca6f425df05f3e6348bc4d347 2500w" data-optimize="true" data-opv="2" />
</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 src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_5_brd_dc_iplistdwnld.png?maxW=1513&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=d8b607adcea6c101504cdf0ee7cfb189" alt="Insomniac_setup_5_brd_dc_iplistdwnld.png" width="1513" height="838" data-path="images/integrations/Insomniac_setup_5_brd_dc_iplistdwnld.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_5_brd_dc_iplistdwnld.png?w=280&maxW=1513&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=fc91ca49d71e4de908d714a1be4d6b2c 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_5_brd_dc_iplistdwnld.png?w=560&maxW=1513&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=00c91677a54eea1998086df4eda33bf2 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_5_brd_dc_iplistdwnld.png?w=840&maxW=1513&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=027d0b0ca00445bd561ea2edd3482b4e 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_5_brd_dc_iplistdwnld.png?w=1100&maxW=1513&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=9b9d07f7434104948578f70836321c6f 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_5_brd_dc_iplistdwnld.png?w=1650&maxW=1513&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a5b6978f9c39c6c27ea58a10f5ba160a 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_5_brd_dc_iplistdwnld.png?w=2500&maxW=1513&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=414d13712f46e289b6a0571d4ff2c0dd 2500w" data-optimize="true" data-opv="2" />
</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 src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_7_proxylist_notepad.png?maxW=1423&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f9b7b598bebaaad00af21eee4b6cf84d" alt="insomniac_setup_7_proxylist_notepad.png" width="1423" height="723" data-path="images/integrations/Insomniac_setup_7_proxylist_notepad.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_7_proxylist_notepad.png?w=280&maxW=1423&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=0520dd1d37851b440a6add37ec677891 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_7_proxylist_notepad.png?w=560&maxW=1423&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=0290dd62546873fa8a7063ed445d92e4 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_7_proxylist_notepad.png?w=840&maxW=1423&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c193b6e2df96e34b3793f0fdcd747de8 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_7_proxylist_notepad.png?w=1100&maxW=1423&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=1c09b91957827a0c756465ed0ecbab62 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_7_proxylist_notepad.png?w=1650&maxW=1423&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=14d5abf4b73850d4b565cd6478975795 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/Insomniac_setup_7_proxylist_notepad.png?w=2500&maxW=1423&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=25977bffa667f9de58f4cad7d0477372 2500w" data-optimize="true" data-opv="2" />
</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, 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](https://docs.brightdata.com/general/account/ssl-certificate#installation-of-the-ssl-certificate) for instructions.
</Warning>


# Proxy Integrations
Source: https://docs.brightdata.com/integrations/introduction

Bright Data's proxies seamlessly integrate with leading third party software. Read our detailed guides to effortlessly configure and utilize Bright Data's proxies in your system, tool or utility.  We support all tools and utilities listed here: 

## Supported integration, tools and utilities list

<Note>
  If you want to use Playwright, Puppeteer, or Selenium with Bright Data's Browser API (not just proxy integration), please refer to the [Browser API documentation](https://docs.brightdata.com/scraping-automation/scraping-browser/introduction) for correct setup and code examples. Proxy Integration guides below are for direct proxy use, not for Browser API.
</Note>

1. [AdsPower](/integrations/adspower)
2. [Aezakmi](/integrations/aezakmi)
3. [Agno](/integrations/agno)
4. [Android](/integrations/android)
5. [Antik](/integrations/antik)
6. [Apify](/integrations/apify)
7. [BeautifulSoup](/integrations/beautifulsoup)
8. [BitBrowser](/integrations/bitbrowser)
9. [BrowserScan](/integrations/browserscan)
10. [Capsolver](/integrations/capsolver)
11. [ChangeDetection](/integrations/changedetection)
12. [Chrome](/integrations/chrome)
13. [ClonBrowser](/integrations/clonbrowser)
14. [CrewAI](/integrations/crew-ai)
15. [DICloak](/integrations/dicloak)
16. [Dify](/integrations/dify)
17. [Dolphin (anty) ](/integrations/dolphin-anty)
18. [Easync](/integrations/easync)
19. [Firefox](/integrations/firefox)
20. [FoxyProxy](/integrations/foxyproxy)
21. [Geelark](/integrations/geelark)
22. [GenLogin](/integrations/genlogin)
23. [Ghost Browser](/integrations/ghost-browser)
24. [GoLogin](/integrations/gologin)
25. [Helium Scraper](/integrations/helium-scraper)
26. [HideMyAcc](/integrations/hidemyacc)
27. [iOS](/integrations/ios)
28. [Incogniton](/integrations/incogniton)
29. [Insomniac](/integrations/insomniac)
30. [IXBrowser](/integrations/ixbrowser)
31. [Kameleo](/integrations/kameleo)
32. [Lalicat](/integrations/lalicat)
33. [LangChain](/integrations/langchain)
34. [Lindy.ai](/integrations/lindy-ai)
35. [Linux](/integrations/linux)
36. [LlamaIndex](/integrations/llamaindex)
37. [MacOS](/integrations/macos)
38. [Make.com](/integrations/make)
39. [MarketerBrowser](/integrations/marketerbrowser)
40. [Maskfog](/integrations/maskfog)
41. [MoreLogin](/integrations/morelogin)
42. [MuLogin](/integrations/mulogin)
43. [Multilogin](/integrations/multilogin)
44. [Nginx](/integrations/nginx)
45. [n8n](/integrations/n8n)
46. [Octo Browser](/integrations/octobrowser)
47. [Octoparse](/integrations/octoparse)
48. [OpenBullet](/integrations/openbullet)
49. [ParseHub](/integrations/parsehub)
50. [PhantomBuster](/integrations/phantombuster)
51. [Pica](/integrations/pica)
52. [Playwright](/integrations/playwright)
53. [Postern](/integrations/postern)
54. [Postman](/integrations/postman)
55. [Proxifier](/integrations/proxifier)
56. [Puppeteer](/integrations/puppeteer)
57. [SaleFreaks](/integrations/salefreaks)
58. [Scrapy](/integrations/scrapy)
59. [Screaming Frog](/integrations/screaming-frog)
60. [Selenium](/integrations/selenium)
61. [SessionBox](/integrations/sessionbox)
62. [ShadowRocket](/integrations/shadowrocket)
63. [SMLogin](/integrations/smlogin)
64. [Sphere Browser](/integrations/sphere-browser)
65. [StablerSOLO](/integrations/stablersolo)
66. [SwitchyOmega](/integrations/switchyomega)
67. [TexAu](/integrations/texau)
68. [Undetectable](/integrations/undetectable)
69. [VMLogin](/integrations/vmlogin)
70. [WebHarvy](/integrations/webharvy)
71. [Web Scraper](/integrations/webscraper)
72. [Windows](/integrations/windows)
73. [XLogin](/integrations/xlogin)
74. [xpander.ai](/integrations/xpander-ai)
75. [Zapier](/integrations/zapier)

***

## Unsupported integrations

1. [Telegram Messenger](/integrations/telegram)


# How to Use Bright Data on iOS
Source: https://docs.brightdata.com/integrations/ios

Learn how to set up Bright Data proxies on your iOS to enjoy secure, private, and unrestricted browsing. This guide walks you through the entire configuration process, ensuring a smooth and reliable connection.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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?

Setting up Bright Data proxies on your iOS helps you:

* **Protect Your Privacy**: Hide your real IP address and browse more securely.

* **Access Geo-Restricted Content**: Connect through various regions to access content available in different countries.

* **Improve Reliability**: Reduce detection risks and enjoy stable, anonymous connections while you browse, shop, or manage accounts from your phone.

## Prerequisites

Before you get started, make sure you have:

1. **Bright Data Proxy Credentials**:
   * Log in to your [Bright Data dashboard](https://brightdata.com/cp/zones) and find your Host, Port, Username, and Password.

2. **An iPhone running iOS 10 or later**:
   * The steps below work with most recent iOS versions.

## Configuring a Proxy for a Wi-Fi Network

<Steps>
  <Step title="Open Wi-Fi Settings">
    1. Go to **Settings** on your iPhone’s home screen.
    2. Tap **Wi-Fi**, then select the **i** (info) icon next to the network you’re connected to.

    <Frame as="div" style={{width:"50%", height:"auto"}}>
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone1.png?maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=7ab15eea854f5df65563c6722b007044" alt="" width="1170" height="1049" data-path="images/integrations/iphone1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone1.png?w=280&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=21cb06de6bc35fbd4642ab5bbe1f943e 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone1.png?w=560&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=13d4af6e03ecb3775f88889961a6768c 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone1.png?w=840&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=37bec84e856d447b06e9e3f5bcffbf9a 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone1.png?w=1100&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3a80e9389da5835f221da787786875e9 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone1.png?w=1650&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=299c8791cb4accc3d19a934272d0059c 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone1.png?w=2500&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c6acc07adf058a6fd10e20153fb57924 2500w" data-optimize="true" data-opv="2" />
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone2.png?maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2d308db3186138b8c38eddc8fe307b39" alt="" width="1170" height="569" data-path="images/integrations/iphone2.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone2.png?w=280&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ba3b267b8bc1fa37ce9ddfc6a989524d 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone2.png?w=560&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=e5c506ee9be2a6d8479a9dc98ce9d7a0 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone2.png?w=840&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8f39678e08e5129371dd886946993352 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone2.png?w=1100&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=9706af07688792deea144cc2f77a3c35 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone2.png?w=1650&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=e099bcdbd60cbd3431c974429bed447a 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone2.png?w=2500&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5748504424d700140265f37ab117aea3 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Change Proxy Settings to Manual">
    1. Scroll down until you see **HTTP Proxy**.
    2. Switch from **Off** or **Auto** to **Manual**.
    3. Toggle **Authentication** *On*.

    <Frame as="div" style={{width:"50%", height:"auto"}}>
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone3.png?maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=19a077c7d00f41119bd0214fc753f98c" alt="" width="1170" height="1043" data-path="images/integrations/iphone3.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone3.png?w=280&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=340d9af5bd1a4b7a6c7f8d111ca30f2b 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone3.png?w=560&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=bdf64545fdfc9ddc35495a96cf31f5e7 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone3.png?w=840&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3afd127e050bb1c8fdd5a917a5bf0809 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone3.png?w=1100&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=20b38f7fdeb27d1a01be4225f44a39b0 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone3.png?w=1650&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=56ee83f8f37ee38358e61d911bcef4c8 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone3.png?w=2500&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=bc78f29f507718b810d09c38c1f54c92 2500w" data-optimize="true" data-opv="2" />
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone4.png?maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=07752577dfc9baa63690de867e553f1b" alt="" width="1170" height="1168" data-path="images/integrations/iphone4.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone4.png?w=280&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d975e4a570cc8795bd994a423f8c69ad 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone4.png?w=560&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4e46887b85094c43dbfb22113886764a 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone4.png?w=840&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b7703ddbf225235a35145f0d3badd3aa 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone4.png?w=1100&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=e11a532cf8df6494d0baed98252ca92a 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone4.png?w=1650&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4a7ca1e6cd0c6fb37dccfdfae7d568d1 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/iphone4.png?w=2500&maxW=1170&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=32e02b8308993f59b4c15a9b60062079 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Input Bright Data Proxy Credentials">
    1. **Server**: Enter `http://brd.superproxy.io/` (or your given Host).
    2. **Port**: Use the port number from your [Bright Data dashboard](https://brightdata.com/cp/zones).
    3. **Username** and **Password**: Provide the Bright Data login details.
    4. Make sure everything is accurate.
    5. Tap **Save** to confirm your settings.
  </Step>

  <Step title="Test">
    1. Open **Safari** and go to [httpbin.org/ip](http://httpbin.org/ip).
    2. Check if the displayed IP matches the Bright Data proxy IP. If it does, your Wi-Fi traffic is now secure and private.
  </Step>
</Steps>

With **Bright Data** integrated into your **iOS device** browsing experience, you’re now better equipped to access geo-restricted content, protect your identity, and ensure a more secure, private connection—no matter where you are. Enjoy the freedom and peace of mind that come with Bright Data’s reliable, anonymous proxies!


# How to Integrate Bright Data With IXBrowser
Source: https://docs.brightdata.com/integrations/ixbrowser

Streamline your account management and secure your browsing with Bright Data and IXBrowser. Follow this guide to configure Bright Data for a seamless and anonymous experience using IXBrowser.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</Tip>

**IXBrowser** is a privacy-focused anti-detect browser tailored for managing multiple accounts 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 as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser1.png?maxW=1364&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ea7f266fc05eedcbe14c5e1ca69e4fff" alt="" width="1364" height="197" data-path="images/integrations/ixbrowser1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser1.png?w=280&maxW=1364&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8c693fb282a2f0c8ba1c4d9961c16db7 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser1.png?w=560&maxW=1364&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=32f4e8b450c73da9c4cbcfa8f22cf14c 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser1.png?w=840&maxW=1364&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4cfd0c91bae7f2f5a55892cdcf6f799e 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser1.png?w=1100&maxW=1364&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=351ead14318286499a64a6a1f357329e 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser1.png?w=1650&maxW=1364&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d34a80347924cd29a4d6cdac13ead10f 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser1.png?w=2500&maxW=1364&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=866aea81c122fd940d036687a14f4cdf 2500w" data-optimize="true" data-opv="2" />
    </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 as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser2.png?maxW=1353&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f7f34b045103bfc94e9b64165992f19c" alt="" width="1353" height="278" data-path="images/integrations/ixbrowser2.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser2.png?w=280&maxW=1353&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=71b0281d973622114d9b5472573ad7de 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser2.png?w=560&maxW=1353&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=91e5d8d4c707ced53d4dc3919e76a8e2 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser2.png?w=840&maxW=1353&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=229c7c535fb581add51b15b4339cddf9 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser2.png?w=1100&maxW=1353&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=66a80177207f9d65f3e42de85b374fdb 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser2.png?w=1650&maxW=1353&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2dbebdf160bf4d9eedbbcce94883ddef 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ixbrowser2.png?w=2500&maxW=1353&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=e419ae8b729fc9f1ce67fc3fd6613f91 2500w" data-optimize="true" data-opv="2" />
    </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

Integrate Bright Data with Kameleo for secure browsing and efficient management of multiple profiles, offering enhanced privacy and robust protection against detection.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 a social media manager, affiliate marketer, e-commerce operator, or web scraper, Kameleo gives you the tools to bypass IP bans, prevent device tracking, and avoid account linking.

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 handling multiple accounts across social media platforms, e-commerce sites, and more—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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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

Integrating Bright Data with Lalicat ensures secure, anonymous multi-account management, offering flexible proxy solutions for reliable and efficient browsing.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 managing social media accounts, handling e-commerce tasks, or performing web scraping, Lalicat offers a reliable and affordable solution for professionals who prioritize privacy and efficiency. It's perfect for anyone who needs to juggle multiple accounts without the risk of being flagged or banned.

<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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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 as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat1.png?maxW=1534&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b779761f0cb35b4556b46e2def6b9ee1" alt="" width="1534" height="364" data-path="images/integrations/lalicat1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat1.png?w=280&maxW=1534&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8a69d3e6f89cbcdea41957d4bb12358b 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat1.png?w=560&maxW=1534&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f90feadd5c3ea6518f2a0407f21bedef 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat1.png?w=840&maxW=1534&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2098c8043e6d1201558b18db8400fade 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat1.png?w=1100&maxW=1534&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=093a762ec3782de1c0df03175bb5ef40 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat1.png?w=1650&maxW=1534&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ce39fe9e58ad9d9d423e8ce630b8126f 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat1.png?w=2500&maxW=1534&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=cb351b77a55d427a5408694288362882 2500w" data-optimize="true" data-opv="2" />
    </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 as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat2.png?maxW=715&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4fcb38a67ff675397aca68d7f23e82d8" alt="" width="715" height="611" data-path="images/integrations/lalicat2.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat2.png?w=280&maxW=715&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=252606f7dedc2e2a42963c0d4ea66442 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat2.png?w=560&maxW=715&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3fe77d7534ecf9bec0c357b2f1800176 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat2.png?w=840&maxW=715&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=802706774e1732efbe6c22e40367921f 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat2.png?w=1100&maxW=715&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=897519c4703b0cab21dffe469c174597 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat2.png?w=1650&maxW=715&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=932e1fbf8dc7a414c57ca816f4336b87 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/lalicat2.png?w=2500&maxW=715&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=58854bc0a8c8d2710633c7ce881f2358 2500w" data-optimize="true" data-opv="2" />
    </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.


# How to Set Up Bright Data With LangChain
Source: https://docs.brightdata.com/integrations/langchain



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 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 Web Scraper API 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)**](https://docs.brightdata.com/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" stepNumber="0">
    * 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](https://docs.brightdata.com/general/account/api-token#generate-a-new-api-key-from-the-settings-page) 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
    pip install langchain-brightdata
    ```
  </Step>

  <Step title="Set the environment variable">
    Set your Bright Data API key as an environment variable:

    ```python
    import os
    os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"
    ```

    <Tip>
      Or pass it directly when initializing tools:

      ```python
      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](https://docs.brightdata.com/scraping-automation/serp-api/introduction)
        </Tip>

        Collect search engine results with geo-targeting

        <CodeGroup>
          ```python Basic Usage
          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
          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
          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**: [Unlocker API Documentation](https://docs.brightdata.com/scraping-automation/web-unlocker/introduction)
        </Tip>

        Access any public website, even if it’s bot-protected or geo-restricted.

        <CodeGroup>
          ```python Basic Usage
          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
          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
          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**: [Web Scraper API Documentation](https://docs.brightdata.com/scraping-automation/web-scraper-api/overview)
        </Tip>

        Extract structured data from over 100 supported domains like Amazon, LinkedIn, and more.

        <CodeGroup>
          ```python Basic Usage
          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
          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
          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 Web Scraper API 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

Automate your web data workflows by integrating Bright Data with Lindy.ai. Learn how to connect APIs, trigger real-time data collection, and enhance business automation.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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, 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
    * **Unlocker API** – For bypassing anti-bot mechanisms

    > 🔗 Example API endpoint (DCA):

    ```
    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
    {
      "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



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
    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
    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
    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
    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
    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](https://docs.brightdata.com/).
  </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](https://docs.brightdata.com/general/account/api-token#generate-a-new-api-key-from-the-settings-page) if you haven't already done so.
  </Step>

  <Step title="Installation">
    Install the required packages:

    ```bash
    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
    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

Integrate Bright Data proxies into your macOS network settings for secure, private, and geo-flexible browsing. This guide will walk you through the entire configuration process to help you stay efficient and protected online.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</Tip>

## Why Use Bright Data on macOS?

Adding Bright Data proxies to your Mac’s network settings provides:

* **Enhanced Privacy**: Keep your real IP hidden and your online activities more secure.

* **Geo-Access Flexibility**: Connect through different regions to access location-specific content.

* **Stable, Anonymous Connections**: Reduce detection risks and maintain reliable browsing sessions across various applications, not just your browser.

## Setting Up Bright Data on macOS

<Steps>
  <Step title="Prerequisites" stepNumber="0">
    Before you begin, ensure you have:

    1. **Bright Data Proxy Credentials**:
       * Log in to your [Bright Data dashboard](https://brightdata.com/cp/zones) to find your Host, Port, Username, and Password.
       * Identify whether you have `HTTP`, `HTTPS`, or `SOCKS5` proxies.

    2. A **macOS device running a recent macOS version** (the instructions below apply generally to macOS 10.12 Sierra and later).
  </Step>

  <Step title="Open Network Preferences">
    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 as="div" style={{width:"50%", height:"auto"}}>
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos1.png?maxW=252&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d74963a371701110295d7e0464a5ec16" alt="" width="252" height="316" data-path="images/integrations/macos1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos1.png?w=280&maxW=252&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f2e4791fed8f436fd6b4e2e1715bdde3 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos1.png?w=560&maxW=252&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f47452759d5e7b3666bdab500b9429d9 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos1.png?w=840&maxW=252&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=87298d2a7bcb97d20be8d86f7eda7710 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos1.png?w=1100&maxW=252&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5e46413fb8b9e2680379f178c2537a77 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos1.png?w=1650&maxW=252&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=721e5e93981f944e2292743c7619b38e 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos1.png?w=2500&maxW=252&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3d3c48b697ca75c484c541206acf8c0b 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    3. Choose **Network** and select the network connection you want to configure (e.g., **Wi-Fi** or **Ethernet**).

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos2.png?maxW=719&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=9482cebd33e6ca0617ab8840c918d0f5" alt="" width="719" height="309" data-path="images/integrations/macos2.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos2.png?w=280&maxW=719&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c5ba0f1bb701a722e267ccd644962f2f 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos2.png?w=560&maxW=719&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=219242e0eae98475d1765f2af287259a 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos2.png?w=840&maxW=719&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=0967e6f33268d188d3d81a32f15bce27 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos2.png?w=1100&maxW=719&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d43e035145b4b20b445996d196a2a9a7 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos2.png?w=1650&maxW=719&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=0933ba0fbff7cf81c6cb62b987b9cd5f 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos2.png?w=2500&maxW=719&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=10e8cb6d8f03425a4c25502adf6718c5 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Go to Advanced Settings">
    1. Click the "**Details…"** button in the top-right corner of the Network pane.

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos3.png?maxW=490&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b33df7399db2913edcb6978b8da40df7" alt="" width="490" height="386" data-path="images/integrations/macos3.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos3.png?w=280&maxW=490&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2e3ea686c40f61034c8cb5f1c385ae7c 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos3.png?w=560&maxW=490&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d5af010743408510d3558be0ce8470ab 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos3.png?w=840&maxW=490&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b48d05903d318d8b4f3b0fa36a468a56 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos3.png?w=1100&maxW=490&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8569ce290c8ded5fb929d2f2e5593084 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos3.png?w=1650&maxW=490&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=a4354dbe5ccc922771c79994bf389a48 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos3.png?w=2500&maxW=490&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=30638fbd18b43bbf96f7ae2057a50f31 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    2. In the new window, select the **Proxies** tab at the bottom.

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos4.png?maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=9a4cff2baf0b7dc9674cf5402d5e8900" alt="" width="659" height="420" data-path="images/integrations/macos4.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos4.png?w=280&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=485a1ecf781399d591e3d2ff735f7fe5 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos4.png?w=560&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8c85718f6198a030e10ed5d19518864f 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos4.png?w=840&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=910de24511862c3d363772b39758aa3f 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos4.png?w=1100&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=01b1c5b39e442c452e050b05981d2769 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos4.png?w=1650&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3aee15ce58c742c0896723d17f3ed6a5 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos4.png?w=2500&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=42955310991ecc33b4c00d3a8096536f 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Choose Your Proxy Type">
    Check the box next to the proxy protocol you need to configure.

    For Bright Data’s `HTTP` or `HTTPS` proxies, select **Web Proxy (HTTP)** or **Secure Web Proxy (HTTPS)**. For `SOCKS` proxies, select **SOCKS Proxy**.

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos5.png?maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=39fdb8e407088b4b7b310f2b75855e93" alt="" width="659" height="420" data-path="images/integrations/macos5.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos5.png?w=280&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2cdacf80b32b5777dd2d5235cc24013b 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos5.png?w=560&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=bb2cfecd8e535506501cb4acd2ddfa29 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos5.png?w=840&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b023a529f44007bc7357b168bc7af836 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos5.png?w=1100&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=dd4f33ba07b00a88ce2cce3b6ff7e1fb 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos5.png?w=1650&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=cce2f96e0f8be972e90b0990470eabc5 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/macos5.png?w=2500&maxW=659&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=05622dee2029490f69b49e3f6f8fd8c2 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Enter Bright Data Proxy Details">
    * **Server**: Input the Bright Data host (e.g., `http://brd.superproxy.io/`).
    * **Port**: Enter the port number from your [Bright Data dashboard](https://brightdata.com/cp/zones).
    * **Toggle Authentication**: Check the option **“Proxy server requires password”** (or a similar setting) to enable credential fields.
    * **Username** and **Password**: Provide your Bright Data proxy credentials. If you need a country-specific exit node, append `-country-XX` to your username (e.g., `your-username-country-US` for a US-based proxy).
    * Click **OK** to close the settings window.
  </Step>

  <Step title="Test Your Proxy Connection">
    1. Open **Safari**, **Chrome**, or another browser on your Mac.
    2. Go to [httpbin.org/ip](http://httpbin.org/ip) to check your IP address.
    3. Confirm that the displayed IP matches your Bright Data proxy’s IP. If so, your Mac is now routing traffic through the Bright Data proxy.
  </Step>
</Steps>

With **Bright Data** proxies integrated into your **macOS** network settings, you can enjoy more secure, private, and flexible browsing across all your applications. Explore geo-restricted content, protect your identity, and enhance reliability—on your Mac, Bright Data makes it easy to stay ahead!


# How to Set Up Bright Data With Make.com
Source: https://docs.brightdata.com/integrations/make

Learn how to integrate Bright Data with Make.com to build automated, no-code data workflows.

## 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 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 **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" stepNumber="0">
    * 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](https://docs.brightdata.com/general/account/api-token#generate-a-new-api-key-from-the-settings-page) 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 Unlocker API' Module">
    * Select the **Run an 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 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 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 Use Bright Data With MarketerBrowser
Source: https://docs.brightdata.com/integrations/marketerbrowser

Effortlessly enhance your browser profile management with Bright Data. Integrating Bright Data with MarketerBrowser allows you to secure your connections, manage multiple accounts, and explore region-specific content with ease. Follow this guide to set up Bright Data with MarketerBrowser today.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</Tip>

**MarketerBrowser** is a specialized browser designed for professionals managing multiple accounts 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 as="div">
        <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/marketerbrowser1.png?maxW=761&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5cac447ad92142cef4db04a0797a42cb" alt="" width="761" height="329" data-path="images/integrations/marketerbrowser1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/marketerbrowser1.png?w=280&maxW=761&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4a888b8ec9443553c1bfdd6aaf8c1ad6 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/marketerbrowser1.png?w=560&maxW=761&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f7f00c9f048a4e9caa58f9825c3dba2e 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/marketerbrowser1.png?w=840&maxW=761&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b1f1fa5f51d7172d96a680c3b18bb891 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/marketerbrowser1.png?w=1100&maxW=761&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8887aaf2774b8c7fb3be755a91ba36a3 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/marketerbrowser1.png?w=1650&maxW=761&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=1c6513774e9c996e509c585176a3fe43 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/marketerbrowser1.png?w=2500&maxW=761&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=e88560c72e391e46863f0dfe9b29bad0 2500w" data-optimize="true" data-opv="2" />
  </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 as="div">
        <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/marketerbrowser2.png?maxW=1268&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=28b003eccd0ddff4d938449c9e62888c" alt="" width="1268" height="241" data-path="images/integrations/marketerbrowser2.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/marketerbrowser2.png?w=280&maxW=1268&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4a1404b9fedb4685b3c5824b8301e0f9 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/marketerbrowser2.png?w=560&maxW=1268&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=78db1b35bf782ea7d44c41d894b34166 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/marketerbrowser2.png?w=840&maxW=1268&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3e91106c62ad2077f9519c6b7569e98d 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/marketerbrowser2.png?w=1100&maxW=1268&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=1267c4a9952093458fc7132c29a5ead0 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/marketerbrowser2.png?w=1650&maxW=1268&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f5541d701d7dc543d46330c349f4c275 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/marketerbrowser2.png?w=2500&maxW=1268&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=620e1d07f3f6629c257edd392aae334a 2500w" data-optimize="true" data-opv="2" />
  </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

Learn how to integrate Bright Data with Maskfog to enhance privacy and streamline your account management. Follow this guide for a smooth setup experience.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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 as="div">
        <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/maskfog1.png?maxW=1598&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=49bfc9262c799a170da6facd836d7e8d" alt="" width="1598" height="385" data-path="images/integrations/maskfog1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/maskfog1.png?w=280&maxW=1598&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4aa4ab971905cf9088ee4ac5d3538da2 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/maskfog1.png?w=560&maxW=1598&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=976da16db3e23c8fdce6754ca988964f 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/maskfog1.png?w=840&maxW=1598&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5477c5eef8f4a73852adb6ad11391e2c 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/maskfog1.png?w=1100&maxW=1598&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6c6f672b64f6cec106bf604c194920d7 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/maskfog1.png?w=1650&maxW=1598&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=1b881fedfa8a201dcb303ec5ad6b59ca 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/maskfog1.png?w=2500&maxW=1598&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4461d0a8f2dc029a9aed641520942cec 2500w" data-optimize="true" data-opv="2" />
  </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

Enhance your multi-account management with Bright Data on MoreLogin for secure, anonymous browsing and better protection against detection.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 social media managers, 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 social media management, e-commerce, and affiliate marketing. Whether you're handling multiple accounts or scaling your 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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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 as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin1.png?maxW=1440&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6f6d66ddb1237c83af76942c1c72d6b0" alt="" width="1440" height="698" data-path="images/integrations/morelogin1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin1.png?w=280&maxW=1440&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=097110ba463d6123b4aa1cd3dfd9001f 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin1.png?w=560&maxW=1440&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=650e60a85af532b243875fdf3449cee1 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin1.png?w=840&maxW=1440&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3be2149b91dfc1721e702bda48eed221 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin1.png?w=1100&maxW=1440&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=36178e45d138f079ad19705184d0969a 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin1.png?w=1650&maxW=1440&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=dbbfcbb18475a72d5ee99fa5e3205807 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin1.png?w=2500&maxW=1440&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c893a35ec96ff30db672a3311c8cf6ad 2500w" data-optimize="true" data-opv="2" />
    </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 as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin2.png?maxW=560&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=07e83f635a0c7e7943b3873cb4e8ae91" alt="" width="560" height="383" data-path="images/integrations/morelogin2.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin2.png?w=280&maxW=560&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2143b39e487161bc2d4490a0e9d792a0 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin2.png?w=560&maxW=560&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d57195e385b9b0e834cbeebb5063b370 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin2.png?w=840&maxW=560&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=cd17e416a7701b7b68e54f77fd247566 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin2.png?w=1100&maxW=560&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=fca6b134031765a5e391099080f3812b 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin2.png?w=1650&maxW=560&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ba1329b54a291cb43d9bc69e092f5735 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin2.png?w=2500&maxW=560&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=69be15277828d6fb8469ffc73a9df6c9 2500w" data-optimize="true" data-opv="2" />
    </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 as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin3.png?maxW=876&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=9567c547de59275d41c3b1dc7f1d3ddb" alt="" width="876" height="815" data-path="images/integrations/morelogin3.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin3.png?w=280&maxW=876&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ffc70b3906d662f82252095ab1d9083d 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin3.png?w=560&maxW=876&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2de74db8b0c37f5e8188cb79a5367998 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin3.png?w=840&maxW=876&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=434e7098db804cf4cf9ecf9f384de1ae 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin3.png?w=1100&maxW=876&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=694c3c9fdef8a5b8208183c5fb1c7300 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin3.png?w=1650&maxW=876&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=29343d4068d3c7849ee87771411d4f6a 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin3.png?w=2500&maxW=876&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=84befe592302754be49a20033b6d9a53 2500w" data-optimize="true" data-opv="2" />
    </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 as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin4.png?maxW=771&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=7d2daba39f9fbe5b2f8afb2a5776f60a" alt="" width="771" height="131" data-path="images/integrations/morelogin4.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin4.png?w=280&maxW=771&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d03e71debc0da16b6179e727ba22b43d 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin4.png?w=560&maxW=771&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8ac40907a54fd0e134c69bbfce49534f 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin4.png?w=840&maxW=771&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8afdfb62b4b1fced9eec452beccb216a 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin4.png?w=1100&maxW=771&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=7b1a700c2b494a301021df0a09c0166c 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin4.png?w=1650&maxW=771&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4a39b189ce0ae1a4004e06d31ef7ebfd 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/morelogin4.png?w=2500&maxW=771&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=28d56d1a6914e35c4616dc2b8baf5188 2500w" data-optimize="true" data-opv="2" />
    </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

Enhance your MuLogin experience by integrating Bright Data proxies. This guide shows you how to set up secure, anonymous connections for better automation, data gathering, and account management.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 managing e-commerce stores, social media profiles, and other online 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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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:

<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 as="div">
        <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin1.png?maxW=1385&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=483ad01a257d547823b1a2bbffbf3d28" alt="" width="1385" height="375" data-path="images/integrations/mulogin1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin1.png?w=280&maxW=1385&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=1a655b7db1cbda87150816196f7c901a 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin1.png?w=560&maxW=1385&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=1cb87434bb0a06375f6791a9088cf594 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin1.png?w=840&maxW=1385&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=62921b4440384687b959c2f96de9be2b 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin1.png?w=1100&maxW=1385&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5ffe2861d1035636f72b6cce76a53d3f 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin1.png?w=1650&maxW=1385&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=a117165fe56d4e46ebeb4af5ac801311 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin1.png?w=2500&maxW=1385&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=696b3ba790f9edac30cf60b66da58bb7 2500w" data-optimize="true" data-opv="2" />
  </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 as="div">
        <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin2.png?maxW=1612&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=149651ca867ab8ed0a8557be3fe281a3" alt="" width="1612" height="242" data-path="images/integrations/mulogin2.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin2.png?w=280&maxW=1612&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c685526f91f4165a66a3e85af65f5576 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin2.png?w=560&maxW=1612&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=71de3c86ea5a135d8517ec0e6b0ad0ff 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin2.png?w=840&maxW=1612&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4daaa286cdda0acd6fa54b14edde5a1c 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin2.png?w=1100&maxW=1612&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=56f1285080e256c88dade1010ad73d51 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin2.png?w=1650&maxW=1612&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=fb51c42cbfd7953125ccef9f90a30de6 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin2.png?w=2500&maxW=1612&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=7e62aee16fd02d5ad034db345f557434 2500w" data-optimize="true" data-opv="2" />
  </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 as="div">
        <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin3.png?maxW=803&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8d15a3d1bd5e4ab45521a34673985e4a" alt="" width="803" height="623" data-path="images/integrations/mulogin3.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin3.png?w=280&maxW=803&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=29742b285749ec78b4a3632e516369b8 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin3.png?w=560&maxW=803&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=21a036b7fd2fb7c41f4128c1fd94915d 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin3.png?w=840&maxW=803&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=0476622960c78e39466665f1afaad3d2 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin3.png?w=1100&maxW=803&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=eab637331f8f027996df9d408362924c 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin3.png?w=1650&maxW=803&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6e8c147f0dee4d817fb31c72f55b2746 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin3.png?w=2500&maxW=803&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=e0fe30fbfd2f003a103d6c65878c032e 2500w" data-optimize="true" data-opv="2" />
  </Frame>

  3. Scroll down the page to find the **“Proxy Settings”** option. Click on it to open the proxy configuration window.

  <Frame as="div">
        <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin4.png?maxW=807&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3b679eca9b7df73f1bde0936dfdc9e51" alt="" width="807" height="621" data-path="images/integrations/mulogin4.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin4.png?w=280&maxW=807&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=283e12082ac8fce17fcf99ac686380c5 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin4.png?w=560&maxW=807&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6ce4053ffa9d80f54ccb88f54924cca5 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin4.png?w=840&maxW=807&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=98e74bd754347f0f4d25aaccf708aff9 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin4.png?w=1100&maxW=807&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4d158c3fd7528f5598921870dfb5b9d3 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin4.png?w=1650&maxW=807&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=852f6b6ebf3e6b8a33230328b3ad5c8b 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin4.png?w=2500&maxW=807&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=88cde43b94b55c184cc120298b6c4433 2500w" data-optimize="true" data-opv="2" />
  </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 as="div">
           <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin5.png?maxW=791&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c77e700aac6d8150bd9f4d90f27fc440" alt="" width="791" height="246" data-path="images/integrations/mulogin5.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin5.png?w=280&maxW=791&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=dbff15002f33bcfeedb806aa62b7e903 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin5.png?w=560&maxW=791&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4c4c0da4ff468e8d26769a1f7a0ee845 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin5.png?w=840&maxW=791&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ded73440586a99857e4f82ae319c812d 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin5.png?w=1100&maxW=791&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b7dffce6a33e934995abff7b4bc0adfb 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin5.png?w=1650&maxW=791&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=0c7c37e116f9044247e23616b2eaf58b 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/mulogin5.png?w=2500&maxW=791&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=02e3a2b2f86bf626759597a65a43edbd 2500w" data-optimize="true" data-opv="2" />
       </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>

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

Integrating Bright Data with Multilogin enhances your multi-account management, offering secure, undetectable browsing with improved privacy and reduced risk of account bans.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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, e-commerce professionals, affiliate marketers, and growth hackers who need to bypass platform restrictions that flag accounts linked to the same IP address or device.

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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</Tip>

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


# How to Set Up Bright Data With n8n
Source: https://docs.brightdata.com/integrations/n8n

Learn how to integrate Bright Data with n8n to build automated, no-code data workflows.

## 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 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**](https://docs.brightdata.com/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 src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/n8n-workflow-sample.png?maxW=1373&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=e205228e904e50f46567ee18e6300cb3" alt="n8n-workflow-sample" width="1373" height="543" data-path="images/integrations/n8n-workflow-sample.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/n8n-workflow-sample.png?w=280&maxW=1373&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=29d3d903279c6d4d9fb44305f2583e7a 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/n8n-workflow-sample.png?w=560&maxW=1373&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=7dfcd345f07c81fca350918a36fcbc01 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/n8n-workflow-sample.png?w=840&maxW=1373&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6064ab2afe9f93a02d51258046c9a785 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/n8n-workflow-sample.png?w=1100&maxW=1373&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=37e01b56139902ff33894db65371edbc 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/n8n-workflow-sample.png?w=1650&maxW=1373&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6965c10f37699219b3fe5b1ac77b7331 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/n8n-workflow-sample.png?w=2500&maxW=1373&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=45dcc9de0cbb766e4c615cfaf05f07ba 2500w" data-optimize="true" data-opv="2" />
</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](https://docs.brightdata.com/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 `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:

    ```
    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>


# How to Set Up Bright Data With NGINX
Source: https://docs.brightdata.com/integrations/nginx

Integrate Bright Data with NGINX to efficiently route traffic, mask domains, and manage connections securely. Follow this guide to configure NGINX with Bright Data proxies for enhanced performance and flexibility.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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
    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
    include /etc/nginx/sites-enabled/*;
    ```

    4. Save the changes and exit the editor.
    5. Your updated `nginx.conf` should look like this:

    ```nginx
    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
    sudo mkdir -p /etc/nginx/sites-enabled
    ```

    2. Create a new configuration file:

    ```bash
    sudo nano /etc/nginx/sites-enabled/brightdata.conf
    ```

    3. Add the following configuration to the file, adjusting the port range as needed:

    ```nginx
    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
    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
    curl --proxy http://10.0.2.15:24000 "http://lumtest.com/myip.json" -v
    ```

    2. Confirm that the response includes the expected proxy IP and location.

       **Expected output:**

       ```json
       {
         "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 Octo Browser
Source: https://docs.brightdata.com/integrations/octobrowser

Integrate Bright Data with Octo Browser to enhance your multi-account management and web scraping with robust anti-detection features and secure browsing.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 online accounts without the risk of detection or bans. It’s perfect for marketers, e-commerce sellers, and web scrapers who need to safely navigate across many accounts.

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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</Tip>

## 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

Boost your web scraping efficiency by integrating Bright Data with Octoparse, ensuring secure and anonymous data extraction while reducing the risk of IP blocks.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 the tool.
  </Step>

  <Step title="Create a New Task">
    Click the **+New** button in the top-left corner, then select **Custom Task**.

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse1.png?maxW=226&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=1bfc3460f56af977205c51a01f56e145" alt="" width="226" height="175" data-path="images/integrations/octoparse1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse1.png?w=280&maxW=226&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b54988089aaefb6de704da2b14828382 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse1.png?w=560&maxW=226&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3e1327edf072b913f7bca8168da6d295 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse1.png?w=840&maxW=226&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=02a5262205ad205cd92a63579981b898 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse1.png?w=1100&maxW=226&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f9696e7057fc8e3fcf2965d44ce22032 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse1.png?w=1650&maxW=226&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=43db2eac4bb4f64b7d6ee78d10058822 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse1.png?w=2500&maxW=226&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=16109a49718b27371edc19feac9dc0ea 2500w" data-optimize="true" data-opv="2" />
    </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 as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse2.png?maxW=468&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=02d68931c5c03da5ec7f62562e33b229" alt="" width="468" height="67" data-path="images/integrations/octoparse2.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse2.png?w=280&maxW=468&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=713b812b71d9be640672df2165cf7847 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse2.png?w=560&maxW=468&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=7622add29b282bc58242dc771fbb8cab 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse2.png?w=840&maxW=468&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=92196f888a7ee239f67be92b49f56349 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse2.png?w=1100&maxW=468&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=7c7d832ed83c7d648d54d93f0c7f9136 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse2.png?w=1650&maxW=468&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b35e36ae75213742371503a02313d390 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse2.png?w=2500&maxW=468&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6fc6c429624d02dd964b273bfb372122 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Enable Proxy Usage">
    Check **Access websites via proxies** and select **Use my own proxies**. Then click **Configure**.

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse3.png?maxW=796&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8b3799f68618ac7ee5e52e36172f4807" alt="" width="796" height="544" data-path="images/integrations/octoparse3.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse3.png?w=280&maxW=796&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=074728779f7f689ba918b16f86c2da52 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse3.png?w=560&maxW=796&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=0f5ff0473d8755a8ae5e5050ee727379 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse3.png?w=840&maxW=796&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4bb6610b9cddecd6be2f00e46b1c6915 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse3.png?w=1100&maxW=796&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=38248cac3a2fbc1e11496e48616b5297 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse3.png?w=1650&maxW=796&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=495e298ef1e83606faaca8ece76aa32f 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse3.png?w=2500&maxW=796&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f979206ad705ddb4bcd1f2a5179bb982 2500w" data-optimize="true" data-opv="2" />
    </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
    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 as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse4.png?maxW=793&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=212abd89c14cc5b93e24026046869137" alt="" width="793" height="543" data-path="images/integrations/octoparse4.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse4.png?w=280&maxW=793&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ef145e1f8c1eeacbc84b6673337d4477 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse4.png?w=560&maxW=793&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=24cb396867fb3922bd3111e793144a48 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse4.png?w=840&maxW=793&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d47a6ec93c66c4f77d3d8c2908c777d0 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse4.png?w=1100&maxW=793&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=0f14ef0b1afd865c34b0b2e79e70524e 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse4.png?w=1650&maxW=793&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c110c36e7c20cfdbce0d6565fee23c46 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/octoparse4.png?w=2500&maxW=793&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=238755a9a3124ac8eccf6efd632dcaa1 2500w" data-optimize="true" data-opv="2" />
    </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 OpenBullet
Source: https://docs.brightdata.com/integrations/openbullet

Enhance your automation workflows with Bright Data on OpenBullet. This guide will help you configure Bright Data for secure and efficient operations.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 a powerful automation and testing tool often used for managing and testing HTTP requests, scraping data, and performing automated workflows. By integrating **Bright Data**, you can ensure secure, private, and reliable connections while minimizing the risk of detection or bans.

## How to Set Up Bright Data With OpenBullet

Follow these steps to integrate **Bright Data** with OpenBullet:

<Steps>
  <Step title="Install OpenBullet">
    1. Visit the [OpenBullet GitHub page](https://github.com/openbullet/OpenBullet2) and download the latest release.
    2. Extract the downloaded files and run the application on your system.
  </Step>

  <Step title="Create a Proxy Group">
    1. From the OpenBullet dashboard, navigate to the **Proxies** tab.
    2. Click **Add Group** to create a new group for your proxies.

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet1.png?maxW=800&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2dcc6c6dc82a89ed28d6114fd222b92f" alt="" width="800" height="178" data-path="images/integrations/openbullet1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet1.png?w=280&maxW=800&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3ee2915a007fb8be95f24e3548a7efe7 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet1.png?w=560&maxW=800&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5c1ecfbfd98d56e2b8f4052ef9e14680 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet1.png?w=840&maxW=800&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=a7d82346fddcd079fe95da0f5c136990 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet1.png?w=1100&maxW=800&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6cca8208c584024bce60943ee2c608b4 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet1.png?w=1650&maxW=800&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3f0b60e8a5ad34e96171b3cecf096ee7 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet1.png?w=2500&maxW=800&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=60552b63910acbb2f0d54d9d2b10d41e 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    3. In the **Name** field, enter a descriptive name for the group to help you organize and identify it later.
    4. Click **Accept** to confirm and save the group.

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet2.png?maxW=265&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b1c3a6636aa6f7b11551dcf8093fa6a0" alt="" width="265" height="129" data-path="images/integrations/openbullet2.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet2.png?w=280&maxW=265&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=afe2382849597ddd74a664e8227dc2cf 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet2.png?w=560&maxW=265&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=55f8c2bcebe12c9893b09ee92aa666e0 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet2.png?w=840&maxW=265&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=09633d5b8378cdf3b83899b97dc77814 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet2.png?w=1100&maxW=265&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=797c85594198cc710ea966bb3a9592f1 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet2.png?w=1650&maxW=265&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=63cbba26d2c119c28461ba902e729294 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet2.png?w=2500&maxW=265&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d7d0df30487160b4a3c76b00b8cdfc61 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Add Your Bright Data Proxy Details">
    1. Select the group you just created from the proxy group list.
    2. Click **Import** to open the proxy configuration panel.

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet3.png?maxW=728&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=7e68c5be07949e8f6254d01601f2493c" alt="" width="728" height="182" data-path="images/integrations/openbullet3.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet3.png?w=280&maxW=728&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=69f654dd36ae26027103654e78e07f7e 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet3.png?w=560&maxW=728&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5edc60b740fbf1f688644e56a5fb5e10 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet3.png?w=840&maxW=728&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=248745ba2001a5c5a33f749567197950 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet3.png?w=1100&maxW=728&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=dbb624285a56b705178974803ef302c9 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet3.png?w=1650&maxW=728&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ef1e111220f0e706d403895266cd5112 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/openbullet3.png?w=2500&maxW=728&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5604e7551bd45f343e193d33e089693e 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    3. In the **Import proxies** window:
       * Switch to the **Paste** tab.
       * Paste your Bright Data details in the format:\
         `[HOST]:[PORT]:[USERNAME]:[PASSWORD]`
       * Click **Accept** to save your proxy settings.

    <Note>
      For country-specific proxies, adjust the username format to `your-username-country-XX` (e.g., `your-username-country-US`) to use a specific exit node.
    </Note>
  </Step>
</Steps>

By integrating **Bright Data** with **OpenBullet**, you enhance your workflows with secure and anonymous connections. Whether automating tasks, testing applications, or scraping data, Bright Data ensures reliable performance and privacy.


# How to Set Up Bright Data With ParseHub
Source: https://docs.brightdata.com/integrations/parsehub

Integrating Bright Data proxies with ParseHub enhances your web scraping by providing secure, anonymous access and reducing the risk of detection and IP bans.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 over 72 million IPs across various locations, 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 caption="Proxy management interface with active proxies and Add button">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-add-zone-2.png?maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=e865d5347223966db43a431c475554d2" alt="ph-add-zone-2.png" width="1000" height="324" data-path="images/integrations/ph-add-zone-2.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-add-zone-2.png?w=280&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=72c6a2160f1e78e280ea1a6e9912d31f 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-add-zone-2.png?w=560&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=9248b3af7be976888de90df24ff2a34b 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-add-zone-2.png?w=840&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=1adf8843946853a910ae2c1cd72cb302 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-add-zone-2.png?w=1100&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d2ea222f862d144b901a5429a6cc830a 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-add-zone-2.png?w=1650&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6f6132f3e8b4fa1fa63d9569bfc9937d 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-add-zone-2.png?w=2500&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f128947235c80f94b06f7e7f5f91966a 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Select proxy type">
    In this example, we will show how to set up ISP proxies.

    <Frame caption="Proxy and scraping infrastructure dashboard with various options displayed">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-types.png?maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=7dca81f5312f83907ad43dd368883e2c" alt="ph-proxy-types.png" width="500" height="257" data-path="images/integrations/ph-proxy-types.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-types.png?w=280&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=0fc57f3b53b8cb06fd086727d9dccd86 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-types.png?w=560&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=80bf74af73757d43248d18616de16b9e 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-types.png?w=840&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=9303b3ed0947784c24be746cab9f62e5 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-types.png?w=1100&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=10cd3f0043aaf8d2e3f5e9762f6c879a 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-types.png?w=1650&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f1c82c3b8a7c92a400ba3fc93c2c6fb8 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-types.png?w=2500&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=6389d5eee629d869aca4dc238d6d704f 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Name proxy solution">
    <Frame caption="Form to choose IP type, showing Dedicated option selected">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-select-ip-type.png?maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=46b4e1e1ce7fe6a1fdd57290700a340e" alt="ph-select-ip-type.png" width="1000" height="333" data-path="images/integrations/ph-select-ip-type.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-select-ip-type.png?w=280&maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=43b19590b3f49ef08acd80917fc5b67a 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-select-ip-type.png?w=560&maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=4198f37c09067caaf9159b1efc388b50 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-select-ip-type.png?w=840&maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=83f0c8e7bb38394cb976b7cf69afd7cf 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-select-ip-type.png?w=1100&maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=3b63d8447683f45007abe8de6fce4e7c 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-select-ip-type.png?w=1650&maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f4c74b52facd41312116a4cfa9a9e82a 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-select-ip-type.png?w=2500&maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=d51537fb6cd44530d673cec42d4e04a4 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Select IP count">
    Fill in the number of IPs you need.

    <Frame>
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-number-of-ips-1.png?maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f0c036e720da6d625b1bda23cebbd790" alt="ph-number-of-ips-1.png" width="1000" height="164" data-path="images/integrations/ph-number-of-ips-1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-number-of-ips-1.png?w=280&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4d4f626ae1d2524527f96f77203a0be0 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-number-of-ips-1.png?w=560&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2d6a7a26d3ab926eb47dc44108f6cb17 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-number-of-ips-1.png?w=840&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=99a44275b1e1550c8df2339c02b4f572 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-number-of-ips-1.png?w=1100&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6b5fb03ed0d5ca9966eb0739fc1007bf 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-number-of-ips-1.png?w=1650&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4178de681e64fdd154c388211ce27d84 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-number-of-ips-1.png?w=2500&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6c3c0aec63318ff7de8cf1af20a55f66 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Country & city selection">
    Choose your desired country and city for the IP location.

    <Frame caption="Geolocation targeting options for United States and New York City">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-city-ip.png?maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c149141b955856b7fe6087c9df32684b" alt="ph-city-ip.png" width="1000" height="197" data-path="images/integrations/ph-city-ip.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-city-ip.png?w=280&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4b05ea0fd42f3e3aba6eaad6e9e8fae5 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-city-ip.png?w=560&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6bbee0ebfb0b6e1a9c8fc36a11d22752 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-city-ip.png?w=840&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ab1efe2db4313e373ece9461aa093c42 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-city-ip.png?w=1100&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=7e06daeee9d42c2c8c78ee22549edff2 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-city-ip.png?w=1650&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=efbc23993271e10874e5dfcbd8a6bab8 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-city-ip.png?w=2500&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=9934bf090af78fce1dbeb23fd9ef999d 2500w" data-optimize="true" data-opv="2" />
    </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 src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-domains.png?maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=18f9e64b5b0017a645cb84bbc54b59ee" alt="ph-domains.png" width="1000" height="178" data-path="images/integrations/ph-domains.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-domains.png?w=280&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ff3f5f2f683ce380b63f15a1b93febc9 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-domains.png?w=560&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=37c8fbeb8a6ed0cdfb3e7cfb2b66e077 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-domains.png?w=840&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5a383c550b1176a228b8ca9a9961eeb3 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-domains.png?w=1100&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=503484a1f9ff30ab9609814f5ede38da 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-domains.png?w=1650&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b1cbf188029e85c72f58ce94e991931d 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-domains.png?w=2500&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=db46e9c512778daf64c665743f1ca3fe 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Add zone">
    Click the “**Add**” button to create the Zone.

    <Frame>
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-click-add.png?maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=03cd2d1885ebf785e9bcb89e1a83f18e" alt="ph-click-add.png" width="1000" height="288" data-path="images/integrations/ph-click-add.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-click-add.png?w=280&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=355b8965a287f5270f16a7a4a697f06e 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-click-add.png?w=560&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=38a3cef105cc55fa248b9294bebf5a8b 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-click-add.png?w=840&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c9d6ff125f1aaed720b0a8d3cb46be7d 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-click-add.png?w=1100&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=a84265f70f84fde3452afd422daf6ee2 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-click-add.png?w=1650&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=9e03174918fefa5003ddc26ae2508c9e 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-click-add.png?w=2500&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d21d8926a37ab17be1009b10ec42d724 2500w" data-optimize="true" data-opv="2" />
    </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 caption="Proxy service access parameters screen with host and username">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-parameters.png?maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ccb8c0133be1731d42667dcea8e3c36c" alt="ph-access-parameters.png" width="1000" height="625" data-path="images/integrations/ph-access-parameters.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-parameters.png?w=280&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=084a1563e1c6533cdd7b3ec62153780b 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-parameters.png?w=560&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=96831236660bc9116c42351a327ef193 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-parameters.png?w=840&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=eb63f6f07b46338211359499ac8b671f 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-parameters.png?w=1100&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c52dcda3674bb84c7a45d5ce5c782ec7 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-parameters.png?w=1650&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=35ca51db05d3fd3c0dfa7318137e3e2e 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-parameters.png?w=2500&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=cb6e0763c1df099fe8dd693635cf0e58 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    1. host: brd.superproxy.io
    2. port: 33335
    3. username: `your-zone-username`
    4. password: `your-zone-password`
  </Step>

  <Step title="Download and Install ParseHub">
    <Frame caption="ParseHub download options: Mac, Windows, Linux">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-parsehub.png?maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=11b9881a3dc14aed4f37e10196da73d6" alt="ph-parsehub.png" width="512" height="320" data-path="images/integrations/ph-parsehub.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-parsehub.png?w=280&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=9e3e36146d9bf9bbad4496e861c069ed 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-parsehub.png?w=560&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=eb486294d04f7888fc41ed79e67ca3c8 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-parsehub.png?w=840&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=668c02242a6364fcc565c7051b81a03e 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-parsehub.png?w=1100&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=81eaea561320394d5a691a2c19ae6c81 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-parsehub.png?w=1650&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=2c78c16bde042145e3a7a06977fb09f8 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-parsehub.png?w=2500&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=cde498112d5e7ff65a988317f6b15921 2500w" data-optimize="true" data-opv="2" />
    </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 caption="Dashboard with project creation and tutorials screen">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-create-a-new-project.png?maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c9162e6f709c5234936ed43d00626402" alt="ph-create-a-new-project.png" width="512" height="280" data-path="images/integrations/ph-create-a-new-project.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-create-a-new-project.png?w=280&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=a24fcb6a2f12c1408918926f3dcc2ce3 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-create-a-new-project.png?w=560&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=2e10c6c1397d66fccdce7fb4c36f7bb4 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-create-a-new-project.png?w=840&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=dff442a7c3be3158dab4fffde1b7ae66 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-create-a-new-project.png?w=1100&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=bfbbd8177c4b2010323833630bd50345 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-create-a-new-project.png?w=1650&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=a963f9af99a60fe2a41792e16579d9e1 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-create-a-new-project.png?w=2500&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ea316f62eedf64cb1fbcf460a6063181 2500w" data-optimize="true" data-opv="2" />
    </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 caption="Web scraping tool interface with tutorials and instructions">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-start-new-project.png?maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=b330e93a2137d7c68634436d9fd3016e" alt="ph-start-new-project.png" width="512" height="280" data-path="images/integrations/ph-start-new-project.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-start-new-project.png?w=280&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=55ca046cdd6086a53a1b4acd6625f250 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-start-new-project.png?w=560&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8a00b920e16043be391b45a76a07a8e2 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-start-new-project.png?w=840&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=0234833894a868994e5e75a2aac819b3 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-start-new-project.png?w=1100&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f8ef0c34edb334036db7b4771b6e004d 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-start-new-project.png?w=1650&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=da3173688c2bd366d93bb9e8efee8c6b 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-start-new-project.png?w=2500&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=7356f93338f5553944ed02d7eb392286 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Navigate to Proxy Configuration in ParseHub">
    Switch to the Browser mode, slider turns green to indicate browsing mode.

    <Frame caption="Instagram login page with an image preview displayed">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-broswer-mode.png?maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=aa588e32c516dd48f2cf823e441fc6c2" alt="ph-broswer-mode.png" width="512" height="280" data-path="images/integrations/ph-broswer-mode.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-broswer-mode.png?w=280&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=02404458d7928ab32dd9c66fa7b0ce4b 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-broswer-mode.png?w=560&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=cef322e7cc9e8c7c95098572d7c453f0 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-broswer-mode.png?w=840&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5348bd9cd30c8294f603fbf6a403ea18 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-broswer-mode.png?w=1100&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=89c90a42e8d55da315a5748222279978 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-broswer-mode.png?w=1650&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=a3a0e7a33fd3c16a0a2e3d86b1db9da2 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-broswer-mode.png?w=2500&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=eb4468264424d2f7dc1d70bf41f6a7f5 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Settings">
    Open the settings located at the top-right side of the Browser interface and click on “options”.

    <Frame caption="Instagram webpage with phone screen simulation tool">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-open-settings.png?maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=355ebefafb2cc9dab985729b2a9ed182" alt="ph-open-settings.png" width="512" height="280" data-path="images/integrations/ph-open-settings.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-open-settings.png?w=280&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=551b469cfeae540327e70fdd3d7a55a9 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-open-settings.png?w=560&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8aff1c454560a0f67ccfa56fad9cad78 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-open-settings.png?w=840&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=5260f87283fa52228b7b043243328b4e 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-open-settings.png?w=1100&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=76bac72b5d8104d168fb44fb552d3c65 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-open-settings.png?w=1650&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=cf433383bdfb217eb5d1bf840b3eab94 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-open-settings.png?w=2500&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=e6d6e239d0f2f91e2a3366e0c66b0863 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Access Advanced Network Settings">
    Select the “Advanced” tab.

    <Frame>
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-advanced-network-settings.png?maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=eb4af16d32a5176dbdafcce5fe21db27" alt="ph-advanced-network-settings.png" width="512" height="280" data-path="images/integrations/ph-advanced-network-settings.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-advanced-network-settings.png?w=280&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=e88b0b5f43e7da21d459c3a9cee296eb 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-advanced-network-settings.png?w=560&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=9a004734ec38828e9e3d1c2bda776506 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-advanced-network-settings.png?w=840&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=39439cd7887c3b9a6ebdcfa53868fcec 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-advanced-network-settings.png?w=1100&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=a2d790d39bbfcbbf9ea0b188c9205292 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-advanced-network-settings.png?w=1650&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8a20c8ea968f7aac2bef352f3612624a 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-advanced-network-settings.png?w=2500&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=db36177930c1714615299288c0bdd5e1 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Click on the “Network” tab">
    Under “Connection” choose “Settings”.

    <Frame caption="Browser settings and error messages shown">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-connection-settings.png?maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ab1a9bd238201f92798760ef4318c1cd" alt="ph-connection-settings.png" width="512" height="280" data-path="images/integrations/ph-connection-settings.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-connection-settings.png?w=280&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=0caecea82919b2ee5c00bfa0f3e37052 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-connection-settings.png?w=560&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=1bb8880950d5715ace7c7b24a7cf6029 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-connection-settings.png?w=840&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=5515bac98068f0a4086edda11b094208 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-connection-settings.png?w=1100&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=1301bbfdd3406d491e71637d8d7efc34 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-connection-settings.png?w=1650&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=65b9a3e5c2a39d716a7e3a0f24fc5e43 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-connection-settings.png?w=2500&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6b2214ef564a47a403437ed20c309a2c 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Configure Manual Proxy Settings">
    In the network settings, select “Manual proxy configuration”.

    <Frame caption="Configuring manual proxy settings in browser options">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-configure-manual-settings.png?maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b90bdeac34f3931759373ff64cf27745" alt="ph-configure-manual-settings.png" width="512" height="280" data-path="images/integrations/ph-configure-manual-settings.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-configure-manual-settings.png?w=280&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=aef3a7af5c9317142c73ef8e9febfe45 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-configure-manual-settings.png?w=560&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ba30f02fad74c8ed9202ba3e02679f60 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-configure-manual-settings.png?w=840&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=15674a55f2329d66621602858eb0396b 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-configure-manual-settings.png?w=1100&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=8d4b3cb882c28c444fa42679631b4450 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-configure-manual-settings.png?w=1650&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=108a6d938a3d601bfbfe81207d463f23 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-configure-manual-settings.png?w=2500&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b8b8bf44acd17b738ef7a3c1801ffbee 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Proxy settings">
    Under HTTP Proxy field enter the Bright Data proxy URL **brd.superproxy.io** and port as **33335**.

    <Frame caption="Proxy configuration settings in a browser window screenshot">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-and-port.png?maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=ecd83aff8ceadd658221856fd38bd30d" alt="ph-proxy-and-port.png" width="512" height="280" data-path="images/integrations/ph-proxy-and-port.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-and-port.png?w=280&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=80b288264ee7ce25c765803feed36ca6 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-and-port.png?w=560&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=66d17953565e789270cdffd7881a9b83 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-and-port.png?w=840&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=555ff3d765da1504edf9b76c62d6612f 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-and-port.png?w=1100&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8e2b091625f62c9b7550e18fad2b19f0 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-and-port.png?w=1650&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=c055e5016fa96efb99f3e45c7d8a9fca 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-proxy-and-port.png?w=2500&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=65182a62d6f7e8d69769cbbeb1a799e9 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Switch to SOCKS v4 and click ok">
    After you switched to the SOCKS v4, click the ‘OK’ button.

    <Frame caption="Configuring proxy settings in the browser options window">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-switch-to-socks.png?maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=42ad62ba3fcd311c8dad5505e04fc18a" alt="ph-switch-to-socks.png" width="512" height="280" data-path="images/integrations/ph-switch-to-socks.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-switch-to-socks.png?w=280&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=d0d9f4bdc2f66ee6806111976373cc53 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-switch-to-socks.png?w=560&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=59c8bfa015c4b87488c656fc1645a142 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-switch-to-socks.png?w=840&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=19027b0bdec6efc1c0725093d9a399b4 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-switch-to-socks.png?w=1100&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=ba9da3d46d2208fc90953f92e6e3e5c2 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-switch-to-socks.png?w=1650&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=20040404b7161a091c1bbaeccf3def46 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-switch-to-socks.png?w=2500&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=ef6356ae248a1ff83df6fc62f2a6e94b 2500w" data-optimize="true" data-opv="2" />
    </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 caption="Password authentication popup window on a computer screen">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-param-parsehub.png?maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c65c26905c8f562c33f1ac5193b0a046" alt="ph-access-param-parsehub.png" width="512" height="274" data-path="images/integrations/ph-access-param-parsehub.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-param-parsehub.png?w=280&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=4ca6a1b3d94851c238ef23a28183d64b 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-param-parsehub.png?w=560&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=03a9454c8809e06c11ee92a2183436e4 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-param-parsehub.png?w=840&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f1a08ed03dc03d9f27243c1483e5b026 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-param-parsehub.png?w=1100&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=b0f41e83478094d69b45d613410da2a7 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-param-parsehub.png?w=1650&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=51ba33e6f48ec21b7966c94c710772ad 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-access-param-parsehub.png?w=2500&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=43acca334e608abe0085d8fd6d32d972 2500w" data-optimize="true" data-opv="2" />
    </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:33335:brd-customer-hl_******-zone-isp_proxy6:b1s*****:Luminati`

    Apply Configured Proxy to ParseHub Project:

    * Navigate to your project settings in ParseHub.

    <Frame caption="Instagram webpage with settings menu open">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-project-settings.png?maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=75ab9a57fe2642e2c29e8758da4f46ed" alt="ph-project-settings.png" width="512" height="280" data-path="images/integrations/ph-project-settings.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-project-settings.png?w=280&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=bbb7702c34b28c6991ec28d1f7b6af7f 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-project-settings.png?w=560&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=6e69cc49243890b56b981db72bc00483 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-project-settings.png?w=840&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=cbf89b2916ce5829047ba1ccbbedbc00 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-project-settings.png?w=1100&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=756153f807c31d43b716bfe379d47806 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-project-settings.png?w=1650&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=746fdab9aa36f8898acb4d836f2c2712 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-project-settings.png?w=2500&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=a6930f9db76b6755814c99ef40547479 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Enable Custom Proxies">
    Check “Rotate IP Addresses” to enable the “Custom Proxy” text box.

    <Frame caption="Instagram scraping tool interface for data extraction">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies.png?maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=a0732c1c58e5482c241003cff60dcd57" alt="ph-custom-proxies.png" width="512" height="280" data-path="images/integrations/ph-custom-proxies.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies.png?w=280&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=63045677140b2533e742421515575d08 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies.png?w=560&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f8330e65f13db643dbd9491ac39dac20 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies.png?w=840&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d3782bf2ea050d44b15b8256a67e4b05 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies.png?w=1100&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=73766e62a83e734e452ee93a7ead3e25 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies.png?w=1650&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=3ae6395ba7f1a9af79dbb11a5fb5756b 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies.png?w=2500&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6497605fd376daff5af9f57d9da697d8 2500w" data-optimize="true" data-opv="2" />
    </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 caption="Instagram interface showing user conversation and login page">
            <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies-field.png?maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=aa9441b332c503202854380702133e08" alt="ph-custom-proxies-field.png" width="512" height="280" data-path="images/integrations/ph-custom-proxies-field.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies-field.png?w=280&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=46633c11acf3eb0972dc84b62f0b1624 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies-field.png?w=560&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d0ffb87cc964ce0b1721dcdb4348abd6 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies-field.png?w=840&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=00bc0f27860e42386c9645e80ef9987c 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies-field.png?w=1100&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=9fb836aa43264e8213cf0142204cc8e5 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies-field.png?w=1650&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=f972a437832132123f750f18438cc941 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ph-custom-proxies-field.png?w=2500&maxW=512&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=1c96a67b498ded9953f37184f23ec219 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Save your project settings">
    After saving, run it with your Bright Data Proxies.

    <Frame caption="Instagram login page with phone message interface">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-save-project.png?maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=26695c85722f965971a97dc7a6f0831e" alt="ph-save-project.png" width="512" height="280" data-path="images/integrations/ph-save-project.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-save-project.png?w=280&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=118c43e2b37cf2f7820d26c8fdcae11c 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-save-project.png?w=560&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=e4b69bf8d95a29c44ed547578d1f8b80 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-save-project.png?w=840&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=dd66d04eb0ae09cc61bf43ed5ef12393 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-save-project.png?w=1100&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=6578d94569e13b8d1d74dd42c1da88ab 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-save-project.png?w=1650&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=3ceb8e1d37ac563862281dc294537fc3 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/ph-save-project.png?w=2500&maxW=512&auto=format&n=lafG1dG0XmKZiP70&q=85&s=4d23ac963999241b9d8463e05827168c 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>
</Steps>

<Warning>
  **Important note**:

  If you are using Bright Data’s Residential Proxies, 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](https://docs.brightdata.com/general/account/ssl-certificate#installation-of-the-ssl-certificate) for instructions.
</Warning>


# How to Set Up Bright Data With PhantomBuster
Source: https://docs.brightdata.com/integrations/phantombuster

Ready to elevate your automation workflows? Connect Bright Data to PhantomBuster for a smoother, safer, and more productive data-gathering experience. With your online footprint masked and performance boosted, you can focus on meaningful insights instead of technical hurdles.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 platform that turns tedious online chores into efficient, automated processes. Instead of handling repetitive tasks or struggling to access the data you need, it quietly tackles the heavy lifting in the background. This frees you to concentrate on exploring opportunities, reaching new audiences, and driving measurable outcomes.

<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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</Tip>

## How to Integrate Bright Data With PhantomBuster

Integrating Bright Data proxies into PhantomBuster helps you maintain anonymity, reduce the risk of blocks, and streamline your entire operation. Just follow the steps below:

<Steps>
  <Step title="Open the Proxies Settings">
    After logging in to your [PhantomBuster account](https://phantombuster.com/), head to the **Proxies** settings page. This is where you’ll configure your connections to keep your automation secure and private.

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster1.png?maxW=187&auto=format&n=lafG1dG0XmKZiP70&q=85&s=be681b19bdc29590bd7fd21bfc82a1e3" alt="" width="187" height="381" data-path="images/integrations/phantombuster1.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster1.png?w=280&maxW=187&auto=format&n=lafG1dG0XmKZiP70&q=85&s=28096c47fb38aaf70b9ccdd208b8ae36 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster1.png?w=560&maxW=187&auto=format&n=lafG1dG0XmKZiP70&q=85&s=37fc99a2e1c47d6856018b889664dadf 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster1.png?w=840&maxW=187&auto=format&n=lafG1dG0XmKZiP70&q=85&s=6a34a266f0c56cd6afabd99504b01f67 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster1.png?w=1100&maxW=187&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8eb6b10ac8c939c696e9e0213df9f5f6 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster1.png?w=1650&maxW=187&auto=format&n=lafG1dG0XmKZiP70&q=85&s=42bfb2eaeedded391c5edb0bf42aea54 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster1.png?w=2500&maxW=187&auto=format&n=lafG1dG0XmKZiP70&q=85&s=261f9455a2ec42019405d803cd53f23a 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Create a New Proxy Pool">
    Click **"New proxy pool"** to create a dedicated collection of Bright Data proxies. Think of it as a safe repository for managing your proxy resources.

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster2.png?maxW=926&auto=format&n=lafG1dG0XmKZiP70&q=85&s=50e7d8dec4d46af3140b99a282533800" alt="" width="926" height="569" data-path="images/integrations/phantombuster2.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster2.png?w=280&maxW=926&auto=format&n=lafG1dG0XmKZiP70&q=85&s=fe3fd59642161a782d7e5e6b2086d739 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster2.png?w=560&maxW=926&auto=format&n=lafG1dG0XmKZiP70&q=85&s=cbf36ff5711635172f13bd2a8f94c92a 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster2.png?w=840&maxW=926&auto=format&n=lafG1dG0XmKZiP70&q=85&s=300a9859743475dd1194afa88762acd6 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster2.png?w=1100&maxW=926&auto=format&n=lafG1dG0XmKZiP70&q=85&s=bcf454585088285aa5efe29814ddd334 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster2.png?w=1650&maxW=926&auto=format&n=lafG1dG0XmKZiP70&q=85&s=99afca12ce2a9a67f5520f36575a71a3 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster2.png?w=2500&maxW=926&auto=format&n=lafG1dG0XmKZiP70&q=85&s=18fd85ea12ad455b387c24acb254d692 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Name Your Proxy Pool">
    Give your proxy pool a clear, memorable name. That way, when you’re juggling multiple projects or tasks, you’ll instantly know which pool to use for each situation.

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster3.png?maxW=532&auto=format&n=lafG1dG0XmKZiP70&q=85&s=dcf77dbd6a3d42ead44d4ee0811138f6" alt="" width="532" height="246" data-path="images/integrations/phantombuster3.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster3.png?w=280&maxW=532&auto=format&n=lafG1dG0XmKZiP70&q=85&s=ec98c5370cbb534f3df41bb1c88fe7b1 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster3.png?w=560&maxW=532&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8d4466904bc0b27e726f113b478fa882 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster3.png?w=840&maxW=532&auto=format&n=lafG1dG0XmKZiP70&q=85&s=27d2689c3468be9a02b4cad0a4adefc3 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster3.png?w=1100&maxW=532&auto=format&n=lafG1dG0XmKZiP70&q=85&s=50451891dd14d6085dab36343a039456 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster3.png?w=1650&maxW=532&auto=format&n=lafG1dG0XmKZiP70&q=85&s=e422469eaeb2458c20c3190b6b8b771d 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster3.png?w=2500&maxW=532&auto=format&n=lafG1dG0XmKZiP70&q=85&s=0431694aa29768eb5ef11b0198e0f61f 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Add Your Bright Data Proxy Details">
    Enter your Bright Data proxy credentials in the format below:
    `host:port:username:password`

    You can find these details in your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).
    After entering them, click **"Add proxy"** to finalize the addition. Your new proxy pool now stands ready as your digital shield.

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster4.png?maxW=1583&auto=format&n=lafG1dG0XmKZiP70&q=85&s=c60be40bd19f4c0263a06ff7283bba96" alt="" width="1583" height="373" data-path="images/integrations/phantombuster4.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster4.png?w=280&maxW=1583&auto=format&n=lafG1dG0XmKZiP70&q=85&s=a0cac4de477e8fd12c668be9785a6eb0 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster4.png?w=560&maxW=1583&auto=format&n=lafG1dG0XmKZiP70&q=85&s=0057bc6ba14f6b44fece599a3ddff849 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster4.png?w=840&maxW=1583&auto=format&n=lafG1dG0XmKZiP70&q=85&s=bc3f3b1b13f144ad7da7dc9e967121ae 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster4.png?w=1100&maxW=1583&auto=format&n=lafG1dG0XmKZiP70&q=85&s=6ab2c626fd8764ca3e79ca2a7e15bc5f 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster4.png?w=1650&maxW=1583&auto=format&n=lafG1dG0XmKZiP70&q=85&s=53bba5679fadb3cd4231c5af195de542 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster4.png?w=2500&maxW=1583&auto=format&n=lafG1dG0XmKZiP70&q=85&s=a5ad3123d83729c238c1fe9f5ef55ea8 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Adjust Advanced Settings in Your Phantom">
    When setting up your Phantom (a PhantomBuster workflow), open the **Advanced settings** to select the proxy pool you created.

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster5.png?maxW=442&auto=format&n=lafG1dG0XmKZiP70&q=85&s=2cf7be7e4dc6cd158939b9be607d2b19" alt="" width="442" height="303" data-path="images/integrations/phantombuster5.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster5.png?w=280&maxW=442&auto=format&n=lafG1dG0XmKZiP70&q=85&s=b1fe2bd5c0e272f2566182df5964841b 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster5.png?w=560&maxW=442&auto=format&n=lafG1dG0XmKZiP70&q=85&s=2cd07aa39d456641a8f948e994df1293 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster5.png?w=840&maxW=442&auto=format&n=lafG1dG0XmKZiP70&q=85&s=e48fd90540df6d0d610cf883c1927ab4 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster5.png?w=1100&maxW=442&auto=format&n=lafG1dG0XmKZiP70&q=85&s=108071b363b766579a4340427555cf19 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster5.png?w=1650&maxW=442&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8344314b47ec77040ddb36792b6b6cd5 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster5.png?w=2500&maxW=442&auto=format&n=lafG1dG0XmKZiP70&q=85&s=b2b5b6257f54a2d06b198ee79a2c196c 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Apply the Proxy Pool">
    In the **Advanced settings**, select the proxy pool you just configured.
    Confirm your changes by clicking **"Save settings"**.
    From now on, your Phantom will operate under the secure and private umbrella of your Bright Data proxies.

    <Frame as="div">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster6.png?maxW=742&auto=format&n=lafG1dG0XmKZiP70&q=85&s=d0b04c7f17fda1f2c43aac458f1174ad" alt="" width="742" height="530" data-path="images/integrations/phantombuster6.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster6.png?w=280&maxW=742&auto=format&n=lafG1dG0XmKZiP70&q=85&s=c641f4c2bc64138f06fdc545c668809d 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster6.png?w=560&maxW=742&auto=format&n=lafG1dG0XmKZiP70&q=85&s=45cadf135a4244ff690ae2e83c226716 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster6.png?w=840&maxW=742&auto=format&n=lafG1dG0XmKZiP70&q=85&s=4419e6534c2b653f8c604a96a57f49bc 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster6.png?w=1100&maxW=742&auto=format&n=lafG1dG0XmKZiP70&q=85&s=88bf28a594fe98a07903488dc53dc37b 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster6.png?w=1650&maxW=742&auto=format&n=lafG1dG0XmKZiP70&q=85&s=3e9733c1c844e6f676f6dad49424c12e 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/phantombuster6.png?w=2500&maxW=742&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8cba1b5cda08d18c1271c7d743e87c02 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>
</Steps>

**Congratulations—your Bright Data proxies are now seamlessly integrated with PhantomBuster!**\
This means you can run your automation with greater peace of mind: your identity stays hidden, the chances of blocks drop, and your data collection becomes more efficient. Embrace the freedom to explore, innovate, and achieve results without getting tangled in technical complications.


# How to Set Up Bright Data With Pica
Source: https://docs.brightdata.com/integrations/pica



[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:

* **Web Scraper API**: Automate web data extraction with Bright Data's powerful Web Scraper API.
* **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](https://docs.brightdata.com/general/account/api-token#generate-a-new-api-key-from-the-settings-page) 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
    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 Web Scraper API endpoint using Pica With LangChain
      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 Unlocker API through Pica & LangChain
      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

Streamline your web automation with Bright Data and Playwright. This guide shows you how to configure secure, anonymous proxies that reduce detection risks and keep your tasks running smoothly.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 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](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)

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access)

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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:

```bash
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**: `33335`
* **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](https://docs.brightdata.com/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 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](https://docs.brightdata.com/integrations/playwright#expand-to-get-your-bright-data-proxy-access-information).

### Example Code

Use this example to get started:

```javascript
const { chromium } = require('playwright');

(async () => {
  // Launch browser with proxy settings
  const browser = await chromium.launch({
    headless: false,  // Set to true for headless mode
    proxy: {
      server: 'http://[HOST]:[PORT]',  // Replace with your proxy host and port
      username: '[USERNAME]',        // Replace with your proxy username
      password: '[PASSWORD]'         // Replace with your proxy password
    }
  });

  const context = await browser.newContext();
  const page = await context.newPage();

  // Test the proxy by visiting an IP verification website
  await page.goto('http://httpbin.org/ip');
  // Capture a screenshot to verify the setup
  await page.screenshot({ path: 'example.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 Postern
Source: https://docs.brightdata.com/integrations/postern

Integrate Bright Data with Postern to manage your proxy configurations effortlessly. Follow this guide to securely configure proxies for efficient and uninterrupted browsing.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 as="div" style={{width:"50%", height:"auto"}}>
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern1.jpg?maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=9da3305fbefc6c9841eec2d6e9416d24" alt="" width="1080" height="583" data-path="images/integrations/postern1.jpg" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern1.jpg?w=280&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=06057deeb2a9ff44ccdd22cb2d38a84e 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern1.jpg?w=560&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f549e9278d3a17aecccc494660866e56 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern1.jpg?w=840&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=739a32d81097f02b8d7ff06c155cb09b 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern1.jpg?w=1100&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=9ef39dd2bd91caf5ba0b571e2f9a300c 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern1.jpg?w=1650&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f5eaebdeea159a93a253f906e2f8a7a0 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern1.jpg?w=2500&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=35304ff767d296934b8ebdd114e89d91 2500w" data-optimize="true" data-opv="2" />
    </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 as="div" style={{width:"50%", height:"auto"}}>
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern2.jpg?maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=c5d2d14c1976605b9c31c55b79bd8a5c" alt="" width="1080" height="1378" data-path="images/integrations/postern2.jpg" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern2.jpg?w=280&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=2da1a7525f1a1087b1a6639f4e1d62fb 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern2.jpg?w=560&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=1dd179718fb944d723de086488ead579 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern2.jpg?w=840&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=73ceb1c37b0b157730a22ece208f598e 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern2.jpg?w=1100&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=14a46899e9bb0bd2c8e698f815409bf7 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern2.jpg?w=1650&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=ec28857db82fbe80b06883ff9084beb5 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern2.jpg?w=2500&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=464ec3d5c7b89f68726acf1fbff5ccd0 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    2. Tap **Add Rule** to create a new rule for your proxy.

    <Frame as="div" style={{width:"50%", height:"auto"}}>
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern3.jpg?maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=57cc8035c96ed8a527c9bf203e9c8588" alt="" width="1080" height="735" data-path="images/integrations/postern3.jpg" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern3.jpg?w=280&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=da16d8d68ab8154f6b1a534b32baab36 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern3.jpg?w=560&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=28535dc328ee5b01f1e45434e54f16fa 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern3.jpg?w=840&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=a363ee0b6428367b9425ac97901a034f 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern3.jpg?w=1100&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=910abba5062ebae5c8fd1b49066ae615 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern3.jpg?w=1650&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8fa46bd7c9ee6342cde65fcc1c4fc03a 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern3.jpg?w=2500&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=6e3619690cc30f30453dd92b915b0c4a 2500w" data-optimize="true" data-opv="2" />
    </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 as="div" style={{width:"50%", height:"auto"}}>
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern4.jpg?maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=ba7b0c0e62bbebdc7448aa66dd610cee" alt="" width="1080" height="1412" data-path="images/integrations/postern4.jpg" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern4.jpg?w=280&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=148058fd40a0caade30aa4faab87d3f4 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern4.jpg?w=560&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=4b82bb87df567fea63ba48463844be25 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern4.jpg?w=840&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=e9b046b33f3d8acd3f46fb33c849a4d3 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern4.jpg?w=1100&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=978ccf1363668523b27e937de509ab25 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern4.jpg?w=1650&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=57e69c9225a02aaaecda2dab7a875ac6 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postern4.jpg?w=2500&maxW=1080&auto=format&n=lafG1dG0XmKZiP70&q=85&s=1bb80c268f11476f428fc657ecdb27fe 2500w" data-optimize="true" data-opv="2" />
    </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

Streamline your API testing with Bright Data in Postman. This guide shows you how to configure proxies for secure, anonymous, and geo-targeted API requests.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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" stepNumber="0">
    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 as="div">
            <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postman1.png?maxW=1920&auto=format&n=lafG1dG0XmKZiP70&q=85&s=c6d25624f548517665d9e91264ba0b38" alt="" width="1920" height="1020" data-path="images/integrations/postman1.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postman1.png?w=280&maxW=1920&auto=format&n=lafG1dG0XmKZiP70&q=85&s=010260d82e0f3abc51b36e1afb753079 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postman1.png?w=560&maxW=1920&auto=format&n=lafG1dG0XmKZiP70&q=85&s=c67435f8ed36851987905b91221a3491 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postman1.png?w=840&maxW=1920&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8afff3450ebcfaa554164303a7e05ce3 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postman1.png?w=1100&maxW=1920&auto=format&n=lafG1dG0XmKZiP70&q=85&s=0fd950a3f8b2cd1267d86658dc2e333f 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postman1.png?w=1650&maxW=1920&auto=format&n=lafG1dG0XmKZiP70&q=85&s=30847d3a98921c7c4b13b7b998a94a80 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/postman1.png?w=2500&maxW=1920&auto=format&n=lafG1dG0XmKZiP70&q=85&s=30aa6a16efeab442c9b52b5e4670b5f6 2500w" data-optimize="true" data-opv="2" />
    </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!


# How to Configure Bright Data With Proxifier
Source: https://docs.brightdata.com/integrations/proxifier

Streamline your network management with Proxifier! By integrating Bright Data, you can securely route traffic from applications that lack native proxy support. With Proxifier's flexible rule-based system, you can customize traffic routing and enjoy seamless, anonymous browsing.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 as="div">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier1.png?maxW=1270&auto=format&n=lafG1dG0XmKZiP70&q=85&s=b9ddfb30aa8f0dfe3365a0b4cdb88910" alt="" width="1270" height="530" data-path="images/integrations/proxifier1.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier1.png?w=280&maxW=1270&auto=format&n=lafG1dG0XmKZiP70&q=85&s=b2d868d42cb0aae70a46b161221a27ba 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier1.png?w=560&maxW=1270&auto=format&n=lafG1dG0XmKZiP70&q=85&s=aa4c454ab2df7eb13846c1e38e7d7249 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier1.png?w=840&maxW=1270&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f12f6f7480331a4b7fed1827885d74c1 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier1.png?w=1100&maxW=1270&auto=format&n=lafG1dG0XmKZiP70&q=85&s=b7caf36a591d859a2b22fc30ca9490d9 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier1.png?w=1650&maxW=1270&auto=format&n=lafG1dG0XmKZiP70&q=85&s=5a6722c7d45465610b490d6f321f2d93 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier1.png?w=2500&maxW=1270&auto=format&n=lafG1dG0XmKZiP70&q=85&s=5e863bf02c26dcd5e7a6f82438a30e26 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 3. Add Your Bright Data Proxy**

1\. Click the **Add** button to configure a new proxy.

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier2.png?maxW=445&auto=format&n=lafG1dG0XmKZiP70&q=85&s=1368e13f16849c1de70e342cd43f83c2" alt="" width="445" height="289" data-path="images/integrations/proxifier2.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier2.png?w=280&maxW=445&auto=format&n=lafG1dG0XmKZiP70&q=85&s=0f4bdeb0b6c276fdc89d236eb857f5da 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier2.png?w=560&maxW=445&auto=format&n=lafG1dG0XmKZiP70&q=85&s=99b572f991864caa4b9097595593a300 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier2.png?w=840&maxW=445&auto=format&n=lafG1dG0XmKZiP70&q=85&s=0739b5a6159866aadcf23a4f8171c87d 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier2.png?w=1100&maxW=445&auto=format&n=lafG1dG0XmKZiP70&q=85&s=0ba306b5e736e82dfb1c546b413e6ef8 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier2.png?w=1650&maxW=445&auto=format&n=lafG1dG0XmKZiP70&q=85&s=7850419a11fdeb9d8e6132b5e43df302 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier2.png?w=2500&maxW=445&auto=format&n=lafG1dG0XmKZiP70&q=85&s=7a6f8bad6413b171ed2e5ccfd9a8c577 2500w" data-optimize="true" data-opv="2" />
</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 as="div">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier3.png?maxW=446&auto=format&n=lafG1dG0XmKZiP70&q=85&s=979386361585e34a48b7e637ecd2c7a5" alt="" width="446" height="288" data-path="images/integrations/proxifier3.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier3.png?w=280&maxW=446&auto=format&n=lafG1dG0XmKZiP70&q=85&s=4349a467a20887ba3f2e4fa56f7952b8 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier3.png?w=560&maxW=446&auto=format&n=lafG1dG0XmKZiP70&q=85&s=df31dc3cd91ad81f7980824e79c396b4 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier3.png?w=840&maxW=446&auto=format&n=lafG1dG0XmKZiP70&q=85&s=6f3e498857d57194b07a94ba23b72626 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier3.png?w=1100&maxW=446&auto=format&n=lafG1dG0XmKZiP70&q=85&s=7e1a43175ff78422bd53efc9d28d377f 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier3.png?w=1650&maxW=446&auto=format&n=lafG1dG0XmKZiP70&q=85&s=18f403618c062c51e3d73e9d6b13e9ce 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier3.png?w=2500&maxW=446&auto=format&n=lafG1dG0XmKZiP70&q=85&s=51c53f418ca305a8c182c6cb36f12a05 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 5. Create Proxy Rules for Applications**

1\. Go to **Profile** > **Proxification Rules**.

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier4.png?maxW=1270&auto=format&n=lafG1dG0XmKZiP70&q=85&s=3d3f6e63d866966c6b31a6e17132a4e7" alt="" width="1270" height="529" data-path="images/integrations/proxifier4.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier4.png?w=280&maxW=1270&auto=format&n=lafG1dG0XmKZiP70&q=85&s=b9245d4b0c4792373676d92b5cbc8688 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier4.png?w=560&maxW=1270&auto=format&n=lafG1dG0XmKZiP70&q=85&s=5a2858e201bb5e715ee00c843264b07e 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier4.png?w=840&maxW=1270&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f8b00f8e0e09c920aa4e65705381526e 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier4.png?w=1100&maxW=1270&auto=format&n=lafG1dG0XmKZiP70&q=85&s=fd553883b069abb8117b82a2bd8a877d 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier4.png?w=1650&maxW=1270&auto=format&n=lafG1dG0XmKZiP70&q=85&s=efb36d4fb9bdbc38fa8235391362241d 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier4.png?w=2500&maxW=1270&auto=format&n=lafG1dG0XmKZiP70&q=85&s=6bd38b73a501381e93ef8bf8b28f303a 2500w" data-optimize="true" data-opv="2" />
</Frame>

2\. Click **Add** to set up a new rule.

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier5.png?maxW=716&auto=format&n=lafG1dG0XmKZiP70&q=85&s=7bf2535a8659ff2e6291cf509dea802a" alt="" width="716" height="428" data-path="images/integrations/proxifier5.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier5.png?w=280&maxW=716&auto=format&n=lafG1dG0XmKZiP70&q=85&s=195d61856ceca4b095731b3ec66aaf65 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier5.png?w=560&maxW=716&auto=format&n=lafG1dG0XmKZiP70&q=85&s=a2683ae1db94e688f9050e5e8b6bf629 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier5.png?w=840&maxW=716&auto=format&n=lafG1dG0XmKZiP70&q=85&s=2995c835e01290382e68e7fb42a2fe85 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier5.png?w=1100&maxW=716&auto=format&n=lafG1dG0XmKZiP70&q=85&s=d1bd7ec5c985d87422f520319528b62f 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier5.png?w=1650&maxW=716&auto=format&n=lafG1dG0XmKZiP70&q=85&s=4008cd8b99fb379ad7a7d7d56dbc6cf1 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier5.png?w=2500&maxW=716&auto=format&n=lafG1dG0XmKZiP70&q=85&s=c9703aed4795d6eed3d982d1fb8fb977 2500w" data-optimize="true" data-opv="2" />
</Frame>

3\. Name the rule for clarity.

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier6.png?maxW=479&auto=format&n=lafG1dG0XmKZiP70&q=85&s=463a4309090e74f2c631386d77a394c1" alt="" width="479" height="534" data-path="images/integrations/proxifier6.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier6.png?w=280&maxW=479&auto=format&n=lafG1dG0XmKZiP70&q=85&s=381a39d2a77305374ac985a72179fa63 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier6.png?w=560&maxW=479&auto=format&n=lafG1dG0XmKZiP70&q=85&s=cbb20ff3a10d8bc06cf69f23922ca9c2 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier6.png?w=840&maxW=479&auto=format&n=lafG1dG0XmKZiP70&q=85&s=33e4f9838e79f99b1b5ab1740111930c 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier6.png?w=1100&maxW=479&auto=format&n=lafG1dG0XmKZiP70&q=85&s=d059d7b11096fb765eabf2d3cfe5bd4f 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier6.png?w=1650&maxW=479&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8e6b4aa52578d0758214b29dfd7166a5 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier6.png?w=2500&maxW=479&auto=format&n=lafG1dG0XmKZiP70&q=85&s=9071721970ffa59ea5f7733e544adca8 2500w" data-optimize="true" data-opv="2" />
</Frame>

4\. Use the **Browse** button to specify the application (e.g., Chrome, Firefox) for the rule.

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier7.png?maxW=844&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8ae07cb2b6363c6f6af28e5b546df78b" alt="" width="844" height="305" data-path="images/integrations/proxifier7.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier7.png?w=280&maxW=844&auto=format&n=lafG1dG0XmKZiP70&q=85&s=40be58f30c7aad486dffc6a067f46e11 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier7.png?w=560&maxW=844&auto=format&n=lafG1dG0XmKZiP70&q=85&s=c92f2eb6b04d6e7aeb1e92370b61a7f5 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier7.png?w=840&maxW=844&auto=format&n=lafG1dG0XmKZiP70&q=85&s=e8063cbe491bebea28cfa9032a4fb415 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier7.png?w=1100&maxW=844&auto=format&n=lafG1dG0XmKZiP70&q=85&s=cb02e736acf95895d2f37d309006fc79 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier7.png?w=1650&maxW=844&auto=format&n=lafG1dG0XmKZiP70&q=85&s=b880f1eb9c887f3debacf9ec5518b542 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier7.png?w=2500&maxW=844&auto=format&n=lafG1dG0XmKZiP70&q=85&s=66b6cdd2a8b5e8bbf85cdcb4c0602fd7 2500w" data-optimize="true" data-opv="2" />
</Frame>

5\. Choose how the traffic is routed:

* Through the proxy.

* Directly to the internet.

* Blocked entirely.

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier8.png?maxW=480&auto=format&n=lafG1dG0XmKZiP70&q=85&s=593f6ec0453ecee766695720e8cc6cad" alt="" width="480" height="534" data-path="images/integrations/proxifier8.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier8.png?w=280&maxW=480&auto=format&n=lafG1dG0XmKZiP70&q=85&s=abbdbabf4af1afb1fc2963df919a4489 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier8.png?w=560&maxW=480&auto=format&n=lafG1dG0XmKZiP70&q=85&s=420ac0dfe9208f2085b28c4a3a5c700d 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier8.png?w=840&maxW=480&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f9f29347237da0f584c20b79537fff40 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier8.png?w=1100&maxW=480&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f029900a48a610faef1e9b09dffac213 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier8.png?w=1650&maxW=480&auto=format&n=lafG1dG0XmKZiP70&q=85&s=ba2456cd25ab917d66f1a5e468977824 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier8.png?w=2500&maxW=480&auto=format&n=lafG1dG0XmKZiP70&q=85&s=0903c6355b0dcf0a335074b6f07502ab 2500w" data-optimize="true" data-opv="2" />
</Frame>

6\. Save the rule and move it to the top of the list for priority.

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier9.png?maxW=718&auto=format&n=lafG1dG0XmKZiP70&q=85&s=66fea92eed78854e7a07c89c559d61eb" alt="" width="718" height="429" data-path="images/integrations/proxifier9.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier9.png?w=280&maxW=718&auto=format&n=lafG1dG0XmKZiP70&q=85&s=7774da0fc4a8f30d85be38cc4f187ef9 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier9.png?w=560&maxW=718&auto=format&n=lafG1dG0XmKZiP70&q=85&s=5f17bd4c8fddebce2e0b17b52d6c35b2 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier9.png?w=840&maxW=718&auto=format&n=lafG1dG0XmKZiP70&q=85&s=15a2e35867f3675e04bc01c8e49ebe3b 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier9.png?w=1100&maxW=718&auto=format&n=lafG1dG0XmKZiP70&q=85&s=75db1a1490389b14b8d6c010437a5135 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier9.png?w=1650&maxW=718&auto=format&n=lafG1dG0XmKZiP70&q=85&s=65f55adb180875b28575c845838a30c3 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxifier9.png?w=2500&maxW=718&auto=format&n=lafG1dG0XmKZiP70&q=85&s=95c84f905b2d8ade0d41555488de8630 2500w" data-optimize="true" data-opv="2" />
</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.


# How to Set Up Bright Data With Puppeteer
Source: https://docs.brightdata.com/integrations/puppeteer

Discover how to enhance Puppeteer’s browser automation with Bright Data. This guide will walk you through setting up secure, anonymous proxies for smoother web scraping and data retrieval.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 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](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)

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</Tip>

## How to Integrate Bright Data With Puppeteer

### Getting 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. **Puppeteer**: Add Puppeteer to your project by running:

```bash
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](https://docs.brightdata.com/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
const puppeteer = require('puppeteer');

(async () => {
  // Launch Chromium with the Bright Data proxy configured
  const browser = await puppeteer.launch({
    headless: false,  // Change to true if you prefer headless mode
    args: ['--proxy-server=[HOST]:[PORT]'] // Replace with your Bright Data host and port
  });

  const page = await browser.newPage();

// Log in with your Bright Data credentials
  await page.authenticate({
    username: '[USERNAME]',   // Replace with your Bright Data username
    password: '[PASSWORD]'    // Replace with your Bright Data password
  });

 // Test the setup by visiting an IP-checking site
  await page.goto('http://httpbin.org/ip');
  // Capture a screenshot to confirm everything’s working
  await page.screenshot({path: 'example.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



<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 known for its automation tools that assist dropshippers in managing their online stores more efficiently. It helps automate various aspects of the dropshipping process, such as product sourcing, order fulfillment, and inventory management. The platform often integrates with popular e-commerce platforms like eBay and Amazon.

## Steps to integrate SaleFreaks with Bright Data proxies

**Step 1. 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 caption="Proxy management interface with active proxies and Add button">
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/add-zone-2.png?maxW=1000&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=dfb3b03a3cd63fff4cdd67e21771c9d3" alt="add-zone-2.png" width="1000" height="324" data-path="images/integrations/add-zone-2.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/add-zone-2.png?w=280&maxW=1000&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=d94d1a9151b147412e24c6bb153c9fbc 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/add-zone-2.png?w=560&maxW=1000&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=021c0477b107bbbd0f288b34a2e354ce 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/add-zone-2.png?w=840&maxW=1000&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=3c59b4e56f3b629264fbf517f66cbf65 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/add-zone-2.png?w=1100&maxW=1000&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=34e11796b87ebcab8b24269c6a0c5a64 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/add-zone-2.png?w=1650&maxW=1000&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=afb1626aa09609ae81fba5c96209e1e5 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/add-zone-2.png?w=2500&maxW=1000&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=85a79d32477589507c7454cdbee21638 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 2. Select proxy type**:

In this example, we will show how to set up datacenter proxies.

<Frame caption="Web interface for managing proxies and scraping infrastructure">
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/SaleFreaks-4.png?maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f059d7a8d822351220aa14857da12d48" alt="SaleFreaks-4.png" width="500" height="313" data-path="images/integrations/SaleFreaks-4.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/SaleFreaks-4.png?w=280&maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=b0c863a012b222058edde74a58908578 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/SaleFreaks-4.png?w=560&maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=58148f3e7559e78483072f88864d7c65 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/SaleFreaks-4.png?w=840&maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=774b3eff1f8f7d08c99d60b60a506848 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/SaleFreaks-4.png?w=1100&maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=0f55b5954d3f6f14009e1a13d8b132e3 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/SaleFreaks-4.png?w=1650&maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=4471d7dfa6d798383d05c867e0a6e94e 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/SaleFreaks-4.png?w=2500&maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c9c423e1f48b697d3338e2153bf0dbcc 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 3. Name proxy solution**:

<Frame caption="Form to choose IP type, showing Dedicated option selected">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/select-ip-type.png?maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=2f98bcc90ad8c581e6955ffbfd33558e" alt="select-ip-type.png" width="1000" height="333" data-path="images/integrations/select-ip-type.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/select-ip-type.png?w=280&maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=eccc0e1a284618d3fe444978b3bfbd81 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/select-ip-type.png?w=560&maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=624f2daa1e7146b372b5eeeb2c69de30 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/select-ip-type.png?w=840&maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=d79cd7061db3f78d1d1e9967926e51e1 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/select-ip-type.png?w=1100&maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=846ff4f2088125523b6dcde0eff0dcf0 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/select-ip-type.png?w=1650&maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=890da15d2008d4c43424ecc954c2c5a6 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/select-ip-type.png?w=2500&maxW=1000&auto=format&n=lafG1dG0XmKZiP70&q=85&s=4516d4bff52d2692fb55dbf5d5411236 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 4. Select IP count**:

Fill in the number of IPs you need.

<Frame>
    <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/number-of-ips-1.png?maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=d758ef7bf9837e5a93da35efc0a5902f" alt="number-of-ips-1.png" width="1000" height="164" data-path="images/integrations/number-of-ips-1.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/number-of-ips-1.png?w=280&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=c75129a1b12b5ef63431dd57d5ab4ed9 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/number-of-ips-1.png?w=560&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=db88179b079be8118fd12a23861a3241 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/number-of-ips-1.png?w=840&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=44f16fa68e243830dd4edfd915ed8805 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/number-of-ips-1.png?w=1100&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=cefd691c8d420d6b5e169a51e22ed782 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/number-of-ips-1.png?w=1650&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=dd81393f09c7cf02c470f5cb531eca69 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/number-of-ips-1.png?w=2500&maxW=1000&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=01604325cfd54b1dec7da2ba54e1cbd4 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 5. Country & city selection**:

Choose your desired country and city for the IP location.

<Frame caption="Geolocation targeting options for United States and New York City">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/city-ip.png?maxW=1000&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a3d0b2785f78eeb12591d8650136a65d" alt="city-ip.png" width="1000" height="197" data-path="images/integrations/city-ip.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/city-ip.png?w=280&maxW=1000&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=3cee12477983d401120fb2f45c9325c1 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/city-ip.png?w=560&maxW=1000&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=51f1d2239c98da5c5860d1fa6b6c4c8e 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/city-ip.png?w=840&maxW=1000&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=934140341e43f3916faca3f161d6d6ba 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/city-ip.png?w=1100&maxW=1000&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=f50460362a325f6dc711050c29e5c6d9 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/city-ip.png?w=1650&maxW=1000&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=fd972346f2bb9e6b966ab6c4e806ed53 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/city-ip.png?w=2500&maxW=1000&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=cea8d43964b90fa006c5b379830c9953 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 6. Add zone**:

Click the “**Add**” button to create the Zone.

<Frame>
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/click-add.png?maxW=1000&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c587138f4f2ba833ead1cbf99fef45ce" alt="click-add.png" width="1000" height="288" data-path="images/integrations/click-add.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/click-add.png?w=280&maxW=1000&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=fb3b055cf88ff62b0285f6729905fa2d 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/click-add.png?w=560&maxW=1000&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=7b7000122142b9d7717507346e86d97b 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/click-add.png?w=840&maxW=1000&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=6841b07e86207d08518f82ae367c7f5c 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/click-add.png?w=1100&maxW=1000&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=60cf4215367493a675dfbe955fca7a05 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/click-add.png?w=1650&maxW=1000&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=dc6b23308f4815f041ed93c48482def1 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/click-add.png?w=2500&maxW=1000&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=9fbd8d8cfc933ad6524e93a355a94d87 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 7. Now Zone is ready**:

You always have the option to edit the zone by clicking on the zone name and taking the data you will require for the next step. To add more proxies, go to the “configuration” page.

<Frame caption="Proxies and Scraping dashboard with various proxy options listed">
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zone-ready.png?maxW=500&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=989ef754372f68d171f6bf003b12ca4b" alt="zone-ready.png" width="500" height="313" data-path="images/integrations/zone-ready.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zone-ready.png?w=280&maxW=500&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=94a6d90e2c57f1a2300ebd821631e6a2 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zone-ready.png?w=560&maxW=500&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=dd4becc761dbac6bc515c845ddb43896 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zone-ready.png?w=840&maxW=500&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=281dbe0563843aaf78c3af71dc183baf 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zone-ready.png?w=1100&maxW=500&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=110fd842eefd21fa2b5b9a19722c5d05 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zone-ready.png?w=1650&maxW=500&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=673ac5b4e3c48ed4ce1201048dd62139 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zone-ready.png?w=2500&maxW=500&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=2935988f8699a3cf6f3e7d6d107472e7 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 8. Adding new password**:

For adding a new proxy password, click on the ‘ Add password’ button (it is now possible to add more proxy passwords on the “Access parameters” page).

<Frame caption="Interface showing proxy configuration settings">
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adding-new-pass.png?maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=3e9b4c76275ce53102fab0388969be70" alt="adding-new-pass.png" width="500" height="313" data-path="images/integrations/adding-new-pass.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adding-new-pass.png?w=280&maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a09a5f92bb80ebbea6a111543d5587dd 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adding-new-pass.png?w=560&maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=32c86d2eb6d8a902fbff60434782090c 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adding-new-pass.png?w=840&maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=7a3dfba1882e7b91e56a578c1161f226 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adding-new-pass.png?w=1100&maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=8fbf6d82abf9b1c8f3326a65543da06b 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adding-new-pass.png?w=1650&maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=97a3a0eaf45e597d1963e689cf771fda 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/adding-new-pass.png?w=2500&maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=b1b066ffe3dde61dfc701f5e00e5cf0c 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 9. Head to the configuration page**:

Once you added a new password, head to the configuration page.

<Frame>
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxy-config.png?maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=a24f6e576c4ba095e96031913e69b0d9" alt="proxy-config.png" width="500" height="313" data-path="images/integrations/proxy-config.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxy-config.png?w=280&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=4ef40d2fa0ed1df4542851800e07f753 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxy-config.png?w=560&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=c6011f8aa94de103393acb22e577ba40 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxy-config.png?w=840&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=c44d5f9db8caba1a56c93e4fa45326e1 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxy-config.png?w=1100&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=68fa49941eae338d7787cc1f79eece44 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxy-config.png?w=1650&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=4936de3de27573449c21ebe5e121e24d 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/proxy-config.png?w=2500&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=776773c82d9b412c7e541d27097c8eca 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 10. Review IPs**:

To review your IPs, click on To review your IPs, click on **Show allocated IPs**.

<Frame caption="Settings page showing IP allocation details">
    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/allocated-ips.png?maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=47e37379248fdf7ead962c4d37fa0cdb" alt="allocated-ips.png" width="500" height="313" data-path="images/integrations/allocated-ips.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/allocated-ips.png?w=280&maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=1bf010e58706e7279f3248bf1fc6a172 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/allocated-ips.png?w=560&maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=b0390c6e2ad95a25b4426513deae2e8d 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/allocated-ips.png?w=840&maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=39bf7f176afc916d997ca7a3e180bb17 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/allocated-ips.png?w=1100&maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=33fd67a76d8a3da66e5da27d44b89933 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/allocated-ips.png?w=1650&maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=7d0b0e1d2ef441908371c9b0c9689f30 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/integrations/allocated-ips.png?w=2500&maxW=500&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=6e18d91bded003763dccc57602c0d03a 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 11. You will notice the list of Allocated IPs**:

Take a look at the list of allocated IPs.

<Frame caption="List of IP addresses with geolocation information">
    <img src="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ip-list.png?maxW=500&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=ca756b7d5247dd7adf189099a3572ad6" alt="ip-list.png" width="500" height="313" data-path="images/integrations/ip-list.png" srcset="https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ip-list.png?w=280&maxW=500&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=849c08540315f7795494357e2ac06acf 280w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ip-list.png?w=560&maxW=500&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=581cc65a70dc507966c7eb7f0da5ff62 560w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ip-list.png?w=840&maxW=500&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=52689bdc71cfce6e7aac1d1ea2e6606d 840w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ip-list.png?w=1100&maxW=500&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=a85759424f09a5a0e5cd1e54eaa5f5de 1100w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ip-list.png?w=1650&maxW=500&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=6387daa8573a20c9b21c854e784a5a4d 1650w, https://mintcdn.com/brightdata/mDnOYJMdf2BWnkdI/images/integrations/ip-list.png?w=2500&maxW=500&auto=format&n=mDnOYJMdf2BWnkdI&q=85&s=06962702495105610a49b68783fd6a7b 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 12. Click on the download IPs list button**:

<Frame caption="Interface showing IP allocation options and download link">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/download-ips.png?maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=0a422fde0129db0ebb5e4be53c6b8490" alt="download-ips.png" width="500" height="313" data-path="images/integrations/download-ips.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/download-ips.png?w=280&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c91e50ed77479cfc0ac50558a490622e 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/download-ips.png?w=560&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=65f81ab2cc48c7d61dd87c52cb2d9863 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/download-ips.png?w=840&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=463aef711557ffe2ed8efa1dae6e0905 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/download-ips.png?w=1100&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=6f43ca0353cce534c9ae01c94fd6fc22 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/download-ips.png?w=1650&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=913809fbefa0299b7494069351d83244 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/download-ips.png?w=2500&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=7cdec7601f1775b5abec7d7d42ee8d25 2500w" data-optimize="true" data-opv="2" />
</Frame>

<Tip>
  **FYI**: If you choose “new password” in step 10, please wait a few minutes before you download the allocated IP’s files, to allow the new password to sync with and reflect in the file.
</Tip>

**Step 13. Open file editor**:

Open the file in the editor of your choice will appear similar to the below example:

<Frame caption="Text file with proxy IP addresses on screen">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/file-editor.png?maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=c6c682107a7cb99f5f4fc805b7850956" alt="file-editor.png" width="500" height="313" data-path="images/integrations/file-editor.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/file-editor.png?w=280&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=62f551df97bd8fd744bfb25339ef6876 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/file-editor.png?w=560&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=80087dfd17fe4c64a8c664edc7895322 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/file-editor.png?w=840&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d9e2adb0deb9cd179da0a3223bc0d031 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/file-editor.png?w=1100&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=3ad279ea38c7b59abc1b1f3510ef6ee9 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/file-editor.png?w=1650&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d543c340379743a6a760bc8343a662eb 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/file-editor.png?w=2500&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=e3ddd3fb81761c21cd5700a2426d7fa4 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 14. Input fields**:

For your convenience we have breakdown the fields you need to fill as shown from the list below:

* Proxy type: **`HTTP`**
* Proxy IP: brd.superproxy.io
* Proxy Port: `33335`
* Proxy user:`lum-customer-{your_customer_id}-zone-{your_zone}-ip-191.101.212.175`
* Proxy password: `zh4*********`

<Frame caption="Text file screenshot showing proxy server details">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/requried-fileds.png?maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=6fc3ec79793927812826f1422df9fe37" alt="requried-fileds.png" width="500" height="313" data-path="images/integrations/requried-fileds.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/requried-fileds.png?w=280&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=17422040ae845188ec5712a170bc2162 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/requried-fileds.png?w=560&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=380357877163b01ea29dfc13c3f158b1 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/requried-fileds.png?w=840&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=d10dff951144dd284046de80a3dc3529 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/requried-fileds.png?w=1100&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=4c908facca3ea1463f50402d7c0c4858 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/requried-fileds.png?w=1650&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=cbef667c12235385a5d896133c70398a 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/requried-fileds.png?w=2500&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=fa57dec5ef00ab3e36d9630d0561f1ce 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 15. Login to Salefreaks**:

After you login at salesfreak.com an add account pop will appear, select your ebay marketplace, enter your store name and click on provide my own proxy.

<Frame caption="Dialog box for adding an eBay account on SaleFreaks">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/salefreaks-logins.png?maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=a5e8396ae7dd8829f220c892d693e217" alt="salefreaks-logins.png" width="500" height="313" data-path="images/integrations/salefreaks-logins.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/salefreaks-logins.png?w=280&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=1e4e29aab6e116f6f70ad1a9b7a0ff92 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/salefreaks-logins.png?w=560&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=38f13a21cca9501507245b46db315059 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/salefreaks-logins.png?w=840&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=1597466d2a8672eddc03093dcea9d8e5 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/salefreaks-logins.png?w=1100&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=39532994271dec5ce2ca2067892b1148 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/salefreaks-logins.png?w=1650&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=7d4b23b610ed691f50d833de16a8ae4e 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/salefreaks-logins.png?w=2500&maxW=500&auto=format&n=lafG1dG0XmKZiP70&q=85&s=616e1e39d4ee2b958c65c8b8a7003092 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 16. Fill in Salefreaks fields**:

Fill in the Salefreaks text field information taken from the Bright Data downloaded file.

<Frame caption="Form for adding eBay account with proxy settings">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/fill-in-info.png?maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ee7952afdb15aae5dc1ec10a0515f598" alt="fill-in-info.png" width="500" height="313" data-path="images/integrations/fill-in-info.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/fill-in-info.png?w=280&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ea2e078292bd0cb8d39c0b0cae31dc68 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/fill-in-info.png?w=560&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=954d2f8ff4e97367d63c3c65f533c78a 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/fill-in-info.png?w=840&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=943c69325f2fb753161f5b92110e25a6 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/fill-in-info.png?w=1100&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=708177c3c42bf2af6e8762676cbe4f92 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/fill-in-info.png?w=1650&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=d1b9df1ab5332ec59a2bc235552dadee 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/fill-in-info.png?w=2500&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=1adb5569144f4559fe3f4c9021f63c44 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 17. For your information**:

To avoid account suspension, which will lead to losing all of the allocated IPs, we recommend enabling the auto-recharge feature, which will ensure that the account will never run out of funds. It could be in any amount, starting from \$20.

<Frame caption="Enable auto recharge confirmation pop-up on billing page.">
    <img src="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/autorecharge.png?maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=b483f9f49f3c9c46845a04ecea648158" alt="autorecharge.png" width="500" height="284" data-path="images/integrations/autorecharge.png" srcset="https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/autorecharge.png?w=280&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=facb2e19e9ba5a31d624bf9dd99dd542 280w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/autorecharge.png?w=560&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=a3e0aeaad27e616254720c35fb4aa4cd 560w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/autorecharge.png?w=840&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=6cef6987c5ac16ea75b31f693d089337 840w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/autorecharge.png?w=1100&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=41eb403706f8a46d9cbe602985b278a5 1100w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/autorecharge.png?w=1650&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=ac12100be794dcb9012b350402a486fe 1650w, https://mintcdn.com/brightdata/eeH2P1gRKelS4k6h/images/integrations/autorecharge.png?w=2500&maxW=500&auto=format&n=eeH2P1gRKelS4k6h&q=85&s=48fb58bb6376e324affde7c3e86d4dfd 2500w" data-optimize="true" data-opv="2" />
</Frame>

<Warning>
  **Important note**:

  If you are using Bright Data’s Residential Proxies, 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](https://docs.brightdata.com/general/account/ssl-certificate#installation-of-the-ssl-certificate) for instructions.
</Warning>


# How to Use Bright Data with Scrapy
Source: https://docs.brightdata.com/integrations/scrapy

Integrate Bright Data with Scrapy to enhance your web scraping workflows. This guide provides a step-by-step configuration process to enable secure and anonymous connections for your Scrapy projects.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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
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
   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
   cd myproject
```

**Step 2. Generate a Spider**

1\. Use Scrapy’s command to create a spider:

```bash
 scrapy genspider <spider_name> <target_url>
```

For example, to scrape [httpbin.org/ip](http://httpbin.org/ip), you can run:

```bash
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
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
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
cd myproject
```

2\. Run the spider:

```bash
scrapy crawl BrightDataExample
```

3\. To save the output to a file, use:

```bash
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
[
    {
        "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!


# How to Set Up Bright Data With Screaming Frog
Source: https://docs.brightdata.com/integrations/screaming-frog

Streamline your SEO tasks by integrating Bright Data with Screaming Frog. Follow this step-by-step guide to set up proxies for efficient and secure web crawling.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 as="div">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/screamingfrog1.png?maxW=1016&auto=format&n=lafG1dG0XmKZiP70&q=85&s=6960cebc297b5c11d9fc2f1acdf7d1fc" alt="" width="1016" height="713" data-path="images/integrations/screamingfrog1.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/screamingfrog1.png?w=280&maxW=1016&auto=format&n=lafG1dG0XmKZiP70&q=85&s=3a3163336ba833288cf9d901487e5cc5 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/screamingfrog1.png?w=560&maxW=1016&auto=format&n=lafG1dG0XmKZiP70&q=85&s=d1c9adda86b0b488d0e13cdfde30d6ad 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/screamingfrog1.png?w=840&maxW=1016&auto=format&n=lafG1dG0XmKZiP70&q=85&s=19864cb3b8907fbdb105ec8cb3e6c590 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/screamingfrog1.png?w=1100&maxW=1016&auto=format&n=lafG1dG0XmKZiP70&q=85&s=dc73189d151f1334c658ddcb0451ae4b 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/screamingfrog1.png?w=1650&maxW=1016&auto=format&n=lafG1dG0XmKZiP70&q=85&s=d4ac9e4012c5d4b1cdc7db5b913c0ef9 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/screamingfrog1.png?w=2500&maxW=1016&auto=format&n=lafG1dG0XmKZiP70&q=85&s=bad8026a2d3eea608b49fde31b62f592 2500w" data-optimize="true" data-opv="2" />
</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 Use Selenium with Bright Data
Source: https://docs.brightdata.com/integrations/selenium

Integrate Bright Data proxies with Selenium in Python to enhance your automation workflows. This guide helps you set up secure, anonymous connections for web scraping and browser automation.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 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, and browser-based workflows. With its flexibility and cross-browser compatibility, it’s an essential tool for developers and testers alike.

<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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</Tip>

## How to Integrate Bright Data With Selenium

**Step 0. Prerequisites**

Before starting, make sure you have:

1\. Python **installed**: Download the latest version from [python.org](https://www.python.org/).

2\. **Install Selenium**: Use pip to install the Selenium library

```bash
pip install selenium
```

3\. **Bright Data Proxy details**: Obtain your proxy details (host, port, username, password) from the [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).

4\. **WebDriver Installed**: Obtain the appropriate WebDriver for your browser of choice (e.g.,  [ChromeDriver](https://developer.chrome.com/docs/chromedriver/) for Google Chrome).

* For easier driver setup, consider using the `webdriver-manager` package:

```python
pip install webdriver-manager
```

<Note>
  If you want to use Selenium with Bright Data's Browser API, please refer to the [Browser API documentation](https://docs.brightdata.com/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>

**Step 1. Import Required Libraries**

Start by importing the necessary modules:

```python
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**

Set up your Bright Data proxy credentials and construct the proxy server URL:

```python
# Bright Data Proxy Configuration
proxy_host = "http://brd.superproxy.io/"
proxy_port = "port"  # Replace with your port number
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**

Use the Selenium ChromeOptions to configure the proxy:

```python
# Configure Chrome Options
chrome_options = Options()
chrome_options.add_argument(f"--proxy-server={proxy}")
```

**Step 4: Initialize the WebDriver**

Specify the path to your ChromeDriver and initialize the WebDriver with the proxy settings:

```python
# Initialize WebDriver
service = Service(ChromeDriverManager().install())
driver = webdriver.Chrome(service=service, options=chrome_options)
```

**Step 5: Test the Proxy**

Use Selenium to navigate to a test URL and verify the proxy is working:

```python
    # Navigate to a test site
    print("Connecting to target website...")
    driver.get("http://httpbin.org/ip")

    # Print the page content
    print("Page content:")
    print(driver.page_source)

    # Close the browser
    driver.quit()
```

**Step 6. Verify the Output**

When running the script, the IP address used by the proxy will be displayed in the browser or printed to the console. Example output:

```python
{
  "origin": "123.45.67.89"
}
```

By integrating **Bright Data** proxies with **Selenium**, you can automate web interactions securely and efficiently. Whether you're testing web applications, scraping dynamic content, or navigating geo-restricted websites, Bright Data ensures reliability and privacy for all your automation needs. Start building smarter workflows with Bright Data and Selenium today!


# How to Set Up Bright Data With SessionBox
Source: https://docs.brightdata.com/integrations/sessionbox

Using Bright Data with SessionBox enables secure, efficient multi-session browsing, offering flexible proxy solutions for undetectable and streamlined account management.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 multi-account management.

SessionBox focuses on simplicity and browser-native functionality, making it an ideal choice for lightweight tasks such as social media management, basic account switching, and other straightforward 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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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 as="div">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sessionbox2.png?maxW=345&auto=format&n=lafG1dG0XmKZiP70&q=85&s=535673f01ff70917b05b95c587ea4a94" alt="" width="345" height="547" data-path="images/integrations/sessionbox2.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sessionbox2.png?w=280&maxW=345&auto=format&n=lafG1dG0XmKZiP70&q=85&s=6d5651aa0f6698a60b33913fd93f1d4d 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sessionbox2.png?w=560&maxW=345&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f402db16a9275d6f2ae8b1f94d4a44ad 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sessionbox2.png?w=840&maxW=345&auto=format&n=lafG1dG0XmKZiP70&q=85&s=ab90ff0dc92baa790d372ec7f04962a6 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sessionbox2.png?w=1100&maxW=345&auto=format&n=lafG1dG0XmKZiP70&q=85&s=69716ee6da5caa94257d33a597a7b14c 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sessionbox2.png?w=1650&maxW=345&auto=format&n=lafG1dG0XmKZiP70&q=85&s=85bb6054f33728a7eafd6db1f9f6ae23 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sessionbox2.png?w=2500&maxW=345&auto=format&n=lafG1dG0XmKZiP70&q=85&s=679dbded47ba8605b8eb333666a43bc2 2500w" data-optimize="true" data-opv="2" />
</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.


# How to Set Up Bright Data With Shadowrocket
Source: https://docs.brightdata.com/integrations/shadowrocket

Learn how to integrate Bright Data with Shadowrocket for secure and seamless browsing on your iOS device. Follow this step-by-step guide to configure proxies and enhance your online privacy.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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.

<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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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.

<Frame as="div">
    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/integrations/shadowrocket1.png" alt="" />
</Frame>

### 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



<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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, e-commerce operators, and data analysts who manage numerous accounts. Here's why this combination is a game-changer:

* **Unmatched Global Network:** Bright Data offers access to an unparalleled network of over 72 million [real residential IPs worldwide](https://brightdata.com/proxy-types/residential-proxies), 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 extensive e-commerce operations and social media campaigns.
* **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 social media management and e-commerce operations. Whether you're managing a handful of accounts 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 multi-account management, 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 caption="Software download page with download button highlighted">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin19.png?maxW=1999&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f423096dc5b0665e3acf03e8521492d9" alt="smlogin19.png" width="1999" height="1250" data-path="images/integrations/smlogin19.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin19.png?w=280&maxW=1999&auto=format&n=lafG1dG0XmKZiP70&q=85&s=236bd568e72c1c3fd50ce81bd25d1938 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin19.png?w=560&maxW=1999&auto=format&n=lafG1dG0XmKZiP70&q=85&s=e4d9578c66ae380791d75c79f60cba2a 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin19.png?w=840&maxW=1999&auto=format&n=lafG1dG0XmKZiP70&q=85&s=fb11bd86877984a67d154d0ab2a6879b 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin19.png?w=1100&maxW=1999&auto=format&n=lafG1dG0XmKZiP70&q=85&s=c12957fa965fb9bae8171d269f2ff8ce 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin19.png?w=1650&maxW=1999&auto=format&n=lafG1dG0XmKZiP70&q=85&s=14b69f20187bc706c47b75b2f3fb1fb0 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin19.png?w=2500&maxW=1999&auto=format&n=lafG1dG0XmKZiP70&q=85&s=1d67e2c2a8f4af79ec97b6466adffe8a 2500w" data-optimize="true" data-opv="2" />
</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 caption="Login page with email and password fields">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin17.png?maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=fa6d9d6b706f10569f13ac8977ca95bb" alt="smlogin17.png" width="1366" height="768" data-path="images/integrations/smlogin17.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin17.png?w=280&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=57b1db36b6ac0fe2659c5918ef83cd3e 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin17.png?w=560&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f1fa5c4b61fa4d46ecb945edf8b3f47f 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin17.png?w=840&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=21abf8543597025bf1d37bb0ca81cdc9 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin17.png?w=1100&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=a33105e5213959866c3bf588b56a2479 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin17.png?w=1650&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=bea580fc2c8cd44023f3ebd52610ac72 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin17.png?w=2500&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=eb67c4959ce4d8e3d304ec191d383799 2500w" data-optimize="true" data-opv="2" />
</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 caption="Browser window showing SMLogin interface and options">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin11.png?maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=50ef176b23ddcbe02fcf2f14c90ec683" alt="smlogin11.png" width="1366" height="768" data-path="images/integrations/smlogin11.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin11.png?w=280&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=661624a88cee5626dc90e1323cbbd8fb 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin11.png?w=560&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=e849996592ec81456377e52bb609153d 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin11.png?w=840&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=347d140f540d168acbbc92dcf011cf77 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin11.png?w=1100&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=36338ac43884b9bb0109855e81db9679 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin11.png?w=1650&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=b3215893a803baf1b3b31ad638f58965 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin11.png?w=2500&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=db6ea6dd40dd29d457bd637e9fb6d777 2500w" data-optimize="true" data-opv="2" />
</Frame>

### Creating a New Profile

In the SMLOGIN dashboard, click on the “+ one-click new profiles” button to create a new browser profile.

<Frame caption="Creating a new profile in application interface">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin13.png?maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=5493f354ea1db40c06d3198b63629a2f" alt="smlogin13.png" width="1366" height="768" data-path="images/integrations/smlogin13.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin13.png?w=280&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=995dae92ea9c4744907f01f3d228fbeb 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin13.png?w=560&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=2b1d70a7f781b754eba5a5443501b844 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin13.png?w=840&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=9617efc7757a1d5d9ab2cffb369914a6 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin13.png?w=1100&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=60a535679693d0b1d9e6b91399477605 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin13.png?w=1650&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=a93e46f5491003ae8e9315db033e09d3 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin13.png?w=2500&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=a360d46f01df56ab3cae356be54b43fb 2500w" data-optimize="true" data-opv="2" />
</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 caption="Browser view of profile management screen">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin22.png?maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f60da2c117b352997752b644c93906f1" alt="smlogin22.png" width="1366" height="768" data-path="images/integrations/smlogin22.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin22.png?w=280&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=12548f2ca72c937c91d1119b28b813e8 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin22.png?w=560&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=5c010ce2bc5c7eb19561d15408c99a67 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin22.png?w=840&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=16d602789fcb8d28a2034c29a7d36d51 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin22.png?w=1100&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=852dc9c1ec0081432588ba1c8c3d1578 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin22.png?w=1650&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=86629ad8ba75dc4c411dabc3061a7a60 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin22.png?w=2500&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=060bd7df42a9713fb10dce675b0d1371 2500w" data-optimize="true" data-opv="2" />
</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 caption="Software showing proxy IP options for configuration">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin5.png?maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=b15f17344f59b3e479b9873b8c05a2d3" alt="smlogin5.png" width="1366" height="768" data-path="images/integrations/smlogin5.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin5.png?w=280&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=7b3ca85030b22b10a82eaef94cdf6e5f 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin5.png?w=560&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=e7eda26190a6199dc4a6bf631db8f1dd 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin5.png?w=840&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=567b732b6c96847e7e87bd37e8fe9114 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin5.png?w=1100&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=56d333ee9c2d1fe6a991a7d3dfcf53b8 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin5.png?w=1650&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=3b71e38cc0139b5add8e1111a2856d0a 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin5.png?w=2500&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=1bb399570fe35d0bfa8123e1eb61f987 2500w" data-optimize="true" data-opv="2" />
</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 caption="Proxy settings: IP brd.superproxy.io with port 33335.">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin6.png?maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=9321a8a1d0b71ab5d5d6e9f84ece2f35" alt="smlogin6.png" width="1366" height="768" data-path="images/integrations/smlogin6.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin6.png?w=280&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=01c280b3844ba14d257fb601ec7ca0f2 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin6.png?w=560&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=30bd74aff81fb61784340fc14413d9cd 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin6.png?w=840&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=dc39902521e67cf84c1dd7f414b0df8a 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin6.png?w=1100&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=aacb9828329a254e9d92c7279381a149 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin6.png?w=1650&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=ca503389e4e1101ec4a6f852dda33b43 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin6.png?w=2500&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=bb8442cc0f3c4ed5ee4f7b6c4d61cc68 2500w" data-optimize="true" data-opv="2" />
</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 33335
* **Username**: Your Bright Data username
* **Password**: Your Bright Data password

<Frame caption="Software interface showing proxy IP settings and information">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin2.png?maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f37eccf935627f1cfb2dfeb763aed513" alt="smlogin2.png" width="1366" height="768" data-path="images/integrations/smlogin2.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin2.png?w=280&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=e26a412c771c522cc8d4a7d92c30c76d 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin2.png?w=560&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=27816854d638c61de1227dc120f114bd 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin2.png?w=840&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8f007a37ad8bb2bf761af9f15655defc 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin2.png?w=1100&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8d753c69ba80a77ad1bb4d5d982a609f 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin2.png?w=1650&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=5a4f43ba10c3f94047cb9cc93eaf2d8b 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin2.png?w=2500&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=e233e10890d11f14fd3badad33811134 2500w" data-optimize="true" data-opv="2" />
</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 caption="Proxy IP settings window on SMLOGIN application">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin16.png?maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=9e94bd0362a446970b0a1c75861bbadd" alt="smlogin16.png" width="1366" height="768" data-path="images/integrations/smlogin16.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin16.png?w=280&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=3948fbb29526de16b8a5cadb1319296a 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin16.png?w=560&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=cbb3322939f1aa0e6b5cc4fcf04802f9 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin16.png?w=840&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=300b796ef33a2f79d1dd861144c115fc 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin16.png?w=1100&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=96ba206b7373730b7688a0d636e4396d 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin16.png?w=1650&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=5cdbd9d592b6d1dc6bbbcbe4adffd67b 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin16.png?w=2500&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=94cba20dd217aed481ab7208e7c6ff6a 2500w" data-optimize="true" data-opv="2" />
</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 src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin8.png?maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=9b0bbace4eebe8577129cd0836402e97" alt="smlogin8.png" width="1366" height="768" data-path="images/integrations/smlogin8.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin8.png?w=280&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=4b3e0193e236533ae8f5df0485ce1bc7 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin8.png?w=560&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=0bdafa8c999fca03dcb928029679395a 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin8.png?w=840&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8ebbad6d09307d0a3991caf51447f7b7 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin8.png?w=1100&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=8b0708cbb6ce4a19f851c765cf67bbeb 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin8.png?w=1650&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=1e5a07c59df35377252db83d8e857138 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/smlogin8.png?w=2500&maxW=1366&auto=format&n=lafG1dG0XmKZiP70&q=85&s=afc546978cf938d6dd84568ebf11b122 2500w" data-optimize="true" data-opv="2" />
</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, 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](https://docs.brightdata.com/general/account/ssl-certificate#installation-of-the-ssl-certificate) for instructions.
</Warning>


# How to Integrate Bright Data With Sphere Browser
Source: https://docs.brightdata.com/integrations/sphere-browser

Integrate Bright Data with Sphere Browser to manage multiple accounts securely and anonymously. Follow this step-by-step guide for a seamless configuration.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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, e-commerce, 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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</Tip>

## 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 as="div">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sphere-browser1.png?maxW=1595&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f22eb2fd31a48def7563b9e785b2c6d1" alt="" width="1595" height="164" data-path="images/integrations/sphere-browser1.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sphere-browser1.png?w=280&maxW=1595&auto=format&n=lafG1dG0XmKZiP70&q=85&s=ba31e7156e6bc183c34e5d2abade0fca 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sphere-browser1.png?w=560&maxW=1595&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f71463548518aecf440ca859a9b75f1a 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sphere-browser1.png?w=840&maxW=1595&auto=format&n=lafG1dG0XmKZiP70&q=85&s=13c4602c04721e118ee73f593bdd6f68 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sphere-browser1.png?w=1100&maxW=1595&auto=format&n=lafG1dG0XmKZiP70&q=85&s=040a978aefb254d3b4153f64120b4bc2 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sphere-browser1.png?w=1650&maxW=1595&auto=format&n=lafG1dG0XmKZiP70&q=85&s=b4d35543339a311f46f2084d6b1ab7e8 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sphere-browser1.png?w=2500&maxW=1595&auto=format&n=lafG1dG0XmKZiP70&q=85&s=b53fd45d457254d7aa385fa77667004c 2500w" data-optimize="true" data-opv="2" />
</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 as="div">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sphere-browser2.png?maxW=1278&auto=format&n=lafG1dG0XmKZiP70&q=85&s=e7b35ef5d320fe436a48af40a0b30398" alt="" width="1278" height="209" data-path="images/integrations/sphere-browser2.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sphere-browser2.png?w=280&maxW=1278&auto=format&n=lafG1dG0XmKZiP70&q=85&s=f0828f108b0f4ebf98d0ce2df480a5f0 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sphere-browser2.png?w=560&maxW=1278&auto=format&n=lafG1dG0XmKZiP70&q=85&s=0eacfc6b95238f838a0c5f4b5f0492d1 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sphere-browser2.png?w=840&maxW=1278&auto=format&n=lafG1dG0XmKZiP70&q=85&s=0a0fabe6bd504654ff8df814dfa4f479 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sphere-browser2.png?w=1100&maxW=1278&auto=format&n=lafG1dG0XmKZiP70&q=85&s=02eefc39f49db867c3223cb5521a1d45 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sphere-browser2.png?w=1650&maxW=1278&auto=format&n=lafG1dG0XmKZiP70&q=85&s=a6c02f24fbf6e9f06590a0e8b5cbb0ac 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/sphere-browser2.png?w=2500&maxW=1278&auto=format&n=lafG1dG0XmKZiP70&q=85&s=60ce8ab860142f328306569cf8fe3d85 2500w" data-optimize="true" data-opv="2" />
</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!


# How to Integrate Bright Data with StablerSOLO
Source: https://docs.brightdata.com/integrations/stablersolo

Enhance your data extraction capabilities by integrating Bright Data with StablerSOLO. Follow this step-by-step guide to configure your proxy settings seamlessly.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 data extraction and web scraping service that offers a low-code interface for configuring scrapers. It enables developers and data scientists to extract data efficiently without the need to code custom scrapers for each task.

## Benefits of Using Bright Data with StablerSOLO

By integrating **Bright Data** with StablerSOLO, you gain:

* **Enhanced Anonymity:** Protect your identity during web scraping activities.

* **Geo-Targeting Capabilities:** Access region-specific data by selecting proxies from various locations.

* **Improved Success Rates:** Bypass anti-scraping measures with high-quality proxy IPs.

## How to Integrate Bright Data With StablerSOLO's

Follow these steps to integrate Bright Data with StablerSOLO's:

**Step 1. Access StablerSOLO's Proxy Configuration**

1\. Log in to your [StablerSOLO account](https://stabler.tech/).

2\. From the main dashboard, scroll to the **Recent Proxies** section at the bottom.

3\. Click on the **New Proxy** button to open the proxy configuration window.

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/stabler1.png?maxW=606&auto=format&n=lafG1dG0XmKZiP70&q=85&s=65b82ec7d5c236342d57ea85e312dff4" alt="" width="606" height="191" data-path="images/integrations/stabler1.png" srcset="https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/stabler1.png?w=280&maxW=606&auto=format&n=lafG1dG0XmKZiP70&q=85&s=884e48b543f0873983cb349fd96df6be 280w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/stabler1.png?w=560&maxW=606&auto=format&n=lafG1dG0XmKZiP70&q=85&s=386e0dd1f692363007d42188de80fffc 560w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/stabler1.png?w=840&maxW=606&auto=format&n=lafG1dG0XmKZiP70&q=85&s=c9b842e553317c4d548346c98b70e062 840w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/stabler1.png?w=1100&maxW=606&auto=format&n=lafG1dG0XmKZiP70&q=85&s=cf5409a2ddcaee717b202793bbdceed3 1100w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/stabler1.png?w=1650&maxW=606&auto=format&n=lafG1dG0XmKZiP70&q=85&s=892dd48c9c7fc9f78c5076ab32adb86d 1650w, https://mintcdn.com/brightdata/lafG1dG0XmKZiP70/images/integrations/stabler1.png?w=2500&maxW=606&auto=format&n=lafG1dG0XmKZiP70&q=85&s=e79b2bf497da38c2a60dd7d433367735 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 2. Configure and Save Your Proxy Settings**&#x20;

1\. In the proxy configuration window:

* Switch to the **Proxies List** tab.

* Enter your Bright Data proxy details in this format:
  `[USERNAME]:[PASSWORD]@[HOST]:[PORT]`.

2\. Click **Test a Proxy Randomly** to verify the connection.

3\. Once the test is successful, click **Add New Proxy** to save your proxy to the list.

Integrating **Bright Data** with **StablerSOLO** enhances your data extraction processes by providing anonymity, geo-targeting, and improved success rates. Follow this guide to set up your proxies and start scraping efficiently.


# How to Set Up Bright Data With SwitchyOmega
Source: https://docs.brightdata.com/integrations/switchyomega

Effortlessly manage your proxies with SwitchyOmega! Learn how to integrate Bright Data with this browser extension to enhance your privacy, streamline account management, and simplify web 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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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 as="div">
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega1.png?maxW=184&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=391d5161ddd13edb80d50afebcec3748" alt="" width="184" height="225" data-path="images/integrations/switchyomega1.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega1.png?w=280&maxW=184&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=52209a0c13259196fc11db36b9c7e2c2 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega1.png?w=560&maxW=184&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=0a2fbcc2944bfc00143954a30d2ba099 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega1.png?w=840&maxW=184&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=415cadfd5bb663e28742376c72214f3b 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega1.png?w=1100&maxW=184&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=277a3e6aeb26d2eeea08ac1cd55c587d 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega1.png?w=1650&maxW=184&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=77f34628701eb9c7d952dc0b7e22a8da 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega1.png?w=2500&maxW=184&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=5cdf352a7b104a2f27f6157310912b54 2500w" data-optimize="true" data-opv="2" />
</Frame>

2\. On the settings page, click **New Profile**.

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega2.png?maxW=285&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=debc0415d80cc947e096d2ec92757129" alt="" width="285" height="155" data-path="images/integrations/switchyomega2.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega2.png?w=280&maxW=285&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=4097b51578fe1e2c4da0df82eba91d9f 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega2.png?w=560&maxW=285&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=433bd227cec57cb441309236d355ee4c 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega2.png?w=840&maxW=285&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=f77e26abd66e6a9bec08131ac82f3248 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega2.png?w=1100&maxW=285&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=1b3329c175c070488b978584e7a9a206 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega2.png?w=1650&maxW=285&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=f0387048c2d29984948c11c8a3145f27 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega2.png?w=2500&maxW=285&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=1f73c0f3e696ca92ad60c61eaa84af47 2500w" data-optimize="true" data-opv="2" />
</Frame>

3\. Provide a descriptive name for your profile (e.g., “Bright Data Proxy”), select **Proxy Profile**, and click **Create** to save.

<Frame as="div" style={{width:"70%", height:"auto"}}>
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega3.png?maxW=592&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=0a01eb536e8ce01978ae00e127a8b3ea" alt="" width="592" height="610" data-path="images/integrations/switchyomega3.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega3.png?w=280&maxW=592&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=dd504f4a886649975507ed5a2d118d20 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega3.png?w=560&maxW=592&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=94c8cadbd824edb61c5cfc51be8a9d64 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega3.png?w=840&maxW=592&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=16be381ba899e020496c69ef328b3328 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega3.png?w=1100&maxW=592&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=2beefaf4ce4b827cc8b258702204d542 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega3.png?w=1650&maxW=592&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=f16e49772790dbf71cb7f403a0f1d5eb 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega3.png?w=2500&maxW=592&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=c5176e400eb81d7fc0f411bd75bf35fb 2500w" data-optimize="true" data-opv="2" />
</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 as="div">
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega4.png?maxW=291&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=19e5ae2be667cd31fd5a97b70eee9fd6" alt="" width="291" height="228" data-path="images/integrations/switchyomega4.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega4.png?w=280&maxW=291&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=09c8e88bd6e8e59baedc26ccad1b8192 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega4.png?w=560&maxW=291&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=44d63d90a0b11f9947dbec046f3f82d0 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega4.png?w=840&maxW=291&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=4423f23c08947d43186a73645fa48efe 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega4.png?w=1100&maxW=291&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=654fa8fa02f50ce423f166f246817da3 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega4.png?w=1650&maxW=291&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=1364505fec48d24aa3ef38725848c421 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega4.png?w=2500&maxW=291&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=881c6614fc8cb37c85eab9bcf5678587 2500w" data-optimize="true" data-opv="2" />
</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 as="div">
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega5.png?maxW=317&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=83df44c4f58e9dd8364f7af646fa2aa8" alt="" width="317" height="128" data-path="images/integrations/switchyomega5.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega5.png?w=280&maxW=317&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9413224adbe2253c5bac72fc514353f4 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega5.png?w=560&maxW=317&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=980dfa6427b9878b7ee6c0f96a473287 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega5.png?w=840&maxW=317&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ab324af674d48b00162a19840b8e54cd 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega5.png?w=1100&maxW=317&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=3e4f5d6caadb869504fe32853e0bb1fb 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega5.png?w=1650&maxW=317&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=aa4a9d8f1230c4d0ff34dbb72cea4840 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega5.png?w=2500&maxW=317&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=1aa46ba7197a756aba2dda264386269d 2500w" data-optimize="true" data-opv="2" />
</Frame>

2\. To enable the proxy, select your configured profile from the SwitchyOmega dropdown menu in the browser toolbar.

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega6.png?maxW=181&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d119117ff3c314f99796d8f5d8ab4de0" alt="" width="181" height="252" data-path="images/integrations/switchyomega6.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega6.png?w=280&maxW=181&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=fd95cd8ff048ee9b113693efdedb2ae9 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega6.png?w=560&maxW=181&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=a41c9000cc0202288793d9613c70b62f 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega6.png?w=840&maxW=181&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=3aeb88ecd2f8c3cbb4fa004dbe68f2b1 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega6.png?w=1100&maxW=181&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=30035f1563a77dbb6d7a51576bc57147 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega6.png?w=1650&maxW=181&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=e459fa63ae883db2f46244a4cd557196 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/switchyomega6.png?w=2500&maxW=181&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=34ce98f034ad088b6de23d1fb18b8271 2500w" data-optimize="true" data-opv="2" />
</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.


# How to Set Up Bright Data With TexAu
Source: https://docs.brightdata.com/integrations/texau

Maximize the power of automation with Bright Data on TexAu. Follow this step-by-step guide to configure secure and anonymous proxy connections for streamlined automation 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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 TexAu?

TexAu is a growth automation platform designed to help marketers and businesses scale their lead generation and online engagement efforts. By combining TexAu’s automation capabilities with Bright Data, you can protect your identity, access geo-targeted data, and reduce the risk of IP bans.

<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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</Tip>

## Why Use Bright Data With TexAu?

* **Enhanced Privacy**: Safeguard your IP address during automated tasks.

* **Geo-Targeted Data**: Access location-specific information using country-specific proxies.

* **Consistent Connections**: Ensure reliable performance for uninterrupted automation.

## How to Integrate Bright Data With TexAu

Follow these steps to connect Bright Data to TexAu:

**Step 1. Log In to TexAu**

1\. Visit the [TexAu website](https://texau.com/) and log in to your account.

2\. Navigate to the **Dashboard** to access your automation tools.

**Step 2. Open Proxy Configuration Settings**

1\. From the Dashboard, go to **Preferences** the left-hand menu.

2\. Select the **Proxies** tab to open the proxy configuration page and click **New Proxy** to start the configuration.

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/texau1.png?maxW=1918&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=c91edf664519aee393f5a74841a7b8f9" alt="" width="1918" height="548" data-path="images/integrations/texau1.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/texau1.png?w=280&maxW=1918&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=c4b88dd0669a0c95ae752ea18efa9a8e 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/texau1.png?w=560&maxW=1918&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=a0d750219a1acfa3e4a8bfdaabc8ac44 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/texau1.png?w=840&maxW=1918&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=6a1ab047159b185f1d9de0121c31f8e7 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/texau1.png?w=1100&maxW=1918&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=14fc5e76752df1bff54f131efa112d2c 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/texau1.png?w=1650&maxW=1918&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=f4def330de063228e18c233ac85c6e21 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/texau1.png?w=2500&maxW=1918&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=5c621f26ddfc41a00cd215f6bea1e5a3 2500w" data-optimize="true" data-opv="2" />
</Frame>

**Step 3. Add Your Bright Data Proxy Details**

1\.  Fill in the proxy details as follows:

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

2\. After entering the details, click **Test Proxy** to verify the connection.

<Note>
  If using country-specific proxies, format the username as \`your-username-country-XX\` (e.g., \`your-username-country-US\`) to select a specific location.
</Note>

**Step 4. Save and Apply Your Proxy**

Once the proxy is successfully tested, click **Save** to apply the configuration.

By integrating **Bright Data** with **TexAu**, you unlock a secure and efficient automation experience. Whether you’re generating leads, scraping data, or managing online engagement, Bright Data ensures privacy, reliability, and seamless performance. Start optimizing your workflows today!


# How to Set Up Bright Data on Ubuntu
Source: https://docs.brightdata.com/integrations/ubuntu

Streamline your terminal-based workflows on Ubuntu! Integrate Bright Data to securely route your commands and applications through proxies, ensuring privacy and seamless access to geo-restricted resources. Follow this guide to configure Bright Data on your Ubuntu system.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</Tip>

## How to set up Bright Data on Ubuntu

**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
export http_proxy="http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]"
export https_proxy="http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]"
```

Use the following commands for SOCKS5 configuration:

```bash
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
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
 nano ~/.bashrc
```

2\. Add the following lines at the end of the file:

```bash
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
source ~/.bashrc
```

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!


# How to Set Up Bright Data With Undetectable
Source: https://docs.brightdata.com/integrations/undetectable

Learn how to configure Bright Data in Undetectable for secure and anonymous browsing. This step-by-step guide will help you enhance your online privacy and efficiency.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 managing multiple accounts, web scraping, 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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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 as="div">
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/undetectable1.png?maxW=370&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=7499829834cc23fe03b5c794dfa2d48d" alt="" width="370" height="261" data-path="images/integrations/undetectable1.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/undetectable1.png?w=280&maxW=370&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9099bf1aeb4ad2f2db3b2faf06e4a2f5 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/undetectable1.png?w=560&maxW=370&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=e0ed8a9b3ddaf4d70b60e8df8f4a7c30 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/undetectable1.png?w=840&maxW=370&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=5cb4c2a645226ca5bb7f8005d0e5ea1a 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/undetectable1.png?w=1100&maxW=370&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=0b098ab09c74910b56c65f394ad53bb3 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/undetectable1.png?w=1650&maxW=370&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=25e79fb5ddcd2b5794283bb438f80c22 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/undetectable1.png?w=2500&maxW=370&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=0fdc855dfe49ec50915c65516c696f4c 2500w" data-optimize="true" data-opv="2" />
</Frame>

2\. Click on the **Plus** button to add a new proxy.

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/undetectable2.png?maxW=690&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=73eb48d6fe4d700ec6f0d5ea66a6d5ba" alt="" width="690" height="187" data-path="images/integrations/undetectable2.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/undetectable2.png?w=280&maxW=690&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=02b0361a0d642a5bbe6a65834edf7419 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/undetectable2.png?w=560&maxW=690&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=4d063fe26dc9dd66906ce3ff5939e609 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/undetectable2.png?w=840&maxW=690&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=a0f470417abf6b57406d4a7bd3799b90 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/undetectable2.png?w=1100&maxW=690&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=242668aa9fe8661e08757a570855697e 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/undetectable2.png?w=1650&maxW=690&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=88dd300baf3f0fc9656a2800c050cecf 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/undetectable2.png?w=2500&maxW=690&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=caa1b328e0386fe5583e3baa4b5a1d9f 2500w" data-optimize="true" data-opv="2" />
</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.

4\. Click **Check** to verify the connection.

5\. 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

Integrating Bright Data with VMLogin ensures secure, anonymous browsing and efficient multi-account management, minimizing the risk of detection and IP bans.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 social media management, e-commerce, 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 account 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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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 Profile.** From the main menu, click on the **New browser profile** button to open the setup page.

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/vmlogin1.png?maxW=235&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=c38932597ca2b37176a130632722df82" alt="" width="235" height="291" data-path="images/integrations/vmlogin1.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/vmlogin1.png?w=280&maxW=235&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9e364550329ae2c2d7e9e195626833f5 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/vmlogin1.png?w=560&maxW=235&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=bda2ebfcef97f433fe494651ed814d06 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/vmlogin1.png?w=840&maxW=235&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=c6c2e239370d02557466042e74e6e1aa 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/vmlogin1.png?w=1100&maxW=235&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=c4841c89d7be8ddc8cbf167022600b7f 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/vmlogin1.png?w=1650&maxW=235&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=696ed29bc699d274adf4c0ae7bcb95a2 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/vmlogin1.png?w=2500&maxW=235&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=014a0eff235dfd827c7f7b324f11d45e 2500w" data-optimize="true" data-opv="2" />
</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 as="div">
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/vmlogin2.png?maxW=992&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=0a4a97801bdddd147354096ff4918cb8" alt="" width="992" height="647" data-path="images/integrations/vmlogin2.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/vmlogin2.png?w=280&maxW=992&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=b1ba32604b84ad2c9cc20368b5c0dece 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/vmlogin2.png?w=560&maxW=992&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9bf8736f9d80def81592843edfe031c5 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/vmlogin2.png?w=840&maxW=992&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=0426a606ae4aafb32e0f605df0122911 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/vmlogin2.png?w=1100&maxW=992&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=c987607ea0165cf07fa1933c7e4ebed2 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/vmlogin2.png?w=1650&maxW=992&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=676c31e0024fb76f9202a29f745adfbc 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/vmlogin2.png?w=2500&maxW=992&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=b95bab7f48e39f0c316b703a803502ca 2500w" data-optimize="true" data-opv="2" />
</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

Integrating WebHarvey with Bright Data proxies improves automated web scraping by offering secure, flexible proxy management for seamless and reliable data extraction.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int4.png?maxW=485&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=a703b1b9050f74ba0022af750b521487" alt="WebHarvy toolbar with home and settings options." width="485" height="206" data-path="images/integrations/webharvy_int4.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int4.png?w=280&maxW=485&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=a6366a690c37bee85c779e173dda8a3b 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int4.png?w=560&maxW=485&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=76ce02d91f6ef0429568233715678257 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int4.png?w=840&maxW=485&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ef77f53e102314840680cfd66328b549 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int4.png?w=1100&maxW=485&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d4d8f7bacf63cc74989967e9c0a2f3f5 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int4.png?w=1650&maxW=485&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=8eff65764664dad812a06d3ab6f4594a 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int4.png?w=2500&maxW=485&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=7fabe98b1fc2658e0738ff51017a8641 2500w" data-optimize="true" data-opv="2" />
</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 src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int1.png?maxW=767&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=2c134cc063e14c8c5d3ae73ce9880ba7" alt="webharvy_int1.png" width="767" height="237" data-path="images/integrations/webharvy_int1.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int1.png?w=280&maxW=767&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=76f9cb1d768cf18150fd84934bd1efc2 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int1.png?w=560&maxW=767&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=35b4094700a0b156297d7d17f16bfe9d 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int1.png?w=840&maxW=767&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ebeae16061d5c76e5351bc4403731cbb 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int1.png?w=1100&maxW=767&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=6fbc52f1e8558b1be0df3e0b8877e3f8 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int1.png?w=1650&maxW=767&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=8aa39c1c884affb53d3c78bd63b08335 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int1.png?w=2500&maxW=767&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=a26f63db064ac16c1e19366c8daf715d 2500w" data-optimize="true" data-opv="2" />
</Frame>

* On the API Examples page, you will see the following details:
  * Proxy address, Port number, User name, and Password

<Frame>
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int2.png?maxW=686&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=1d3c1c8b45400a2fe9ac21277a39833c" alt="Instructions for bot configuration with red arrows." width="686" height="171" data-path="images/integrations/webharvy_int2.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int2.png?w=280&maxW=686&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=e7e6e8d1c6bc2e6daf5401d53edb0fd2 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int2.png?w=560&maxW=686&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=a45d8bbd5b684da75b85c6bca10f3a2a 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int2.png?w=840&maxW=686&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=8e12be83c62c40f4ed54f91f3ebe48e2 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int2.png?w=1100&maxW=686&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=acdf0f71ab812f43eb7466851e64a328 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int2.png?w=1650&maxW=686&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=80531a4e868ce5d392d94b97201f6d96 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int2.png?w=2500&maxW=686&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=2b0d3e0096764a62684338b9eda7fc5f 2500w" data-optimize="true" data-opv="2" />
</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 src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int3.png?maxW=401&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=29eb949c93535647068934fb23ffd3e2" alt="WebHarvy proxy settings configuration screen." width="401" height="518" data-path="images/integrations/webharvy_int3.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int3.png?w=280&maxW=401&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=49090e3dc87f000b24a75a59a9deeb12 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int3.png?w=560&maxW=401&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=cdb3558b282434658850b79c13087d42 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int3.png?w=840&maxW=401&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=6916287b030224a4500ae55c969a7bc5 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int3.png?w=1100&maxW=401&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=b32975a7bdd4c0a9bad6bf1dfa142662 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int3.png?w=1650&maxW=401&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ca2f3039ac04c8aa5969a26eaeadfa2f 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webharvy_int3.png?w=2500&maxW=401&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=84b625d53000b6f8f8f968c82b2c74f1 2500w" data-optimize="true" data-opv="2" />
</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, 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](https://docs.brightdata.com/general/account/ssl-certificate#installation-of-the-ssl-certificate) for instructions.
</Warning>


# Webscraper.io Proxy Integration
Source: https://docs.brightdata.com/integrations/webscraper

Learn how to Integrate Webscraper.io with Bright Data proxies.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration6.png?maxW=237&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=53d847b535949e34a8372c92bb53279f" alt="webscraperio_integration6.png" width="237" height="480" data-path="images/integrations/webscraperio_integration6.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration6.png?w=280&maxW=237&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=941a6ae44515ee6c0a1dd7df1a7a2415 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration6.png?w=560&maxW=237&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=c452376e6d43beb2937ce716e50c9e1f 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration6.png?w=840&maxW=237&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=149d7ed9376f2730e7a4003c638eff9e 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration6.png?w=1100&maxW=237&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=c5d182e21f9ab4a9a97240e66139f1a7 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration6.png?w=1650&maxW=237&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=6f95ea6241e94a2ad6eabc41f1f84251 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration6.png?w=2500&maxW=237&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=a55f45c4f062a98ba954c8b9b1801978 2500w" data-optimize="true" data-opv="2" />
</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 src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration7.png?maxW=1154&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9d584380a1ab7a93b0f2b3d3f5f53283" alt="webscraperio_integration7.png" width="1154" height="107" data-path="images/integrations/webscraperio_integration7.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration7.png?w=280&maxW=1154&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=37e7aedd1cb1e68b8da151a91d27eb9a 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration7.png?w=560&maxW=1154&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=c665b4b1b0a9bad2ec9b162a275ce7e8 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration7.png?w=840&maxW=1154&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=88255fd638a4581f9390a548c020e62b 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration7.png?w=1100&maxW=1154&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=4547f765f69d125beaa69705f9f633c3 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration7.png?w=1650&maxW=1154&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=bc88a9742ebbf9ec5bedd5d1d48819b6 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration7.png?w=2500&maxW=1154&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=1aa997e8f7936050fa6581ad4d05325e 2500w" data-optimize="true" data-opv="2" />
</Frame>

1. 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 src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration5.png?maxW=1154&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d2ae652c122af67f4d7b4a270cac5792" alt="webscraperio_integration5.png" width="1154" height="502" data-path="images/integrations/webscraperio_integration5.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration5.png?w=280&maxW=1154&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=41b9345df3e81acb5cb2aff36fcb0140 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration5.png?w=560&maxW=1154&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=2bb9361e7818d60fc1b592957fb61f2c 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration5.png?w=840&maxW=1154&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=56f0f51c9ac1745d4d2d766c1bda5c5f 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration5.png?w=1100&maxW=1154&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=677931d2fd3156d3330e74cd9a3d8d7d 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration5.png?w=1650&maxW=1154&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=b9269b1616b4de9c66892bf0776073de 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration5.png?w=2500&maxW=1154&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d625ca3f814f55d3fc4aa7b4c6d825b0 2500w" data-optimize="true" data-opv="2" />
</Frame>

1. Click **Add Proxy**

2. The custom proxy will now be listed down below

<Frame>
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration1.png?maxW=987&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=813f23320f85e0ec0a4f72d0d32ad23f" alt="webscraperio_integration1.png" width="987" height="171" data-path="images/integrations/webscraperio_integration1.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration1.png?w=280&maxW=987&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9ae0feb6242211554bb3d3d2dd5e7f0a 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration1.png?w=560&maxW=987&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ec630161911472bbb7b8204d8b90ce21 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration1.png?w=840&maxW=987&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=3b1a63bbcaccc75a2d99dcb8e9328769 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration1.png?w=1100&maxW=987&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=baaa4164c324f4b800829abe141a27f2 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration1.png?w=1650&maxW=987&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d27e3c356caa1716f94a1997b09ce3f2 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration1.png?w=2500&maxW=987&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9f5ec4b797eadf05379ade2a53b0ee1d 2500w" data-optimize="true" data-opv="2" />
</Frame>

1. To use a proxy for a scraping job, go to “My Sitemaps” from the menu on the left side

<Frame>
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration4.png?maxW=232&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=4983db119a62f8b7675a6c48495e81a8" alt="webscraperio_integration4.png" width="232" height="500" data-path="images/integrations/webscraperio_integration4.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration4.png?w=280&maxW=232&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ebe29d12e98835605ef757afc37f6edf 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration4.png?w=560&maxW=232&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=36436540b0e685b80a7b14427eb3d7c7 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration4.png?w=840&maxW=232&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=e350abf0ed7f95dc6760bd065aea2a40 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration4.png?w=1100&maxW=232&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=f347fad35cebeecc0a0cc7d1f439cfba 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration4.png?w=1650&maxW=232&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=e98a159d93c18d4192b5e63f28d2a052 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration4.png?w=2500&maxW=232&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=b150f5ffbafc991590da2706f766f454 2500w" data-optimize="true" data-opv="2" />
</Frame>

1. Click **Details Page** next to the sitemap you want to scrape

<Frame>
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration2.png?maxW=1506&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=c184b91cf4fbb8364b23e75ba852daf8" alt="webscraperio_integration2.png" width="1506" height="168" data-path="images/integrations/webscraperio_integration2.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration2.png?w=280&maxW=1506&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=87d91676863679b399f16e700358ad28 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration2.png?w=560&maxW=1506&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=7da8d6c4235e8fabf57d5d86af92f05a 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration2.png?w=840&maxW=1506&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=706902a97a16c4f07c9385d236eb256a 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration2.png?w=1100&maxW=1506&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=e3c0dc69ae4bd97adcb5f93a5646726e 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration2.png?w=1650&maxW=1506&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=18e4fd705e9a1887897969ae11fc96c6 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration2.png?w=2500&maxW=1506&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=0d97f6dbb3646ab29a6919764b78d88c 2500w" data-optimize="true" data-opv="2" />
</Frame>

1. From the **Proxy** drop-down menu select the created proxy and click **Scrape**

<Frame>
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration3.png?maxW=1574&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d58581510337b2ad3af85012fd3a0d5c" alt="webscraperio_integration3.png" width="1574" height="397" data-path="images/integrations/webscraperio_integration3.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration3.png?w=280&maxW=1574&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=b92ad89fdef93ebc51eba04e973ca34d 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration3.png?w=560&maxW=1574&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=b6ac9148eb307f5bf427171f7ab23e0a 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration3.png?w=840&maxW=1574&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=b531e0da812ec0d626e16acf4dadcb80 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration3.png?w=1100&maxW=1574&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=79f79743df72467d19a20dc5a8f87ab4 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration3.png?w=1650&maxW=1574&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=a477bcf78b7eb981b181372cedfd678b 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/webscraperio_integration3.png?w=2500&maxW=1574&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=b4b441bb86e783201b3bff17d09a88bb 2500w" data-optimize="true" data-opv="2" />
</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 Web Scraper API utility - this article refers to the external Webscraper.io integration.&#x20;


# How to Set Up a Bright Data on Windows
Source: https://docs.brightdata.com/integrations/windows

Enhance your online experience with proxies! Whether you're accessing geo-restricted content, safeguarding your privacy, or securing your device, these tools are a powerful way to optimize your browsing. In this guide, we’ll show you how to set up a proxy server on Windows, step by step, for both Windows 10 and 11.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</Tip>

## Setting Up Proxies on Windows

Getting started is simple: Windows 10 and 11 have an identical proxy setup process. Follow these quick steps to configure your settings:

Step 1. **Open Network & Internet Settings**. Press **Windows + I** to launch **Settings**, then navigate to **Network & Internet**.

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/windows1.png?maxW=1920&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=8188b9f15ad5165de3b46732a1e9434f" alt="" width="1920" height="1020" data-path="images/integrations/windows1.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/windows1.png?w=280&maxW=1920&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=5decf0021cf2078fbd47329c2289e620 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/windows1.png?w=560&maxW=1920&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=e353ebfd4e16cb899654ec527c98d6f4 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/windows1.png?w=840&maxW=1920&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=7c0d68fbece53cca15a15c6765a532ec 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/windows1.png?w=1100&maxW=1920&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=c08dd4a379543992eeb9a609d03bfe74 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/windows1.png?w=1650&maxW=1920&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=eb2cd6f8d76d2c62c027b6cbf9beac17 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/windows1.png?w=2500&maxW=1920&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=0b710b9154714330ff4d024a90faebd3 2500w" data-optimize="true" data-opv="2" />
</Frame>

Step 2. **Enable Automatic Detection**. Select **Proxy** from the sidebar menu. Under **Automatic proxy setup**, switch **Automatically detect settings** to *On*.

<Frame as="div">
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/windows2.png?maxW=1920&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=211c0718da1887ea93fd3e8589c3117a" alt="" width="1920" height="1020" data-path="images/integrations/windows2.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/windows2.png?w=280&maxW=1920&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ef4498151be4b7e348ca0bef86046f60 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/windows2.png?w=560&maxW=1920&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=bf3de02b115f6db2585440e3774d7b54 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/windows2.png?w=840&maxW=1920&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=eb26aa60024e6bfe974537356aa155a7 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/windows2.png?w=1100&maxW=1920&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=7d04405a4fd19c0a2c95b87e1ca9f2b7 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/windows2.png?w=1650&maxW=1920&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=b5f1aa10eaf8429ae81ced0d2f6564ad 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/windows2.png?w=2500&maxW=1920&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=911d2ca39148587cc57109882e1ad624 2500w" data-optimize="true" data-opv="2" />
</Frame>

Step 3. **Set Up Manual Proxy Settings**. Scroll to **Manual proxy setup**, switch **Use a proxy server** to *On*, and complete the fields with the following information:

* **Address**: Enter `http://brd.superproxy.io/`.

* **Port**: Use the port number found in your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).

Once finished, click **Save** to confirm your changes.

<Note>
  Windows doesn’t let you save your username and password directly in the proxy settings. Don’t worry! When an app or browser asks for your credentials, just enter your Bright Data **Username** and **Password**. For example, if a pop-up appears while browsing, simply fill in the details to continue securely.
</Note>

All done! Your Windows device is now set up with Bright Data, giving you extra privacy, easy access, and a safer browsing experience. Whether you’re working, streaming, or just exploring, you’re good to go!


# How to Use Bright Data with XLogin
Source: https://docs.brightdata.com/integrations/xlogin

Enhance your XLogin experience with Bright Data’s secure and anonymous proxies. This guide walks you through setting up Bright Data proxies for smoother, safer, and more efficient online automation.

<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 src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=e8c23d13d8d36e20395160a9b30d7350" alt="" width="597" height="508" data-path="snippets/accessdetails.png" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=280&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=f67a7db0d9eba3a55aa4a22af22cba8c 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=560&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=43c51edffb31a7d68d894886f32dda76 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=840&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d8a22e9317820a420b31042502c68716 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1100&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=90e4e8e89d8ffcf23d0c3b687fc068d6 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=1650&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=78ba67247d143859434dfa2028a485bc 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/snippets/accessdetails.png?w=2500&maxW=597&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=d673b9af217c4c3dc0ea284c06ccc2ba 2500w" data-optimize="true" data-opv="2" />

  ### 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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](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 />

  New users should begin with ISP or Data Center proxies, as residential proxies are incompatible with browser integration in [Immediate-Access mode](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) .<br />

  For use-cases related to **account management**, use a consistent static dedicated IP for each account you are managing. dedicated [ISP proxies](https://docs.brightdata.com/proxy-networks/isp/introduction) should be used for this.
</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 scaling e-commerce operations, managing social media campaigns, and conducting detailed research. 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;

## Step-by-Step Integration

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 as="div">
    <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xlogin1.png?maxW=239&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=921e4104cc070237855964fa52eb647d" alt="" width="239" height="265" data-path="images/integrations/xlogin1.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xlogin1.png?w=280&maxW=239&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=61cec345a56237d04cee00c06248f687 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xlogin1.png?w=560&maxW=239&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d8c77b27d15c1b68c2a90b43d47a60f8 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xlogin1.png?w=840&maxW=239&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=bc58145e6af620ffeb9a3a3f35376375 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xlogin1.png?w=1100&maxW=239&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=29f6e5f494356df776864d99f0e727d2 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xlogin1.png?w=1650&maxW=239&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=36a079d3d34a9715b56e8a4e009b1da3 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xlogin1.png?w=2500&maxW=239&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=f04370a15f54a408c6331d977547dae7 2500w" data-optimize="true" data-opv="2" />
</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.

<Frame as="div">
    <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/integrations/xlogin2.png" alt="" />
</Frame>

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!


# How to Set Up Bright Data With xpander.ai
Source: https://docs.brightdata.com/integrations/xpander-ai



[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 cols={1}>
    <Card title="Start Data Collection Job by Dataset ID" icon="1">
      Launches a scraping job for a specified dataset using the Web Scraper APIs.
    </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" stepNumber="0">
    * [xpander.ai account](https://app.xpander.ai/login)
    * [Bright Data API key](https://docs.brightdata.com/api-reference/authentication#api-key)
  </Step>

  <Step title="Create a new agent" stepNumber="1">
    1. In your [profile dashboard](https://app.xpander.ai/agents) and press the “New Agent” button to add a new agent:

    <Frame>
            <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/new-agent-button.png?maxW=2048&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ece6b16a25dbd440b28628d145171203" alt="Clicking the “Agents > New Agent” button" width="2048" height="624" data-path="images/integrations/xpander-ai/new-agent-button.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/new-agent-button.png?w=280&maxW=2048&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=40fc50bf959ac0f6028176c3ce2eb6cd 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/new-agent-button.png?w=560&maxW=2048&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=b3ff555eb0d1a30316d54d8e405879e3 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/new-agent-button.png?w=840&maxW=2048&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=c054399de847b2cf10ca18986de9a7d8 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/new-agent-button.png?w=1100&maxW=2048&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ba55aa455b64ada68df9df4a12d70d19 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/new-agent-button.png?w=1650&maxW=2048&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=7bb65daad171f99196f88e7912c6205d 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/new-agent-button.png?w=2500&maxW=2048&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=14ecde28b49ea85d1a7bc055cc7f17ae 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Basic Configuration" stepNumber="2">
    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 src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/new-agent-name.png?maxW=3054&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d178f28c2192645bb128c6601a0ebfea" alt="Calling the new agent “Web Scraper Agent”" width="3054" height="1495" data-path="images/integrations/xpander-ai/new-agent-name.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/new-agent-name.png?w=280&maxW=3054&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=308a3c6d982a58d6d89bcc73e161a2fe 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/new-agent-name.png?w=560&maxW=3054&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ec3135d70886bf191fc594fc59e46709 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/new-agent-name.png?w=840&maxW=3054&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=f7ae1868815c807f4f3ab91e1b7cc056 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/new-agent-name.png?w=1100&maxW=3054&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=82febfa326f7ebde68a2762efbad042b 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/new-agent-name.png?w=1650&maxW=3054&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ffde0de84c8c344e9f264d7d47854b26 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/new-agent-name.png?w=2500&maxW=3054&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=06988d090c33845fcfa0344e979de3de 2500w" data-optimize="true" data-opv="2" />
    </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" stepNumber="3">
    1. Go to the “Tools” tab on your agent’s page, then click the “Add tools” button:

    <Frame>
            <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/add-tools-button.png?maxW=3054&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=84ca13eadefc6fd914b0630ed02fd6a9" alt="Clicking the “Add tools” button" width="3054" height="1491" data-path="images/integrations/xpander-ai/add-tools-button.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/add-tools-button.png?w=280&maxW=3054&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=8eba602c48b8d615b165172ccc4f097b 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/add-tools-button.png?w=560&maxW=3054&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=56af759f7766c9ba26d7e5c578ab3855 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/add-tools-button.png?w=840&maxW=3054&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=29d6e44f3944c24264d25ffe9ec78354 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/add-tools-button.png?w=1100&maxW=3054&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=46d5e4d56d0828540916f21c9848166e 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/add-tools-button.png?w=1650&maxW=3054&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=0cd61ba8cd0562b3a06858c325c44206 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/add-tools-button.png?w=2500&maxW=3054&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=240388ee4de9cbf1eda02577ed7741dd 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    2. Search for “bright data” on the right side panel and select the Bright Data integration:

    <Frame>
            <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/select-bright-data-connector.png?maxW=825&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=b864d756a2aad035e7ff7691e89574f1" alt="Selecting the Bright Data connector" width="825" height="495" data-path="images/integrations/xpander-ai/select-bright-data-connector.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/select-bright-data-connector.png?w=280&maxW=825&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=07dc6cd6ac59b089bcf5083e143a3304 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/select-bright-data-connector.png?w=560&maxW=825&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=df817f5241102cb27649108992b50c3b 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/select-bright-data-connector.png?w=840&maxW=825&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=a8e9430ec0c947c4c277ee19cef5c058 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/select-bright-data-connector.png?w=1100&maxW=825&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=097e85331befb88192711ac12070968b 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/select-bright-data-connector.png?w=1650&maxW=825&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=f40c36299fde48d4a3045eeeb36fc06a 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/select-bright-data-connector.png?w=2500&maxW=825&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=69a4545ba714627fd4b2887c6ea5f36f 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Configure the Bright Data Connector" stepNumber="4">
    The following modal will show up:

    <Frame>
            <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/connector-configuration-form.png?maxW=1176&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=e04d3a55ccd5678f88252ac0228cbd33" alt="Filling out the Bright Data connector configuration form" width="1176" height="1485" data-path="images/integrations/xpander-ai/connector-configuration-form.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/connector-configuration-form.png?w=280&maxW=1176&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=a0197681317ec22bbd9477e7e2c8517d 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/connector-configuration-form.png?w=560&maxW=1176&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=e6962d7ee792524b533f3a815ef473d6 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/connector-configuration-form.png?w=840&maxW=1176&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=55d9de92a1b822b1203a0574d8861c5b 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/connector-configuration-form.png?w=1100&maxW=1176&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=3587f3ea3a915642480dfaf1393b1d55 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/connector-configuration-form.png?w=1650&maxW=1176&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=2a3e7a57841391e12b4929e2902c9eab 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/connector-configuration-form.png?w=2500&maxW=1176&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9bb740fc67d12c2c9a9c3bb83d74abf5 2500w" data-optimize="true" data-opv="2" />
    </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" stepNumber="5">
    Now, you will be prompted to select the specific Bright Data tools you want to enable in your agent:

    <Frame>
            <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/select-bright-data-tools.png?maxW=790&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=726eea4c9c0861adea3d12509339926b" alt="Selecting the Bright Data tools to enable" width="790" height="657" data-path="images/integrations/xpander-ai/select-bright-data-tools.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/select-bright-data-tools.png?w=280&maxW=790&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=b14f307419cea2b98117e655c0d40f8b 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/select-bright-data-tools.png?w=560&maxW=790&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=636669fa7d3f1fc33274854742548c43 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/select-bright-data-tools.png?w=840&maxW=790&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=a8c598b5118fe68b5dd4cd9c2719455a 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/select-bright-data-tools.png?w=1100&maxW=790&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=8a0c08631f7d6e7785b87e1501aa9168 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/select-bright-data-tools.png?w=1650&maxW=790&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=6e182239edfecdef0ac3d9a7b153348b 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/select-bright-data-tools.png?w=2500&maxW=790&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=c9593cca56de7627cbf56e2158008c1b 2500w" data-optimize="true" data-opv="2" />
    </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 [Web Scraper APIs](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" stepNumber="6">
    Once you have selected the desired tools, click the “Add to agent” button in the bottom-right corner:

    <Frame>
            <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/add-to-agent-button.png?maxW=811&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=655b5e2adb8ada4ffb83fc475d13b7cd" alt="Clicking the “Add to agent” button" width="811" height="127" data-path="images/integrations/xpander-ai/add-to-agent-button.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/add-to-agent-button.png?w=280&maxW=811&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=36f09d015a9d55cef679f732a66e0354 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/add-to-agent-button.png?w=560&maxW=811&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d3f4bcf238f1a204dd098fe9ccf85bed 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/add-to-agent-button.png?w=840&maxW=811&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=f46949c364c12e23afd7400697b051bf 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/add-to-agent-button.png?w=1100&maxW=811&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=e243e1e5d544d6fb40d6a3f0a57541cd 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/add-to-agent-button.png?w=1650&maxW=811&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=e2f5bda9d02e91cf1785fddeda3f9718 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/add-to-agent-button.png?w=2500&maxW=811&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=cb2bec563b7d5766eac0426ca1348676 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    The “Tools” tab of your agent will now show the Bright Data connector with the tools you configured:

    <Frame>
            <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/configured-bright-data-tools.png?maxW=1163&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=6e904025c4f0af790155c61eb4ce4859" alt="Note the configured Bright Data tools" width="1163" height="622" data-path="images/integrations/xpander-ai/configured-bright-data-tools.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/configured-bright-data-tools.png?w=280&maxW=1163&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ac57866a305653265eaed9bd44d12069 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/configured-bright-data-tools.png?w=560&maxW=1163&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=b882b119d9861703d01487fdfa47266c 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/configured-bright-data-tools.png?w=840&maxW=1163&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=3cae589964bafc0c7c7cc76b02f29190 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/configured-bright-data-tools.png?w=1100&maxW=1163&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=68b64d1dadbecd006a8568c8ad2fe346 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/configured-bright-data-tools.png?w=1650&maxW=1163&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d8067ad8e8768412bea9958f12ef565e 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/configured-bright-data-tools.png?w=2500&maxW=1163&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=3898130f219fe22befe28962e71e516e 2500w" data-optimize="true" data-opv="2" />
    </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" stepNumber="8">
    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:

    ```
    You are an AI agent capable of grounding your responses by scraping data from the web
    ```

    <Frame>
            <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/agent-system-prompt.png?maxW=1144&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d6195f7b5570ed5d72195023e7add764" alt="Adding a system prompt to your agent" width="1144" height="1178" data-path="images/integrations/xpander-ai/agent-system-prompt.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/agent-system-prompt.png?w=280&maxW=1144&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=da701ad69c0ec06eb28081e42c50d254 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/agent-system-prompt.png?w=560&maxW=1144&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=f5a871e5eb1b94f4375e871973a84c91 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/agent-system-prompt.png?w=840&maxW=1144&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=925a1ab31d799f498639de4dd22d16c2 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/agent-system-prompt.png?w=1100&maxW=1144&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=c7683e83aa085c3af7f99d3c4ea1eb3e 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/agent-system-prompt.png?w=1650&maxW=1144&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d6718abdb2c7535904c4180aa92cf315 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/agent-system-prompt.png?w=2500&maxW=1144&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9fb1c65070efd39844bab5f01d9436e0 2500w" data-optimize="true" data-opv="2" />
    </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" stepNumber="9">
    Click on the “Agent graph” button to view your current AI agent workflow:

    <Frame>
            <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/agent-graph.png?maxW=1759&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=6dd97e3ff5f473e7f35e75ed991b421b" alt="The agent graph" width="1759" height="1161" data-path="images/integrations/xpander-ai/agent-graph.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/agent-graph.png?w=280&maxW=1759&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=97363cb511abb1570eb3e1c5ff7523d3 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/agent-graph.png?w=560&maxW=1759&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ab10e8a0624613619f66c4523f893a83 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/agent-graph.png?w=840&maxW=1759&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=68ffc3c7b7b04959ba0f110eb2490691 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/agent-graph.png?w=1100&maxW=1759&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=51126a6583f9329585306134c03fa21c 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/agent-graph.png?w=1650&maxW=1759&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=6dabccd50b6ddaff3817bbd2f7f23f5f 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/agent-graph.png?w=2500&maxW=1759&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=33bb44378ac96590dfa37bc5de6b5719 2500w" data-optimize="true" data-opv="2" />
    </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" stepNumber="10">
    Go back to the “Tester Chat” tab and try out your agent with a prompt like this:

    ```
    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 src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/ai-scraping-agent-in-action.png?maxW=1080&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=68dce6ef3f61dce7c44d556b10b67c1b" alt="The AI scraping agent in action" width="1080" height="486" data-path="images/integrations/xpander-ai/ai-scraping-agent-in-action.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/ai-scraping-agent-in-action.png?w=280&maxW=1080&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=569500977ced37cad22379f12adf3b34 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/ai-scraping-agent-in-action.png?w=560&maxW=1080&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=babcf41db1af109508313b6f9e04c503 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/ai-scraping-agent-in-action.png?w=840&maxW=1080&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=99eb25141d1e88cf034dbf5f13712134 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/ai-scraping-agent-in-action.png?w=1100&maxW=1080&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=df8a07f49afb91d9c094fb9c33eca44e 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/ai-scraping-agent-in-action.png?w=1650&maxW=1080&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=0b2f98f02d5002dc813d9cf99dd6c3f7 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/ai-scraping-agent-in-action.png?w=2500&maxW=1080&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=60000b88c67c1ab56928973514d16153 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Analyze the Agent's Response" stepNumber="11">
    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" stepNumber="12">
    If you expand one of the tool sections in the interface, you will see something like this:

    <Frame>
            <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/tool-call-io-details.png?maxW=1657&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=5220bb93126a07ab01c0d5faac98ca92" alt="The I/O details from a tool call" width="1657" height="1029" data-path="images/integrations/xpander-ai/tool-call-io-details.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/tool-call-io-details.png?w=280&maxW=1657&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=bc7cfaa5f15b785d5936033f7026432d 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/tool-call-io-details.png?w=560&maxW=1657&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=827a75c4e38bb1a81c79e0ab5cbaf424 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/tool-call-io-details.png?w=840&maxW=1657&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=574cdfe7ee480259e6d2a2733f173d56 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/tool-call-io-details.png?w=1100&maxW=1657&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=28ffc833728f5241411b246538ab9a84 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/tool-call-io-details.png?w=1650&maxW=1657&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=de49d92b0c46c26f510cd3eae2d02bfc 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/xpander-ai/tool-call-io-details.png?w=2500&maxW=1657&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=2a4c8115cc0e0c6390c5eabccb250066 2500w" data-optimize="true" data-opv="2" />
    </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

Learn how to integrate your Bright Data Actors with Zapier.

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 Unlocker API                         | Creates an 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 (Web Scraper API) | Download snapshot content (Web Scraper API)                                             |
| 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](https://docs.brightdata.com/api-reference/authentication#api-key)
    * An active [Zapier account](https://zapier.com/)
  </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 workflow.
  </Step>

  <Step title="Set Up a Trigger">
    Choose a trigger app and event that align with your use case. For example:

    * Use **Schedule by Zapier** to run a scraper hourly or daily.
    * Use **New Row in Google Sheets** to trigger a scrape when new data is added.
    * Use **Webhook** or **Form Submissions** to trigger scrapers dynamically based on 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 set up your desired action.

    <Frame>
            <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zapier-action-setup.png?maxW=391&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=040b8493d1fcbfe6574cc9bbd7e728f9" alt="zapier-action-setup" width="391" height="740" data-path="images/integrations/zapier-action-setup.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zapier-action-setup.png?w=280&maxW=391&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=82be961a6d784b5fa6bc5bc80584b3e4 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zapier-action-setup.png?w=560&maxW=391&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=792fdd05ee974610d95f220e813483a6 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zapier-action-setup.png?w=840&maxW=391&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=a82c3bd628992bfa6ce237fc5ccfa980 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zapier-action-setup.png?w=1100&maxW=391&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=b0057eeec37c72ec385b451070a7c8ea 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zapier-action-setup.png?w=1650&maxW=391&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=adbafb7661ba5327f859210107890089 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zapier-action-setup.png?w=2500&maxW=391&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=5a1448adfbd07b814063a2f14ce8349e 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Select an Action Event">
    Choose the specific Bright Data action you want to perform. For example, to scrape Amazon, select **Scrape Amazon**. Available options include scraping from various platforms such as LinkedIn, TikTok, YouTube, and more.
  </Step>

  <Step title="Connect Your Bright Data Account">
    Click Sign In next to the Bright Data connection field to authorize your account. A new window will open where you can enter your Bright Data API key.

    <Frame>
            <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zapier-api-key.png?maxW=950&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=b4976ff64330b12a091a329b4bee3e6b" alt="zapier-api-key" width="950" height="695" data-path="images/integrations/zapier-api-key.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zapier-api-key.png?w=280&maxW=950&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=8d2b15253f6a51048f3cf1caae44d049 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zapier-api-key.png?w=560&maxW=950&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=acf448b713b21394ea4bad68f0efb480 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zapier-api-key.png?w=840&maxW=950&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=577861c0d2a25e6de6d87f88d88b7363 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zapier-api-key.png?w=1100&maxW=950&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=ef0348c2582644d7620fb06643846341 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zapier-api-key.png?w=1650&maxW=950&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=e860f03b3c413890549d8b4c7e65a340 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/integrations/zapier-api-key.png?w=2500&maxW=950&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9586dbcc6cd399b1af19c0665e910efa 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Configure and Test Your Action">
    Customize the scraping parameters based on your selected action. For example, the **Scrape Amazon** action allows you to extract:

    * Product details
    * Reviews
    * Seller information
    * Product search results
    * Global product database entries

    Once configured, click **Test Action** to ensure your setup is working correctly. You should receive a sample response to verify the output.
  </Step>

  <Step title="Publish Your Zap">
    After a successful test, click **Publish Zap** to activate your workflow. Once published, it will run automatically based on your trigger conditions.

    You can also chain additional actions, such as sending notifications via Slack or email, or populating structured data into tools like Google Sheets, Airtable, or CRMs.

    The possibilities are endless!
  </Step>
</Steps>

## Conclusion

With Bright Data’s Zapier integration, you can automate your web data collection workflows without writing a single line of code. From scheduled scrapes to dynamic triggers tied to real-time inputs, this integration makes it easy to gather, manage, and route web data wherever you need it, streamlining reporting, monitoring, and business operations across your favorite tools.


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

Bright Data provides a powerful data collection platform to help you reliably build, run, and scale your web scraping operations. Discover, access, navigate, extract, and structure the web—delivering unmatched performance at every step.

<Note>
  ### Special Offer

  [Start now](https://brightdata.com/?hs_signup=1\&utm_source=docs) with \$5 credits, no credit card required. We’ll match your first account deposit up to \$500 !
</Note>

<Card>
  <CardGroup cols={2}>
    <Card title="Proxy Infrastructure" icon="globe" href="/proxy-networks">
      Access any website, anywhere, anytime. Navigate the web without barriers using our network of 150M+ high-performance IPs with 99.99% uptime. Build your data operations ethical and reliably.
    </Card>

    <Card title="Web Access APIs" icon="bolt" href="/scraping-automation">
      Automate web data collection, our APIs handle all the complex parts—unblocking, remote browsers, crawling, and search. So you can focus on using the data, not gathering it.
    </Card>

    <Card title="Data Feeds" icon="table" href="/datasets">
      Get actionable web data without building scrapers. Our Data Feeds deliver structured information in real-time or historical, with zero infrastructure management on your end.
    </Card>

    <Card title="MCP Server" icon="microchip-ai" href="/mcp-server/overview">
      Make your AI smarter with live web intelligence. Our MCP Server connects your models to real-time public web data, delivering relevant content without the complexity of managing scrapers.
    </Card>
  </CardGroup>
</Card>

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

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


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





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





# FAQ: MCP
Source: https://docs.brightdata.com/mcp-server/faqs

Find answers to common questions about integrating, configuring, and using Bright Data's MCP server.

<AccordionGroup>
  <Accordion title="What is Bright Data MCP Server?">
    how to set country for browser api mcpBright 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.\
    \
    \*For our new MCP users, we are offering a FREE tier\
    \
    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**](https://docs.brightdata.com/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 out the MCP Smithery playground**](https://smithery.ai/server/@luminati-io/brightdata-mcp/tools) to test and experiment with live requests in a no-code environment.
  </Accordion>

  <Accordion title="There are limitations for Bright Data free tier?">
    Yes, there is a limit of 5000 request per month.
  </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="How do I use Bright Data MCP Server?">
    Bright Data MCP (Model Context Protocol) is a local server that allows AI agents, LLMs, and dev tools to access and extract real-time web data using Bright Data’s infrastructure.

    To get started: [**BrightData-MCP**](https://docs.brightdata.com/mcp-server/overview)

    **Helpful links:**

    * [ MCP GitHub Repository](https://github.com/brightdata/brightdata-mcp)
    * [ MCP API Documentation](https://docs.brightdata.com/mcp-server/overview)
    * [ Try MCP in Smithery Playground](https://smithery.ai/server/@luminati-io/brightdata-mcp/tools)
  </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 HTTP requests

    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: [Smithery Playground](https://smithery.ai/server/@luminati-io/brightdata-mcp/tools)
  </Accordion>

  <Accordion title="How do I enable browser control tools?">
    To enable browser control tools:

    1. Visit your Bright Data control panel at [brightdata.com/cp/zones](https://brightdata.com/cp/zones)
    2. Create a new 'Browser API' zone
    3. Once created, copy the authentication string from the Browser API overview tab
    4. The authentication string will be formatted like: `brd-customer-[your-customer-ID]-zone-[your-zone-ID]:[your-password]`
    5. Add this authentication string to your MCP configuration as the `BROWSER_AUTH` environment variable
  </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 for 99% of requests)
    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
    {
      "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 playground on [Smithery](https://smithery.ai/server/@luminati-io/brightdata-mcp/tools).
    This platform 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 to connect my AI agent with Bright Data's MCP?" iconType="solid">
    You can connect your AI agent with bright data by:

    * Install [Node.js package](https://nodejs.org/en/download)
    * Create [A Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs)  (new users get free credit for testing)
    * And 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.)
    * Then 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](https://docs.brightdata.com/mcp-server/overview#configuration).
  </Accordion>

  <Accordion title="When using MCP, should I create zones or configure them?">
    No, we will create thoes for you :) All you need is NodeJS and your BrightData API key. If you want to change your zone name to something specific, you always can do it.
  </Accordion>

  <Accordion title="There is a free tier for Bright Data MCP?">
    Yes! Bright Data provid a free tier for our new MCP users
  </Accordion>

  <Accordion title="How to set country for browser api mcp?">
    Currently, the MCP (Model Context Protocol) integration does not support direct country targeting via a dedicated country parameter in the MCP configuration itself. However, you can control the country selection by specifying a custom zone in your MCP setup, and then configure that zone in your Bright Data Control Panel to target the country you want.

    Here’s how you can achieve country targeting with MCP:

    1. **Create a Zone for the Desired Country:**
       * In your Bright Data Control Panel, create a new zone (e.g., Residential, Mobile, or Browser API) and set the geolocation targeting to your desired country in the zone’s configuration.
    2. **Specify the Zone in Your MCP Configuration:**
       * In your MCP client configuration, use the environment variable for the relevant zone:
         * For web scraping: `WEB_UNLOCKER_ZONE`
         * For browser automation: `BROWSER_ZONE`
       * Example (for a custom browser zone):

         json

         ```
         {
           "mcpServers": {
             "Bright Data": {
               "command": "npx",
               "args": ["@brightdata/mcp"],
               "env": {
                 "API_TOKEN": "<your_api_key>",
                 "BROWSER_ZONE": "<your_zone_name>"
               }
             }
           }
         }

         ```
       * Make sure `<your_zone_name>` is the zone you configured for the specific country.
    3. **Requests through MCP will now use the country targeting set in your zone.**

    For more details, see the [MCP Server documentation](https://docs.brightdata.com/mcp-server/overview) and [Browser API location targeting](https://docs.brightdata.com/scraping-automation/scraping-browser/features/proxy-location?_gl=1*g3vjv6*_gcl_au*OTk4MjcxMzc1LjE3NTQyOTAyMDQ.*_ga*NjYwNjM1MTUwLjE3NTQyOTAyMDQ.*_ga_KQX3XWKR2T*czE3NTQyOTAyMDQkbzEkZzEkdDE3NTQyOTA0MzMkajUxJGwwJGgw).
  </Accordion>
</AccordionGroup>


# Claude Desktop Integration
Source: https://docs.brightdata.com/mcp-server/integrations/claude

How to integrate Claude Desktop with Bright Data's MCP server for enhanced AI capabilities.

**Getting Started Video**:

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/2lspK4o2tTo" title="Easiest way to start with Claude" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

## 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
    {
      "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
    {
      "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
    {
      "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>",
            "ADVANCED_MODE":"<Optional - deafult : false set to true if you want to expose all 60+ tools>"     
          }
        }
      }
    }
    ```
  </Step>
</Steps>


# Claude Code MCP Server Integration
Source: https://docs.brightdata.com/mcp-server/integrations/claude-code

How to integrate Claude Code with Bright Data's MCP server for enhanced AI capabilities.

## Quick Install

To integrate Bright Data into Claude Code, simply copy this command to your terminal:

```bash
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
    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
    claude mcp list
    ```

    You should see the following output confirming successful connection:

    ```
    brightdata: https://mcp.brightdata.com/sse?token=<yourapikey>(SSE) - ✓ Connected
    ```
  </Step>
</Steps>


# CrewAI Integration
Source: https://docs.brightdata.com/mcp-server/integrations/crewai

How to integrate CrewAI with Bright Data's The Web MCP server for enhanced AI agent capabilities.

## 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
    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/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/mcp-server/integrations/cursor

How to integrate Cursor with Bright Data's MCP server for enhanced AI capabilities.

## 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
    {
        "mcpServers": {
        "brightdata-mcp": {
            "command": "npx",
            "args": ["-y", "@brightdata/mcp"],
            "env": {
            "API_TOKEN": "<your API token>"
            }
        }
        }
    }
    ```

    <Frame>
      <img src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Screenshot2025-07-14at13.50.57.png?maxW=1453&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=25138dc5510eb4b2b438e47761a9dc9c" alt="Screenshot 2025-07-14 at 13.50.57.png" title="Screenshot 2025-07-14 at 13.50.57.png" width="1453" height="602" data-path="images/Screenshot2025-07-14at13.50.57.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Screenshot2025-07-14at13.50.57.png?w=280&maxW=1453&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=eca591dd5f06a276e752b83cfa4df9dc 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Screenshot2025-07-14at13.50.57.png?w=560&maxW=1453&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=6b0f21741779110a5127c899f71cad34 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Screenshot2025-07-14at13.50.57.png?w=840&maxW=1453&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=8c31006f77f601c6e8711b9bb42148fe 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Screenshot2025-07-14at13.50.57.png?w=1100&maxW=1453&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=0a49db513365961c90b81715e0192659 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Screenshot2025-07-14at13.50.57.png?w=1650&maxW=1453&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=7113931f520a5342f63efde1a60eaf67 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Screenshot2025-07-14at13.50.57.png?w=2500&maxW=1453&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=1b740d3f04b81f697adc47977df461b4 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    Then you need to see:

    <Frame>
      <img src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Screenshot2025-07-14at14.18.16.png?maxW=386&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=02d50927eb4e8b1a9adf365b5c946428" alt="Screenshot 2025-07-14 at 14.18.16.png" title="Screenshot 2025-07-14 at 14.18.16.png" width="386" height="153" data-path="images/Screenshot2025-07-14at14.18.16.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Screenshot2025-07-14at14.18.16.png?w=280&maxW=386&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=3e72b2c87d8dad5ff761635185e62c29 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Screenshot2025-07-14at14.18.16.png?w=560&maxW=386&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=b9fee55214bd3c31ff2ca71bed5efe4a 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Screenshot2025-07-14at14.18.16.png?w=840&maxW=386&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=01667a4f55218cc72e4745b6c6d40af2 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Screenshot2025-07-14at14.18.16.png?w=1100&maxW=386&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=99d7477927e6138a22ada52f6a7c7684 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Screenshot2025-07-14at14.18.16.png?w=1650&maxW=386&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=870efc86ca018f3bd35db8c6aba5f224 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/images/Screenshot2025-07-14at14.18.16.png?w=2500&maxW=386&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=236010939349610f218a56c4784b2400 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>
</Steps>


# LangChain Integration
Source: https://docs.brightdata.com/mcp-server/integrations/langchain

How to integrate LangChain with Bright Data's The Web MCP server for enhanced AI agent capabilities.

## 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
    pip install langchain-mcp-adapters
    ```
  </Step>

  <Step title="Configure your MCP server">
    ```python expandable
    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
    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/mcp-server/integrations/llamaindex

How to integrate LlamaIndex with Bright Data's The Web MCP server for enhanced AI agent capabilities.

## 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
    pip install llama-index-tools-mcp
    ```
  </Step>

  <Step title="Configure your MCP server">
    ```python expandable
    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>


# n8n Integration
Source: https://docs.brightdata.com/mcp-server/integrations/n8n



### Self-hosted MCP Integration

**Requirements:**

* [Node.js](https://nodejs.org/en/download) installed
* [Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs)
* API token from [user settings](https://brightdata.com/cp/setting/users)

**Configuration:**

1. Create an AI Agent in your preferred platform.
2. Attach:
   * A Chat Model (e.g., `gpt-4`, `gpt-4o`)
   * Bright Data MCP client (via HTTP or WebSocket)
3. Configure:

| **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 format>" |

*`Example for RATE_LIMIT: possible values: 100/1h, 50/30m, 10/5s`*

***

### SSE-Based MCP Integration

You can also integrate our MCP via SSE (Server-Sent Events)\\

**Requirements:**

* [Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs)
* API token from [user settings](https://brightdata.com/cp/setting/users)

**Configuration:**

1. Create an AI Agent in your preferred platform.
2. Attach:
   * A Chat Model (e.g., `gpt-4`, `gpt-4o`)
   * Bright Data MCP client (via HTTP or WebSocket)
3. Configure SSE (Server-Sent Events) with:

   ```sh
    https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN_HERE
   ```
4. In n8n, use the HTTP Request node to send prompts and receive streaming responses.

The AI agent will use the MCP client to perform the task and stream back the results in real time.

<Info>
  **Contribution and Support**

  This node was created by [Miquel Colomer Salas](https://www.linkedin.com/in/miquelcolomersalas/) at [n8nhackers.com](https://n8nhackers.com).
</Info>


# OpenAI SDK Integration
Source: https://docs.brightdata.com/mcp-server/integrations/openai

How to integrate OpenAI with Bright Data's MCP server for enhanced AI capabilities.

## 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
    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>


# VS Code MCP Server Integration
Source: https://docs.brightdata.com/mcp-server/integrations/vscode

How to integrate VS Code with Bright Data's MCP server for enhanced AI capabilities.

## 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" target="_blank">
      <img src="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/visual-studio-code-svgrepo-com.svg?maxW=800&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=5215720e2a6af0d8ef41c3a39f38538f" alt="Install in VS Code" noZoom={true} height="0" className="mr-auto" title="" style={{ width: "5%", margin: "0", padding: "0" }} width="800" height="800" data-path="visual-studio-code-svgrepo-com.svg" srcset="https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/visual-studio-code-svgrepo-com.svg?w=280&maxW=800&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=b2eff30cc0006cf6ce1c21ed24dbb114 280w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/visual-studio-code-svgrepo-com.svg?w=560&maxW=800&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=74ea5688e46e8aabd5802410d644934f 560w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/visual-studio-code-svgrepo-com.svg?w=840&maxW=800&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=11cf37d0e89b74309da4aab6ab0566dd 840w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/visual-studio-code-svgrepo-com.svg?w=1100&maxW=800&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=941bd61a2c763fefc73841595ac9fa72 1100w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/visual-studio-code-svgrepo-com.svg?w=1650&maxW=800&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=ee032db7b9ee25c79aef5fce216cc8f1 1650w, https://mintcdn.com/brightdata/fC1f9RYBP6dv7X6V/visual-studio-code-svgrepo-com.svg?w=2500&maxW=800&auto=format&n=fC1f9RYBP6dv7X6V&q=85&s=77410cdc5ebadec12c376aef63affb9b 2500w" data-optimize="true" data-opv="2" />
    </a>
  </Step>
</Steps>


# Advanced Configuration
Source: https://docs.brightdata.com/mcp-server/local/advanced

Once you’ve completed the basic setup, you can customize your MCP server with advanced options.

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

<Tip>
  **Rapid (Free)** mode is enabled by default and is **recommended** for everyday browsing and data needs.
</Tip>

***

## Local Configuration

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`).

<Tip>
  Use `PRO_MODE=true` to enable **Pro mode**.
</Tip>

### Usage Example:

```json
{
  "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"
      }
    }
  }
}
```


# How to Set Up Local (Self-hosted) MCP
Source: https://docs.brightdata.com/mcp-server/local/quickstart

Step-by-step guide for setting up a self-hosted MCP server instance.

<Steps>
  <Step title="Prerequisites">
    Before you begin, make sure you have the following:

    <CardGroup cols={2}>
      <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>
  </Step>

  <Step title="Choose Your Client">
    Select and configure your preferred MCP client:

    * <a href="https://docs.brightdata.com/integrations/claude#self-hosted-mcp"><span style={{ display: "inline-flex", alignItems: "center", gap: "4px" }}>{<svg xmlns="http://www.w3.org/2000/svg" fillRule="evenodd" clipRule="evenodd" imageRendering="optimizeQuality" shapeRendering="geometricPrecision" textRendering="geometricPrecision" viewBox="0 0 512 509.64" width="24" height="24"><path fill="#D77655" d="M115.612 0h280.775C459.974 0 512 52.026 512 115.612v278.415c0 63.587-52.026 115.612-115.613 115.612H115.612C52.026 509.639 0 457.614 0 394.027V115.612C0 52.026 52.026 0 115.612 0"></path><path fill="#FCF2EE" fillRule="nonzero" d="m142.27 316.619 73.655-41.326 1.238-3.589-1.238-1.996-3.589-.001-12.31-.759-42.084-1.138-36.498-1.516-35.361-1.896-8.897-1.895-8.34-10.995.859-5.484 7.482-5.03 10.717.935 23.683 1.617 35.537 2.452 25.782 1.517 38.193 3.968h6.064l.86-2.451-2.073-1.517-1.618-1.517-36.776-24.922-39.81-26.338-20.852-15.166-11.273-7.683-5.687-7.204-2.451-15.721 10.237-11.273 13.75.935 3.513.936 13.928 10.716 29.749 23.027 38.848 28.612 5.687 4.727 2.275-1.617.278-1.138-2.553-4.271-21.13-38.193-22.546-38.848-10.035-16.101-2.654-9.655c-.935-3.968-1.617-7.304-1.617-11.374l11.652-15.823 6.445-2.073 15.545 2.073 6.547 5.687 9.655 22.092 15.646 34.78 24.265 47.291 7.103 14.028 3.791 12.992 1.416 3.968 2.449-.001v-2.275l1.997-26.641 3.69-32.707 3.589-42.084 1.239-11.854 5.863-14.206 11.652-7.683 9.099 4.348 7.482 10.716-1.036 6.926-4.449 28.915-8.72 45.294-5.687 30.331h3.313l3.792-3.791 15.342-20.372 25.782-32.227 11.374-12.789 13.27-14.129 8.517-6.724 16.1-.001 11.854 17.617-5.307 18.199-16.581 21.029-13.75 17.819-19.716 26.54-12.309 21.231 1.138 1.694 2.932-.278 44.536-9.479 24.062-4.347 28.714-4.928 12.992 6.066 1.416 6.167-5.106 12.613-30.71 7.583-36.018 7.204-53.636 12.689-.657.48.758.935 24.164 2.275 10.337.556h25.301l47.114 3.514 12.309 8.139 7.381 9.959-1.238 7.583-18.957 9.655-25.579-6.066-59.702-14.205-20.474-5.106-2.83-.001v1.694l17.061 16.682 31.266 28.233 39.152 36.397 1.997 8.999-5.03 7.102-5.307-.758-34.401-25.883-13.27-11.651-30.053-25.302-1.996-.001v2.654l6.926 10.136 36.574 54.975 1.895 16.859-2.653 5.485-9.479 3.311-10.414-1.895-21.408-30.054-22.092-33.844-17.819-30.331-2.173 1.238-10.515 113.261-4.929 5.788-11.374 4.348-9.478-7.204-5.03-11.652 5.03-23.027 6.066-30.052 4.928-23.886 4.449-29.674 2.654-9.858-.177-.657-2.173.278-22.37 30.71-34.021 45.977-26.919 28.815-6.445 2.553-11.173-5.789 1.037-10.337 6.243-9.2 37.257-47.392 22.47-29.371 14.508-16.961-.101-2.451h-.859l-98.954 64.251-17.618 2.275-7.583-7.103.936-11.652 3.589-3.791 29.749-20.474-.101.102z"></path></svg>} Claude</span></a>
    * <a href="https://docs.brightdata.com/integrations/n8n#self-hosted-mcp-integration"><span style={{ display: "inline-flex", alignItems: "center", gap: "4px" }}>{<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="none" viewBox="0 0 228 120"><path fill="#EA4B71" fillRule="evenodd" d="M204 48c-11.183 0-20.58-7.649-23.244-18h-27.508a12 12 0 0 0-11.836 10.027l-.987 5.919A23.94 23.94 0 0 1 132.626 60a23.94 23.94 0 0 1 7.799 14.054l.987 5.919A12 12 0 0 0 153.248 90h3.508C159.42 79.649 168.817 72 180 72c13.255 0 24 10.745 24 24s-10.745 24-24 24c-11.183 0-20.58-7.649-23.244-18h-3.508c-11.732 0-21.744-8.482-23.673-20.054l-.987-5.919A12 12 0 0 0 116.752 66h-9.508C104.58 76.351 95.183 84 84 84s-20.58-7.649-23.244-18H47.244C44.58 76.351 35.183 84 24 84 10.745 84 0 73.255 0 60s10.745-24 24-24c11.183 0 20.58 7.649 23.244 18h13.512C63.42 43.649 72.817 36 84 36s20.58 7.649 23.244 18h9.508a12 12 0 0 0 11.836-10.027l.987-5.919C131.504 26.482 141.516 18 153.248 18h27.508C183.42 7.649 192.817 0 204 0c13.255 0 24 10.745 24 24s-10.745 24-24 24m0-12c6.627 0 12-5.373 12-12s-5.373-12-12-12-12 5.373-12 12 5.373 12 12 12M24 72c6.627 0 12-5.373 12-12s-5.373-12-12-12-12 5.373-12 12 5.373 12 12 12m72-12c0 6.627-5.373 12-12 12s-12-5.373-12-12 5.373-12 12-12 12 5.373 12 12m96 36c0 6.627-5.373 12-12 12s-12-5.373-12-12 5.373-12 12-12 12 5.373 12 12" clipRule="evenodd"></path></svg>} 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" iconType="sharp-solid">
        “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" cta="Click here" icon="sliders" href="/mcp-server/advanced-config#local-configuration">
  See the Advanced Configuration page for more details.
</Card>


# MCP Server Overview
Source: https://docs.brightdata.com/mcp-server/overview

The Web Model Context Protocol (MCP) by Bright Data empowers your AI models and agents with real-time, reliable access to public web data — now available for free.

<Card title="Get Started for Free" cta="Sign Up Now" icon="rocket" href="https://brightdata.com/?hs_signup=1&utm_source=docs">
  Start using Bright Data’s MCP service with **5,000 requests** per month — completely FREE.
</Card>

## Choose Your MCP Server

<CardGroup>
  <Card title="Remote (Hosted) MCP" cta="Quick Start" icon="cloud" href="/mcp-server/remote/quickstart">
    Launch a fully managed MCP server in the cloud — no setup required.
  </Card>

  <Card title="Local (Self-hosted) MCP" cta="Quick Start" icon="house" href="/mcp-server/local/quickstart">
    Set up your own MCP server instance on-premise or in your private cloud.
  </Card>
</CardGroup>

## Explore MCP Server Resources

<CardGroup>
  <Card title="Tools" icon="wrench" href="/mcp-server/tools">
    Discover the built-in tools available for your MCP Server.
  </Card>

  <Card title="FAQs" icon="book-open" href="/mcp-server/faqs">
    Get quick answers to frequently asked MCP Server questions.
  </Card>

  <Card title="Usage Examples" icon="code" href="/mcp-server/usage-examples">
    Learn from practical examples to accelerate your implementation.
  </Card>

  <Card title="Integrations" icon="puzzle-piece" href="/mcp-server/integrations">
    Connect MCP Server with leading AI platforms like Claude, Cursor, and more.
  </Card>
</CardGroup>

<Tip>
  With Bright Data’s free MCP tier, your applications can seamlessly access both static and dynamic web content — without building or maintaining complex data pipelines.
</Tip>

<Note>
  For team accounts, the MCP free tier is shared across all users within the account. If you require additional credits, please contact your account manager.
</Note>


# Advanced Configuration
Source: https://docs.brightdata.com/mcp-server/remote/advanced

Once you’ve completed the basic setup, you can customize your MCP server with advanced options.

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

<Tip>
  **Rapid (Free)** mode is enabled by default and is **recommended** for everyday browsing and data needs.
</Tip>

***

## Remote Configuration

When using a remote MCP server, you can configure advanced options by passing query parameters to your endpoint:

<ParamField query="unlocker" type="string" default="mcp_unlocker">
  Use a custom zone name for web scraping.

  > **For example:** `&unlocker=my_zone_name`
</ParamField>

<ParamField query="browser" type="string" default="mcp_browser">
  Use a custom zone name for browser automation.

  > **For example:** `&browser=my_browser_zone`
</ParamField>

<ParamField query="pro" type="number" default="0">
  Enable advanced (Pro) processing.

  > **For example:** `&pro=1`

  <Tip>
    Use `&pro=1` to enable **Pro mode**.
  </Tip>
</ParamField>

### Usage Example:

<CodeGroup>
  ```sh SSE (Server-Sent Events) endpoint:
  https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN&unlocker=my_zone_name&browser=my_browser_zone&pro=1
  ```

  ```sh Streamable HTTP endpoint:
  https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN&unlocker=my_zone_name&browser=my_browser_zone&pro=1
  ```
</CodeGroup>

***


# How to Get Started with Remote MCP Server
Source: https://docs.brightdata.com/mcp-server/remote/quickstart

Step-by-step guide for integrating with the Remote MCP Server.

<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:
      https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN
      ```

      ```sh Streamable HTTP endpoint:
      https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
      ```
    </CodeGroup>

    <Tip>
      Replace `YOUR_API_TOKEN` with your actual Bright Data API token.
    </Tip>
  </Step>

  <Step title="Choose Your Client">
    Select and configure your preferred client:

    * <a href="https://docs.brightdata.com/integrations/claude#hosted-mcp"><span style={{ display: "inline-flex", alignItems: "center", gap: "4px" }}>{<svg xmlns="http://www.w3.org/2000/svg" fillRule="evenodd" clipRule="evenodd" imageRendering="optimizeQuality" shapeRendering="geometricPrecision" textRendering="geometricPrecision" viewBox="0 0 512 509.64" width="24" height="24"><path fill="#D77655" d="M115.612 0h280.775C459.974 0 512 52.026 512 115.612v278.415c0 63.587-52.026 115.612-115.613 115.612H115.612C52.026 509.639 0 457.614 0 394.027V115.612C0 52.026 52.026 0 115.612 0"></path><path fill="#FCF2EE" fillRule="nonzero" d="m142.27 316.619 73.655-41.326 1.238-3.589-1.238-1.996-3.589-.001-12.31-.759-42.084-1.138-36.498-1.516-35.361-1.896-8.897-1.895-8.34-10.995.859-5.484 7.482-5.03 10.717.935 23.683 1.617 35.537 2.452 25.782 1.517 38.193 3.968h6.064l.86-2.451-2.073-1.517-1.618-1.517-36.776-24.922-39.81-26.338-20.852-15.166-11.273-7.683-5.687-7.204-2.451-15.721 10.237-11.273 13.75.935 3.513.936 13.928 10.716 29.749 23.027 38.848 28.612 5.687 4.727 2.275-1.617.278-1.138-2.553-4.271-21.13-38.193-22.546-38.848-10.035-16.101-2.654-9.655c-.935-3.968-1.617-7.304-1.617-11.374l11.652-15.823 6.445-2.073 15.545 2.073 6.547 5.687 9.655 22.092 15.646 34.78 24.265 47.291 7.103 14.028 3.791 12.992 1.416 3.968 2.449-.001v-2.275l1.997-26.641 3.69-32.707 3.589-42.084 1.239-11.854 5.863-14.206 11.652-7.683 9.099 4.348 7.482 10.716-1.036 6.926-4.449 28.915-8.72 45.294-5.687 30.331h3.313l3.792-3.791 15.342-20.372 25.782-32.227 11.374-12.789 13.27-14.129 8.517-6.724 16.1-.001 11.854 17.617-5.307 18.199-16.581 21.029-13.75 17.819-19.716 26.54-12.309 21.231 1.138 1.694 2.932-.278 44.536-9.479 24.062-4.347 28.714-4.928 12.992 6.066 1.416 6.167-5.106 12.613-30.71 7.583-36.018 7.204-53.636 12.689-.657.48.758.935 24.164 2.275 10.337.556h25.301l47.114 3.514 12.309 8.139 7.381 9.959-1.238 7.583-18.957 9.655-25.579-6.066-59.702-14.205-20.474-5.106-2.83-.001v1.694l17.061 16.682 31.266 28.233 39.152 36.397 1.997 8.999-5.03 7.102-5.307-.758-34.401-25.883-13.27-11.651-30.053-25.302-1.996-.001v2.654l6.926 10.136 36.574 54.975 1.895 16.859-2.653 5.485-9.479 3.311-10.414-1.895-21.408-30.054-22.092-33.844-17.819-30.331-2.173 1.238-10.515 113.261-4.929 5.788-11.374 4.348-9.478-7.204-5.03-11.652 5.03-23.027 6.066-30.052 4.928-23.886 4.449-29.674 2.654-9.858-.177-.657-2.173.278-22.37 30.71-34.021 45.977-26.919 28.815-6.445 2.553-11.173-5.789 1.037-10.337 6.243-9.2 37.257-47.392 22.47-29.371 14.508-16.961-.101-2.451h-.859l-98.954 64.251-17.618 2.275-7.583-7.103.936-11.652 3.589-3.791 29.749-20.474-.101.102z"></path></svg>} Claude</span></a>
    * <a href="https://docs.brightdata.com/integrations/cursor"><span style={{ display: "inline-flex", alignItems: "center", gap: "4px" }}>{<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="none" className="size-30" viewBox="0 0 104 104"><rect width="104" height="104" fill="#0C0C0C" rx="22"></rect><path fill="#939393" d="M51.998 90.405v-37.8L20 71.504z"></path><path fill="#E3E3E3" d="M84 33.703 52.001 90.404v-37.8z"></path><path fill="#FFF" d="M20 33.703h63.995l-31.998 18.9z"></path><path fill="#444" d="M52.002 14.804v18.9h31.997z"></path><path fill="#939393" d="M20 33.705h31.998v-18.9zm64 37.799-16-9.45-15.998 28.35z"></path><path fill="#444" d="m83.996 33.703-15.999 28.35 15.999 9.45zM51.998 52.604 20 71.504v-37.8z"></path></svg>} Cursor</span></a>
    * <a href="https://docs.brightdata.com/integrations/n8n#sse-based-mcp-integration"><span style={{ display: "inline-flex", alignItems: "center", gap: "4px" }}>{<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="none" viewBox="0 0 228 120"><path fill="#EA4B71" fillRule="evenodd" d="M204 48c-11.183 0-20.58-7.649-23.244-18h-27.508a12 12 0 0 0-11.836 10.027l-.987 5.919A23.94 23.94 0 0 1 132.626 60a23.94 23.94 0 0 1 7.799 14.054l.987 5.919A12 12 0 0 0 153.248 90h3.508C159.42 79.649 168.817 72 180 72c13.255 0 24 10.745 24 24s-10.745 24-24 24c-11.183 0-20.58-7.649-23.244-18h-3.508c-11.732 0-21.744-8.482-23.673-20.054l-.987-5.919A12 12 0 0 0 116.752 66h-9.508C104.58 76.351 95.183 84 84 84s-20.58-7.649-23.244-18H47.244C44.58 76.351 35.183 84 24 84 10.745 84 0 73.255 0 60s10.745-24 24-24c11.183 0 20.58 7.649 23.244 18h13.512C63.42 43.649 72.817 36 84 36s20.58 7.649 23.244 18h9.508a12 12 0 0 0 11.836-10.027l.987-5.919C131.504 26.482 141.516 18 153.248 18h27.508C183.42 7.649 192.817 0 204 0c13.255 0 24 10.745 24 24s-10.745 24-24 24m0-12c6.627 0 12-5.373 12-12s-5.373-12-12-12-12 5.373-12 12 5.373 12 12 12M24 72c6.627 0 12-5.373 12-12s-5.373-12-12-12-12 5.373-12 12 5.373 12 12 12m72-12c0 6.627-5.373 12-12 12s-12-5.373-12-12 5.373-12 12-12 12 5.373 12 12m96 36c0 6.627-5.373 12-12 12s-12-5.373-12-12 5.373-12 12-12 12 5.373 12 12" clipRule="evenodd"></path></svg>} 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" iconType="sharp-solid">
        “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" cta="Click here" icon="sliders" href="/mcp-server/advanced-config#remote-configuration">
  See the Advanced Configuration page for more details.
</Card>


# Tools
Source: https://docs.brightdata.com/mcp-server/tools

Overview of available tools for web scraping and data extraction.

<Note>
  ### Modes: Rapid (Free) vs Pro

  Bright Data's MCP server offers two modes to suit different needs:

  * <Icon icon="gift" iconType="duotone" size={20} />   **Rapid (Free)** - Quickly scrape search results and unlock any public webpage as clean Markdown.

  * <Icon icon="gem" iconType="duotone" size={20} />   **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.

  ***

  To use **Pro mode**:

  * In Remote MCP, request Pro features by setting `&pro=1`.
  * In Local MCP, enable Pro features with `PRO_MODE=true`.
</Note>

<Tip>
  **Rapid (Free)** mode is enabled by default and is **recommended** for everyday browsing and data needs.
</Tip>

|                        Mode                       | Feature                                  | Description                                                                                                                                                                                        |
| :-----------------------------------------------: | :--------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <Icon icon="gift" iconType="duotone" size={20} /> | `search_engine`                          | Scrape search results from Google, Bing or Yandex. Returns SERP results in markdown (URL, title, description)                                                                                      |
| <Icon icon="gift" iconType="duotone" size={20} /> | `scrape_as_markdown`                     | Scrape a single webpage URL with advanced options for content extraction and get back the results in MarkDown language. This tool can unlock any webpage even if it uses bot detection or CAPTCHA. |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `scrape_as_html`                         | Scrape a single webpage URL with advanced options for content extraction and get back the results in HTML. This tool can unlock any webpage even if it uses bot detection or CAPTCHA.              |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `session_stats`                          | Tell the user about the tool usage during this session                                                                                                                                             |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_amazon_product`                | Quickly read structured amazon product data. Requires a valid product URL with /dp/ in it. This can be a cache lookup, so it can be more reliable than scraping                                    |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_amazon_product_reviews`        | Quickly read structured amazon product review data. Requires a valid product URL with /dp/ in it. This can be a cache lookup, so it can be more reliable than scraping                             |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_linkedin_person_profile`       | Quickly read structured linkedin people profile data. This can be a cache lookup, so it can be more reliable than scraping                                                                         |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_linkedin_company_profile`      | Quickly read structured linkedin company profile data. This can be a cache lookup, so it can be more reliable than scraping                                                                        |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_zoominfo_company_profile`      | Quickly read structured ZoomInfo company profile data. Requires a valid ZoomInfo company URL. This can be a cache lookup, so it can be more reliable than scraping                                 |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_instagram_profiles`            | Quickly read structured Instagram profile data. Requires a valid Instagram URL. This can be a cache lookup, so it can be more reliable than scraping                                               |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_instagram_posts`               | Quickly read structured Instagram post data. Requires a valid Instagram URL. This can be a cache lookup, so it can be more reliable than scraping                                                  |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_instagram_reels`               | Quickly read structured Instagram reel data. Requires a valid Instagram URL. This can be a cache lookup, so it can be more reliable than scraping                                                  |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_instagram_comments`            | Quickly read structured Instagram comments data. Requires a valid Instagram URL. This can be a cache lookup, so it can be more reliable than scraping                                              |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_facebook_posts`                | Quickly read structured Facebook post data. Requires a valid Facebook post URL. This can be a cache lookup, so it can be more reliable than scraping                                               |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_facebook_marketplace_listings` | Quickly read structured Facebook marketplace listing data. Requires a valid Facebook marketplace listing URL. This can be a cache lookup, so it can be more reliable than scraping                 |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_facebook_company_reviews`      | Quickly read structured Facebook company reviews data. Requires a valid Facebook company URL and number of reviews. This can be a cache lookup, so it can be more reliable than scraping           |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_x_posts`                       | Quickly read structured X post data. Requires a valid X post URL. This can be a cache lookup, so it can be more reliable than scraping                                                             |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_zillow_properties_listing`     | Quickly read structured zillow properties listing data. Requires a valid zillow properties listing URL. This can be a cache lookup, so it can be more reliable than scraping                       |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_booking_hotel_listings`        | Quickly read structured booking hotel listings data. Requires a valid booking hotel listing URL. This can be a cache lookup, so it can be more reliable than scraping                              |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_youtube_videos`                | Quickly read structured YouTube videos data. Requires a valid YouTube video URL. This can be a cache lookup, so it can be more reliable than scraping                                              |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `scraping_browser_navigate`              | Navigate a scraping browser session to a new URL                                                                                                                                                   |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `scraping_browser_go_back`               | Go back to the previous page                                                                                                                                                                       |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `scraping_browser_go_forward`            | Go forward to the next page                                                                                                                                                                        |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `scraping_browser_click`                 | Click on an element. Avoid calling this unless you know the element selector (you can use other tools to find those)                                                                               |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `scraping_browser_links`                 | Get all links on the current page, text and selectors. It's strongly recommended that you call the links tool to check that your click target is valid                                             |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `scraping_browser_type`                  | Type text into an element                                                                                                                                                                          |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `scraping_browser_wait_for`              | Wait for an element to be visible on the page                                                                                                                                                      |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `scraping_browser_screenshot`            | Take a screenshot of the current page                                                                                                                                                              |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `scraping_browser_get_html`              | Get the HTML content of the current page. Avoid using the full\_page option unless it is important to see things like script tags since this can be large                                          |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `scraping_browser_get_text`              | Get the text content of the current page                                                                                                                                                           |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_amazon_product_search`         | Quickly read structured amazon product search data. Requires a valid search keyword and amazon domain URL. This can be a cache lookup, so it can be more reliable than scraping                    |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_walmart_product`               | Quickly read structured walmart product data. Requires a valid product URL with /ip/ in it. This can be a cache lookup, so it can be more reliable than scraping                                   |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_walmart_seller`                | Quickly read structured walmart seller data. Requires a valid walmart seller URL. This can be a cache lookup, so it can be more reliable than scraping                                             |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_ebay_product`                  | Quickly read structured ebay product data. Requires a valid ebay product URL. This can be a cache lookup, so it can be more reliable than scraping                                                 |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_homedepot_products`            | Quickly read structured homedepot product data. Requires a valid homedepot product URL. This can be a cache lookup, so it can be more reliable than scraping                                       |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_zara_products`                 | Quickly read structured zara product data. Requires a valid zara product URL. This can be a cache lookup, so it can be more reliable than scraping                                                 |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_etsy_products`                 | Quickly read structured etsy product data. Requires a valid etsy product URL. This can be a cache lookup, so it can be more reliable than scraping                                                 |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_bestbuy_products`              | Quickly read structured bestbuy product data. Requires a valid bestbuy product URL. This can be a cache lookup, so it can be more reliable than scraping                                           |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_linkedin_job_listings`         | Quickly read structured linkedin job listings data. This can be a cache lookup, so it can be more reliable than scraping                                                                           |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_linkedin_posts`                | Quickly read structured linkedin posts data. This can be a cache lookup, so it can be more reliable than scraping                                                                                  |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_linkedin_people_search`        | Quickly read structured linkedin people search data. This can be a cache lookup, so it can be more reliable than scraping                                                                          |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_crunchbase_company`            | Quickly read structured crunchbase company data. This can be a cache lookup, so it can be more reliable than scraping                                                                              |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_facebook_events`               | Quickly read structured Facebook events data. Requires a valid Facebook event URL. This can be a cache lookup, so it can be more reliable than scraping                                            |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_tiktok_profiles`               | Quickly read structured Tiktok profiles data. Requires a valid Tiktok profile URL. This can be a cache lookup, so it can be more reliable than scraping                                            |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_tiktok_posts`                  | Quickly read structured Tiktok post data. Requires a valid Tiktok post URL. This can be a cache lookup, so it can be more reliable than scraping                                                   |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_tiktok_shop`                   | Quickly read structured Tiktok shop data. Requires a valid Tiktok shop product URL. This can be a cache lookup, so it can be more reliable than scraping                                           |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_tiktok_comments`               | Quickly read structured Tiktok comments data. Requires a valid Tiktok video URL. This can be a cache lookup, so it can be more reliable than scraping                                              |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_google_maps_reviews`           | Quickly read structured Google maps reviews data. Requires a valid Google maps URL. This can be a cache lookup, so it can be more reliable than scraping                                           |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_google_shopping`               | Quickly read structured Google shopping data. Requires a valid Google shopping product URL. This can be a cache lookup, so it can be more reliable than scraping                                   |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_google_play_store`             | Quickly read structured Google play store data. Requires a valid Google play store app URL. This can be a cache lookup, so it can be more reliable than scraping                                   |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_apple_app_store`               | Quickly read structured apple app store data. Requires a valid apple app store app URL. This can be a cache lookup, so it can be more reliable than scraping                                       |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_reuter_news`                   | Quickly read structured reuter news data. Requires a valid reuter news report URL. This can be a cache lookup, so it can be more reliable than scraping                                            |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_github_repository_file`        | Quickly read structured github repository data. Requires a valid github repository file URL. This can be a cache lookup, so it can be more reliable than scraping                                  |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_yahoo_finance_business`        | Quickly read structured yahoo finance business data. Requires a valid yahoo finance business URL. This can be a cache lookup, so it can be more reliable than scraping                             |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_youtube_profiles`              | Quickly read structured youtube profiles data. Requires a valid youtube profile URL. This can be a cache lookup, so it can be more reliable than scraping                                          |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_youtube_comments`              | Quickly read structured youtube comments data. Requires a valid youtube video URL. This can be a cache lookup, so it can be more reliable than scraping                                            |
|  <Icon icon="gem" iconType="duotone" size={20} /> | `web_data_reddit_posts`                  | Quickly read structured reddit posts data. Requires a valid reddit post URL. This can be a cache lookup, so it can be more reliable than scraping                                                  |


# MCP Usage Examples
Source: https://docs.brightdata.com/mcp-server/usage-examples

A curated list of community demos using Bright Data's MCP server.

1. AI voice agent that closed 4 deals & made \$596 overnight 🤑

* <Icon icon="github" size={20} />   [GitHub Repo](https://github.com/llSourcell/my_ai_intern)

* <Icon icon="youtube" size={20} />   [YouTube Demo](https://www.youtube.com/watch?v=YGzT3sVdwdY)

***

2. LangGraph with mcp-adapters demo

* <Icon icon="github" size={20} />   [GitHub Repo](https://github.com/techwithtim/BrightDataMCPServerAgent)

* <Icon icon="youtube" size={20} />   [YouTube Demo](https://www.youtube.com/watch?v=6DXuadyaJ4g)

***

3. Researcher Agent built with Google ADK that is connected to Bright Data's MCP to fetch real-time data

* <Icon icon="github" size={20} />   [GitHub Repo](https://github.com/MeirKaD/MCP_ADK)

* <Icon icon="youtube" size={20} />   [YouTube Demo](https://www.youtube.com/watch?v=r7WG6dXWdUI)

***

4. Multi-Agent job finder using Bright Data MCP and TypeScript from SCRATCH

* <Icon icon="github" size={20} />   [GitHub Repo](https://github.com/bitswired/jobwizard)

* <Icon icon="youtube" size={20} />   [YouTube Demo](https://www.youtube.com/watch?v=45OtteCGFiI)

***

5. Replacing 3 MCP servers with our MCP server to avoid getting blocked 🤯

* <Icon icon="youtube" size={20} />   [YouTube Demo](https://www.youtube.com/watch?v=0xmE0OJrNmg)

***

6. Scrape ANY Website In Realtime With This Powerful AI MCP Server

* <Icon icon="youtube" size={20} />   [YouTube Demo](https://www.youtube.com/watch?v=bL5JIeGL3J0)

***

7. Usage example with Gemini CLI

* <Icon icon="youtube" size={20} />   [YouTube Demo](https://www.youtube.com/watch?v=FE1LChbgFEw)


# Mobile
Source: https://docs.brightdata.com/mobile-quickstart





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





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



## Proxy networks authentication

### Native access via proxy user name and password

After creating a Bright Data proxy zone, which includes a product and its configuration settings, you receive a proxy username and password.

The **proxy user name** comprises your account ID, zone name and optional parameters.

Proxy username structure is:

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

<Warning>
  Note, that you cannot change the *zone name* itself after it was created. If you need to change the zone name, create a new zone (you can transfer proxies from zone to zone of the same type).
</Warning>

This page explains how by adding optional parameters and  **modifying the username**, you can control the Bright Data system in a very granular way from your code. The table below consolidates the options developers can use in the proxy username. Elaborated list can be seen in our API reference documentation: [Proxy API documentation](https://docs.brightdata.com/api-reference/proxy/) .

## Intergrate with 3rd Parties & Tools

You can use the [Proxy Integration Examples](https://brightdata.com/cp/zones/proxy_examples) page on your dashboard to create different requests.

## 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](https://docs.brightdata.com/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`                   |
| -carrier-os-xxxxx | For mobile proxies only, you can choose to use a specific carrier from [this list](https://docs.brightdata.com/api-reference/proxy/carrier_specific_proxy_peer_ip_mobile_only_)                                 | `brd-customer-<customer_id>-zone-<zone_name>-carrier-dt`                   |

## Controlling your proxies' DNS

The following option allows you to set how DNS resolution is performed.

| 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](https://docs.brightdata.com/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](https://docs.brightdata.com/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 or mobile 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 the main servers that decide on the routing of your request to the actual proxies (these can be datacentre, ISP or residential proxies). Note: modifying these parameters is rarely needed\\!

| Function                                | Parameter      | Description                                                                                                                                                                  | Example username                                                                                  |     |
| --------------------------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | --- |
| Send requests directly from Super Proxy | -direct        | Keeps the same IP for multiple requests. Each unique session ID will get a unique IP.                                                                                        | `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](https://docs.brightdata.com/api-reference/proxy/select_super_proxy_in_specific_country) | [example](https://docs.brightdata.com/api-reference/proxy/select_super_proxy_in_specific_country) |     |
| Selecting specific group of IPs (gIP)   | gip-xxxxxx     | Only for dedicated Residential or mobile proxies.                                                                                                                            | `brd-customer-<customer_id>-zone-<zone_name>-gip-us_7922_fl_hollywood_0`                          | hey |


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

Learn how to configure your datacenter proxy settings, 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.

## IP type

Bright Data offers 3 types of datacenter proxies:

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

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

<Card title="Dedicated unlimited" icon="square-3" horizontal="true">
  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...](https://docs.brightdata.com/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?](https://docs.brightdata.com/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.

### Country selection

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 src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d307c894cda3101699ba450988554136" alt="Geolocation Targeting" width="572" height="358" data-path="images/proxy-networks/data-center/geotargeting.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=280&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=67026a086654981fcd2439025d93033d 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=560&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=341cf0c6a4d403bdb158cc49a0f23ebf 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=840&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=895a1fd7f97db50b0571cfb2db31fb05 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=1100&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=dc5caddedc4dcc33fb7169cb5c6bc9d8 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=1650&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9d153ef8bfb872cb54758141256a6d5d 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=2500&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=39e92809ce18ca858e9ac907ed504a9a 2500w" data-optimize="true" data-opv="2" />
</Frame>

### Changing country

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 src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configure-your-proxy/your-proxy-list.png?maxW=1465&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=8639ba2cdb27e6a0a0e9a7a58dd1e436" alt="your-proxy-list" width="1465" height="607" data-path="images/proxy-networks/data-center/configure-your-proxy/your-proxy-list.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configure-your-proxy/your-proxy-list.png?w=280&maxW=1465&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d74622202d6a14987207752c1f7154a5 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configure-your-proxy/your-proxy-list.png?w=560&maxW=1465&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=3edba3e55d8111b6f49296146dfd7e07 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configure-your-proxy/your-proxy-list.png?w=840&maxW=1465&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=7718e68797e47c8e7e4190ec8bb45fc9 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configure-your-proxy/your-proxy-list.png?w=1100&maxW=1465&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=73747a6b2ebe9528812d5b028f8ae832 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configure-your-proxy/your-proxy-list.png?w=1650&maxW=1465&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=030e37f556e3909e96c737fa2006b4a7 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configure-your-proxy/your-proxy-list.png?w=2500&maxW=1465&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=0b098ccd6c999f6524c893fb4927c938 2500w" data-optimize="true" data-opv="2" />

***

## Advanced options

### 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...](https://docs.brightdata.com/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

Find answers to common questions about integrating, configuring, and using Bright Data's Datacenter proxy products, including IP types, geotargeting, and error codes.

<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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8865e37db6b85ba4c7b10554f96b5152" alt="integrate-new-proxy.gif" width="1828" height="978" data-path="images/proxy-networks/faqs/integrate-new-proxy.gif" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=280&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=af6967b98840c378451f71789844683c 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=560&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c8a668490c5e77e52cfaaa33e9611f92 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=840&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d8bc15aa37a36943e130b755bef3760c 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=1100&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f48c0c165a1ca706da431cb105685adb 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=1650&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e3a7b54c9cf2cd04dcfb7cbceb39b55b 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=2500&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e2e00c6be0bb7ce6e8c8b666071aff96 2500w" data-optimize="true" data-opv="2" />

    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](https://docs.brightdata.com/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 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](https://dashboard.mintlify.com/editor#how-to-integrate-a-proxy-into-3rd-party-software).
  </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
    curl "http://target.site" --proxy brd.superproxy.io:33335 --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
    * Crimea region of Russia

    If you need proxies from there 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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e58931c902b2aa2b9cb71157e98e2ab9" alt="event-log.png" width="1833" height="977" data-path="images/proxy-networks/faqs/event-log.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=280&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3ca0f70abbd76e232d8bbe117f4350aa 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=560&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b08adc7e24153bf24ee8e4e36e79bf25 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=840&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=58efc19a1f43403f4cc6b896de99bc5e 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=1100&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2c9e851671051303d96f000a7e23bcfd 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=1650&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2f30a688c191fe1392e473e86826ee46 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=2500&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f7ee65bd5eabe6ae149263a8f9464acc 2500w" data-optimize="true" data-opv="2" />

    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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f2905127ebde0e5876295cb21ed341ce" alt="event-log-headers.png" width="1833" height="977" data-path="images/proxy-networks/faqs/event-log-headers.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=280&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7b9dd50469ff007397a1e8c93a030795 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=560&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=564c5cbb33cf376f1a4697557c98d724 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=840&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=888b55dcce504a411741144fed9ec49a 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=1100&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=22d813089ee901fe3d7ef46fd2dfbfda 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=1650&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=611238c6c04383d5b659d5d4fadf56af 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=2500&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6c16fdf908195d513b49f3577770876e 2500w" data-optimize="true" data-opv="2" />
  </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 our system 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
    brd.superproxy.io:33335 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
    brd-customer-<customer_id>-zone-<zone_name>-session-glob_rand39484
    ```

    Full request example:

    ```sh
    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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8f7a07929b754153ea7bcdb5cd694a96" alt="add-ports.gif" width="1828" height="978" data-path="images/proxy-networks/faqs/add-ports.gif" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=280&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4cdebdc4fc77c5c7ec627ed72bb3711e 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=560&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=621bba8c5764779d6a593bfa7dff671c 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=840&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8bd6dda3e631778f028bed40a55944ef 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=1100&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9a525823504d24e8b675244fef786c66 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=1650&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=016680c4f990848121b7137bc8e8e470 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=2500&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c5a061323e37be5b0f7b459f02d8f236 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

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

    <CodeGroup>
      ```sh Windows
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-windows:<zone_password> --proxy brd.superproxy.io:33335 "<target_site>"
      ```

      ```sh macOS
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-osx:<zone_password> --proxy brd.superproxy.io:33335 "<target_site>"
      ```

      ```sh Android
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-android:<zone_password> --proxy brd.superproxy.io:33335 "<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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9a072edcc7d8329a525f4b0e3ec89849" alt="refresh-ips.gif" width="1892" height="868" data-path="images/proxy-networks/faqs/refresh-ips.gif" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=280&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3e069c1d9efdc57fa3028e437ed053fa 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=560&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b685c6696ece105061da5680ba285314 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=840&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3351c3aee8a4784c020acf6077cbb962 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=1100&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c78525f268a2e266fdcffc8f2d7bcac4 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=1650&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e168df26bb68ac033290abe45eb60d9e 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=2500&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=dd549db272ead649e10cc291b39c5340 2500w" data-optimize="true" data-opv="2" />

    <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
    curl "https://lumtest.com/myip.json" --verbose --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
    ```

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

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ae57da3518779f40a958f78a00ecfedf" alt="x-brd-ip.png" width="423" height="23" data-path="images/proxy-networks/faqs/x-brd-ip.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=280&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4578ce7b27745497ae8123a53a852500 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=560&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=eea20a9293172fd0a758c50ab8438dca 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=840&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7549acd6febbfb9404217c4337ae4713 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=1100&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f2376a4f21caa18b90f3501d109f1c2e 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=1650&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=79eece5f221dab3bf68b12a7611e0a84 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=2500&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8d41955b988378d12e7838ad4e5a3b15 2500w" data-optimize="true" data-opv="2" />

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

    ```sh
    curl "https://lumtest.com/myip.json" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-<hashed-ip>:<zone_password>
    ```

    We recommend using [https://lumtest.com/myip.json](https://lumtest.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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=382d3e5f40fd938e5a84ae2849fd0c3e" alt="asn-targeting.png" width="583" height="931" data-path="images/proxy-networks/faqs/asn-targeting.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=280&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=77b6b1aa38626011a34ca6486219d353 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=560&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e6630c50ab7413f6837e8d326ba00b3f 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=840&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6e220de756396a15aaba32b6c5da186f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=1100&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=da2df73c5b2c0d5d37cbe06ee086f73b 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=1650&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5664f5ee339248026f6350324c0adcbf 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=2500&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6df52c82ff5d02aeb05a43655e73736c 2500w" data-optimize="true" data-opv="2" />

    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
    curl --proxy brd.superproxy.io:33335 --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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c6271c5594fac3f6861969bd7af27f1e" alt="number-of-dedicated-gIPs.png" width="645" height="909" data-path="images/proxy-networks/faqs/number-of-dedicated-gIPs.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=280&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5dbdca062126def5cb6056cefbb9b7dd 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=560&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9bcacda84b73566eae2020e039b2e38b 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=840&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0d9c62f26e4bd3d36d89ee278440d204 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=1100&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=42f6b5b50b0e87f20029e4a89df13c2b 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=1650&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=655cc189fd49c7ffeb9b739f59a23ebd 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=2500&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=15972b33cfafd930e2d7b90d18768248 2500w" data-optimize="true" data-opv="2" />

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

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=75d1f6c97b99b54c4bb1f4e6ac222b09" alt="show-allocated-dedicated-ips.png" width="583" height="393" data-path="images/proxy-networks/faqs/show-allocated-dedicated-ips.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=280&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2d56759505ae73cd244f0a59e673516d 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=560&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6ff579ae3da9b8a1fb08048c5cd40f42 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=840&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e9e229a90011d93f9128b7a67e47b47a 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=1100&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d26dd0084f0f82302519b8c73013a03c 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=1650&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=1936faef05312195dd9c83c8960bed3a 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=2500&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fd1c5fca0c04634e370f8b82cd451fb1 2500w" data-optimize="true" data-opv="2" />

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

    ```sh
    curl --proxy brd.superproxy.io:33335 --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
    curl --proxy brd.superproxy.io:33335 --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:

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

    * For Example

    <CodeGroup>
      ```sh Deutsche Telekom
      brd-customer-<customer_id>-zone-<zone_name>-carrier-dt
      ```

      ```sh Sprint
      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://lumtest.com/echo.json](https://lumtest.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](https://docs.brightdata.com/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](https://docs.brightdata.com/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](https://docs.brightdata.com/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:

    ```
    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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8e6dbf5d13a5a505ee83311e5423848c" alt="x-luminati-ip.png" width="1431" height="891" data-path="images/proxy-networks/faqs/x-luminati-ip.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=280&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e16c6daf292290c6ab018be163c94542 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=560&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ae65c3d709a142b5df4e6ac680a139b4 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=840&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fad48d3ca58086816807cc0483223f44 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=1100&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e691672a4db29bfcad1c420f69c30608 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=1650&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=30238efbb97cfebaa172def9f97d0f5a 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=2500&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d0c10e74aa99a4b9ef5b172266a00659 2500w" data-optimize="true" data-opv="2" />
  </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](https://docs.brightdata.com/proxy-networks/socks5)
  </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?" defaultOpen={false}>
    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, our 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>
</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.

## Best for

* 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
* Managing multiple online profiles

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


# How to Get Started with Datacenter Proxies
Source: https://docs.brightdata.com/proxy-networks/data-center/quickstart

Learn how to quickly set up your Datacenter proxy on Bright Data with this step-by-step guide, including signing in, creating a proxy, and verifying your account.

<Tip>
  if you haven't yet signed up for Bright Data, you can [sign up for
  free](https://brightdata.com/), and when adding your payment method, you'll
  receive a \$5 credit to get you started!
</Tip>

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

  <Step title={<>Navigate to "Proxies & Scraping", then <a href="https://brightdata.com/cp/zones">"My Zones"</a></>}>
    <Accordion title="In My Zones page, under Datacenter Proxies click Get started">
      <Warning>
        If you already have an active proxy, simply choose **Add** at the top right corner
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/get_started.png?maxW=1157&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=3ca96e786eacec63397440db8d11f38f" alt="Get Started" width="1157" height="888" data-path="images/proxy-networks/data-center/get_started.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/get_started.png?w=280&maxW=1157&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=6e45c907b9672da2db515697d565ba2f 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/get_started.png?w=560&maxW=1157&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=5674ae7eb8f2f138522aeeb98382dd9f 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/get_started.png?w=840&maxW=1157&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=644b02ab995ff95049398cd409d97050 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/get_started.png?w=1100&maxW=1157&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=6491975d1dd1cd046979a9cce9582adf 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/get_started.png?w=1650&maxW=1157&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d8002fd66d490d7f8a6499ca343c1d43 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/get_started.png?w=2500&maxW=1157&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=72a6afe3b9c1f1cd749cd9de09c2e3c6 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="Assign a name to your Proxy">
    <Warning>
      Please select a meaningful name, as the zone's name cannot be changed once created.
    </Warning>
  </Step>

  <Step title={<> <a href="https://docs.brightdata.com/proxy-networks/data-center/configure-your-proxy">Configure</a> your proxy</>} />

  <Step title="Click Add" />
</Steps>

<Accordion title="Before continuing, verify your account">
  If you haven’t yet added a payment method, you’ll be prompted to add one at this point to verify your account. If it’s your first time using Bright Data, then you’ll also receive a \$5 bonus credit to get you started!

  <Tip>
    You will not be charged anything at this point and this is solely for verification purposes
  </Tip>
</Accordion>

<Note>
  Don't worry, we'll cover all the configurations in the next section [Configure your Proxy](/proxy-networks/data-center/configure-your-proxy)
</Note>


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

Learn how to send your first request using Bright Data's proxy products with easy-to-follow code examples in multiple programming languages.

<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. 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
  curl "http://lumtest.com/myip.json" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```javascript Node.js
  #!/usr/bin/env node

  require('request-promise')({
      url: 'http://lumtest.com/myip.json',
      proxy: 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:33335',
    })
    .then(function (data) {
        console.log(data);
      },
      function (err) {
        console.error(err);
      });
  ```

  ```python Python
  import pprint
  import requests


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

  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://lumtest.com/myip.json"
  response = requests.get(url, proxies=proxies)
  pprint.pprint(response.json())

  ```

  ```php PHP

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

  ```

  ```ruby Ruby
  #!/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://lumtest.com/myip.json')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 33335, '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#
  using System;
  using System.Net;

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

  ```java Java
  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", 33335);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("http://lumtest.com/myip.json").viaProxy(proxy))
              .returnContent().asString();
          System.out.println(res);
      }
  }
  ```

  ```perl Perl
  #!/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:33335");
  print $agent->get('http://lumtest.com/myip.json')->content();
  ```

  ```vb VBA
  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:33335")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("http://lumtest.com/myip.json"))
      End Sub
  End Module
  ```
</CodeGroup>

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

```json Output
{
  "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://lumtest.com/myip.json”](https://lumtest.com/myip.json”) with the website of your choice and ...

**That's it!**


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

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

<Tip>
  This article addresses all proxy errors **originating from BrightData**. 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 (seen below). Ensure you receive all response headers by following the instructions as seen below (-v flag).

  If the error response lacks BrightData error header fields, the issue is unrelated to BrightData and instead you should refer to [How to overcome website blocking](https://docs.brightdata.com/proxy-networks/website-blocking).
</Tip>

## Bright Data HTTP Errors

## HTTP 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`     |

### 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
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
curl -i [rest of curl command options]
```

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

```sh
echo "[tcp nc inputs]" | nc -C -v brd.superproxy.io 33335
```

<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 Unlocker API and our SERP for targeting search engines. The error field names are slightly different , yet the content is identical.

Example response:

```JSON
"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.

<AccordionGroup>
  <Accordion title="client_10060">
    * `x-brd-error`: Proxy Error: `ip_requested_not_allocated_by_customer`
    * `x-brd-err-msg`: 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
  </Accordion>

  <Accordion title="client_10061">
    * `x-brd-error`: Peer not found
    * `x-brd-err-msg`: 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 here: [https://docs.brightdata.com/api-reference/proxy/geolocation-targeting](https://docs.brightdata.com/api-reference/proxy/geolocation-targeting)
  </Accordion>

  <Accordion title="client_10062">
    * `x-brd-error`: Peer not found
    * `x-brd-err-msg`: Your `[proxy type] [DC|ISP]` zone does not have IPs in selected countries. Either IPs location has changed, or zone not configured with proxies in selected countries. Check zone configuration and try again with relevant country code. Read more: [https://docs.brightdata.com/api-reference/proxy/geolocation-targeting](https://docs.brightdata.com/api-reference/proxy/geolocation-targeting)
  </Accordion>
</AccordionGroup>

### HTTP Error 401

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

<AccordionGroup>
  <Accordion title="client_10050">
    * `x-brd-error`: Auth failed: IP denylisted `[IP]`
    * `x-brd-err-msg`: Auth Failed IP denylisted: `[IP]`. [Check FAQ: how to denylist/allowlist ips and domains?](https://docs.brightdata.com/proxy-networks/faqs#how-to-allowlist-denylist-ips-and-domains) to resolve
  </Accordion>
</AccordionGroup>

### HTTP Error 402

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

<AccordionGroup>
  <Accordion title="policy_20130">
    * `x-brd-error`: Residential Failed `bad_endpoint`
    * `x-brd-err-msg`: Residential Failed (`bad_endpoint`) - Requested site is not available for immediate residential (no KYC) access mode due to the fact that `%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)
  </Accordion>

  <Accordion title="policy_20140">
    * `x-brd-error`: Residential Failed `bad_endpoint`
    * `x-brd-err-msg`: Requested site is not available for 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](https://docs.brightdata.com/proxy-networks/residential/network-access)
  </Accordion>
</AccordionGroup>

### 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:

<AccordionGroup>
  <Accordion title="client_10070">
    * `x-brd-error`: No Protocol
    * `x-brd-err-msg`: Protocol was missing from original request. Please add either HTTP or HTTPS and retry.
  </Accordion>

  <Accordion title="client_10080">
    * `x-brd-error`: No Destination Host
    * `x-brd-err-msg`: No destination host. Destination host is missing or incorrect. Check your request parameters and try again
  </Accordion>

  <Accordion title="client_10090">
    * `x-brd-error`: You are trying to use Browser API zone as regular proxy
    * `x-brd-err-msg`: You are trying to use Browser API zone as regular proxy. A browser should be used to access this zone. See [Browser API](https://docs.brightdata.com/scraping-automation/scraping-browser/introduction) for information on how to access your Browser API zone
  </Accordion>

  <Accordion title="client_10130">
    * `x-brd-error`: Forbidden: this super proxy is allowed to be used only for China domains via China peers. Otherwise use brd.superproxy.io. For more details review the following: [https://docs.brightdata.com/proxy-networks/mobile/faqs#how-to-browse-chinese-sites-by-using-chinese-residentials-ips](https://docs.brightdata.com/proxy-networks/mobile/faqs#how-to-browse-chinese-sites-by-using-chinese-residentials-ips)
    * `x-brd-err-msg`: Forbidden: this super proxy is allowed to be used only for China domains via China peers. Otherwise use brd.superproxy.io. For more details review the following: [https://docs.brightdata.com/proxy-networks/mobile/faqs#how-to-browse-chinese-sites-by-using-chinese-residentials-ips](https://docs.brightdata.com/proxy-networks/mobile/faqs#how-to-browse-chinese-sites-by-using-chinese-residentials-ips)
  </Accordion>

  <Accordion title="client_10250">
    * `x-brd-error`: Forbidden: You tried to target `%HOST%` but got blocked
    * `x-brd-err-msg`: 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 allowlist to allow all targets.
  </Accordion>

  <Accordion title="client_10260">
    * `x-brd-error`: Forbidden: You tried to target `%HOST%` but got blocked
    * `x-brd-err-msg`: Forbidden: You tried to target `%HOST%` but got blocked since this host is explicitly blocked target in your zone's denylist security setting. Please remove this host from your denylist or delete all content from denylist to allow all targets.
  </Accordion>

  <Accordion title="policy_20010">
    * `x-brd-error`: Bad protocol
    * `x-brd-err-msg`: 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
  </Accordion>

  <Accordion title="policy_20020">
    * `x-brd-error`: Bad port
    * `x-brd-err-msg`: Bad Port used. Ports we support: [https://docs.brightdata.com/proxy-networks/faqs#how-to-see-supported-ports-and-protocols](https://docs.brightdata.com/proxy-networks/faqs#how-to-see-supported-ports-and-protocols)
  </Accordion>

  <Accordion title="policy_20050">
    * `x-brd-error`: Forbidden: target site requires special permission. Contact BrightData for assistance
    * `x-brd-err-msg`: Forbidden: target site requires special permission. You are trying to access a target site which is not permitted by our compliance policy. In order to gain access you may need to undergo a KYC process, you can do so by filling in the form: [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.
  </Accordion>

  <Accordion title="policy_20051">
    * `x-brd-error`: Forbidden: target site requires special permission. Contact BrightData for assistance
    * `x-brd-err-msg`: Forbidden: target site requires is a government site and requires special permissions to access. In order to gain access you may need to undergo a KYC process, you can do so by filling in the form: [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.
  </Accordion>

  <Accordion title="policy_20080">
    * `x-brd-error`: Forbidden: request needs to be made using residential network
    * `x-brd-err-msg`: 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.
  </Accordion>

  <Accordion title="policy_20090">
    * `x-brd-error`: Forbidden: requests to this domain are blocked using the proxy networks, please get access via an Unlocker API zone or IDE tools, or contact your account manager to assist
    * `x-brd-err-msg`: Forbidden: requests to this domain are blocked using the Datacenter, ISP and Residential proxy networks, please get access via an Unlocker API zone or IDE tools, or contact your account manager for further assistance
  </Accordion>

  <Accordion title="policy_20091">
    * `x-brd-error`: Forbidden: Target `$host` is blocked by Bright Data on IPv6 protocol. Please try IPv4 proxies or our Unlocker API to access this target.
    * `x-brd-err-msg`: Forbidden: Target `$host` is blocked by Bright Data on IPv6 protocol. Please try IPv4 proxies or our Unlocker API to access this target.
  </Accordion>

  <Accordion title="policy_20030">
    * `x-brd-error`: Forbidden: target blocked
    * `x-brd-err-msg`: Forbidden: You tried to target [www.somehost.com](http://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: [https://docs.brightdata.com/proxy-networks/faqs#what-is-error-code-403](https://docs.brightdata.com/proxy-networks/faqs#what-is-error-code-403)
  </Accordion>

  <Accordion title="policy_20000">
    * `x-brd-error`: Access denied: `<URL>` is classified as `<category>` and blocked by Bright Data
    * `x-brd-err-msg`: Access denied: `%URL%` is classified as `%CATEGORY%` and blocked by Bright Data as it might breach Bright Data usage policy. For more details review the following: [https://docs.brightdata.com/proxy-networks/residential/network-access#residential-proxy-network-policy](https://docs.brightdata.com/proxy-networks/residential/network-access#residential-proxy-network-policy)
  </Accordion>

  <Accordion title="policy_20230">
    * `x-brd-error`: Country `%COUNTRY%` is not permitted for targeting, please modify to a different country
    * `x-brd-err-msg`: Country `%COUNTRY%` is not permitted for targeting, please modify to a different country
  </Accordion>

  <Accordion title="policy_20250">
    * `x-brd-error`: Forbidden: You tried to target `%HOST%` but got blocked.
    * `x-brd-err-msg`: 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.
  </Accordion>

  <Accordion title="policy_20251">
    * `x-brd-error`: Forbidden: You tried to target `%HOST%` but got blocked.
    * `x-brd-err-msg`: 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.
  </Accordion>

  <Accordion title="policy_20260">
    * `x-brd-error`: Forbidden: You tried to target `%HOST%` but got blocked.
    * `x-brd-err-msg`: 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.
  </Accordion>

  <Accordion title="policy_20261">
    * `x-brd-error`: Forbidden: You tried to target `%HOST%` but got blocked.
    * `x-brd-err-msg`: 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.
  </Accordion>

  <Accordion title="policy_20031">
    * `x-brd-error`: Forbidden: Target `%HOST%` is blocked.
    * `x-brd-err-msg`: 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)
  </Accordion>

  <Accordion title="policy_20040">
    * `x-brd-error`: Forbidden host
    * `x-brd-err-msg`: Destination host is blocked either by Brightdata 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 the zone settings:
      [https://brightdata.com/cp/zones/](https://brightdata.com/cp/zones/)
  </Accordion>

  <Accordion title="policy_20240">
    * `x-brd-error`: Proxy port `%PORT%` is restricted. Contact [Bright Data support](\(mailto:support@brightdata.com\)).
    * `x-brd-err-msg`: Proxy port `%PORT%` is restricted. Contact [Bright Data support](\(mailto:support@brightdata.com\)).
  </Accordion>

  <Accordion title="policy_20110">
    * `x-brd-error`: Forbidden SERP domain
    * `x-brd-err-msg`: 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 the zone settings: [https://brightdata.com/cp/zones/](https://brightdata.com/cp/zones/)
  </Accordion>
</AccordionGroup>

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

<AccordionGroup>
  <Accordion title="client_10000">
    * `x-brd-error`: Authentication failed
    * `x-brd-err-msg`: Invalid authentication: check credentials and retry. Bright Data credentials include your account ID, zone name and password
  </Accordion>

  <Accordion title="client_10001">
    * `x-brd-error`: Invalid Auth
    * `x-brd-err-msg`: Invalid authentication: check credentials and retry
  </Accordion>

  <Accordion title="client_10002">
    * `x-brd-error`: Auth failed: Zone not found.
    * `x-brd-err-msg`: 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](https://docs.brightdata.com/api-reference/account-management-api/Get_active_Zones)
  </Accordion>

  <Accordion title="client_10010">
    * `x-brd-error`: Proxy Authentication Required
    * `x-brd-err-msg`: No proxy credentials provided. Please add credentials and try again.
  </Accordion>

  <Accordion title="client_10020">
    * `x-brd-error`: Account is suspended. [Login](https://brightdata.com/cp/setting/billing) to activate your account
    * `x-brd-err-msg`: Account is suspended. [Login](https://brightdata.com/cp/setting/billing) to activate your account
  </Accordion>

  <Accordion title="client_10030">
    * `x-brd-error`: Authentication failed
    * `x-brd-err-msg`: You are not allowed to access our API via this IP. Please verify your settings or allowlist this IP.
  </Accordion>

  <Accordion title="client_10040">
    * `x-brd-error`: KYC Required. Please visit [http://brighdata.com/cp/kyc](http://brighdata.com/cp/kyc) and ensure you are verified
    * `x-brd-err-msg`: KYC Required. Please visit [http://brighdata.com/cp/kyc](http://brighdata.com/cp/kyc) and ensure you are verified
  </Accordion>

  <Accordion title="policy_20120">
    * `x-brd-error`: IP parameter `<IP>` is incorrect, use correct format in the IP parameter
    * `x-brd-err-msg`: IP parameter `<IP>` is incorrect, use x-luminati-ip header format in the IP parameter
  </Accordion>
</AccordionGroup>

### HTTP Error 429

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

<AccordionGroup>
  <Accordion title="client_10110">
    * `x-brd-error`: Your limited trial mode account exceeded the allowed rate limits. Add payment method to receive \$5 credit and remove rate limits. You will not be charged
    * `x-brd-err-msg`: Your limited trial mode account exceeded the allowed rate limits. Add payment method to receive \$5 credit and remove rate limits. You will not be charged
  </Accordion>

  <Accordion title="policy_20220">
    * `x-brd-error`: Requests rate to `%URL%` is too high
    * `x-brd-err-msg`: 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
  </Accordion>

  <Accordion title="policy_20221">
    * `x-brd-error`: Requests rate to `%URL%` is too high
    * `x-brd-err-msg`: 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
  </Accordion>

  <Accordion title="policy_20222">
    * `x-brd-error`: Requests rate per IP is too high
    * `x-brd-err-msg`: Rate limit per IP %IP% on zone %ZONE% has been reached. Requests are throttled down to avoid overload. Either increase number of IPs or reduce rate, and review your rotation logic or your response size for unexpected increase to assure even distribution of requests and bandwidth across IPs of this zone.
  </Accordion>
</AccordionGroup>

### HTTP Error 502

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

<AccordionGroup>
  <Accordion title="client_10120">
    * `x-brd-error`: Block direct route
    * `x-brd-err-msg`: Request reroute blocked. You chose option not to reroute requests thru our superproxy on failure so reroute was blocked. To see more about this setting see: [Request Error Handling](https://docs.brightdata.com/api-reference/proxy/request_error_handling)
  </Accordion>

  <Accordion title="peer_30030">
    * `x-brd-error`: Proxy Error: We do not have proxies in the city you requested
    * `x-brd-err-msg`: 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](https://docs.brightdata.com/proxy-networks/faqs#how-to-target-a-specific-city) for proper use of city targeting.
  </Accordion>

  <Accordion title="policy_20070">
    * `x-brd-error`: Host is blocked in requested country
    * `x-brd-err-msg`: Host you are trying to access is blocked in requested country. Please change country and retry.
  </Accordion>

  <Accordion title="client_10100">
    * `x-brd-error`: Zone has reached usage limit
    * `x-brd-err-msg`: Zone has reached usage limit. Go to [https://brightdata.com/cp/zones](https://brightdata.com/cp/zones) to remove/modify limitation.
  </Accordion>

  <Accordion title="target_40001">
    * `x-brd-error`: Could not resolve host `%HOST%`
    * `x-brd-err-msg`: Could not resolve host `%HOST%`. Check host name is correctly spelled and retry. If host is properly spelled contact brightdata.com for DNS support.
  </Accordion>

  <Accordion title="target_40011">
    * `x-brd-error`: No IPv6 address (AAAA record) found for `%HOST%`
    * `x-brd-err-msg`: 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.
  </Accordion>
</AccordionGroup>

***


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

Find answers to common questions about integrating, configuring, and using Bright Data's proxy products, including IP types, geotargeting, and error codes.

<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](https://docs.brightdata.com/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, Unlocker API or SERP API don't forget to [use the SSL certificate](https://docs.brightdata.com/general/account/ssl-certificate) to ensure and to end encrypted connections.

    <Warning>
      For accounts in ["Immediate Access"](https://docs.brightdata.com/proxy-networks/residential/network-access) mode integration with some third party tools may not be possible due to them not supporting the SSL Certificate.
    </Warning>

    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](https://docs.brightdata.com/integrations/browserscan)

    XLogin 		[https://docs.brightdata.com/integrations/xlogin](https://docs.brightdata.com/integrations/xlogin)

    GeeLark 	[https://docs.brightdata.com/integrations/geelark](https://docs.brightdata.com/integrations/geelark)

    Puppeteer 	[https://docs.brightdata.com/integrations/puppeteer](https://docs.brightdata.com/integrations/puppeteer)

    Playwright 	[https://docs.brightdata.com/integrations/playwright](https://docs.brightdata.com/integrations/playwright)

    Selenium 	[https://docs.brightdata.com/integrations/selenium](https://docs.brightdata.com/integrations/selenium)

    AdsPower 	[https://docs.brightdata.com/integrations/adspower](https://docs.brightdata.com/integrations/adspower)

    Dolphin Anty 	[https://docs.brightdata.com/integrations/dolphin-anty](https://docs.brightdata.com/integrations/dolphin-anty)

    Incogniton 	[https://docs.brightdata.com/integrations/incogniton](https://docs.brightdata.com/integrations/incogniton)

    Marketerbrowser [https://docs.brightdata.com/integrations/marketerbrowser](https://docs.brightdata.com/integrations/marketerbrowser)

    SMLOGIN 	[https://docs.brightdata.com/integrations/smlogin](https://docs.brightdata.com/integrations/smlogin)

    Hidemyacc 	[https://docs.brightdata.com/integrations/hidemyacc](https://docs.brightdata.com/integrations/hidemyacc)

    OpenBullet	[https://docs.brightdata.com/integrations/openbullet](https://docs.brightdata.com/integrations/openbullet)

    Switchyomega 	[https://docs.brightdata.com/integrations/switchyomega](https://docs.brightdata.com/integrations/switchyomega)

    PhantomBuster 	[https://docs.brightdata.com/integrations/phantombuster](https://docs.brightdata.com/integrations/phantombuster)

    BitBrowser 	[https://docs.brightdata.com/integrations/bitbrowser](https://docs.brightdata.com/integrations/bitbrowser)

    Maskfog 	[https://docs.brightdata.com/integrations/maskfog](https://docs.brightdata.com/integrations/maskfog)

    Ghost Browser 	[https://docs.brightdata.com/integrations/ghost-browser](https://docs.brightdata.com/integrations/ghost-browser)

    Postman 	[https://docs.brightdata.com/integrations/postman](https://docs.brightdata.com/integrations/postman)

    NGINX 		[https://docs.brightdata.com/integrations/nginx](https://docs.brightdata.com/integrations/nginx)

    StablerSOLO 	[https://docs.brightdata.com/integrations/stablersolo](https://docs.brightdata.com/integrations/stablersolo)

    VMLogin 	[https://docs.brightdata.com/integrations/vmlogin](https://docs.brightdata.com/integrations/vmlogin)

    GoLogin 	[https://docs.brightdata.com/integrations/gologin](https://docs.brightdata.com/integrations/gologin)

    Windows 	[https://docs.brightdata.com/integrations/windows](https://docs.brightdata.com/integrations/windows)

    Scrapy 		[https://docs.brightdata.com/integrations/scrapy](https://docs.brightdata.com/integrations/scrapy)

    AEZAKMI 	[https://docs.brightdata.com/integrations/aezakmi](https://docs.brightdata.com/integrations/aezakmi)

    Beautifulsoup 	[https://docs.brightdata.com/integrations/beautifulsoup](https://docs.brightdata.com/integrations/beautifulsoup)

    WebHarvy 	[https://docs.brightdata.com/integrations/webharvy](https://docs.brightdata.com/integrations/webharvy)

    Ubuntu 		[https://docs.brightdata.com/integrations/ubuntu](https://docs.brightdata.com/integrations/ubuntu)

    Lalicat 	[https://docs.brightdata.com/integrations/lalicat](https://docs.brightdata.com/integrations/lalicat)

    Multilogin 	[https://docs.brightdata.com/integrations/multilogin](https://docs.brightdata.com/integrations/multilogin)

    Undetectable 	[https://docs.brightdata.com/integrations/undetectable](https://docs.brightdata.com/integrations/undetectable)

    Apify 		[https://docs.brightdata.com/integrations/apify](https://docs.brightdata.com/integrations/apify)

    iPhone 		[https://docs.brightdata.com/integrations/ios](https://docs.brightdata.com/integrations/ios)

    MuLogin 	[https://docs.brightdata.com/integrations/mulogin](https://docs.brightdata.com/integrations/mulogin)

    Changedetection [https://docs.brightdata.com/integrations/changedetection](https://docs.brightdata.com/integrations/changedetection)

    Morelogin 	[https://docs.brightdata.com/integrations/morelogin](https://docs.brightdata.com/integrations/morelogin)

    Proxifier 	[https://docs.brightdata.com/integrations/proxifier](https://docs.brightdata.com/integrations/proxifier)

    Texau 		[https://docs.brightdata.com/integrations/texau](https://docs.brightdata.com/integrations/texau)

    Android 	[https://docs.brightdata.com/integrations/android](https://docs.brightdata.com/integrations/android)

    Kameleo 	[https://docs.brightdata.com/integrations/kameleo](https://docs.brightdata.com/integrations/kameleo)

    Screaming Frog 	[https://docs.brightdata.com/integrations/screaming-frog](https://docs.brightdata.com/integrations/screaming-frog)

    Foxy		[https://docs.brightdata.com/integrations/foxyproxy](https://docs.brightdata.com/integrations/foxyproxy)

    SessionBox 	[https://docs.brightdata.com/integrations/sessionbox](https://docs.brightdata.com/integrations/sessionbox)

    Insomniac 	[https://docs.brightdata.com/integrations/insomniac](https://docs.brightdata.com/integrations/insomniac)

    Helium Scraper 	[https://docs.brightdata.com/integrations/helium-scraper](https://docs.brightdata.com/integrations/helium-scraper)

    SaleFreaks 	[https://docs.brightdata.com/integrations/salefreaks](https://docs.brightdata.com/integrations/salefreaks)

    Postern 	[https://docs.brightdata.com/integrations/postern](https://docs.brightdata.com/integrations/postern)

    Antik 		[https://docs.brightdata.com/integrations/antik](https://docs.brightdata.com/integrations/antik)

    Easync 		[https://docs.brightdata.com/integrations/easync](https://docs.brightdata.com/integrations/easync)

    ParseHub 	[https://docs.brightdata.com/integrations/parsehub](https://docs.brightdata.com/integrations/parsehub)

    Sphere Browser 	[https://docs.brightdata.com/integrations/sphere-browser](https://docs.brightdata.com/integrations/sphere-browser)

    Octoparse 	[https://docs.brightdata.com/integrations/octoparse](https://docs.brightdata.com/integrations/octoparse)

    ixBrowser 	[https://docs.brightdata.com/integrations/ixbrowser](https://docs.brightdata.com/integrations/ixbrowser)

    Shadowrocket 	[https://docs.brightdata.com/integrations/shadowrocket](https://docs.brightdata.com/integrations/shadowrocket)

    Firefox 	[https://docs.brightdata.com/integrations/firefox](https://docs.brightdata.com/integrations/firefox)

    Chrome 		[https://docs.brightdata.com/integrations/chrome](https://docs.brightdata.com/integrations/chrome)

    MacOS 		[https://docs.brightdata.com/integrations/macos](https://docs.brightdata.com/integrations/macos)

    ClonBrowser 	[https://docs.brightdata.com/integrations/clonbrowser](https://docs.brightdata.com/integrations/clonbrowser)

    Octo Browser 	[https://docs.brightdata.com/integrations/octobrowser](https://docs.brightdata.com/integrations/octobrowser)

    Genlogin 	[https://docs.brightdata.com/integrations/genlogin](https://docs.brightdata.com/integrations/genlogin)

    Web Scraper 	[https://docs.brightdata.com/integrations/webscraper](https://docs.brightdata.com/integrations/webscraper)

    If the tool 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 [150M+ 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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/geolocation-targeting-dropdown.png?maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d7e9e441e88447b417742c98760b2b09" alt="geolocation-targeting-dropdown.png" width="536" height="178" data-path="images/proxy-networks/faqs/geolocation-targeting-dropdown.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/geolocation-targeting-dropdown.png?w=280&maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=aac30f83fad6bf93e1a2260916a4e2d2 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/geolocation-targeting-dropdown.png?w=560&maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b222fa0047340339979893717fc98191 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/geolocation-targeting-dropdown.png?w=840&maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6d13e3056ad7f67cc91eca698e31de85 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/geolocation-targeting-dropdown.png?w=1100&maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=78e5c81670c0755b75d44297cf3ec155 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/geolocation-targeting-dropdown.png?w=1650&maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=56bd34470b25fec5f69d0464efb8e7f5 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/geolocation-targeting-dropdown.png?w=2500&maxW=536&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8f1254e5c3ab1944506f2e284e5b3f09 2500w" data-optimize="true" data-opv="2" />

        ## 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
        curl "http://target.site" --proxy brd.superproxy.io:33335 --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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/dedicated-ip-groups.png?maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c270120cff39350ccb3d8bfe88a8b352" alt="dedicated-ip-groups.png" width="526" height="124" data-path="images/proxy-networks/faqs/dedicated-ip-groups.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/dedicated-ip-groups.png?w=280&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ce8c17b758d7a8c9c36ddf04aa97da1f 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/dedicated-ip-groups.png?w=560&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ecf4569c0c287f5f6b62a7a6a3dc905f 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/dedicated-ip-groups.png?w=840&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0bd5d9b1c00c793eadb2fb06ab2516fd 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/dedicated-ip-groups.png?w=1100&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c20b13032342acd984f33ce29f1bd529 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/dedicated-ip-groups.png?w=1650&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6c24972c9d3ce7b57bca355aed1118c4 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/dedicated-ip-groups.png?w=2500&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d7bca1a45e11fe78121e3ca78fa3a473 2500w" data-optimize="true" data-opv="2" />

        ## Geolocation targeting

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

                <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=112ecae8ddb56c1ebb813f9b2422866f" alt="add-country.png" width="514" height="112" data-path="images/proxy-networks/faqs/add-country.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=280&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=64a1b2980ff6a5888b94d2c5c46e9a79 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=560&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=df276075373b92ca3bb12dbb66479bbe 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=840&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9da95587a1b49839713cff7c34e8333f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1100&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b4650734643e0979a398a7bda8a41576 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=1650&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fe32545646ad097427f40f33403d0fb8 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-country.png?w=2500&maxW=514&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=93c75cd9a1a7fbed4c3aff1ebd125d65 2500w" data-optimize="true" data-opv="2" />

        ## 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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6a4de57e233019ed0f30522817c01d7b" alt="add-domains.png" width="528" height="134" data-path="images/proxy-networks/faqs/add-domains.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=280&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fc93cd504b61d61b4eaf086dcccef602 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=560&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=896c83e3e9b2ded9fb48199421e0c221 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=840&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=facb857392cc2909e13029b24f151212 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=1100&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2c652b524fe7f2a8cff08fb1dba06496 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=1650&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=bf5f81409686ad12cbf5e26a7f84e2e6 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-domains.png?w=2500&maxW=528&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ade906f28f183329a7ea046ab20b224a 2500w" data-optimize="true" data-opv="2" />

        <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
        curl "http://target.site" --proxy brd.superproxy.io:33335 --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
    curl "http://target.site" --proxy brd.superproxy.io:33335 --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](https://docs.brightdata.com/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](https://docs.brightdata.com/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](https://docs.brightdata.com/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](https://docs.brightdata.com/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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8865e37db6b85ba4c7b10554f96b5152" alt="integrate-new-proxy.gif" width="1828" height="978" data-path="images/proxy-networks/faqs/integrate-new-proxy.gif" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=280&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=af6967b98840c378451f71789844683c 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=560&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c8a668490c5e77e52cfaaa33e9611f92 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=840&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d8bc15aa37a36943e130b755bef3760c 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=1100&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f48c0c165a1ca706da431cb105685adb 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=1650&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e3a7b54c9cf2cd04dcfb7cbceb39b55b 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=2500&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e2e00c6be0bb7ce6e8c8b666071aff96 2500w" data-optimize="true" data-opv="2" />

    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](https://docs.brightdata.com/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 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](https://dashboard.mintlify.com/editor#how-to-integrate-a-proxy-into-3rd-party-software).
  </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
    curl "http://target.site" --proxy brd.superproxy.io:33335 --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](https://docs.brightdata.com/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 >>](/brightdata/brightdata/editor/main#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
    * Crimea region of Russia

    If you need proxies from there 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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e58931c902b2aa2b9cb71157e98e2ab9" alt="event-log.png" width="1833" height="977" data-path="images/proxy-networks/faqs/event-log.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=280&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3ca0f70abbd76e232d8bbe117f4350aa 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=560&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b08adc7e24153bf24ee8e4e36e79bf25 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=840&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=58efc19a1f43403f4cc6b896de99bc5e 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=1100&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2c9e851671051303d96f000a7e23bcfd 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=1650&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2f30a688c191fe1392e473e86826ee46 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=2500&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f7ee65bd5eabe6ae149263a8f9464acc 2500w" data-optimize="true" data-opv="2" />

    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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f2905127ebde0e5876295cb21ed341ce" alt="event-log-headers.png" width="1833" height="977" data-path="images/proxy-networks/faqs/event-log-headers.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=280&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7b9dd50469ff007397a1e8c93a030795 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=560&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=564c5cbb33cf376f1a4697557c98d724 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=840&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=888b55dcce504a411741144fed9ec49a 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=1100&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=22d813089ee901fe3d7ef46fd2dfbfda 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=1650&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=611238c6c04383d5b659d5d4fadf56af 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=2500&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6c16fdf908195d513b49f3577770876e 2500w" data-optimize="true" data-opv="2" />
  </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 our system 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
    brd.superproxy.io:33335 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
    brd-customer-<customer_id>-zone-<zone_name>-session-glob_rand39484
    ```

    Full request example:

    ```sh
    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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d438296191d4567832ffc1428804bf2e" alt="whitelist-blacklist.png" width="557" height="490" data-path="images/proxy-networks/faqs/whitelist-blacklist.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=280&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=363f6c345e5393a22de1c06867bf6d0d 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=560&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a3aae6a92643ae783a957a726c662310 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=840&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a98a1d5655cc162f1378621db15aa53c 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=1100&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=bb65479ef65304ad7f8b3fdf0bc1ea31 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=1650&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9aca6308d18a97a6d7c9281068888f0c 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/whitelist-blacklist.png?w=2500&maxW=557&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a2866c8436989541f0510a76667fffa5 2500w" data-optimize="true" data-opv="2" />

      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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c7dfe555b41399d5e9a309475aa224c5" alt="domain-add-example.png" width="376" height="112" data-path="images/proxy-networks/faqs/domain-add-example.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?w=280&maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c655c57674c2f27a0aca0a226c7576df 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?w=560&maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3ac470b45bdd7da35b4497e885cc0e99 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?w=840&maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9a5c1fd6b95f3e925a0f4218cabf376e 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?w=1100&maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b64cbde9c4199b6bcff1db31ff74d95b 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?w=1650&maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c43e175ee5ae7c1ede504b2a4e5dc6d5 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/domain-add-example.png?w=2500&maxW=376&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ff1b81e4092a8378def814864f0d5ac8 2500w" data-optimize="true" data-opv="2" />
    * Example for adding IPs:

      <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d0d9cde18e32305b3b725a6319c55651" alt="ip-add-example.png" width="222" height="82" data-path="images/proxy-networks/faqs/ip-add-example.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?w=280&maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=cb92c7bb958479d9870506a316f6760c 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?w=560&maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0fd611195ad49f67af68339ebf8699c3 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?w=840&maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4867ab10946eea6b0779af10da4e8465 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?w=1100&maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c5b6bbc36978e629b16f96dcfcce3419 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?w=1650&maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3f796d5f2ca9e9a2875b15632d6ba91c 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/ip-add-example.png?w=2500&maxW=222&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=484261c0c5a589cb25d61e8f6e12db3a 2500w" data-optimize="true" data-opv="2" />
    * 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](https://docs.brightdata.com/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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8f7a07929b754153ea7bcdb5cd694a96" alt="add-ports.gif" width="1828" height="978" data-path="images/proxy-networks/faqs/add-ports.gif" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=280&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4cdebdc4fc77c5c7ec627ed72bb3711e 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=560&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=621bba8c5764779d6a593bfa7dff671c 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=840&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8bd6dda3e631778f028bed40a55944ef 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=1100&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9a525823504d24e8b675244fef786c66 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=1650&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=016680c4f990848121b7137bc8e8e470 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-ports.gif?w=2500&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c5a061323e37be5b0f7b459f02d8f236 2500w" data-optimize="true" data-opv="2" />
  </Accordion>

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

    <CodeGroup>
      ```sh Windows
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-windows:<zone_password> --proxy brd.superproxy.io:33335 "<target_site>"
      ```

      ```sh macOS
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-osx:<zone_password> --proxy brd.superproxy.io:33335 "<target_site>"
      ```

      ```sh Android
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-android:<zone_password> --proxy brd.superproxy.io:33335 "<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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9a072edcc7d8329a525f4b0e3ec89849" alt="refresh-ips.gif" width="1892" height="868" data-path="images/proxy-networks/faqs/refresh-ips.gif" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=280&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3e069c1d9efdc57fa3028e437ed053fa 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=560&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b685c6696ece105061da5680ba285314 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=840&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3351c3aee8a4784c020acf6077cbb962 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=1100&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c78525f268a2e266fdcffc8f2d7bcac4 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=1650&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e168df26bb68ac033290abe45eb60d9e 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/refresh-ips.gif?w=2500&maxW=1892&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=dd549db272ead649e10cc291b39c5340 2500w" data-optimize="true" data-opv="2" />

    <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
    curl "https://lumtest.com/myip.json" --verbose --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
    ```

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

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ae57da3518779f40a958f78a00ecfedf" alt="x-brd-ip.png" width="423" height="23" data-path="images/proxy-networks/faqs/x-brd-ip.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=280&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4578ce7b27745497ae8123a53a852500 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=560&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=eea20a9293172fd0a758c50ab8438dca 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=840&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7549acd6febbfb9404217c4337ae4713 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=1100&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f2376a4f21caa18b90f3501d109f1c2e 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=1650&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=79eece5f221dab3bf68b12a7611e0a84 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=2500&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8d41955b988378d12e7838ad4e5a3b15 2500w" data-optimize="true" data-opv="2" />

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

    ```sh
    curl "https://lumtest.com/myip.json" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-<hashed-ip>:<zone_password>
    ```

    We recommend using [https://lumtest.com/myip.json](https://lumtest.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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=382d3e5f40fd938e5a84ae2849fd0c3e" alt="asn-targeting.png" width="583" height="931" data-path="images/proxy-networks/faqs/asn-targeting.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=280&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=77b6b1aa38626011a34ca6486219d353 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=560&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e6630c50ab7413f6837e8d326ba00b3f 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=840&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6e220de756396a15aaba32b6c5da186f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=1100&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=da2df73c5b2c0d5d37cbe06ee086f73b 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=1650&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5664f5ee339248026f6350324c0adcbf 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=2500&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6df52c82ff5d02aeb05a43655e73736c 2500w" data-optimize="true" data-opv="2" />

    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
    curl --proxy brd.superproxy.io:33335 --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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c6271c5594fac3f6861969bd7af27f1e" alt="number-of-dedicated-gIPs.png" width="645" height="909" data-path="images/proxy-networks/faqs/number-of-dedicated-gIPs.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=280&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5dbdca062126def5cb6056cefbb9b7dd 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=560&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9bcacda84b73566eae2020e039b2e38b 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=840&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0d9c62f26e4bd3d36d89ee278440d204 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=1100&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=42f6b5b50b0e87f20029e4a89df13c2b 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=1650&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=655cc189fd49c7ffeb9b739f59a23ebd 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=2500&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=15972b33cfafd930e2d7b90d18768248 2500w" data-optimize="true" data-opv="2" />

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

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=75d1f6c97b99b54c4bb1f4e6ac222b09" alt="show-allocated-dedicated-ips.png" width="583" height="393" data-path="images/proxy-networks/faqs/show-allocated-dedicated-ips.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=280&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2d56759505ae73cd244f0a59e673516d 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=560&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6ff579ae3da9b8a1fb08048c5cd40f42 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=840&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e9e229a90011d93f9128b7a67e47b47a 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=1100&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d26dd0084f0f82302519b8c73013a03c 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=1650&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=1936faef05312195dd9c83c8960bed3a 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=2500&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fd1c5fca0c04634e370f8b82cd451fb1 2500w" data-optimize="true" data-opv="2" />

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

    ```sh
    curl --proxy brd.superproxy.io:33335 --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
    curl --proxy brd.superproxy.io:33335 --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:

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

    * For Example

    <CodeGroup>
      ```sh Deutsche Telekom
      brd-customer-<customer_id>-zone-<zone_name>-carrier-dt
      ```

      ```sh Sprint
      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](https://docs.brightdata.com/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](https://docs.brightdata.com/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](https://docs.brightdata.com/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:

    ```
    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="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
    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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8e6dbf5d13a5a505ee83311e5423848c" alt="x-luminati-ip.png" width="1431" height="891" data-path="images/proxy-networks/faqs/x-luminati-ip.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=280&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e16c6daf292290c6ab018be163c94542 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=560&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ae65c3d709a142b5df4e6ac680a139b4 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=840&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fad48d3ca58086816807cc0483223f44 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=1100&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e691672a4db29bfcad1c420f69c30608 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=1650&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=30238efbb97cfebaa172def9f97d0f5a 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-luminati-ip.png?w=2500&maxW=1431&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d0c10e74aa99a4b9ef5b172266a00659 2500w" data-optimize="true" data-opv="2" />
  </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](https://docs.brightdata.com/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](https://docs.brightdata.com/proxy-networks/proxy-manager/introduction) you can make use of the [long single session](https://docs.brightdata.com/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, our system 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](https://docs.brightdata.com/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](https://docs.brightdata.com/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](https://docs.brightdata.com/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/mobile networks in 'Immediate Access' mode, and have not handled the SSL verification correctly

    For more info on what 'Immediate Access' mode and 'Special Permissions' mean: [Immediate Access Explanation](https://docs.brightdata.com/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](https://docs.brightdata.com/api-reference/api-vs-native-access)
    * 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](https://docs.brightdata.com/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](https://docs.brightdata.com/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?">
    Bright Data policy allows targeting government website after passing the KYC process. [Read more about KYC process](https://docs.brightdata.com/proxy-networks/residential/network-access#kyc-verification).
  </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. In Residential Immediate access mode, 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:

    * Complete the Know Your Customer (KYC) process, after which you'll have full unrestricted access to our residential network which will resolve all robots.txt errors. To start the process see the following link: [https://brightdata.com/cp/kyc](https://brightdata.com/cp/kyc)
    * Use our other products, that do not require KYC verification, such as ISP and DataCenter proxies.
    * 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](https://docs.brightdata.com/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?" defaultOpen="false">
    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](https://docs.brightdata.com/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](https://docs.brightdata.com/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](https://docs.brightdata.com/integrations/introduction)
  </Accordion>

  <Accordion title="Does Bright Data have any request limits? " defaultOpen="false">
    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](https://docs.brightdata.com/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?" defaultOpen="false">
    {/* TAGS: "youtube.com block"; "google.com block"; "403 forbidden"; "immediate access"; "no kyc"; "youtube 403 forbidden"; "residential"; "mobile"; "Why can I open website X but not Google"; "cant open google"; "cant open paypal"; "bing.com block"; "www.bing.com"*/}

    As part of BrightData's policy - we perform blocks or [Super-Proxy-Bypasses](https://docs.brightdata.com/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](https://docs.brightdata.com/scraping-automation/serp-api/introduction) or Unlocker API instead.
  </Accordion>

  <Accordion title="Why am i getting wrong geolocation when checking proxy IP?" defaultOpen="false">
    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?](https://docs.brightdata.com/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?" defaultOpen="false">
    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](https://docs.brightdata.com/proxy-networks/proxy-manager/configuration#port-targeting)
  </Accordion>

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

    If our system detects unusual or suspicious activity originating from a particular IP address on one of your zones, our 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 & Scraping' tab in your dashboard
    2. Navigate to the affected 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 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 src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configure-your-proxy/your-proxy-list.png?maxW=1465&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=8639ba2cdb27e6a0a0e9a7a58dd1e436" alt="your-proxy-list" width="1465" height="607" data-path="images/proxy-networks/data-center/configure-your-proxy/your-proxy-list.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configure-your-proxy/your-proxy-list.png?w=280&maxW=1465&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d74622202d6a14987207752c1f7154a5 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configure-your-proxy/your-proxy-list.png?w=560&maxW=1465&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=3edba3e55d8111b6f49296146dfd7e07 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configure-your-proxy/your-proxy-list.png?w=840&maxW=1465&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=7718e68797e47c8e7e4190ec8bb45fc9 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configure-your-proxy/your-proxy-list.png?w=1100&maxW=1465&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=73747a6b2ebe9528812d5b028f8ae832 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configure-your-proxy/your-proxy-list.png?w=1650&maxW=1465&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=030e37f556e3909e96c737fa2006b4a7 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/configure-your-proxy/your-proxy-list.png?w=2500&maxW=1465&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=0b098ccd6c999f6524c893fb4927c938 2500w" data-optimize="true" data-opv="2" />
    </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...](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 tool configuration, and not controlled by Bright Data).
  </Accordion>

  <Accordion title="Does Bright Data proxies support HTTP3?" defaultOpen="false">
    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? " defaultOpen="false">
    ### 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.

    ```
    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>
</AccordionGroup>


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

Bright Data’s proxy infrastructure gives developers access to the web through 150M+ of industry’s most advanced and diverse IP networks. With full control over request logic, session management, and geo-location targeting, you can build and scale custom scrapers for any use case of your new file.

<div align="center">
  <h2 align="center"> 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>

    <Card title="Mobile" href="/proxy-networks/mobile/introduction" icon="mobile">
      See the web as any real mobile user around the world through a 3G/4G/5G IP Network.
    </Card>
  </CardGroup>
</Card>

<Tip>
  [Proxy Manager](https://docs.brightdata.com/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) with \$5 credits, no credit card required. We’ll match your first account deposit up to \$500 !
</Note>

<Info>
  For billing, settings and user access, visit the [account management](https://docs.brightdata.com/general/account/api-token) 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.

## IP type

Bright Data offers 3 types of ISP proxies:

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

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

<Card title="Dedicated unlimited" icon="square-3" horizontal="true">
  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...](https://docs.brightdata.com/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?](https://docs.brightdata.com/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.

### Country selection

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 src="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=d307c894cda3101699ba450988554136" alt="Geolocation Targeting" width="572" height="358" data-path="images/proxy-networks/data-center/geotargeting.png" srcset="https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=280&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=67026a086654981fcd2439025d93033d 280w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=560&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=341cf0c6a4d403bdb158cc49a0f23ebf 560w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=840&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=895a1fd7f97db50b0571cfb2db31fb05 840w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=1100&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=dc5caddedc4dcc33fb7169cb5c6bc9d8 1100w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=1650&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=9d153ef8bfb872cb54758141256a6d5d 1650w, https://mintcdn.com/brightdata/_z4zr7zjFQ35V26y/images/proxy-networks/data-center/geotargeting.png?w=2500&maxW=572&auto=format&n=_z4zr7zjFQ35V26y&q=85&s=39e92809ce18ca858e9ac907ed504a9a 2500w" data-optimize="true" data-opv="2" />
</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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/configure-your-proxy/your-proxy-list.png?maxW=1465&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3206712d507bce390e2a9fb96f4f747d" alt="your-proxy-list" width="1465" height="607" data-path="images/proxy-networks/isp/configure-your-proxy/your-proxy-list.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/configure-your-proxy/your-proxy-list.png?w=280&maxW=1465&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3f14d7e14a5a028b016785d21363a67f 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/configure-your-proxy/your-proxy-list.png?w=560&maxW=1465&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=711882fd052ed0535eadba5e5b400684 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/configure-your-proxy/your-proxy-list.png?w=840&maxW=1465&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8c569db5560a4b4d9dcb0af3810aaf9a 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/configure-your-proxy/your-proxy-list.png?w=1100&maxW=1465&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9f500fe3c5b6ea5cf171caf06718263d 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/configure-your-proxy/your-proxy-list.png?w=1650&maxW=1465&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=22dad2f1c7cb4b9d855158d97102d56d 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/configure-your-proxy/your-proxy-list.png?w=2500&maxW=1465&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=93a58d5bf6aa6227f225bcee5cef9acd 2500w" data-optimize="true" data-opv="2" />
</Frame>

***

## Advanced options

***

### 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...](https://docs.brightdata.com/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

Discover how Bright Data's virtual ISP proxies operate, including security measures, user privacy, and compliance with ISP policies. Get answers to your most pressing questions.

<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

Learn how Bright Data's ISP Proxy Network leverages residential IPs for high-speed, reliable data access, ideal for ad verification, QA, and overcoming datacenter proxy 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](https://docs.brightdata.com/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. 

## Best for

* 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](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 [Unlocker API](https://docs.brightdata.com/scraping-automation/web-unlocker/introduction) or check out our [other proxy products.](https://brightdata.com/proxy-types)
</Tip>


# How to Get Started with ISP Proxies
Source: https://docs.brightdata.com/proxy-networks/isp/quickstart

Learn how to get started with Bright Data's ISP Proxies, from setting up your account to creating and naming your proxy zone, with easy-to-follow steps.

<Tip>
  if you haven't yet signed up for Bright Data, you can [sign up for
  free](https://brightdata.com/), and when adding your payment method, you'll
  receive a \$5 credit to get you started!
</Tip>

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

  <Step title={<>Navigate to "Proxies & Scraping", then <a href="https://brightdata.com/cp/zones">"My Zones"</a></>}>
    <Accordion title="In My Zones page, under ISP Proxies click Get started">
      <Warning>
        If you already have an active proxy, simply choose **Add** at the top right corner
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/get_started.png?maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b2babb702918308c826f3747e9b855a5" alt="Get Started" width="1157" height="888" data-path="images/proxy-networks/isp/quick-start/get_started.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/get_started.png?w=280&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f117b6843b9cbe067a7a546a3337db15 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/get_started.png?w=560&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c68fb721cc2eebd513f89ec252118d20 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/get_started.png?w=840&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9eb11a43b12b98e09bfdc3c6793ae4ac 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/get_started.png?w=1100&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=93107fc609c525d8f6504f05245f12a5 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/get_started.png?w=1650&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7235a12c876c723f67f5a56717736c12 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/isp/quick-start/get_started.png?w=2500&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=87e1825a81098f5672c354145e2a9a72 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="Assign a name to your Proxy">
    <Warning>
      Please select a meaningful name, as the zone's name cannot be changed once created.
    </Warning>
  </Step>

  <Step title={<> <a href="https://docs.brightdata.com/proxy-networks/isp/configure-your-proxy">Configure</a> your proxy</>} />

  <Step title="Click Add" />
</Steps>

<Accordion title="Before continuing, verify your account">
  If you haven’t yet added a payment method, you’ll be prompted to add one at this point to verify your account. If it’s your first time using Bright Data, then you’ll also receive a \$5 bonus credit to get you started!

  <Tip>
    You will not be charged anything at this point and this is solely for verification purposes
  </Tip>
</Accordion>

<Note>
  Don't worry, we'll cover all the configurations in the next section [Configure your Proxy](/proxy-networks/isp/configure-your-proxy)
</Note>


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

Learn how to send your first request using Bright Data's proxy products with easy-to-follow code examples in multiple programming languages.

<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. 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
  curl "http://lumtest.com/myip.json" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```javascript Node.js
  #!/usr/bin/env node

  require('request-promise')({
      url: 'http://lumtest.com/myip.json',
      proxy: 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:33335',
    })
    .then(function (data) {
        console.log(data);
      },
      function (err) {
        console.error(err);
      });
  ```

  ```python Python
  import pprint
  import requests


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

  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://lumtest.com/myip.json"
  response = requests.get(url, proxies=proxies)
  pprint.pprint(response.json())

  ```

  ```php PHP

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

  ```

  ```ruby Ruby
  #!/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://lumtest.com/myip.json')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 33335, '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#
  using System;
  using System.Net;

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

  ```java Java
  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", 33335);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("http://lumtest.com/myip.json").viaProxy(proxy))
              .returnContent().asString();
          System.out.println(res);
      }
  }
  ```

  ```perl Perl
  #!/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:33335");
  print $agent->get('http://lumtest.com/myip.json')->content();
  ```

  ```vb VBA
  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:33335")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("http://lumtest.com/myip.json"))
      End Sub
  End Module
  ```
</CodeGroup>

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

```json Output
{
  "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://lumtest.com/myip.json”](https://lumtest.com/myip.json”) with the website of your choice and ...

**That's it!**


# How to Configure Your Mobile Proxy
Source: https://docs.brightdata.com/proxy-networks/mobile/configure-your-proxy

Learn how to configure your Bright Data Mobile Proxy settings, including IP types, geolocation targeting, cache proxy, and advanced options for optimal performance.

<Accordion title="First: Navigate to the Configuration tab">
  Once you have created your proxy, you can configure your proxy settings by navigating to **Configurations** tab.

  <Frame>
    <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configuraton_tab.png?maxW=1090&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8d966833fd4e1cb50df32de1c6c264e3" alt="Configuration" width="1090" height="813" data-path="images/proxy-networks/residential/configuraton_tab.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configuraton_tab.png?w=280&maxW=1090&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=30bd74b7d2df93332c74034568366751 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configuraton_tab.png?w=560&maxW=1090&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0b149aebc517d8b8a467639d9d8e3749 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configuraton_tab.png?w=840&maxW=1090&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a541509bf7121f1d1d4bcdd5f50d8014 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configuraton_tab.png?w=1100&maxW=1090&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0513721693a6af94abe5594e2e9dce9e 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configuraton_tab.png?w=1650&maxW=1090&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e5e06ad808f834cb15fc1d3693cd152a 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/configuraton_tab.png?w=2500&maxW=1090&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6960cd7f993ff12b11057bfd3d931e9a 2500w" data-optimize="true" data-opv="2" />
  </Frame>
</Accordion>

## IP type

**Choose one of two IP types for your proxy zone:**

<CardGroup cols={2}>
  <Card title="Shared" href="/proxy-networks/faqs#what-are-ip-types-for-residential-and-mobile-proxy" icon="square-1">
    When you want a cost-efficient option, and you don’t require IP exclusivity. These proxies will rotate so every request you can get a new IP address ("Rotating proxies").

    <Note>IPs shared across **multiple** users</Note>
  </Card>

  <Card title="Dedicated IP" href="/proxy-networks/faqs#what-are-ip-types-for-residential-and-mobile-proxy" icon="square-2">
    When you need to access websites with an exclusive IP address.
    <Note>IPs are **for your use only**.</Note>
  </Card>
</CardGroup>

***

## Geolocation targeting

<Tip>
  Since your IPs are automatically allocated, it is recommended to set up a separate Mobile proxy, for each geolocation you wish to target.
</Tip>

Geolocation targeting allows you to target specific locations based on `City`, `State`, `Zip code`, or `ASN`.
Select the needed parameter from the drop-down menu.

<Frame>
  <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c2babc7def711369d0249cc5820e4caa" alt="Geolocation Targeting" width="511" height="203" data-path="images/proxy-networks/residential/geotargeting.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?w=280&maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b34ec8323b5307560ce3c34906c0d19a 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?w=560&maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2d9a9a91968a19e96316e4aa649fddbb 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?w=840&maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=29e0c12f04aec36d9d66aa94e7c2146f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?w=1100&maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=58890929d555f8be3a229be672afd43e 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?w=1650&maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=de2a9470d63a8a114f3abd6cc8ca3f27 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?w=2500&maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8d45370c4ac71cc126d7103aac4bf0eb 2500w" data-optimize="true" data-opv="2" />
</Frame>

### 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...](https://docs.brightdata.com/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?](https://docs.brightdata.com/general/faqs#where-can-i-see-the-list-of-country-codes)

***

## IP Groups `gIPs`

<Warning>
  Only works with the **Dedicated** option
</Warning>

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

<Frame>
  <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5ed0bbca23ae05267b2456a2349b15b7" alt="Geolocation Targeting" width="526" height="124" data-path="images/proxy-networks/residential/gips.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?w=280&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=acb16d5d6cc96fa2bcd3415d34e62164 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?w=560&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ef361918cc7d6a924a6ed9b6498a92f8 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?w=840&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9a7909edce3aad911238e5aaacc5dbf1 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?w=1100&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=abcc32fbd40697c8c281df9fa2cfa1db 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?w=1650&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d214c6f6ef3e312151577f63c418b6d4 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?w=2500&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f643cbe11055a98de688a6fc2ef2f4f6 2500w" data-optimize="true" data-opv="2" />
</Frame>

***

## Domains

<Warning>
  Only works with the **Dedicated** option
</Warning>

Define the domains you'd like your IPs to be exclusive to. Requests to any other domain will be sent from our super proxies.

<Frame>
  <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=57db917f7a823e6d9703a4bf28bf68d1" alt="Domains" width="518" height="130" data-path="images/proxy-networks/residential/domains.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?w=280&maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6114708991ef45cc5799cdcc2f111bb7 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?w=560&maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=328d3ad1f40a72ee54435e29944a85cf 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?w=840&maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2dcd1cd46638b19b7fd397a3cdd63f9f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?w=1100&maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=37dae90b2a8d34b68d015f7eb2a50ad2 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?w=1650&maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=16a782d50d20686dd3453233eee2dd47 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?w=2500&maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6672486d6d38264946a94909983c72aa 2500w" data-optimize="true" data-opv="2" />
</Frame>

***

## Advanced options:

### Long-session peers: Deprecated

<Warning>
  Bright Data used to offer long session peers. This is no longer offerred, account which had zone configured with long session peers will still be able to use them.
</Warning>

To see how to direct requests to explicit proxies, or create a sequence of requests with the same context (session) routed thru the same proxy peer see here: [https://docs.brightdata.com/api-reference/proxy/rotate\_ips#proxy-and-ip-rotation-control](https://docs.brightdata.com/api-reference/proxy/rotate_ips#proxy-and-ip-rotation-control)

### Ports

The following ports are open by default: `80`, `443`, `8080`, `8443`, `5678`, `1962`, `2000`, `4443`, `4433`, `4430`, `4444` and `1969`.

If you need access to other ports, click "Add ports" and fill out the form. Bright Data's compliance team will review the request and update you.


# Mobile Proxy FAQs
Source: https://docs.brightdata.com/proxy-networks/mobile/faqs

Find answers to common questions about integrating, configuring, and using Bright Data's Mobile proxy products, including IP types, geotargeting, and error codes.

<AccordionGroup>
  <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

    * Crimea region of Russia

    If you need proxies from there countries, unfortunately Bright Data will not be able to help you.
  </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
    curl --proxy brd.superproxy.io:33335 --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:

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

    * For Example

    <CodeGroup>
      ```sh Deutsche Telekom
      brd-customer-<customer_id>-zone-<zone_name>-carrier-dt
      ```

      ```sh Sprint
      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://lumtest.com/echo.json](https://lumtest.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](https://docs.brightdata.com/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](https://docs.brightdata.com/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](https://docs.brightdata.com/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:

    ```
    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="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](https://docs.brightdata.com/proxy-networks/socks5) or visit the [SOCKS5 proxies page](https://brightdata.com/solutions/socks5-proxies).
  </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.

    **Possible causes**

    * We currently do have not matching peers for your zone's configuration, as they might already be in use with a different client, or unavailable for other reasons.

    * The connection has been timed out due to inactivity.

    * The connection has been closed by the host (target URL) side

    **Sample error 502 response**

    ```
    Request URL: SAMPLE_URL Request method: GET ***Status code: 502***  
    Super proxy IP: IP  
    Username: brd-customer-customer_id-zone-zone_name-country  
    Password: zone_password  
    Sent from: 127.0.0.1  
    Response headers  
    connection: keep-alive  
    date: Tue, 14 Feb 2023 08:49:16 GMT  
    keep-alive: timeout=5  
    transfer-encoding: chunked  
    x-lpm-port: 24000  
    x-luminati-error: waiting for selector ".price-container" failed: timeout 90000ms exceeded  
    ***x-luminati-error-code: expect_element***  
    x-request-id2: REQUEST_ID  
    Request headers  
    user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36(KHTML, like Gecko) Chrome/110.0.0.0 Safari/537.36  
    host: SAMPLE_HOST  
    accept-encoding: gzip, deflate  
    Connection: keep-alive
    ```
  </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.

    **Possible causes**

    * Your machine IP is not allowlisted. In order to learn how to allowlist an IP, please review the [following article.](/api-reference/proxy-manager/allowlist-ips)

    * The domain you try to access is blocked by Bright Data.

    * The domain you try to access is not specified in your use case.

    * Failed captcha response (relevant for Unlocker API and SERP API).

    * The domain you tried to access is blocked by the Target host settings of your zone (check your proxy zone's Access Parameters)

    **Sample error 403 response**

    ```
    < HTTP/1.1 403 response status was rejected  
    < x-debug-req-id: SAMPLE_ID  
    < X-Luminati-Error: response status was rejected: 403 Forbidden  
    < X-Luminati-Error-Code: http_status  
    < Date: Wed, 22 Feb 2023 11:11:23 GMT  
    < Connection: keep-alive  
    < Keep-Alive: timeout=5  
    < Transfer-Encoding: chunked
    ```

    The 403 X-luminati-error (Forbidden) indicates you are targeting a domain that is not allowed by Bright Data \
    This can be resolved by contacting the Bright data compliance team for approval.\
    As the Bright data compliance team reviews your use case and confirms - you will be informed that access is been added.\
    For better handling, it is advised to add your account manager to the ticket and inform him as well for your requirement 

    When error message:

    ```
    You tried to target <host> but got blocked
    ```

    Appears, contact the Bright data compliance team ([compliance@brightdata.com](mailto:compliance@brightdata.com)) or from the ticketing system 

    Our compliance team will review your request to gain access to the particular domain
  </Accordion>

  <Accordion title="What devices and network does mobile proxies have? " defaultOpen={false}>
    Bright Data mobile proxies are real mobile devices connected to a real mobile network (not a personal or public wifi).&#x20;

    When issuing a request, in the response header we populate the field `x-brd-ip`  with the gIP or the proxy used (masked hash which we use to distinguish proxies and protect our peers' real IP address), for mobile proxies this field will have the letter "m" as prefix.&#x20;
  </Accordion>
</AccordionGroup>


# Introduction to Mobile Proxies
Source: https://docs.brightdata.com/proxy-networks/mobile/introduction

Discover Bright Data's Mobile Proxy Network with 7 million mobile IPs worldwide, ideal for business intelligence, competitor analysis, and ad verification.

Bright Data's [Mobile Proxy Network](https://brightdata.com/proxy-types/mobile-proxies) is a network of 7 million mobile IPs that come from people all over the world. These mobile residential IPs are distributed by ISPs to be used for people's mobile devices, and these real people opt-in and share their IP with our residential mobile network.

This allows you to connect to real mobile connections in every country and city across the world, using 3G/4G mobile connections, and access the internet as any real mobile user would. Our network is complete with ASN, carrier, and mobile network targeting capabilities.

### Best for

* Browsing sophisticated target websites as a real user would with his mobile phone.
* Business intelligence, competitor analysis, Ads verification, app quality assurance, and more
* Teams who need our [Residential](https://docs.brightdata.com/proxy-networks/residential/introduction) networks capability, with a focus on **mobile** devices

<Tip>
  If you are looking for another proxy solution that tackles different challenges [check out our other proxy products](https://brightdata.com/proxy-types).
</Tip>


# How to Get Started with Mobile Proxies
Source: https://docs.brightdata.com/proxy-networks/mobile/quickstart

Follow this step-by-step guide to quickly get started with Bright Data's Mobile Proxies, including setup instructions and account verification tips.

<Tip>
  if you haven't yet signed up for Bright Data, you can [sign up for
  free](https://brightdata.com/), and when adding your payment method, you'll
  receive a \$5 credit to get you started!
</Tip>

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

  <Step title={<>Navigate to "Proxies & Scraping", then <a href="https://brightdata.com/cp/zones">"My Zones"</a></>}>
    <Accordion title="In My Zones page, under Mobile Proxies click Get started">
      <Warning>
        If you already have an active proxy, simply choose **Add** at the top right corner
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/get_started.png?maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=57f4108c40c71779a7b7e31a50379a3e" alt="Get Started" width="1157" height="888" data-path="images/proxy-networks/mobile/quick-start/get_started.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/get_started.png?w=280&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=64eca1de59a3655d033f3bdff1bfca65 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/get_started.png?w=560&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=51e82aa530c4fdde697f56d71f19f6f8 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/get_started.png?w=840&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=42fcaf8dd0461269315a41221f7bebbc 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/get_started.png?w=1100&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=bc2d775654dd79da0a151e2567eb30b1 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/get_started.png?w=1650&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=de0c2130589632dcda358edf6a4988be 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/mobile/quick-start/get_started.png?w=2500&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=580a864c00748dded11783af1ab9cdd2 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="Assign a name to your Proxy">
    <Warning>
      Please select a meaningful name, as the zone's name cannot be changed once created.
    </Warning>
  </Step>

  <Step title={<> <a href="https://docs.brightdata.com/proxy-networks/mobile/configure-your-proxy">Configure</a> your proxy</>} />

  <Step title="Click Add" />
</Steps>

<Accordion title="Before continuing, verify your account">
  If you haven’t yet added a payment method, you’ll be prompted to add one at this point to verify your account. If it’s your first time using Bright Data, then you’ll also receive a \$5 bonus credit to get you started!

  <Tip>
    You will not be charged anything at this point and this is solely for verification purposes
  </Tip>
</Accordion>

<Note>
  Don't worry, we'll cover all the configurations in the next section [Configure your Proxy](/proxy-networks/mobile/configure-your-proxy)
</Note>


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

Learn how to send your first request using Bright Data's proxy products with easy-to-follow code examples in multiple programming languages.

<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. 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
  curl "http://lumtest.com/myip.json" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```javascript Node.js
  #!/usr/bin/env node

  require('request-promise')({
      url: 'http://lumtest.com/myip.json',
      proxy: 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:33335',
    })
    .then(function (data) {
        console.log(data);
      },
      function (err) {
        console.error(err);
      });
  ```

  ```python Python
  import pprint
  import requests


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

  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://lumtest.com/myip.json"
  response = requests.get(url, proxies=proxies)
  pprint.pprint(response.json())

  ```

  ```php PHP

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

  ```

  ```ruby Ruby
  #!/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://lumtest.com/myip.json')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 33335, '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#
  using System;
  using System.Net;

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

  ```java Java
  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", 33335);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("http://lumtest.com/myip.json").viaProxy(proxy))
              .returnContent().asString();
          System.out.println(res);
      }
  }
  ```

  ```perl Perl
  #!/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:33335");
  print $agent->get('http://lumtest.com/myip.json')->content();
  ```

  ```vb VBA
  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:33335")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("http://lumtest.com/myip.json"))
      End Sub
  End Module
  ```
</CodeGroup>

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

```json Output
{
  "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://lumtest.com/myip.json”](https://lumtest.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.

{/*tags:pmgr*/}

## 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 per 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
            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
    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
    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 33335 replacing port 22225 deprecated on Sep 2026, click to read more">[`33335`](https://docs.brightdata.com/general/faqs#which-port-shall-i-use-22225-or-33335) </Tooltip> for dropin and 24000-24... for all the ports that you'll create.

    * To run docker with cli option see the below example:

    ```sh
    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>

***

## Presets

***

<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/))

## Port Targeting

***

Bright Data proxy manager enables targeting the Proxy using IP:PORT format. For example, targeting a [port](https://docs.brightdata.com/api-reference/proxy-manager/create_a_new_proxy_port) indexed as 24000 when the proxy manager is installed locally:

```sh
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
curl --proxy brd.superproxy.io:33335 --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](https://docs.brightdata.com/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
[
    '<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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/configuration/external-sources.png?maxW=612&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a9aad1cb4e38a447e9a238369759099f" alt="" width="612" height="431" data-path="images/proxy-networks/proxy-manager/configuration/external-sources.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/configuration/external-sources.png?w=280&maxW=612&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fcf3a9792fbe38c7ad70341a602897f0 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/configuration/external-sources.png?w=560&maxW=612&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=63f3bd91abf01f263a4405ad16d1b5fa 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/configuration/external-sources.png?w=840&maxW=612&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=85d611b743dd43130bbb36a5b90a55e3 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/configuration/external-sources.png?w=1100&maxW=612&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0b163d31cb15c339318b948f365b51c4 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/configuration/external-sources.png?w=1650&maxW=612&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=df1b7ff81eb5050be520d63ea1545969 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/configuration/external-sources.png?w=2500&maxW=612&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=1de73146d83d312f5772168d9ad5c8b8 2500w" data-optimize="true" data-opv="2" />
</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

{/*tags:pmgr*/}


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

{/*tags:pmgr*/}

<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
    curl -x lum-country-br@127.0.0.1:24001 http://lumtest.com/myip.json
    ```

    The request's structure is:

    ```sh
    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
    "x-lpm-country: <country_code>"
    ```

    Example request could look like this:

    ```sh
    curl --proxy http://127.0.0.1:24000 -H "x-lpm-country: us" http://lumtest.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
    curl --proxy [LPM_DOMAIN]:[PORT] -H "x-lpm-country: il" "http://lumtest.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
    curl --proxy http://127.0.0.1:24000 -H "x-lpm-session: rand123" http://lumtest.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
    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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/logs-settings.png?maxW=1029&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8f9b5940d6f3a62a0bc86613aaa0cb1a" alt="logs-settings.png" width="1029" height="644" data-path="images/proxy-networks/proxy-manager/faqs/logs-settings.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/logs-settings.png?w=280&maxW=1029&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2eabae97956bf35527bea9caed6c99f7 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/logs-settings.png?w=560&maxW=1029&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=09a7ca7433b49fbb8bfa6688d8cdd529 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/logs-settings.png?w=840&maxW=1029&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=940875860ee0b2c66e9de27ef4f5b623 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/logs-settings.png?w=1100&maxW=1029&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=72dc72bb316b7e319ab06b2d08ca4b22 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/logs-settings.png?w=1650&maxW=1029&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=18cc7306924eece99caaa2741a02ef78 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/logs-settings.png?w=2500&maxW=1029&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e218cdf3e0074654f44a44d3b2870553 2500w" data-optimize="true" data-opv="2" />

    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
    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">
    A SOCKS server is a proxy server that works for any type of network protocol on any port and establishes a connection to a server on behalf of a user, then routes traffic between the user and the server.

    Why use [SOCKS5 proxies](https://brightdata.com/solutions/socks5-proxies) with Bright Data?

    When you use SOCKS5 with Bright Data, the Proxy Manager converts any requests to port 80 or port 443 to http and https requests, so you don't have to worry about which format is accepted by your target site. With any other port, the traffic is sent as-is between the user and the host.

    Guidelines to use SOCKS5:

    * Open Proxy Manager
    * Click a port, then 'Edit Proxy'
    * Under 'General' add SOCKS port number
    * Go to "Performance" - Set Reverse Resolve: DNS
    * Add a resolve file

      * Add '--resolve PATH' to the program code
      * Follow the hosts [file format](https://en.wikipedia.org/wiki/Hosts_\(file\))
      * List domains you are going to use and their IPs
      * Add domains and IPs from the resolve file editor in the Proxy Manager 'tools' page

      <Note>
        In order to allow SOCKS5 connections, you need to undergo KYC process shown here: [https://brightdata.com/cp/kyc](https://brightdata.com/cp/kyc) , and request approval from our compliance department. Contact your account manager if you need assistance with this procedure.
      </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
    curl -v "http://lumtest.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
    curl -v "http://lumtest.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 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
        /etc/systemd/system/pmgr.service
        ```

        ```sh
        [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
        systemctl daemon-reload
        ```
      </Step>

      <Step title="Start Proxy Manager service">
        ```sh
        systemctl start pmgr
        ```
      </Step>

      <Step title="Check status:">
        ```sh
        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
        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-luminati-ip-destination` - IP of the targeted host
    * `x-luminati-ip` - IP allocated to the request.
    * `x-luminati-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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/long-single-session.png?maxW=913&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ccccd09d1c9670f70e1c53160e69e0ba" alt="long-single-session.png" width="913" height="321" data-path="images/proxy-networks/proxy-manager/faqs/long-single-session.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/long-single-session.png?w=280&maxW=913&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c331d2ed0d6f6a6531f2e18e9ee255eb 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/long-single-session.png?w=560&maxW=913&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=27e6d15ea265cd8e18953a323be7fbb6 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/long-single-session.png?w=840&maxW=913&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=489b609a17b3665ca88c7ffe5d3c478b 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/long-single-session.png?w=1100&maxW=913&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b77d0b7654e0a619db24fcb242eddb70 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/long-single-session.png?w=1650&maxW=913&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b93b970a924195b5f6abc026267a215b 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/long-single-session.png?w=2500&maxW=913&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f8816373d4877eddc1635b4ef79981cd 2500w" data-optimize="true" data-opv="2" />
  </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
        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
    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 48 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
    curl --v "http://lumtest.com/myip.json" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-1.1.1.1:<zone_password>
    ```

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/shell-example.png?maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ce4705110d859894fe13df5b25b8eecb" alt="shell-example.png" width="1600" height="630" data-path="images/proxy-networks/proxy-manager/faqs/shell-example.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/shell-example.png?w=280&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d8acf089a9c247f8d9d83f918cb6859e 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/shell-example.png?w=560&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=32152e423bdabe9c82dc2dc201d2f661 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/shell-example.png?w=840&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=1107509fc27248a999ab412d5dc4b5cc 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/shell-example.png?w=1100&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=709888dba09506748b547a1c9053f1bf 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/shell-example.png?w=1650&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=bbbfb7254cc9ce3ae4419f9dc0a9ad56 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/faqs/shell-example.png?w=2500&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=844049b5967e76bcb1a7ee719df57721 2500w" data-optimize="true" data-opv="2" />
  </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, 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
    curl -L https://brightdata.com/static/lpm/luminati-proxy-latest-setup.sh | bash
    ```

    `NPM `package installer:

    ```sh
    sudo npm install -g @luminati-io/luminati-proxy
    ```

    `Docker`image:

    ```sh
    docker pull luminati/luminati-proxy
    ```

    ### Source code

    [https://github.com/luminati-io/luminati-proxy](https://github.com/luminati-io/luminati-proxy)
  </Accordion>
</AccordionGroup>

{/*tags:pmgr*/}


# Proxy Manager Integration
Source: https://docs.brightdata.com/proxy-networks/proxy-manager/integration

Learn about Bright Data's Proxy Manager integration options and some tips for best use.

{/*tags:pmgr*/}

## 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
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
         ipconfig
         ```

         ```sh Shell
         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
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://lumtest.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
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://lumtest.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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/add-bulk-proxies.png?maxW=1018&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=91a7f2be96d1a6689368cd9447229c10" alt="" width="1018" height="251" data-path="images/proxy-networks/proxy-manager/integration/add-bulk-proxies.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/add-bulk-proxies.png?w=280&maxW=1018&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ccf3bdf514fea43e1f0c15afd4cb561a 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/add-bulk-proxies.png?w=560&maxW=1018&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=bb986b012149e62d077f0ad7a4f9472e 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/add-bulk-proxies.png?w=840&maxW=1018&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a6c9f7026857996d617cc16726a9189d 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/add-bulk-proxies.png?w=1100&maxW=1018&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ff6f90e65dd97679d263448d0f3b7e72 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/add-bulk-proxies.png?w=1650&maxW=1018&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=001eb4cd70d53380958c22606a91d9d8 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/add-bulk-proxies.png?w=2500&maxW=1018&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0e0fb721832bc66839b729e8a978c5e6 2500w" data-optimize="true" data-opv="2" />
  </Frame>

* Select Import proxy list and upload the CSV file

<Frame>
    <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/proxies-in-csv.png?maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2d6eb6070ea579c08297c948e57438b7" alt="" width="1600" height="548" data-path="images/proxy-networks/proxy-manager/integration/proxies-in-csv.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/proxies-in-csv.png?w=280&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2b042b20f71a8c263c54083f34644356 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/proxies-in-csv.png?w=560&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2dc67fec0d37456dd738d7e7ecdfaef1 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/proxies-in-csv.png?w=840&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9dd6a52517a457b16c507adb957d7742 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/proxies-in-csv.png?w=1100&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3e8286b4f132829bf1ff39918a96b618 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/proxies-in-csv.png?w=1650&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=faf03b13e912be85b21135058ea1eda0 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/proxies-in-csv.png?w=2500&maxW=1600&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b3fa242f5eded22ab814e961f10c91ed 2500w" data-optimize="true" data-opv="2" />
</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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/lum_ml.gif?maxW=1147&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e11a1fedc01acbd192fbbdeb9d3ba136" alt="" width="1147" height="457" data-path="images/proxy-networks/proxy-manager/integration/lum_ml.gif" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/lum_ml.gif?w=280&maxW=1147&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ef215a3ab94f882abd0bd9eeb1c21026 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/lum_ml.gif?w=560&maxW=1147&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a672b1b0a1a380d9e7b1da70b6d30e1e 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/lum_ml.gif?w=840&maxW=1147&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7b284085fa54f6cf32b11b9e1f0c2348 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/lum_ml.gif?w=1100&maxW=1147&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b7fc1b04cb036d9e7165a032daf62a10 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/lum_ml.gif?w=1650&maxW=1147&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=a04de9899c79530384204f8cd464f864 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/lum_ml.gif?w=2500&maxW=1147&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=dc0d4e7c5c883a960a614d3b5ffa96dd 2500w" data-optimize="true" data-opv="2" />
</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
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://lumtest.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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/jarvee.png?maxW=1024&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7644b2d47d104b25f0bd545f35d29cca" alt="" width="1024" height="406" data-path="images/proxy-networks/proxy-manager/integration/jarvee.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/jarvee.png?w=280&maxW=1024&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=16467e4fe75d2802f30e5c1b14ee8552 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/jarvee.png?w=560&maxW=1024&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=328d31792e9167213d76389003a6a398 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/jarvee.png?w=840&maxW=1024&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7cbf315f4a6dc319a66123e6cf290a77 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/jarvee.png?w=1100&maxW=1024&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e64baffae46885601f331260ba44328f 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/jarvee.png?w=1650&maxW=1024&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ab4f73338f58a95976cc3cd85e9135d8 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/proxy-manager/integration/jarvee.png?w=2500&maxW=1024&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6395468fd71f61b7ac338a369f0787a7 2500w" data-optimize="true" data-opv="2" />
</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

Get to know Bright Data's Proxy Manager, an advanced tool for controlling, managing, and monitoring proxies with unique customization, rules implementation, and API integration.

{/*tags:pmgr*/}

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


# How to Get Started with Proxy Manager
Source: https://docs.brightdata.com/proxy-networks/proxy-manager/quickstart

Get started with Bright Data's Proxy Manager by choosing Cloud Server or On-Premise, and begin managing and customizing your proxies for optimal performance.

{/*tags:pmgr*/}

<Tip>
  if you haven't yet signed up for Bright Data, you can [sign up for
  free](https://brightdata.com/), and when adding your payment method, you'll
  receive a \$2 credit on sign up and aditional \$5 credit once you enter payment method.
</Tip>

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

  <Step title="Select your prefered method">
    <CardGroup cols={2}>
      <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 Benifits">
      * 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 teamTo see further info on installation and setup see the [Introduction video](https://brightdata.com/webinar/how-to-start-using-the-bright-data-proxy-manager).
    </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](https://docs.brightdata.com/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](https://docs.brightdata.com/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

Implement best practices for securing your Proxy Manager, including IP allowlisting, admin access control, and API key-based authentication.

{/*tags:pmgr*/}

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](https://docs.brightdata.com/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
curl -X GET "http://127.0.0.1:22999/api/gen_token" -H "accept: application/json"
```

* You should be seeing the token response:

```js
"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
curl -x token:API_KEY@127.0.0.1:24000 "http://lumtest.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
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
pmgr --local_login
```


# How to Configure Your Residential Proxy
Source: https://docs.brightdata.com/proxy-networks/residential/configure-your-proxy

Configure your Bright Data Residential Proxy settings with ease. Learn how to set IP types, enable geolocation targeting, manage advanced options like long-session peers, and more.

Start by going to the configuration tab of the proxy you want to configure.

## Proxy type

**Choose one of four Proxy types (IPs types) for your proxy zone:**

<CardGroup cols={4}>
  <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 our residential network is subject to our access policy. Our dedicated and IPv6 proxies is only to customers who passed our KYC verfification process. For more information on access - see here:  [Residential network access policy](https://docs.brightdata.com/proxy-networks/residential/network-access#residential-network-access-policy).

## 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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c2babc7def711369d0249cc5820e4caa" alt="Geolocation Targeting" width="511" height="203" data-path="images/proxy-networks/residential/geotargeting.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?w=280&maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b34ec8323b5307560ce3c34906c0d19a 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?w=560&maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2d9a9a91968a19e96316e4aa649fddbb 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?w=840&maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=29e0c12f04aec36d9d66aa94e7c2146f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?w=1100&maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=58890929d555f8be3a229be672afd43e 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?w=1650&maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=de2a9470d63a8a114f3abd6cc8ca3f27 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/geotargeting.png?w=2500&maxW=511&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8d45370c4ac71cc126d7103aac4bf0eb 2500w" data-optimize="true" data-opv="2" />
</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...](https://docs.brightdata.com/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?](https://docs.brightdata.com/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 comply with <u>residential network access policy</u>.It is available only to selected customers who passed our KYC and are eligible to use this protocol over our 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
curl -i --proxy brd.superproxy.io:33335 --proxy-user brd-customer-*******-zone-residential_proxy21:********** "https://geo.brdtest.com/welcome.txt?product=resi&method=native" -g -6
```

Response error:

```sh
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

Our dedicated residential proxies are accessible **only** to customers who were verified by our compliance department (**Full mode**). Customers with "**Immediate access**" mode will see this option as **disabled** in our control panel. To read more about it visit: [https://docs.brightdata.com/proxy-networks/residential/network-access](https://docs.brightdata.com/proxy-networks/residential/network-access).

### 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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5ed0bbca23ae05267b2456a2349b15b7" alt="Geolocation Targeting" width="526" height="124" data-path="images/proxy-networks/residential/gips.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?w=280&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=acb16d5d6cc96fa2bcd3415d34e62164 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?w=560&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ef361918cc7d6a924a6ed9b6498a92f8 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?w=840&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9a7909edce3aad911238e5aaacc5dbf1 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?w=1100&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=abcc32fbd40697c8c281df9fa2cfa1db 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?w=1650&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d214c6f6ef3e312151577f63c418b6d4 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/gips.png?w=2500&maxW=526&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f643cbe11055a98de688a6fc2ef2f4f6 2500w" data-optimize="true" data-opv="2" />
</Frame>

***

### 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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=57db917f7a823e6d9703a4bf28bf68d1" alt="Domains" width="518" height="130" data-path="images/proxy-networks/residential/domains.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?w=280&maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6114708991ef45cc5799cdcc2f111bb7 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?w=560&maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=328d3ad1f40a72ee54435e29944a85cf 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?w=840&maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2dcd1cd46638b19b7fd397a3cdd63f9f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?w=1100&maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=37dae90b2a8d34b68d015f7eb2a50ad2 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?w=1650&maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=16a782d50d20686dd3453233eee2dd47 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/domains.png?w=2500&maxW=518&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6672486d6d38264946a94909983c72aa 2500w" data-optimize="true" data-opv="2" />
</Frame>

***

## 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...](https://docs.brightdata.com/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.


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

Find answers to common questions about integrating, configuring, and using Bright Data's Residential proxy products, including IP types, geotargeting, and error codes.

<AccordionGroup>
  <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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8865e37db6b85ba4c7b10554f96b5152" alt="integrate-new-proxy.gif" width="1828" height="978" data-path="images/proxy-networks/faqs/integrate-new-proxy.gif" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=280&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=af6967b98840c378451f71789844683c 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=560&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c8a668490c5e77e52cfaaa33e9611f92 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=840&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d8bc15aa37a36943e130b755bef3760c 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=1100&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f48c0c165a1ca706da431cb105685adb 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=1650&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e3a7b54c9cf2cd04dcfb7cbceb39b55b 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/integrate-new-proxy.gif?w=2500&maxW=1828&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e2e00c6be0bb7ce6e8c8b666071aff96 2500w" data-optimize="true" data-opv="2" />

    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](https://docs.brightdata.com/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 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](https://dashboard.mintlify.com/editor#how-to-integrate-a-proxy-into-3rd-party-software).

    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](https://docs.brightdata.com/integrations/browserscan)

    XLogin 		[https://docs.brightdata.com/integrations/xlogin](https://docs.brightdata.com/integrations/xlogin)

    GeeLark 	[https://docs.brightdata.com/integrations/geelark](https://docs.brightdata.com/integrations/geelark)

    Puppeteer 	[https://docs.brightdata.com/integrations/puppeteer](https://docs.brightdata.com/integrations/puppeteer)

    Playwright 	[https://docs.brightdata.com/integrations/playwright](https://docs.brightdata.com/integrations/playwright)

    Selenium 	[https://docs.brightdata.com/integrations/selenium](https://docs.brightdata.com/integrations/selenium)

    AdsPower 	[https://docs.brightdata.com/integrations/adspower](https://docs.brightdata.com/integrations/adspower)

    Dolphin Anty 	[https://docs.brightdata.com/integrations/dolphin-anty](https://docs.brightdata.com/integrations/dolphin-anty)

    Incogniton 	[https://docs.brightdata.com/integrations/incogniton](https://docs.brightdata.com/integrations/incogniton)

    Marketerbrowser [https://docs.brightdata.com/integrations/marketerbrowser](https://docs.brightdata.com/integrations/marketerbrowser)

    SMLOGIN 	[https://docs.brightdata.com/integrations/smlogin](https://docs.brightdata.com/integrations/smlogin)

    Hidemyacc 	[https://docs.brightdata.com/integrations/hidemyacc](https://docs.brightdata.com/integrations/hidemyacc)

    OpenBullet	[https://docs.brightdata.com/integrations/openbullet](https://docs.brightdata.com/integrations/openbullet)

    Switchyomega 	[https://docs.brightdata.com/integrations/switchyomega](https://docs.brightdata.com/integrations/switchyomega)

    PhantomBuster 	[https://docs.brightdata.com/integrations/phantombuster](https://docs.brightdata.com/integrations/phantombuster)

    BitBrowser 	[https://docs.brightdata.com/integrations/bitbrowser](https://docs.brightdata.com/integrations/bitbrowser)

    Maskfog 	[https://docs.brightdata.com/integrations/maskfog](https://docs.brightdata.com/integrations/maskfog)

    Ghost Browser 	[https://docs.brightdata.com/integrations/ghost-browser](https://docs.brightdata.com/integrations/ghost-browser)

    Postman 	[https://docs.brightdata.com/integrations/postman](https://docs.brightdata.com/integrations/postman)

    NGINX 		[https://docs.brightdata.com/integrations/nginx](https://docs.brightdata.com/integrations/nginx)

    StablerSOLO 	[https://docs.brightdata.com/integrations/stablersolo](https://docs.brightdata.com/integrations/stablersolo)

    VMLogin 	[https://docs.brightdata.com/integrations/vmlogin](https://docs.brightdata.com/integrations/vmlogin)

    GoLogin 	[https://docs.brightdata.com/integrations/gologin](https://docs.brightdata.com/integrations/gologin)

    Windows 	[https://docs.brightdata.com/integrations/windows](https://docs.brightdata.com/integrations/windows)

    Scrapy 		[https://docs.brightdata.com/integrations/scrapy](https://docs.brightdata.com/integrations/scrapy)

    AEZAKMI 	[https://docs.brightdata.com/integrations/aezakmi](https://docs.brightdata.com/integrations/aezakmi)

    Beautifulsoup 	[https://docs.brightdata.com/integrations/beautifulsoup](https://docs.brightdata.com/integrations/beautifulsoup)

    WebHarvy 	[https://docs.brightdata.com/integrations/webharvy](https://docs.brightdata.com/integrations/webharvy)

    Ubuntu 		[https://docs.brightdata.com/integrations/ubuntu](https://docs.brightdata.com/integrations/ubuntu)

    Lalicat 	[https://docs.brightdata.com/integrations/lalicat](https://docs.brightdata.com/integrations/lalicat)

    Multilogin 	[https://docs.brightdata.com/integrations/multilogin](https://docs.brightdata.com/integrations/multilogin)

    Undetectable 	[https://docs.brightdata.com/integrations/undetectable](https://docs.brightdata.com/integrations/undetectable)

    Apify 		[https://docs.brightdata.com/integrations/apify](https://docs.brightdata.com/integrations/apify)

    iPhone 		[https://docs.brightdata.com/integrations/ios](https://docs.brightdata.com/integrations/ios)

    MuLogin 	[https://docs.brightdata.com/integrations/mulogin](https://docs.brightdata.com/integrations/mulogin)

    Changedetection [https://docs.brightdata.com/integrations/changedetection](https://docs.brightdata.com/integrations/changedetection)

    Morelogin 	[https://docs.brightdata.com/integrations/morelogin](https://docs.brightdata.com/integrations/morelogin)

    Proxifier 	[https://docs.brightdata.com/integrations/proxifier](https://docs.brightdata.com/integrations/proxifier)

    Texau 		[https://docs.brightdata.com/integrations/texau](https://docs.brightdata.com/integrations/texau)

    Android 	[https://docs.brightdata.com/integrations/android](https://docs.brightdata.com/integrations/android)

    Kameleo 	[https://docs.brightdata.com/integrations/kameleo](https://docs.brightdata.com/integrations/kameleo)

    Screaming Frog 	[https://docs.brightdata.com/integrations/screaming-frog](https://docs.brightdata.com/integrations/screaming-frog)

    Foxy		[https://docs.brightdata.com/integrations/foxyproxy](https://docs.brightdata.com/integrations/foxyproxy)

    SessionBox 	[https://docs.brightdata.com/integrations/sessionbox](https://docs.brightdata.com/integrations/sessionbox)

    Insomniac 	[https://docs.brightdata.com/integrations/insomniac](https://docs.brightdata.com/integrations/insomniac)

    Helium Scraper 	[https://docs.brightdata.com/integrations/helium-scraper](https://docs.brightdata.com/integrations/helium-scraper)

    SaleFreaks 	[https://docs.brightdata.com/integrations/salefreaks](https://docs.brightdata.com/integrations/salefreaks)

    Postern 	[https://docs.brightdata.com/integrations/postern](https://docs.brightdata.com/integrations/postern)

    Antik 		[https://docs.brightdata.com/integrations/antik](https://docs.brightdata.com/integrations/antik)

    Easync 		[https://docs.brightdata.com/integrations/easync](https://docs.brightdata.com/integrations/easync)

    ParseHub 	[https://docs.brightdata.com/integrations/parsehub](https://docs.brightdata.com/integrations/parsehub)

    Sphere Browser 	[https://docs.brightdata.com/integrations/sphere-browser](https://docs.brightdata.com/integrations/sphere-browser)

    Octoparse 	[https://docs.brightdata.com/integrations/octoparse](https://docs.brightdata.com/integrations/octoparse)

    ixBrowser 	[https://docs.brightdata.com/integrations/ixbrowser](https://docs.brightdata.com/integrations/ixbrowser)

    Shadowrocket 	[https://docs.brightdata.com/integrations/shadowrocket](https://docs.brightdata.com/integrations/shadowrocket)

    Firefox 	[https://docs.brightdata.com/integrations/firefox](https://docs.brightdata.com/integrations/firefox)

    Chrome 		[https://docs.brightdata.com/integrations/chrome](https://docs.brightdata.com/integrations/chrome)

    MacOS 		[https://docs.brightdata.com/integrations/macos](https://docs.brightdata.com/integrations/macos)

    ClonBrowser 	[https://docs.brightdata.com/integrations/clonbrowser](https://docs.brightdata.com/integrations/clonbrowser)

    Octo Browser 	[https://docs.brightdata.com/integrations/octobrowser](https://docs.brightdata.com/integrations/octobrowser)

    Genlogin 	[https://docs.brightdata.com/integrations/genlogin](https://docs.brightdata.com/integrations/genlogin)

    Web Scraper 	[https://docs.brightdata.com/integrations/webscraper](https://docs.brightdata.com/integrations/webscraper)

    If the tool 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
    curl "http://target.site" --proxy brd.superproxy.io:33335 --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":

    ```
    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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ca7361e14082b55128dfeaecf1222f9a" alt="add-city.png" width="664" height="376" data-path="images/proxy-networks/faqs/add-city.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=280&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=04a0e4f99086ed0b3ffa814a0d6d8901 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=560&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e783c970a46a962b796015a72bf16acd 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=840&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3cac3ce62610ee6ae080145996ebb746 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=1100&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f66bf044a4bf60204463610aebca401a 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=1650&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c1478268f631d03401ac9e3c3ae0cdc2 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/add-city.png?w=2500&maxW=664&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fda8142825643a46c283f3bc55793d84 2500w" data-optimize="true" data-opv="2" />

    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?id=all) for a specific geolocation.

    Once configured, you'll be able to send requests from the selected city, using the following syntax

    ```sh
    curl "http://target.site" --proxy brd.superproxy.io:33335 --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
    * Crimea region of Russia

    If you need proxies from there 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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e58931c902b2aa2b9cb71157e98e2ab9" alt="event-log.png" width="1833" height="977" data-path="images/proxy-networks/faqs/event-log.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=280&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=3ca0f70abbd76e232d8bbe117f4350aa 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=560&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=b08adc7e24153bf24ee8e4e36e79bf25 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=840&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=58efc19a1f43403f4cc6b896de99bc5e 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=1100&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2c9e851671051303d96f000a7e23bcfd 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=1650&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2f30a688c191fe1392e473e86826ee46 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log.png?w=2500&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f7ee65bd5eabe6ae149263a8f9464acc 2500w" data-optimize="true" data-opv="2" />

    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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f2905127ebde0e5876295cb21ed341ce" alt="event-log-headers.png" width="1833" height="977" data-path="images/proxy-networks/faqs/event-log-headers.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=280&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7b9dd50469ff007397a1e8c93a030795 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=560&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=564c5cbb33cf376f1a4697557c98d724 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=840&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=888b55dcce504a411741144fed9ec49a 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=1100&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=22d813089ee901fe3d7ef46fd2dfbfda 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=1650&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=611238c6c04383d5b659d5d4fadf56af 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/event-log-headers.png?w=2500&maxW=1833&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6c16fdf908195d513b49f3577770876e 2500w" data-optimize="true" data-opv="2" />
  </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
    brd.superproxy.io:33335 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 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
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-windows:<zone_password> --proxy brd.superproxy.io:33335 "<target_site>"
      ```

      ```sh macOS
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-osx:<zone_password> --proxy brd.superproxy.io:33335 "<target_site>"
      ```

      ```sh Android
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-android:<zone_password> --proxy brd.superproxy.io:33335 "<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
    curl "https://lumtest.com/myip.json" --verbose --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
    ```

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

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=ae57da3518779f40a958f78a00ecfedf" alt="x-brd-ip.png" width="423" height="23" data-path="images/proxy-networks/faqs/x-brd-ip.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=280&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4578ce7b27745497ae8123a53a852500 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=560&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=eea20a9293172fd0a758c50ab8438dca 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=840&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=7549acd6febbfb9404217c4337ae4713 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=1100&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=f2376a4f21caa18b90f3501d109f1c2e 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=1650&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=79eece5f221dab3bf68b12a7611e0a84 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/x-brd-ip.png?w=2500&maxW=423&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8d41955b988378d12e7838ad4e5a3b15 2500w" data-optimize="true" data-opv="2" />

    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
    curl "https://lumtest.com/myip.json" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-<hashed-ip>:<zone_password>
    ```

    We recommend using [https://lumtest.com/myip.json](https://lumtest.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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=382d3e5f40fd938e5a84ae2849fd0c3e" alt="asn-targeting.png" width="583" height="931" data-path="images/proxy-networks/faqs/asn-targeting.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=280&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=77b6b1aa38626011a34ca6486219d353 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=560&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e6630c50ab7413f6837e8d326ba00b3f 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=840&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6e220de756396a15aaba32b6c5da186f 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=1100&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=da2df73c5b2c0d5d37cbe06ee086f73b 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=1650&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5664f5ee339248026f6350324c0adcbf 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/asn-targeting.png?w=2500&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6df52c82ff5d02aeb05a43655e73736c 2500w" data-optimize="true" data-opv="2" />

    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
    curl --proxy brd.superproxy.io:33335 --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 src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=c6271c5594fac3f6861969bd7af27f1e" alt="number-of-dedicated-gIPs.png" width="645" height="909" data-path="images/proxy-networks/faqs/number-of-dedicated-gIPs.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=280&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5dbdca062126def5cb6056cefbb9b7dd 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=560&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9bcacda84b73566eae2020e039b2e38b 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=840&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=0d9c62f26e4bd3d36d89ee278440d204 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=1100&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=42f6b5b50b0e87f20029e4a89df13c2b 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=1650&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=655cc189fd49c7ffeb9b739f59a23ebd 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/number-of-dedicated-gIPs.png?w=2500&maxW=645&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=15972b33cfafd930e2d7b90d18768248 2500w" data-optimize="true" data-opv="2" />

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

        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=75d1f6c97b99b54c4bb1f4e6ac222b09" alt="show-allocated-dedicated-ips.png" width="583" height="393" data-path="images/proxy-networks/faqs/show-allocated-dedicated-ips.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=280&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=2d56759505ae73cd244f0a59e673516d 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=560&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6ff579ae3da9b8a1fb08048c5cd40f42 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=840&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=e9e229a90011d93f9128b7a67e47b47a 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=1100&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=d26dd0084f0f82302519b8c73013a03c 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=1650&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=1936faef05312195dd9c83c8960bed3a 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/faqs/show-allocated-dedicated-ips.png?w=2500&maxW=583&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=fd1c5fca0c04634e370f8b82cd451fb1 2500w" data-optimize="true" data-opv="2" />

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

    ```sh
    curl --proxy brd.superproxy.io:33335 --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
    curl --proxy brd.superproxy.io:33335 --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:

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

    * For Example

    <CodeGroup>
      ```sh Deutsche Telekom
      brd-customer-<customer_id>-zone-<zone_name>-carrier-dt
      ```

      ```sh Sprint
      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](https://docs.brightdata.com/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](https://docs.brightdata.com/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](https://docs.brightdata.com/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:

    ```
    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
    x-luminati-ip: superproxy bypass
    ```
  </Accordion>
</AccordionGroup>


# Introduction to Residential Proxies
Source: https://docs.brightdata.com/proxy-networks/residential/introduction

Bright Data’s Residential proxy network offers 150M+ IPs from 195+ countries, ideal for browsing and data collection as a real user.

The Bright Data [Residential proxy network](https://brightdata.com/proxy-types/residential-proxies) is one of our proxy network solutions and is a network of 150M+ IPs from 195+ countries all around the world.

Our vast pool of Residential IPs is made up of real people who opt-in and are rewarded in exchange for lending their IP to our network, allowing you to target sophisticated, hard-to-reach websites with local IPs from the target area, which helps you view or collect relevant data as a real person would.

## Best for

* Browsing sophisticated target websites as a real user
* Business intelligence, competitor analysis, and Ads verification
* If you're getting low success rates or blocked altogether when using our [Datacenter](https://docs.brightdata.com/proxy-networks/data-center/introduction) or [ISP](https://docs.brightdata.com/proxy-networks/isp/introduction) proxy network

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


# Residential Network Access Policy
Source: https://docs.brightdata.com/proxy-networks/residential/network-access

To safeguard our expansive and ethical Residential network, Bright Data applies monitoring rules to ensure all Residential proxy traffic aligns with approved use cases and compliance policies.

Bright Data offers two distinct modes for accessing its Residential network:

<CardGroup cols={2}>
  <Card title="Immediate access (default)" href="/proxy-networks/residential/network-access#immediate-access">
    Begin targeting with our Residential network immediately after sign up, without the need for KYC
  </Card>

  <Card title="Full access (recommended)" href="/proxy-networks/residential/network-access#full-access">
    Expand your Residential network access for your approved use case by completing KYC
  </Card>
</CardGroup>

On initial setup of your Residential proxy, by default you are given [**Immediate access**](https://docs.brightdata.com/proxy-networks/residential/network-access#immediate-access) and can get started targeting a wide range of domains right away.

If during your initial targeting you encounter a [402 Residential Failed (bad\_endpoint)](https://docs.brightdata.com/proxy-networks/errorCatalog#http-error-402) or `robots.txt` error, you will need to request [**Full access**](https://docs.brightdata.com/proxy-networks/residential/network-access#full-access), which can be granted once we get to know you and your use case better through [KYC](https://brightdata.com/cp/kyc).

## Immediate access

<Warning>
  An [SSL certificate](https://docs.brightdata.com/general/account/ssl-certificate) must be installed on your device when accessing our Residential network with *Immediate access*.
</Warning>

* Access a wide range of domains without KYC, under the following limitations:
  * Domains restricted by their own 'robots.txt' rules.
  * Domains restricted by Bright Data’s compliance policy for Immediate access.
  * Use of certain HTTP methods (POST, PUT, DELETE) is not permitted.
  * Automatic throttling may be applied if request volume exceeds acceptable thresholds (`status code: 502`, `error: sr_rate_limit`).
  * Note: Attempting to access restricted domains or methods will result in a `402 Residential Failed (bad_endpoint)` error and you'll need to apply for [Full access](https://docs.brightdata.com/proxy-networks/residential/network-access#full-access) mode instead.

<Tip>
  Completing [KYC](https://brightdata.com/cp/kyc) removes the above restrictions and automatically grants you **Full access** to domains under the Residential network, tailored to your approved use case.
</Tip>

<AccordionGroup>
  <Accordion title="Why does Immediate access mode require an SSL certificate?">
    ### Secure and Ethical Usage

    Our SSL certificate ensures compliance with Bright Data's ethical guidelines while providing secure encryption. Since Immediate Access does not require KYC, the SSL certificate acts as an added layer of assurance, enabling Bright Data to enforce compliance and safeguard the ethical use of our Residential network. This ensures that the network is used responsibly while protecting both users and our infrastructure.

    If you don't install our SSL certificate, your requests may be rejected with security errors like "SSL/TLS handshake failure" or "certificate validation error", indicating an insecure connection. While you can bypass and ignore SSL errors, this is not recommended as it compromises your long-term security.
  </Accordion>

  <Accordion title="Why installing an SSL certificate is simple and secure">
    By installing the SSL certificate, you can immediately start using the Residential network with minimal friction, while enjoying the peace of mind that your traffic is handled ethically and securely.

    Installing an SSL certificate may sound daunting, but it’s a quick, secure, and one-time setup process that unlocks Immediate Access. Here’s why it’s worth considering:

    ### Temporary and Limited Data Handling

    Bright Data accesses minimal data (e.g., web pages visited, access times) only for troubleshooting and compliance purposes. This data is stored temporarily and is not shared with third parties, except where legally required.

    ### Privacy-Focused Approach

    We prioritize your privacy above all else. Learn more in our [Privacy Policy](https://brightdata.com/privacy)

    ### Still prefer not to install an SSL certificate?

    If you prefer not to install an SSL certificate, you can complete the [KYC process](https://brightdata.com/cp/kyc) to unlock Full Access, eliminating the need for SSL while enabling broader network capabilities.
  </Accordion>

  <Accordion title="What is robots.txt and how does it affect Immediate access?">
    `robots.txt` is a file that website owners use to define which areas of their site can be accessed by automated systems. In **Immediate access** mode, Bright Data adheres to these rules to ensure ethical compliance. Requests to blocked areas will return a `402 Residential Failed (bad_endpoint)` error. For unrestricted **Full access**, complete [KYC](https://brightdata.com/cp/kyc).
  </Accordion>

  <Accordion title="Why can't I add dedicated residential proxies?" defaultOpen="false">
    Our dedicated residential proxies are available only to customers who complete our verification process. In Bright Data control panel, when you add a residential proxies zone, under "Proxy type" selection, the "Dedicated" proxies will appear disabled until you pass our verification process. You can use our "Shared" residential proxies in immediate access mode, after installing our certificate or ignoring SSL errors.
  </Accordion>
</AccordionGroup>

## Full access

* After completing [KYC](https://brightdata.com/cp/kyc), you will have Full Access to the Residential network, tailored to your approved use case.
* Allows the use of HTTP methods in your request
* SSL certificate is **not** required
* The option to submit a KYC form is only open to customers that signed up on behalf of a registered company. You will be required to add a user with a company email domain to your account and submit a company registration document during the process.

## FAQ: What is Bright Data KYC (Know Your Customer) verification process?

<AccordionGroup>
  <Accordion title="Why do you require KYC for Full Access?">
    * Our KYC (“Know Your Customer”) process is a mandatory step for all new customers who wish to join our residential proxy network or gain special access rights.
    * The purpose of this stage is to ensure that we maintain the highest possible compliance and ethics standards by verifying your business and use case.
    * If you were asked to complete the process that means you requested access to our residential network or require a special access right that is not allowed by default in our system.
  </Accordion>

  <Accordion title="What is the process for KYC verification?">
    To complete KYC, you’ll need to submit details about your yourself and your scraping use case to verify eligibility by our Compliance team. This process removes the need for an SSL certificate and unlocks access to sites not pre-approved in Immediate Access. Start the KYC process below:

    [Start KYC Verification](https://brightdata.com/cp/kyc)

    <Warning>
      The KYC process is not available in [Playground](https://docs.brightdata.com/general/faqs#what-is-playground-mode)/[Limited Trial](https://docs.brightdata.com/general/faqs#what-is-limited-trial-mode) modes. The process can be started only after adding real funds to the account balance.
    </Warning>
  </Accordion>

  <Accordion title="How much time it takes to get my KYC approved?" defaultOpen="false">
    * A company submission (“As a company” KYC) will usually take up to 5 minutes while a freelancer submission (“As myself” KYC) will take up to 10 minutes.
    * Following the submission, freelancers are required to set up a quick video call to review their request and validate the information. You can set up the time according to your availability and one of our sales representatives will be happy to assist.
    * Once all the information is collected and updated, our sales team validates the information in the submission and the KYC is sent to our Compliance & Ethics team for review and approval.
    * You can see the status of your request in Bright Data control panel, under "Account" then "Profile" tab.
    * Allow 2 business days to review your request
  </Accordion>

  <Accordion title="How do I know that my KYC has been approved? " defaultOpen="false">
    * You can check out the status of your KYC process at any time in your control panel. A notification regarding the submission of your KYC and approval or decline of your request will be sent to your email once the process is completed.
    * The status will be under Settings -> Profile , showing "Account verification status"
  </Accordion>

  <Accordion title="Do I have to complete the KYC process to gain Residential network access? ">
    * If you have a specific use case in mind, you may want to try our immediate residential proxy access, which provides access to popular domains, without requiring the KYC onboarding process.
    * For all other domains in our residential network, a KYC process is mandatory.
  </Accordion>

  <Accordion title="Is this a one-time process?">
    The KYC information is documented in our systems to allow us to review your use case if needed in the future. Although we want to make it a one-time process, we also monitor our network 24/7 and we may reach out to you for additional clarifications or information in order to make sure that our network remains safe.
  </Accordion>

  <Accordion title="Should I submit the KYC as myself or as a company?">
    Freelancers should submit the KYC information under their own name. All other applicants should submit the KYC information under their registered company name. Submitting the KYC information under the wrong type of application can lead to extra requests for information, mismatches, and declined applications.
  </Accordion>

  <Accordion title="What information will I need to share?">
    The KYC process requires some basic information about your business, such as a description of your use case and general contact information.

    The more information we have about your business and your use case the easier it will be for our Compliance & Ethics team to evaluate and approve your request.

    We may require further clarification, validation, or identification, so if needed we will follow up accordingly once you complete the KYC.
  </Accordion>

  <Accordion title="Why do I have to submit an ID?">
    Submitting a valid form of identification (license, passport, or other government issued ID) is a requirement for freelancers who would like access to the residential/mobile network. All of our IP addresses belong to 100% real peers, and part of our process of keeping everyone safe is to verify the identity of customers who would like to use the residential network.
  </Accordion>

  <Accordion title="Why do I need to set up a video call?">
    A video call is a mandatory step for anyone submitting the KYC under their own name (not a company name) in order to verify their identity before allowing any special access rights. If your account is to be used as part of a company activity, we strongly recommend choosing the relevant KYC process option accordingly (set process option as “on behalf of a company”) as it may allow for a faster and smoother process. Please note that you might be required to go on a video call, regardless of the type of KYC submitted, if further verification is required.
  </Accordion>

  <Accordion title="What is a company registration form/certificate of incorporation?">
    A company registration form (also referred to as a “Certificate of incorporation”) is used by government offices as proof of registering new businesses. The form usually contains the company's official information, including the company's formal name, registered office address, company registration unique identifier, and more. The form is usually available to the company legal counsel, financial department, or similar and can be publicly shared as part of the company's routine business activity as proof of registration according to local regulations.
  </Accordion>

  <Accordion title="Can I still use Bright Data services while my KYC is inspected?">
    * You can use all our other products and services while your KYC request is being processed.
  </Accordion>

  <Accordion title="Can I still use Datacenter and ISP if my KYC for residential access was declined?">
    * If your KYC was not approved you may still use one of our other products and services according to Bright Data's [license](https://brightdata.com/license).
  </Accordion>

  <Accordion title="I'm a freelancer, can I submit a KYC form?">
    * Yes, freelancers are welcome to submit a KYC. Just select the "As myself" option in the form and fill in your personal details.
  </Accordion>

  <Accordion title="What documents do I need to submit as a freelancer?">
    * You'll need to upload a valid government-issued ID and schedule a short video call to verify your identity and explain your use case.
  </Accordion>

  <Accordion title="Why do freelancers need a video call?">
    * The video call helps us verify your identity and better understand your use case. It’s a quick process and usually takes just a few minutes.
  </Accordion>

  <Accordion title="I am a freelancer and I don’t have a company website, is that a problem?">
    * Not at all. As a freelancer, we don’t expect you to have a company website. If you have any online presence (like LinkedIn, portfolio, etc.), feel free to share it.
  </Accordion>

  <Accordion title="How long does the freelancer KYC process take?">
    * Once you’ve submitted the form and completed the video call, it usually takes up to 3 business days for our Compliance team to review and approve your request.
  </Accordion>

  <Accordion title="What happens during the freelancer KYC video call?">
    * During the call, we’ll ask you to show your ID and walk us through your use case. This includes what kind of data you’re collecting, how you use proxies in your workflow, and what platforms or tools you use. The call is recorded and reviewed by our Compliance team.
  </Accordion>

  <Accordion title="What kind of ID does a freelancer needs to provide?">
    * You’ll need to upload a valid government-issued photo ID (like a passport or driver’s license). We’ll also ask you to show it during the video call to confirm your identity.
  </Accordion>

  <Accordion title="What if I am a freelancer and I don’t have a LinkedIn or website?">
    * That’s okay. Freelancers aren’t required to have a company website. If you have any kind of online presence (like a portfolio, GitHub, Fiverr profile, etc.), you can share that, but it’s not mandatory.
  </Accordion>

  <Accordion title="What if I don’t want to do a video call?">
    * The video call is required for freelancer KYC. It helps us verify your identity and understand your use case clearly. Without it, we won’t be able to approve your access to the residential network.
  </Accordion>

  <Accordion title="Can I use Bright Data for personal projects?">
    * No. Bright Data is a B2B platform. We only support business-related use cases. If your project is personal (like scraping for a hobby or side project), it won’t be approved.
  </Accordion>

  <Accordion title="What kind of use cases are not allowed?">
    * For freelancers we don’t allow scraping behind login, fake engagement, fake account creation, or anything that violates our Acceptable Use Policy. If you’re unsure, feel free to ask before submitting.
  </Accordion>

  <Accordion title="I submitted my KYC but haven’t heard back, what should I do?">
    * KYC reviews for freelancers can take up to 3 business days. If it’s been longer, you can check the status in your Control Panel under Account > Profile, or reach out to your account manager or our support team.
  </Accordion>
</AccordionGroup>


# How to Get Started with Residential Proxies
Source: https://docs.brightdata.com/proxy-networks/residential/quickstart

Follow these steps to set up your [Residential Proxy](https://brightdata.com/proxy-types/residential-proxies) with Bright Data. Sign in, create a proxy zone, and verify your account to start.

<Tip>
  if you haven't yet signed up for Bright Data, you can [sign up for
  free](https://brightdata.com/), and when adding your payment method, you'll
  receive a \$5 credit to get you started!
</Tip>

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

  <Step title={<>Navigate to "Proxies & Scraping", then <a href="https://brightdata.com/cp/zones">"My Zones"</a></>}>
    {/* In [My Zones](https://brightdata.com/cp/zones) page, under `Residential Proxies` click `Get started` */}

    <Accordion title="In My Zones page, under Residential Proxies click Get started">
      <Warning>
        If you already have an active proxy, simply choose **Add** at the top right corner
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/get_started.png?maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=6877ab7b71796d26ce960f42ffec4b62" alt="Get Started" width="1157" height="888" data-path="images/proxy-networks/residential/get_started.png" srcset="https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/get_started.png?w=280&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=4f8edeb856d1d04e75463106be6a0808 280w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/get_started.png?w=560&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=5ccb40539239854351126dbbac11aa35 560w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/get_started.png?w=840&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=9937a9bd68383565b6f2e1781b46590c 840w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/get_started.png?w=1100&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=08625b8f49c175f65bd85d330ca8b7aa 1100w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/get_started.png?w=1650&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=59ec5a318119941b4b8276e8bbdec437 1650w, https://mintcdn.com/brightdata/OHb0qOLABq5WIuwB/images/proxy-networks/residential/get_started.png?w=2500&maxW=1157&auto=format&n=OHb0qOLABq5WIuwB&q=85&s=8e793e8c0f30b8ce133458a77c5f7fde 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="Assign a name to your Proxy">
    <Warning>
      Please select a meaningful name, as the zone's name cannot be changed once created.
    </Warning>
  </Step>

  <Step title={<> <a href="https://docs.brightdata.com/proxy-networks/residential/configure-your-proxy">Configure</a> your proxy</>} />

  <Step title="Click Add" />
</Steps>

<Accordion title="Before continuing, verify your account">
  If you haven't yet added a payment method, you'll be prompted to add one at this point to verify your account. If it's your first time using Bright Data, then you'll also receive a \$5 bonus credit to get you started!

  <Tip>
    You will not be charged anything at this point and this is solely for verification purposes
  </Tip>
</Accordion>

<Note>
  Don't worry, we'll cover all the configurations in the next section, [Configure your Proxy](/proxy-networks/residential/configure-your-proxy)
</Note>


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

Learn how to send your first request using Bright Data's proxy products with easy-to-follow code examples in multiple programming languages.

<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. 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
  curl "http://lumtest.com/myip.json" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```javascript Node.js
  #!/usr/bin/env node

  require('request-promise')({
      url: 'http://lumtest.com/myip.json',
      proxy: 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:33335',
    })
    .then(function (data) {
        console.log(data);
      },
      function (err) {
        console.error(err);
      });
  ```

  ```python Python
  import pprint
  import requests


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

  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://lumtest.com/myip.json"
  response = requests.get(url, proxies=proxies)
  pprint.pprint(response.json())

  ```

  ```php PHP

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

  ```

  ```ruby Ruby
  #!/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://lumtest.com/myip.json')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 33335, '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#
  using System;
  using System.Net;

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

  ```java Java
  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", 33335);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("http://lumtest.com/myip.json").viaProxy(proxy))
              .returnContent().asString();
          System.out.println(res);
      }
  }
  ```

  ```perl Perl
  #!/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:33335");
  print $agent->get('http://lumtest.com/myip.json')->content();
  ```

  ```vb VBA
  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:33335")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("http://lumtest.com/myip.json"))
      End Sub
  End Module
  ```
</CodeGroup>

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

```json Output
{
  "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://lumtest.com/myip.json”](https://lumtest.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

Learn how to use SOCKS and SOCKS5 protocol with Bright Data proxy networks

## 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 tip="Port 33335 replacing port 22225 deprecated on Sep 2026, click to read more">33335 </Tooltip>`](https://docs.brightdata.com/general/faqs#which-port-shall-i-use-22225-or-33335)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.

### Target Ports

#### 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](https://docs.brightdata.com/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:

    ```
    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
    // 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
    # 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](https://docs.brightdata.com/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](https://docs.brightdata.com/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`):

```
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

See general advice on how to overcome blocking and errors from websites

{/* tags: why am i getting blocked by website X? How to bypass blocking? */}

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

```
curl -v [rest of curl command options]
```

## General Tips

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

### Sessions

* If you're trying to mimic a real user, you should use the session ID username parameter:
  [Proxy and IP Rotation control](https://docs.brightdata.com/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 Unlocker API and Browser API, which manage all of this on your behalf.

## 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](https://docs.brightdata.com/scraping-automation/introduction), particularly the 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 the latest product updates and improvements. Scroll down to explore release notes from previous weeks.

<Note>
  Questions? Click here to [contact us >>>](https://brightdata.com/?hs_signup=160692)
</Note>

<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](https://docs.brightdata.com/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](https://docs.brightdata.com/scraping-automation/serp-api/parsed-json-results/bing-to-bright-data-serp-migration-guide)

  ***

  ## Release notes for week ending Jul 22, 2025

  ### 🆕 New features

  #### Web Scraper API – 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](https://docs.brightdata.com/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](https://docs.brightdata.com/api-reference/MCP-Server#self-hosted-mcp)

  #### Web Archive Prefix Customization

  Ability to set a custom prefix for the top-level export folder path. [Read more](https://docs.brightdata.com/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](https://docs.brightdata.com/datasets/functions/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.](https://docs.brightdata.com/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.](https://docs.brightdata.com/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.](https://docs.brightdata.com/datasets/scrapers/custom-scrapers/scrape-any-web)

  ### 🚀 New Integrations

  #### LangChain

  Power LLM agents with real-time, anonymous web data. [Read more.](https://docs.brightdata.com/integrations/langchain)

  #### Lindy.ai

  Enable AI “employees” to automate tasks using live web data. [Read more.](https://docs.brightdata.com/integrations/lindy-ai)

  #### LlamaIndex

  Ingest and index web data seamlessly into your knowledge base to enable powerful retrieval-augmented generation (RAG) workflows. [Read more.](https://docs.brightdata.com/integrations/llamaindex)

  #### Make

  Automate scraping, dataset retrieval, and API calls — no code required. [Read more.](https://docs.brightdata.com/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.](https://docs.brightdata.com/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 src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_1.png?maxW=1547&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=cb7d716582c4a43503302da6e32b3b7f" alt="mar20_1" width="1547" height="690" data-path="images/general/release-notes/mar20_1.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_1.png?w=280&maxW=1547&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=26fe0d109b80f1a451e8897d37db6b69 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_1.png?w=560&maxW=1547&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=fbeb8bf4315ddf96229503188dbf4dc2 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_1.png?w=840&maxW=1547&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=0a488598be957e6275df9e731a0facd6 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_1.png?w=1100&maxW=1547&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=1e155a3d2014a8ec5c54c7c22c688559 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_1.png?w=1650&maxW=1547&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=5b89be30b860c3d5ab4731dfdc68b036 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_1.png?w=2500&maxW=1547&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=d089fac56c4e37030f90f63d74f7343b 2500w" data-optimize="true" data-opv="2" />
  * **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](https://docs.brightdata.com/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 src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_2.png?maxW=931&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=439c4df911dbb478bbe7f67524adb9be" alt="mar20_2" width="931" height="808" data-path="images/general/release-notes/mar20_2.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_2.png?w=280&maxW=931&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f2de0af9a6f52710e001217642f950ca 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_2.png?w=560&maxW=931&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=e008904c249b483270b850e8c234aff8 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_2.png?w=840&maxW=931&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=58f6c3b0c27b224e8f772d0eac544304 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_2.png?w=1100&maxW=931&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f522a1997f5b63d6472edf2ad09ad130 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_2.png?w=1650&maxW=931&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=6dea37efa51f8c60856309fa448e9c99 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_2.png?w=2500&maxW=931&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=371f5a1bb57746269505cd2699e5659a 2500w" data-optimize="true" data-opv="2" />
  * **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 src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_3.png?maxW=926&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=2d4cec9d056c25c43fadb1707aa9bdc3" alt="mar20_3" width="926" height="211" data-path="images/general/release-notes/mar20_3.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_3.png?w=280&maxW=926&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=e5e3b4900c8908576890235e86bafa6c 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_3.png?w=560&maxW=926&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=064cec00150efbede81c8638e1bbdc66 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_3.png?w=840&maxW=926&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a6d2fc58bf16f7b9a955a034a1b83edb 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_3.png?w=1100&maxW=926&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=6188f3be083f03f96793541f36a8254c 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_3.png?w=1650&maxW=926&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=1cb698d79468c13ee587e8f429ddd448 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_3.png?w=2500&maxW=926&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=ac5917de3e21bb6a28f3c95b308e4246 2500w" data-optimize="true" data-opv="2" />
  * **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 src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_4.png?maxW=959&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=70fe8daadbaa4c354e5cf30cf74acace" alt="mar20_4" width="959" height="563" data-path="images/general/release-notes/mar20_4.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_4.png?w=280&maxW=959&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=876bb6bcf73b6bb37df8051fb98d8329 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_4.png?w=560&maxW=959&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=0bf09a8d43700a17bdb5aa6b6fb34036 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_4.png?w=840&maxW=959&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=97d99fb586f885832441d6846d717148 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_4.png?w=1100&maxW=959&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=894841314d614b86cb23e75d8f0c12a0 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_4.png?w=1650&maxW=959&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=cf7a8708de9a4b2a308df8c7b601bb60 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_4.png?w=2500&maxW=959&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=4b7ad58d705daaa4033da4b39b66aee4 2500w" data-optimize="true" data-opv="2" />

  #### 🐞 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](https://docs.brightdata.com/api-reference/web-scraper-api/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 src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_5.png?maxW=1337&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=d0f70ff8df8e4c344683e6d3a733e8e2" alt="mar20_5" width="1337" height="725" data-path="images/general/release-notes/mar20_5.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_5.png?w=280&maxW=1337&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=bda761fc0800d1fda591707725077c26 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_5.png?w=560&maxW=1337&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=ad081caefe0d987ffc79f231b52a2cf4 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_5.png?w=840&maxW=1337&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a315e6d92d78c3c4d65190f0c6d42d49 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_5.png?w=1100&maxW=1337&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=194b2fb761e275a4e36f66071fc41528 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_5.png?w=1650&maxW=1337&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=87f941e09743dd72cfdb1e3fab61f91b 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_5.png?w=2500&maxW=1337&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=273a2349d2e0bfada530fec9bc06e885 2500w" data-optimize="true" data-opv="2" />
  * **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 src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_6.png?maxW=809&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=6f4af822c16f0fa76b59557b835faa3d" alt="mar20_6" width="809" height="241" data-path="images/general/release-notes/mar20_6.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_6.png?w=280&maxW=809&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=3fd2254e721a464c7e1ba1dc8fe154b7 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_6.png?w=560&maxW=809&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a468f8b975717eccacbf07d6bd6b9741 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_6.png?w=840&maxW=809&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=74c32694050a7646e45bb3a90b1ad34a 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_6.png?w=1100&maxW=809&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=8cb6f3126586dcbd0e7a97f1095a4212 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_6.png?w=1650&maxW=809&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=866ad6a2f0686c63ce538f700e7ecf75 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar20_6.png?w=2500&maxW=809&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=046e02fdbcce3491ef4238d302ecb68e 2500w" data-optimize="true" data-opv="2" />

  #### 🐞 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](https://docs.brightdata.com/scraping-automation/data-snapshots-api#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 src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar13_img1.png?maxW=727&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=3bcbd5baba28e76f3f1eeeee0330efbc" alt="mar13_img1" width="727" height="791" data-path="images/general/release-notes/mar13_img1.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar13_img1.png?w=280&maxW=727&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=b0334a7326db522d5e581c7541699134 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar13_img1.png?w=560&maxW=727&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=3df1cd79ddea5ecd010208105e7faf2a 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar13_img1.png?w=840&maxW=727&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=eeebff39bf0411ac206bc5ab05c8ef2b 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar13_img1.png?w=1100&maxW=727&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=b0102985739d32afd0ca2f1c81b0c483 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar13_img1.png?w=1650&maxW=727&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=ceb6c1b87457b04421aee8d810a418b7 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/mar13_img1.png?w=2500&maxW=727&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c50a44c4e2f675f95752a1dd3e1ff807 2500w" data-optimize="true" data-opv="2" />
  * **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 src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image1.png?maxW=1497&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=2093122b7789ad5513b054e68f3a51f5" alt="" width="1497" height="789" data-path="7mar-image1.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image1.png?w=280&maxW=1497&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=bdb39742b9181cf4278b888953bccfab 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image1.png?w=560&maxW=1497&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=95367a3405b6336224f28c740dfa1e0a 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image1.png?w=840&maxW=1497&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=a631af16fb685725454a62d8fbbb9f13 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image1.png?w=1100&maxW=1497&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=ea681aa4aee83436c8cd9483a6b7ae5f 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image1.png?w=1650&maxW=1497&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=6552eb109554f86f8fd1e716b1a4dcb9 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image1.png?w=2500&maxW=1497&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=6d6fb8979cb8272da4c445ea8a2e402b 2500w" data-optimize="true" data-opv="2" />

    🚀 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 src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image2.png?maxW=806&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=94fcf4e2ed2f93ba8c2f08f419e1a9b2" alt="" width="806" height="371" data-path="7mar-image2.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image2.png?w=280&maxW=806&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=7a7e8085d63dd431b641a6fb0e76b1dd 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image2.png?w=560&maxW=806&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=207972e6fc0f58eb4d3c8b8fd6be0909 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image2.png?w=840&maxW=806&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=57dfada8d28f62e71325b54807b83bd6 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image2.png?w=1100&maxW=806&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=db87d1d7dd01ef1fbc0c4ee6c85b1463 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image2.png?w=1650&maxW=806&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=dc58956280ea9356d3d90d78739e7187 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image2.png?w=2500&maxW=806&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=22adadaba2ad9dd7ffd25894f560f967 2500w" data-optimize="true" data-opv="2" />
  * **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 src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image3.png?maxW=245&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=18dd0f0034232a055b8186199ceaeb04" alt="" width="245" height="132" data-path="7mar-image3.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image3.png?w=280&maxW=245&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=9b1b98b7fa35b7424aef51b466ddb576 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image3.png?w=560&maxW=245&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=6a767b8965001ce9eda15e29d005416d 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image3.png?w=840&maxW=245&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=d656962fcf1da1b25badcf79e074136b 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image3.png?w=1100&maxW=245&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=9ee97ba4385737cda52ee70de9fc7fff 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image3.png?w=1650&maxW=245&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=24e87676ed4edf869d9f5a5819d171d9 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image3.png?w=2500&maxW=245&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=a347b7a4df5769de391644bf37cbe280 2500w" data-optimize="true" data-opv="2" />
  * **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 src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image4.png?maxW=1488&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=cd6da40da2e34acbe5db57859e95cffc" alt="" width="1488" height="912" data-path="7mar-image4.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image4.png?w=280&maxW=1488&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=a9b22cf240c119af33ad668fe20f44f5 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image4.png?w=560&maxW=1488&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=1f2a9c6f5c4b2f8f61c5fc7bf4c4babc 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image4.png?w=840&maxW=1488&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=ca963d9c02b971efba8180518e12925e 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image4.png?w=1100&maxW=1488&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=ccf20cd1fcecdd92a1b45cb03af3d869 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image4.png?w=1650&maxW=1488&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=7250dca33f9c331aabcadf7a79d945ac 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image4.png?w=2500&maxW=1488&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=2ab1523e7c5c5c12bf4e15abc6ef49b5 2500w" data-optimize="true" data-opv="2" />
  * **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 src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image5.png?maxW=1846&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=18ed8aa25166099a51a6239109268a2e" alt="" width="1846" height="933" data-path="7mar-image5.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image5.png?w=280&maxW=1846&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=4eea8080a6653cb63e2e041e9947c002 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image5.png?w=560&maxW=1846&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=0b993faa3497f0a1891c6f9d6df159e8 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image5.png?w=840&maxW=1846&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=ce79a6d45daf4b2902c87d1ccc69800b 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image5.png?w=1100&maxW=1846&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=bc2b45b0de40e68bb0889b4020bcdf67 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image5.png?w=1650&maxW=1846&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=a8478e19dd78bee75bee0e342234c051 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image5.png?w=2500&maxW=1846&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=4af1388fae2979f2f0412d042e01f0ef 2500w" data-optimize="true" data-opv="2" />

  #### 🐞 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 src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image6.png?maxW=693&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=1430037149569fbfd43b9a89ee48821e" alt="" width="693" height="161" data-path="7mar-image6.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image6.png?w=280&maxW=693&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=317e2a2c65d6e8ec4c2a2b39fd0fbc1c 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image6.png?w=560&maxW=693&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=23a9d17066dfd2c017739a80a0f5e8e2 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image6.png?w=840&maxW=693&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=4efea3533eae908fc42889c9d16d41bd 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image6.png?w=1100&maxW=693&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=1e6ae9abd1a6edbbd740f64edbc2d8fd 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image6.png?w=1650&maxW=693&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=a782fdf9e74afb7c4c8f8d8806a97fba 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image6.png?w=2500&maxW=693&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=c1806359bbaddffcd5286faf571c6070 2500w" data-optimize="true" data-opv="2" />
  * **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 src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image7.png?maxW=1306&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=3e210cf121108ee06afa1745c1f5ae1e" alt="" width="1306" height="850" data-path="7mar-image7.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image7.png?w=280&maxW=1306&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=85e36a62fb1f98849c7572dd603a1a9c 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image7.png?w=560&maxW=1306&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=1baa7b1aa1ec782978c108bf73262dab 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image7.png?w=840&maxW=1306&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=9bd5263e90f86c3f213f70789cab15e5 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image7.png?w=1100&maxW=1306&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=4f34e58c522eea66c6048021bef1d598 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image7.png?w=1650&maxW=1306&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=d82f88eb93acf88d697e47bc0df6bdc6 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/7mar-image7.png?w=2500&maxW=1306&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=d0d79bbce90742aa2102f005621faf6a 2500w" data-optimize="true" data-opv="2" />

  * **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 src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image1.png?maxW=1461&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=0bdfdc6ddd56d01c06e868ae6e0c6735" alt="feb27_image1" width="1461" height="557" data-path="images/general/release-notes/feb27_image1.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image1.png?w=280&maxW=1461&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a694d3bbec95e049d5a920686afd1999 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image1.png?w=560&maxW=1461&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=995b03246cef428e7f5ef05e58143d6d 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image1.png?w=840&maxW=1461&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=874b97aa3ecaa41203e330c454d94a71 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image1.png?w=1100&maxW=1461&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=53d6503fbd9dc1f4ded647b94422e684 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image1.png?w=1650&maxW=1461&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=eedd571a4c4e40f38e2ab2c71aabb3d1 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image1.png?w=2500&maxW=1461&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=64b92d197d495fccd8b04e5341ee0985 2500w" data-optimize="true" data-opv="2" />

  ### **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 src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image2.png?maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a0cdc6d9e9e5b893c026eb4dd2ade3f9" alt="feb27_image2" width="1636" height="810" data-path="images/general/release-notes/feb27_image2.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image2.png?w=280&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=10c1e1eee69a2a198aa72614fd71ab43 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image2.png?w=560&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=fc13c3c022487c79bab8e013f5a1a1a2 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image2.png?w=840&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a3e34edec151c109fa67b41eb4fd6d4e 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image2.png?w=1100&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=88874254929b75c482d2e4bbc0b7b22e 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image2.png?w=1650&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=1f75a7fdfff73601e5a7ded9ed8e0de7 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image2.png?w=2500&maxW=1636&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=3cc65a33aad7687fe5ef6661e83ad3c7 2500w" data-optimize="true" data-opv="2" />

  #### 🚀 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\&id=hl_f65438a5)

    <img src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image3.png?maxW=1063&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a037cc37cf200f212b2bbc300f47a2d5" alt="feb27_image3" width="1063" height="441" data-path="images/general/release-notes/feb27_image3.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image3.png?w=280&maxW=1063&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=b71a0706ba4702188bf31c08c00cb709 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image3.png?w=560&maxW=1063&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=a10b6db263961c2f9b25f799b7ea2b96 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image3.png?w=840&maxW=1063&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=b25ec9089eda9500eae32488274a8024 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image3.png?w=1100&maxW=1063&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=f98d87b20042371950dcc6c2de63f879 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image3.png?w=1650&maxW=1063&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=6a18adff1845efb216fb3c83d0aa9be0 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image3.png?w=2500&maxW=1063&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=38b5bc54f467ce68f33ec9e015c4a6bd 2500w" data-optimize="true" data-opv="2" />
  * **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 src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image4.png?maxW=1240&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c76b26f9ed3d5fe1eb50ed7a482c546c" alt="feb27_image4" width="1240" height="575" data-path="images/general/release-notes/feb27_image4.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image4.png?w=280&maxW=1240&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=5ff7251ab06d0e82c79d0b73502dda6d 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image4.png?w=560&maxW=1240&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=df9993f9b06ccf416577e29c1e10c20f 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image4.png?w=840&maxW=1240&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=045d95cb0b60bb9f81ae98fae045e07b 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image4.png?w=1100&maxW=1240&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=3b70361f9520906c774d68f3d6f704f2 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image4.png?w=1650&maxW=1240&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=49ba2545db685260b79d498b5dbf9aca 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image4.png?w=2500&maxW=1240&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=5b55af60849e4b746e34b8062ae115bc 2500w" data-optimize="true" data-opv="2" />

  #### 🚀 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 src="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image5.png?maxW=1033&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=70f764bdaf0bc91db7f976e3688ec6ac" alt="feb27_image5" width="1033" height="431" data-path="images/general/release-notes/feb27_image5.png" srcset="https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image5.png?w=280&maxW=1033&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=18c21612ecd5db7ce008f5f7b4fd57b9 280w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image5.png?w=560&maxW=1033&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=419cc46bdf202698a9a2d4d20f21ee0b 560w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image5.png?w=840&maxW=1033&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=264e0666a4509acccc276eaee55faa8e 840w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image5.png?w=1100&maxW=1033&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=139bc6a31069a1f8ce57c873a0a0dee3 1100w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image5.png?w=1650&maxW=1033&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=02a326c3535f49264e28506f9251856f 1650w, https://mintcdn.com/brightdata/klVtuyVQZ5GK3nLT/images/general/release-notes/feb27_image5.png?w=2500&maxW=1033&auto=format&n=klVtuyVQZ5GK3nLT&q=85&s=c02ff9c88a8e8ca22044a0d4c5428e3a 2500w" data-optimize="true" data-opv="2" />
  * **"Deliver to external storage" is now enabled by default –** To streamline workflows, external storage delivery is now automatically enabled on the web scraper API, 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.](https://docs.brightdata.com/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](https://docs.brightdata.com/integrations/introduction).
  * We added error codes to our error catalog. Find and resolve issues faster by yourself [Proxy errors catalog](https://docs.brightdata.com/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 our system does it for you.

    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_1.png?maxW=969&auto=format&n=JpbB64sgI_r6D502&q=85&s=8c72be9bb8d271b356e0d0409579ed32" alt="feb20_1" width="969" height="908" data-path="images/general/release-notes/feb20_1.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_1.png?w=280&maxW=969&auto=format&n=JpbB64sgI_r6D502&q=85&s=df7dd8ab3a5a5e262f280c289d841082 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_1.png?w=560&maxW=969&auto=format&n=JpbB64sgI_r6D502&q=85&s=a1f5343f8abfc809cb43df7827381ac9 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_1.png?w=840&maxW=969&auto=format&n=JpbB64sgI_r6D502&q=85&s=f43e906d93d8a59230d2626dd3bbd120 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_1.png?w=1100&maxW=969&auto=format&n=JpbB64sgI_r6D502&q=85&s=c1d519eca23600478d6c18164be0b520 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_1.png?w=1650&maxW=969&auto=format&n=JpbB64sgI_r6D502&q=85&s=ab739f39695f24a264aef0e69cbd1834 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_1.png?w=2500&maxW=969&auto=format&n=JpbB64sgI_r6D502&q=85&s=9cecf0dfe5ca6d49f6e028646f01f135 2500w" data-optimize="true" data-opv="2" />

  #### 🚀 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\&id=all)

    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_2.png?maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=70156e4c09154fe9d7c87f008902bf0c" alt="feb20_2" width="1999" height="1074" data-path="images/general/release-notes/feb20_2.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_2.png?w=280&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=26b1a86b0e8dbe4aeceee98f899abcb0 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_2.png?w=560&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=7516ca35e8001c0531b8c5377f444fd9 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_2.png?w=840&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=3744238cb580d64d8ce62b1cfb7c0190 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_2.png?w=1100&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=e18ccd701a12498c4e728297c93997f9 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_2.png?w=1650&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=cd3769261930a8cda20692b8a2019e8e 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_2.png?w=2500&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=d20d5a2469b9cf25d876aaf8309e108b 2500w" data-optimize="true" data-opv="2" />

    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_3.png?maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=c57031c2487eac8579f54d7367d9a9bb" alt="feb20_3" width="1999" height="1066" data-path="images/general/release-notes/feb20_3.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_3.png?w=280&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=ad6b5bc4c172e5a05093c225b6dc68aa 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_3.png?w=560&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=49103e5560ce3b88289a937642218437 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_3.png?w=840&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=143b65c01ead061fa2abf092e6e25615 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_3.png?w=1100&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=229b33a378dceaed71d376ce991fa30f 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_3.png?w=1650&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=70bfa725755750a9e4da1036f3826b0a 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_3.png?w=2500&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=cb948374979f15e7f13384a6a21352bc 2500w" data-optimize="true" data-opv="2" />

    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_4.png?maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=bbef9cdfe9a7ee5e8844dea38e876bbb" alt="feb20_4" width="1999" height="1475" data-path="images/general/release-notes/feb20_4.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_4.png?w=280&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=5f8d907b79f617382d3675991c3765f7 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_4.png?w=560&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=3b0cdec6c35921a08e52ccd70d6c6df0 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_4.png?w=840&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=7d4148ed9fd0fb3c87d864578ceff499 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_4.png?w=1100&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=ce2bc3a2416642e72e3ddd63c0e7fc42 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_4.png?w=1650&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=57da054476c3a0a0110905fabc4c1eba 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_4.png?w=2500&maxW=1999&auto=format&n=JpbB64sgI_r6D502&q=85&s=6044a55b9612c8c859f455a2eb1bc23f 2500w" data-optimize="true" data-opv="2" />
  * **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\&id=all)

    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_5.png?maxW=856&auto=format&n=JpbB64sgI_r6D502&q=85&s=cf1702fa3f678c4c93d248bf27653905" alt="feb20_5" width="856" height="387" data-path="images/general/release-notes/feb20_5.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_5.png?w=280&maxW=856&auto=format&n=JpbB64sgI_r6D502&q=85&s=d3fc28ec2a612eb6ed44a9fe502926a2 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_5.png?w=560&maxW=856&auto=format&n=JpbB64sgI_r6D502&q=85&s=407c4a73b8eb838f7ae122097f53c447 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_5.png?w=840&maxW=856&auto=format&n=JpbB64sgI_r6D502&q=85&s=72b8ada0df54d24cb0395ba98bc41248 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_5.png?w=1100&maxW=856&auto=format&n=JpbB64sgI_r6D502&q=85&s=caabb87b3f6fc5a05c742e2ab9419e78 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_5.png?w=1650&maxW=856&auto=format&n=JpbB64sgI_r6D502&q=85&s=3f171455dcc16617bf65d82706729f23 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_5.png?w=2500&maxW=856&auto=format&n=JpbB64sgI_r6D502&q=85&s=20430a7926ff3b0cdc45797c4e7047c9 2500w" data-optimize="true" data-opv="2" />
  * **"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 src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_6.png?maxW=1293&auto=format&n=JpbB64sgI_r6D502&q=85&s=c563343ee840f28acfbeec43565c479c" alt="feb20_6" width="1293" height="380" data-path="images/general/release-notes/feb20_6.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_6.png?w=280&maxW=1293&auto=format&n=JpbB64sgI_r6D502&q=85&s=eb630ed342a50443d3f3d28652311f7e 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_6.png?w=560&maxW=1293&auto=format&n=JpbB64sgI_r6D502&q=85&s=580abeec7e52c544b201c26e1fad4945 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_6.png?w=840&maxW=1293&auto=format&n=JpbB64sgI_r6D502&q=85&s=a6e18147454a77bd0f8489b2dc86a2e6 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_6.png?w=1100&maxW=1293&auto=format&n=JpbB64sgI_r6D502&q=85&s=31b64e192a9debcfa012921a5679f7e1 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_6.png?w=1650&maxW=1293&auto=format&n=JpbB64sgI_r6D502&q=85&s=9be2e87e202e9a0548af36ad7c322ad1 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb20_6.png?w=2500&maxW=1293&auto=format&n=JpbB64sgI_r6D502&q=85&s=22762545ed2d28a8cd2f18d8d890c8f3 2500w" data-optimize="true" data-opv="2" />

  #### 🚀 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 src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img1.png?maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=4c41f757706769bd079c90a5284aaae1" alt="feb13_img1" width="1600" height="859" data-path="images/general/release-notes/feb13_img1.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img1.png?w=280&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=be1895f9cc0bb4b4865e4bc0856c2c80 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img1.png?w=560&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=997b7ff37f1cd895c9bab15a10578fe9 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img1.png?w=840&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=b382bee03c45f8e3a68a2f3182c3ed43 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img1.png?w=1100&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=203a43a7bbffae0321ccbd9b42a04464 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img1.png?w=1650&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=f7d2c260b6e0c3a2ac0a0c9d917b3689 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img1.png?w=2500&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=b82a88f7568adbf891aa483d048a413a 2500w" data-optimize="true" data-opv="2" />

    <img src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img2.png?maxW=914&auto=format&n=JpbB64sgI_r6D502&q=85&s=3a1b74a8cab0f014189f6502e131e0aa" alt="feb13_img2" width="914" height="1056" data-path="images/general/release-notes/feb13_img2.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img2.png?w=280&maxW=914&auto=format&n=JpbB64sgI_r6D502&q=85&s=22cbf5e795d753c9a5a3017d07ab23cd 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img2.png?w=560&maxW=914&auto=format&n=JpbB64sgI_r6D502&q=85&s=0e3279c33bb058b0bb117320c1de7a56 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img2.png?w=840&maxW=914&auto=format&n=JpbB64sgI_r6D502&q=85&s=c443c14a2a12221b20a3305ed793748b 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img2.png?w=1100&maxW=914&auto=format&n=JpbB64sgI_r6D502&q=85&s=38dd52fbfd58a509e2a8e7cdccb1d2a1 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img2.png?w=1650&maxW=914&auto=format&n=JpbB64sgI_r6D502&q=85&s=bff8eea984f0fb5d8fe133fd2e70cf5c 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img2.png?w=2500&maxW=914&auto=format&n=JpbB64sgI_r6D502&q=85&s=99fff9bcdea6beb8949cdc50b349d3e2 2500w" data-optimize="true" data-opv="2" />

  * **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 src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img3.png?maxW=1474&auto=format&n=JpbB64sgI_r6D502&q=85&s=b644a92e3966c57fa05926177d5ac2b9" alt="feb13_img3" width="1474" height="974" data-path="images/general/release-notes/feb13_img3.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img3.png?w=280&maxW=1474&auto=format&n=JpbB64sgI_r6D502&q=85&s=f23cfe716261c5a5ba4105df1a610c2c 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img3.png?w=560&maxW=1474&auto=format&n=JpbB64sgI_r6D502&q=85&s=3b57f88c8c20064ab4fe45d7fb33689c 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img3.png?w=840&maxW=1474&auto=format&n=JpbB64sgI_r6D502&q=85&s=5ef6bcf28405f2df48194572109a2bea 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img3.png?w=1100&maxW=1474&auto=format&n=JpbB64sgI_r6D502&q=85&s=2f5c3947e5e0fbfada32e8e041906a88 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img3.png?w=1650&maxW=1474&auto=format&n=JpbB64sgI_r6D502&q=85&s=a16c692babe9dd1cbf21f4e287832851 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img3.png?w=2500&maxW=1474&auto=format&n=JpbB64sgI_r6D502&q=85&s=a65413f953707339f03bade4efc20682 2500w" data-optimize="true" data-opv="2" />

  * **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 src="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img4.png?maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=0c2de9864f48053bc3ee3ddd814925be" alt="feb13_img4" width="1600" height="859" data-path="images/general/release-notes/feb13_img4.png" srcset="https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img4.png?w=280&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=077a6651fe235ccc51e4fbd6aed1d642 280w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img4.png?w=560&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=56ec7e6de386953cba79053ca5805a5f 560w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img4.png?w=840&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=b9f9c3de4e4e0342b9c58b8d60c81442 840w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img4.png?w=1100&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=2a426a80c35778a77f17571921c2dae0 1100w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img4.png?w=1650&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=b06f95f75f3b1a9c921a9f93813da746 1650w, https://mintcdn.com/brightdata/JpbB64sgI_r6D502/images/general/release-notes/feb13_img4.png?w=2500&maxW=1600&auto=format&n=JpbB64sgI_r6D502&q=85&s=34fea29de603a22d35547a77775604f2 2500w" data-optimize="true" data-opv="2" />

  #### 🚀 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
  * **Bright AI:** 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





# Scrapers
Source: https://docs.brightdata.com/scrapers-quickstart





# Bright Data's Asset Shield
Source: https://docs.brightdata.com/scraping-automation/bright-shield/asset-shield

Protect your domain with Bright Data's Asset Shield, monitoring traffic, setting rules, and receiving alerts to secure your online assets.

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>

### Data Monitor

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 src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/requests-count.png?maxW=503&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=4a2d58918abb3b48bd8fbedd519e223c" alt="Number of Requests" width="503" height="377" data-path="images/scraping-automation/bright-shield/asset-shield/requests-count.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/requests-count.png?w=280&maxW=503&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e47b60df92a2a756c9140c8f0135aaf2 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/requests-count.png?w=560&maxW=503&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=34c72f008c740eb68028944d9af39bf0 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/requests-count.png?w=840&maxW=503&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b5f6c23007d95a2925d1d97d53b05a88 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/requests-count.png?w=1100&maxW=503&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=24e00a3d45a07c74302dcb34d63c0f94 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/requests-count.png?w=1650&maxW=503&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c0178a4ad0ff50c304fd91abc853fd7f 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/requests-count.png?w=2500&maxW=503&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=89aa86685961c4c828422c2cf71f2dd1 2500w" data-optimize="true" data-opv="2" />

    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/filters.png?maxW=397&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a246a75cde3a5fc28929c954198e0896" alt="Filters" width="397" height="374" data-path="images/scraping-automation/bright-shield/asset-shield/filters.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/filters.png?w=280&maxW=397&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f8eebc0dfa221f97e13ec6e18365f459 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/filters.png?w=560&maxW=397&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=99c099339a99e1558ab7ca3521c10235 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/filters.png?w=840&maxW=397&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a85ae2f95d582575374a23a2097a4919 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/filters.png?w=1100&maxW=397&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=fb6dd6a5788155386eeace2987e5aeaf 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/filters.png?w=1650&maxW=397&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=11edd182f61fe36833c3d65ce190f3bc 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/filters.png?w=2500&maxW=397&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=008fbf3569b2667a8ee39e94bb7f3f96 2500w" data-optimize="true" data-opv="2" />
  </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 src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/add-rules.gif?maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=ab6a00cb3f83008a6b6c118c3ad4b575" alt="Adding and using rules" width="1388" height="834" data-path="images/scraping-automation/bright-shield/asset-shield/add-rules.gif" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/add-rules.gif?w=280&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=23078ca66e71e9e6f6a20370353d47ff 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/add-rules.gif?w=560&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=ca3a7684e9ef2289fa468ea41c85ad15 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/add-rules.gif?w=840&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=306e59b64acc8e07ad78ff318e6d78c4 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/add-rules.gif?w=1100&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=4b245ace9dee404ee1005e5a8f8f701a 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/add-rules.gif?w=1650&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=6f5be3b8198c21543cb4f00cc5d38cf0 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/asset-shield/add-rules.gif?w=2500&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=285df1b88710b281e81e7b8f634f1658 2500w" data-optimize="true" data-opv="2" />
</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 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, classify domains, set rules, block requests, and receive alerts to enhance your data security.

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

### Domain Classification

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 src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/traffic-chat.png?maxW=473&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=5c5cf9c78a5a46bcb8d75eecc453bf51" alt="Traffic Chart" width="473" height="381" data-path="images/scraping-automation/bright-shield/scraping-shield/traffic-chat.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/traffic-chat.png?w=280&maxW=473&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a31840d8dcd11247ab082d707b9b0d51 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/traffic-chat.png?w=560&maxW=473&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=438f132b4180a0a7f542709f43ee2fed 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/traffic-chat.png?w=840&maxW=473&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f166507095d81530671b38b7ff5713bc 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/traffic-chat.png?w=1100&maxW=473&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=14bde05333de69ec9cc60db739ab9b5b 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/traffic-chat.png?w=1650&maxW=473&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8ab0ebe0b571cd478b398a79047ea6e0 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/traffic-chat.png?w=2500&maxW=473&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9b85788156e9ea7e79573fd6c106a0c3 2500w" data-optimize="true" data-opv="2" />
  </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 src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/classification-table.png?maxW=1280&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f5b777d21b2d7d61e1ddb495de9af549" alt="Classification Table" width="1280" height="281" data-path="images/scraping-automation/bright-shield/scraping-shield/classification-table.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/classification-table.png?w=280&maxW=1280&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b53e60914b35c923dfc559256a420e53 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/classification-table.png?w=560&maxW=1280&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a09f24a8d6af14dc7be47e557b56ff0f 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/classification-table.png?w=840&maxW=1280&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=485dec25c3017b50119d536a594d571e 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/classification-table.png?w=1100&maxW=1280&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8c23f7d90875e54fa413bad60e252da3 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/classification-table.png?w=1650&maxW=1280&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8975158543d75d94c7d04f864c071bbe 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/classification-table.png?w=2500&maxW=1280&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a5c535d95957a7792bc7fac42e42cbfe 2500w" data-optimize="true" data-opv="2" />
  </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 src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-scratch.gif?maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=12477c6cf3f6f24d20a9a3ee7af6e7ce" alt="Create rule from Scratch" width="1388" height="738" data-path="images/scraping-automation/bright-shield/scraping-shield/create-rule-from-scratch.gif" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-scratch.gif?w=280&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8f8ea8bd6660cc92af183a38f443c91a 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-scratch.gif?w=560&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3f841a488e9997b35a72563ed5349768 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-scratch.gif?w=840&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=1e7b2dee23c45cca82513e5a4fab002d 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-scratch.gif?w=1100&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=54e8a5af950b885479b00f71aeac50c6 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-scratch.gif?w=1650&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=91e8a82306c37c9e282122c9b8521699 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-scratch.gif?w=2500&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e2c2d3a2797c6f0d62ff6c9d086f8d1d 2500w" data-optimize="true" data-opv="2" />
    </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 src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-table.gif?maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=2558c0e5a85def314a79982a6693b361" alt="Create rule from stats table" width="1388" height="768" data-path="images/scraping-automation/bright-shield/scraping-shield/create-rule-from-table.gif" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-table.gif?w=280&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c6965fc05f538981f19a64826c219556 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-table.gif?w=560&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=d47b1cac9543d81cf41fca7568e6b92e 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-table.gif?w=840&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=533d5d14be74b3e2522a1b106ecfd6f2 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-table.gif?w=1100&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3bcae178513f6445c7c90e7df9633932 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-table.gif?w=1650&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=34378b1b31eb681f9a48568b31165468 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/bright-shield/scraping-shield/create-rule-from-table.gif?w=2500&maxW=1388&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=fdc37d7e6cf30312f4bf1ac285e26bdc 2500w" data-optimize="true" data-opv="2" />
    </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>


# null
Source: https://docs.brightdata.com/scraping-automation/browser-extension/configuration



{/*tags:bext*/}

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 src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/configuration/change-extension-settings.gif?maxW=912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=5f944a977d42ac1a285976f5de666af4" alt="" width="912" height="872" data-path="images/scraping-automation/browser-extension/configuration/change-extension-settings.gif" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/configuration/change-extension-settings.gif?w=280&maxW=912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=83db4e80ec996f448e529b6fa9e1021b 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/configuration/change-extension-settings.gif?w=560&maxW=912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=fe9b73910437beca8328a9e07e1dc3d7 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/configuration/change-extension-settings.gif?w=840&maxW=912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=17f7776c038a2fa5aca749292a6776cb 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/configuration/change-extension-settings.gif?w=1100&maxW=912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=72d3d5401e824439918ef8fe2a9a9fb8 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/configuration/change-extension-settings.gif?w=1650&maxW=912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a4e61ffd2f2f15becba4db207fd4a04d 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/configuration/change-extension-settings.gif?w=2500&maxW=912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e856fd6834d6c2fe0250bd4cb0e343c8 2500w" data-optimize="true" data-opv="2" />


# FAQs
Source: https://docs.brightdata.com/scraping-automation/browser-extension/faqs



{/*tags:bext*/}

<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">
    Browser extension does not yet support the new SSL certificate (which works with port `33335`).
    Support for new certificate will be introduced soon and then you can work with the new certificate.
  </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 our service with no interruptions and keep your browser extensions alive.

        <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/delete-cookies.png?maxW=384&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c2e8dbf05de221cd9743a120778d4b1c" alt="delete-cookies.png" width="384" height="529" data-path="images/scraping-automation/browser-extension/faqs/delete-cookies.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/delete-cookies.png?w=280&maxW=384&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3c489c342bdda3e98344fce717f2ff67 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/delete-cookies.png?w=560&maxW=384&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c72a689508a1bb34a6d17de3c5430a18 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/delete-cookies.png?w=840&maxW=384&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9d232322ae4413d4c022f640602009b5 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/delete-cookies.png?w=1100&maxW=384&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c605bdaa8db16eb6241044a66d0804f9 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/delete-cookies.png?w=1650&maxW=384&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=49f90eddbf9a0a42b1e1b8da0a683f8e 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/delete-cookies.png?w=2500&maxW=384&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=bb11a07a2687da4e884d5ecf91e3da33 2500w" data-optimize="true" data-opv="2" />
  </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 src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/allow-in-incognito.gif?maxW=1536&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c9ef055f21e29333f0b89f6cf9a4747f" alt="allow-in-incognito.gif" width="1536" height="990" data-path="images/scraping-automation/browser-extension/faqs/allow-in-incognito.gif" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/allow-in-incognito.gif?w=280&maxW=1536&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=4a5ad28c8f7cb75f2913e0aea86f8bc1 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/allow-in-incognito.gif?w=560&maxW=1536&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8f1f01391a4f52ee913f4b354a9f7810 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/allow-in-incognito.gif?w=840&maxW=1536&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=ed5a9099d2fb0b08dd206c52095d8ed5 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/allow-in-incognito.gif?w=1100&maxW=1536&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=6a071bfec063336aae32e5a5692f7d8e 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/allow-in-incognito.gif?w=1650&maxW=1536&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=6a3cd500adb7fff1ee45da72ecdca484 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/allow-in-incognito.gif?w=2500&maxW=1536&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=fd110a9d9e9e782b577a47f0f5add143 2500w" data-optimize="true" data-opv="2" />
  </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:

    ```
    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
    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 src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/user-credentials.png?maxW=591&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3eeab823ea3fa182ee54bf7aeeccb91a" alt="user-credentials.png" width="591" height="58" data-path="images/scraping-automation/browser-extension/faqs/user-credentials.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/user-credentials.png?w=280&maxW=591&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=eec9dba34f14a8099ac60cef603dc921 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/user-credentials.png?w=560&maxW=591&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b3e505d373e5f5ba6277723d182b6e65 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/user-credentials.png?w=840&maxW=591&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=51a4b6fca0c4ac70d1d47f1c6ffbdbf4 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/user-credentials.png?w=1100&maxW=591&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b97c276beb4d3668804f4a208511939b 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/user-credentials.png?w=1650&maxW=591&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e7d88cda19ce54d78b3782c295b0ea5e 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/user-credentials.png?w=2500&maxW=591&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f8ad4ebddfc26e7c82b409c11f810771 2500w" data-optimize="true" data-opv="2" />

    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 src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/connect-through-proxy-manager.png?maxW=315&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f7ce887f695365f8c2e6a3f7eeb1b2fd" alt="connect-through-proxy-manager.png" width="315" height="437" data-path="images/scraping-automation/browser-extension/faqs/connect-through-proxy-manager.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/connect-through-proxy-manager.png?w=280&maxW=315&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e4f5357b67bddb701efc21b9e6dede79 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/connect-through-proxy-manager.png?w=560&maxW=315&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=fead9b92acc0b725f7aa4a819d460f8f 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/connect-through-proxy-manager.png?w=840&maxW=315&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=2d28b97a9e2b8f66b578f19e28accf4a 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/connect-through-proxy-manager.png?w=1100&maxW=315&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c8bfa5e0feeae9d2113ad080081046a7 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/connect-through-proxy-manager.png?w=1650&maxW=315&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=720756ef37d8323547803b1e61b8225c 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/connect-through-proxy-manager.png?w=2500&maxW=315&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=22e91bbc0edf60cfda59605efe574006 2500w" data-optimize="true" data-opv="2" />

    6. Enter the IP address of the Proxy Manager server along with the relevant port for example:
       <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/proxy-manager-ip.png?maxW=319&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=0d06064f21fa7cb11c9675a9e99d400b" alt="proxy-manager-ip.png" width="319" height="425" data-path="images/scraping-automation/browser-extension/faqs/proxy-manager-ip.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/proxy-manager-ip.png?w=280&maxW=319&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b2fda9bc02a84316986894993901a323 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/proxy-manager-ip.png?w=560&maxW=319&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=247c256364188cc1bf4a9969d4099f62 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/proxy-manager-ip.png?w=840&maxW=319&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=057a2eaa0b78f71b8ac07ed3f17d8ed9 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/proxy-manager-ip.png?w=1100&maxW=319&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=76fde0a7b4e43fa53df49804049ad3a9 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/proxy-manager-ip.png?w=1650&maxW=319&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=0e9d2d603eb561c1c07a46d3cfeaa878 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/proxy-manager-ip.png?w=2500&maxW=319&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=1ff2dac19b93be1f42cb2121c829d8d9 2500w" data-optimize="true" data-opv="2" />

    7. Select done. Then, click **"Sign in".**
       <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/sign-in.png?maxW=463&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a23274bdeefdb9bd195bdd7de2f2ed21" alt="sign-in.png" width="463" height="59" data-path="images/scraping-automation/browser-extension/faqs/sign-in.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/sign-in.png?w=280&maxW=463&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9056ccead745f1304e5fc01e9686bc20 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/sign-in.png?w=560&maxW=463&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b019e6c32aeb44d2041f4e08fcadfb96 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/sign-in.png?w=840&maxW=463&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=70e391e1965ba4c0a1b09d3e150455aa 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/sign-in.png?w=1100&maxW=463&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=159a4b8b828e3fa5a9a566e5f56c465e 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/sign-in.png?w=1650&maxW=463&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e4f411239d827bc79ea66ad028e008ee 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/faqs/sign-in.png?w=2500&maxW=463&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=4d86609e79ccad4d0efbe6c3b93a07d4 2500w" data-optimize="true" data-opv="2" />

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


# null
Source: https://docs.brightdata.com/scraping-automation/browser-extension/features



{/*tags:bext*/}

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/scraping-automation/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.

{/*tags:bext*/}

<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/scraping-automation/browser-extension/introduction

Learn about Bright Data's Browser Extension

{/*tags:bext*/}

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.&#x20;

<Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/introduction/introduction.gif?maxW=1912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c0774947202f78f32fd9877c84272450" alt="title" width="1912" height="986" data-path="images/scraping-automation/browser-extension/introduction/introduction.gif" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/introduction/introduction.gif?w=280&maxW=1912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=29bfe25fde142ee2de7637f192185448 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/introduction/introduction.gif?w=560&maxW=1912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=493094e32b0033bcd83607dfd66e5e70 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/introduction/introduction.gif?w=840&maxW=1912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=0e3585304be574be00b24a2b3a554410 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/introduction/introduction.gif?w=1100&maxW=1912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a6f4d40cdc723ae2968755930ff8c3b4 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/introduction/introduction.gif?w=1650&maxW=1912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=38ed06f8467c5c6fa6729c8a1dcad5e6 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/introduction/introduction.gif?w=2500&maxW=1912&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3dda4bfcdf4bdf5134b88002feba8cb7 2500w" data-optimize="true" data-opv="2" />
</Frame>


# null
Source: https://docs.brightdata.com/scraping-automation/browser-extension/quickstart



{/*tags:bext*/}

## How to start working with the browser extension:

1. For starting to work with our extension you will need to make sure you have at least 1 active zone in your bright data account in [My Proxy page](https://brightdata.com/cp/zones) or Add new Zone. For more Zone creation details visit our [Datacenter](/proxy-networks/data-center/introduction), [ISP](/proxy-networks/isp/introduction), [Residential](/proxy-networks/residential/introduction) and [Mobile](/proxy-networks/residential/introduction) guides.

<Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/active-proxy.png?maxW=1283&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8486b59d2860c4c281baca5538de7ab6" alt="" width="1283" height="237" data-path="images/scraping-automation/browser-extension/quickstart/active-proxy.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/active-proxy.png?w=280&maxW=1283&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=48fdc86467d665446cdfa98485120948 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/active-proxy.png?w=560&maxW=1283&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c123ddd61545faabd421fa833d5228d7 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/active-proxy.png?w=840&maxW=1283&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=28029ca39931e9a4019a38208294dfdc 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/active-proxy.png?w=1100&maxW=1283&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=40af0fd8eae6b5297d0a59c03a9475f7 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/active-proxy.png?w=1650&maxW=1283&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=0d951bcecb582bf9129b4877b2f01106 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/active-proxy.png?w=2500&maxW=1283&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b716a544c50f6ecdefd0cd9301e5028c 2500w" data-optimize="true" data-opv="2" />
</Frame>

1. Select the zone you like to work with in the extension:

<Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-the-zone.png?maxW=398&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=40b8f73697e7cb8272fffdbd79af17cd" alt="" width="398" height="538" data-path="images/scraping-automation/browser-extension/quickstart/select-the-zone.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-the-zone.png?w=280&maxW=398&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=92e57e36cb327cd8e98ee88b3433799f 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-the-zone.png?w=560&maxW=398&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=5afafeb0cb4ef72ced33fcfbfede77b7 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-the-zone.png?w=840&maxW=398&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=16b22564fdf99f235d09f158e1226031 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-the-zone.png?w=1100&maxW=398&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=341a7249590f8bd57b5effba04a8fa07 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-the-zone.png?w=1650&maxW=398&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=632fa7d0296da0be40f547c862439717 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-the-zone.png?w=2500&maxW=398&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=7fb630ff14f5a685c95e0ac107be75f8 2500w" data-optimize="true" data-opv="2" />
</Frame>

1. If you selected our \*\*Residential \*\*network zone, and you get this notification: "Certificate or approved KYC are must to use residential zone" you need to install our certificate on your chrome browser. Browse here: [https://docs.brightdata.com/general/account/ssl-certificate#installation-instructions](https://docs.brightdata.com/general/account/ssl-certificate#installation-instructions) and click "Chrome" to get instuctions to setup the certificate. To read more on our residential network access modes browser here: [https://docs.brightdata.com/proxy-networks/residential/network-access](https://docs.brightdata.com/proxy-networks/residential/network-access)

<img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/kyc-certificate.png?maxW=387&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=d6be58547e100e5a7d11119c720e785f" alt="kyc-certificate" width="387" height="558" data-path="images/scraping-automation/browser-extension/quickstart/kyc-certificate.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/kyc-certificate.png?w=280&maxW=387&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b0d655061603aa8f8031fb54d8292ab9 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/kyc-certificate.png?w=560&maxW=387&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b0243b807f889de7567a72648b5488ed 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/kyc-certificate.png?w=840&maxW=387&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=63e8897661cd39f0314e40197cb2537d 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/kyc-certificate.png?w=1100&maxW=387&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=dd4d5854ef70c4c85426b61ae0e9f516 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/kyc-certificate.png?w=1650&maxW=387&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c3d641a1277b1731deb8d57e60100440 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/kyc-certificate.png?w=2500&maxW=387&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=da13319c3ece0d4629a71a13ac44ed5e 2500w" data-optimize="true" data-opv="2" />

1. Select or Change country and city geo-location. please note city can be selected with Residential and Mobile zones:

<Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-country.png?maxW=385&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3d48b88bca592a985d98e5a0b4eb4548" alt="" width="385" height="562" data-path="images/scraping-automation/browser-extension/quickstart/select-country.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-country.png?w=280&maxW=385&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9c1a423814944c4507ff96aa08a9d593 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-country.png?w=560&maxW=385&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=034022a012b4ab2300cba73e62f2ec5f 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-country.png?w=840&maxW=385&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=bd5a4a5a45af63fa1f0ea5f3ed32005b 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-country.png?w=1100&maxW=385&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=542dee63b0b4814666bcc4e7f0280cd7 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-country.png?w=1650&maxW=385&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=2eec46ed0b624220ba4377be70d10a7f 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/select-country.png?w=2500&maxW=385&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=73ad73d738d0fda2d786fb3c8b113c5f 2500w" data-optimize="true" data-opv="2" />
</Frame>

1. Turn on the Proxy and start using it:

<Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/turn-on-the-proxy.png?maxW=383&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8e0e754c3c1ebca5fc1554876f091992" alt="" width="383" height="523" data-path="images/scraping-automation/browser-extension/quickstart/turn-on-the-proxy.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/turn-on-the-proxy.png?w=280&maxW=383&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=579e859d8221e88f29c1c5f61becb0d6 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/turn-on-the-proxy.png?w=560&maxW=383&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=dbd9871b4f8e05b99ab27ad1eeaa611a 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/turn-on-the-proxy.png?w=840&maxW=383&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=1a16083d92a3d35b05e22081205e4267 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/turn-on-the-proxy.png?w=1100&maxW=383&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=7d3fe987968cfb0213c19ca6e97d5399 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/turn-on-the-proxy.png?w=1650&maxW=383&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=ad847ad62f1508f09f4a0fb299b55307 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/turn-on-the-proxy.png?w=2500&maxW=383&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=fc121dd21bb32c47108af51775003c74 2500w" data-optimize="true" data-opv="2" />
</Frame>

## How to enable city selection:

1. Go to [Control panel My proxy page](https://brightdata.com/cp/zones)
2. Click on the zone you would like to enable it (Residential/Mobile):

<Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/enable-proxy.png?maxW=1409&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=02656492822f27217093157a10c4d4ab" alt="" width="1409" height="280" data-path="images/scraping-automation/browser-extension/quickstart/enable-proxy.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/enable-proxy.png?w=280&maxW=1409&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=51e461a01a267b908ab218babafd370c 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/enable-proxy.png?w=560&maxW=1409&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=310850698d518707d2a353a0a1d5b834 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/enable-proxy.png?w=840&maxW=1409&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=2f2e2bbf0dc47aac11e3fa01741a6149 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/enable-proxy.png?w=1100&maxW=1409&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=bd7103f2fb85613f5cc64923dca37d7f 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/enable-proxy.png?w=1650&maxW=1409&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a09ac32228447a37da9434b1842e6287 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/enable-proxy.png?w=2500&maxW=1409&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=15cfc824f3e86183ed8f4b209996c792 2500w" data-optimize="true" data-opv="2" />
</Frame>

1. Go to Geolocation targeting and select City:

<Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/geolocation-targetting.png?maxW=573&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=ddbc932e8d1e69871b3c6ce75c3ae8f6" alt="" width="573" height="292" data-path="images/scraping-automation/browser-extension/quickstart/geolocation-targetting.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/geolocation-targetting.png?w=280&maxW=573&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c047a34a65c6e192eeea5420cb77f59b 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/geolocation-targetting.png?w=560&maxW=573&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a016ac077d4266c1f33f5c8aac17967c 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/geolocation-targetting.png?w=840&maxW=573&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3890265fb5d8b8b9e906a92fef5395a4 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/geolocation-targetting.png?w=1100&maxW=573&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=ff7ad9adbccca9a384c0f2d22a1bf7c2 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/geolocation-targetting.png?w=1650&maxW=573&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=56975f0077c44f25c328aec3efdce234 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/browser-extension/quickstart/geolocation-targetting.png?w=2500&maxW=573&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=43af489ee2dbb92ec346d2443e0b8c2d 2500w" data-optimize="true" data-opv="2" />
</Frame>

1. Save the zone


# Crawl API Overview
Source: https://docs.brightdata.com/scraping-automation/crawl-api/overview

Crawl API allows you to extract, map, and transform content from any domain into structured, LLM-compatible data. Whether you're building AI training datasets, performing SEO audits, or integrating content into your workflows, Crawl API delivers clean, ready-to-use data in formats like HTML, Markdown, and JSON.

## Key Features

* Crawl Any Domain. Extract Any Data.
* Discover and map full domain structures with a single API call
* 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
* SEO audits and site structure analysis
* 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



There are two ways to use Crawl API:

1. API-Based collection
2. No-Code collection (via Control Panel)

## API-Based collection

1. [Trigger a data collection](https://docs.brightdata.com/api-reference/web-scraper-api/trigger-a-collection) 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
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 path="dataset_id" type="query" required>
  Your dataset ID (e.g., `gd_m6gjtfmeh43we6cqc`)
</ParamField>

<ParamField path="include_errors" type="query" default="true">
  include error logs in results
</ParamField>

<ParamField path="custom_output_fields" type="query">
  `markdown`, `html`, `ld_json`, etc.  \\

  Choose the format that best fits your workflow:

  <CodeGroup>
    ```md markdown
    # 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

    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
    <!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
    {
      "@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>

## Delivery

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


# FAQs
Source: https://docs.brightdata.com/scraping-automation/easy-scraper/faqs



<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 Web Scraper API 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 src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/faqs/response-time-per-input.png?maxW=265&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f62c10ca7a25a57ec6c6b8ed92c1dc18" alt="response-time-per-input.png" width="265" height="103" data-path="images/scraping-automation/easy-scraper/faqs/response-time-per-input.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/faqs/response-time-per-input.png?w=280&maxW=265&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=708c209bcbcbd93dba878f9d5718812b 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/faqs/response-time-per-input.png?w=560&maxW=265&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e72a3782a080a7d5e0c87c5df2614d46 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/faqs/response-time-per-input.png?w=840&maxW=265&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9edacc2e29fac5ec3c14d4139f564fdc 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/faqs/response-time-per-input.png?w=1100&maxW=265&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=1e35cc340d8378a0947e784a20056e12 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/faqs/response-time-per-input.png?w=1650&maxW=265&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=fbddd464cf8b8626a75dd1eb2a30c5bd 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/faqs/response-time-per-input.png?w=2500&maxW=265&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=54040ef80e36009cb13ac726671adf55 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>

  <Accordion title="How can i use your tools to access the same info in a user-friendly manner?" defaultOpen={false}>
    For every API scraper, we also offer a no-code simple scraper, which you can leverage to retrieve the same data&#x20;
  </Accordion>
</AccordionGroup>


# Product Overview
Source: https://docs.brightdata.com/scraping-automation/easy-scraper/overview



Easy Scraper is a plug-and-play solution that allows users to effortlessly collect data from various domains using ready-made scrapers.

This product simplifies the data collection process by offering an intuitive control panel where users can select a scraper, input parameters, set collection preferences, and retrieve data in multiple formats.

<Frame>
    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/overview/initiate-data-collection.png?maxW=2144&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=40f6521a27dd2f0c437c2a68a1a77f86" alt="initiate-data-collection.png" width="2144" height="1158" data-path="images/scraping-automation/easy-scraper/overview/initiate-data-collection.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/overview/initiate-data-collection.png?w=280&maxW=2144&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=24cba02f03503fe8387ba39035e1657b 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/overview/initiate-data-collection.png?w=560&maxW=2144&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=041b9cbb8e1007aadf409ea6d2f59a67 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/overview/initiate-data-collection.png?w=840&maxW=2144&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=32e0ffcdcf211d455a80d03e860c8739 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/overview/initiate-data-collection.png?w=1100&maxW=2144&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=4da5a22bfdeac5bcc583ea25134361f1 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/overview/initiate-data-collection.png?w=1650&maxW=2144&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=42128b20cdb37cc93a4f9097c1369255 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/overview/initiate-data-collection.png?w=2500&maxW=2144&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e9bba95e56c466fadf54f2a9b4f77495 2500w" data-optimize="true" data-opv="2" />
</Frame>

### Limitations &#xA;File size

Input - up to 1GB

Download - up to 5GB (for bigger files use API delivery)


# Getting Started with Easy Scraper
Source: https://docs.brightdata.com/scraping-automation/easy-scraper/quickstart



<Steps>
  <Step title="Access the Control Panel">
    * Navigate to the **Easy Scraper** section in your dashboard.
    * You will be presented with an array of scrapers to choose from (e.g., Amazon products, Airbnb, Instagram, LinkedIn, etc.).

    <Frame>
            <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/select-target.png?maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=25e44f9994c78d66d478f97bd86f599c" alt="select-target.png" width="624" height="372" data-path="images/scraping-automation/easy-scraper/quickstart/select-target.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/select-target.png?w=280&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=dbe960a1dff63dfbdc7258a0b4ba0e1d 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/select-target.png?w=560&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=7974db53a82ef0fa316e56a33146c796 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/select-target.png?w=840&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=15b1b4e5813c53021c7bee9e34b5e915 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/select-target.png?w=1100&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b1b30f38027de1503fabb4aed2462181 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/select-target.png?w=1650&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=2663a8188b858ded9e265ee1e38b193a 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/select-target.png?w=2500&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=1538b375a22057199a29d6bfb391cfd9 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Select a Scraper">
    * Choose the domain you wish to collect data from by clicking on the corresponding scraper.
  </Step>

  <Step title="Input Parameters">
    * Enter the required inputs (e.g., keywords, URLs, or other specific search parameters depending on the selected scraper).

    <Frame>
            <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/instagram-posts.png?maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=6bc1255153e7c1303b16df6f0e8ee7e5" alt="instagram-posts.png" width="624" height="383" data-path="images/scraping-automation/easy-scraper/quickstart/instagram-posts.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/instagram-posts.png?w=280&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=d176c9c3af6e83fdc3e94c20be5d8a88 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/instagram-posts.png?w=560&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b9c085ecfbeaead6e5605af9e61e3721 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/instagram-posts.png?w=840&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=5f29f5c089be396828ca1051ea199f3c 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/instagram-posts.png?w=1100&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c18ecf21bd49b326b7933136c686ad5e 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/instagram-posts.png?w=1650&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=b3f0c406e8113a6cf69c9b22b4f39e86 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/instagram-posts.png?w=2500&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9633919aec7a17941e33fa4cd027cfd2 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>

  <Step title="Set Result Limit">
    * Optionally, set a limit on the number of results you wish to collect. If no limit is set, the scraper will collect as much data as available.
  </Step>

  <Step title="Run and Monitor">
    * Start the data collection process by clicking the "Start Collecting" button.
    * You will be directed to the logs tab, where you can track the progress of your scraping jobs and view details like Snapshot ID, Dataset name, Timestamp, Status, Collection time, Number of records, File size, and any Errors.
  </Step>

  <Step title="Retrieve Data">
    * Once the data collection is complete, the data will be available to download in the desired format

    1. `JSON`
    2. `CSV`
    3. `NDJSON`
    4. `JSON lines`

    <Frame>
            <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/retrieve-data.png?maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=41d165c3b67eaaf2c5b6e097c72b4453" alt="retrieve-data.png" width="624" height="55" data-path="images/scraping-automation/easy-scraper/quickstart/retrieve-data.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/retrieve-data.png?w=280&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=39eaf639a6d155e8b71d33c37d737f53 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/retrieve-data.png?w=560&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=dd674694ad4217b62e6bcf803f01ed26 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/retrieve-data.png?w=840&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=7b6d28a891dd3a5740a0a3463a569d46 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/retrieve-data.png?w=1100&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=39aa0f10dacd84269ffeac492e86e932 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/retrieve-data.png?w=1650&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a9c2e9579ae0778c326bb0a5366a9276 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/easy-scraper/quickstart/retrieve-data.png?w=2500&maxW=624&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=0d41785c949b0160a9aaecddfd89359b 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Step>
</Steps>


# FAQ: Scraping automation products
Source: https://docs.brightdata.com/scraping-automation/faqs

Find answers to common questions about integrating, configuring, and using Bright Data's Scraping Automation, 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 [Unlocker API](https://docs.brightdata.com/scraping-automation/web-unlocker/introduction) or [Browser API](https://docs.brightdata.com/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.

    [Unlocker API](https://docs.brightdata.com/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](https://docs.brightdata.com/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 [Unlocker API](https://docs.brightdata.com/scraping-automation/web-unlocker/introduction) or [Browser API](https://docs.brightdata.com/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.

    [Unlocker API](https://docs.brightdata.com/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](https://docs.brightdata.com/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 Unlocker API resources due to their complexity in unblocking. See more details on [premium domains and pricing](https://docs.brightdata.com/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 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 Unlocker API?" defaultOpen={false}>
    If you require the Unlocker API to render a page using JavaScript, you should utilize the following feature: [Manual Expect Elements](https://docs.brightdata.com/scraping-automation/web-unlocker/features#manual-'expect'-elements)

    This will ensure that the response that is returned by the 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](https://docs.brightdata.com/scraping-automation/scraping-browser/introduction)
  </Accordion>

  <Accordion title="Where can I find my public IP when using Unlocker API, SERP API, or Browser API?">
    The public IPs used by these "Unlocker API" products are not visible to customers. 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://lumtest.com/myip.json`

    **Note:** The IP field will not be included in the response.
  </Accordion>

  <Accordion title="How do I scrape specific sites?" defaultOpen={false}>
    To scrape specific sites, follow these steps:

    1. **Select the Right Product for you:** Bright Data offers various tools like the **Web Scraper IDE**, **Web Scraper API**, and **Custom scrapers**. Choose the one that best suits your needs for scraping the target site.

    2. **Search for Target Site Templates:** If you're using the Web Scraper API, 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 **Custom Scrapers** 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>


# Web Access APIs
Source: https://docs.brightdata.com/scraping-automation/introduction

Bright Data’s Web access APIs give developers a powerful way to automate unblocking, crawling, dynamic content scraping, and search engine data collection—without managing heavy proxy infrastructure or complex anti-bot logic. These APIs abstract away challenges like IP rotation, session handling, fingerprinting, and CAPTCHA solving, so you can focus on extracting the data you need.

<div align="center">
  <h2 align="center"> Our products </h2>
</div>

<Card>
  <CardGroup>
    <Card title="Unlocker API" href="/scraping-automation/web-unlocker" icon="lock-open">
      For automated unblocking and continuous access to web content— including ip auto-rotation, fingerprinting, and CAPTCHA solving.
    </Card>

    <Card title="Search API" href="/scraping-automation/serp-api/" icon="magnifying-glass">
      For structured, real-time access to search engine results—including rankings, snippets, ads, and other SERP elements.
    </Card>

    <Card title="Browser API" href="/scraping-automation/scraping-browser/" icon="window-restore">
      For dynamic data extraction—Run browser automation scripts on remote browsers with built-in unblocking.
    </Card>

    <Card title="Crawl API" href="/scraping-automation/crawl-api" icon="sitemap">
      For fast, large-scale web crawling—Extract, map, and transform content from any domain into structured, LLM-ready data.
    </Card>
  </CardGroup>
</Card>

<Tip>
  [Browser Extension](https://docs.brightdata.com/scraping-automation/browser-extension): Manually control and Change your geo-location browsing.
</Tip>

<Note>
  [<u>Start now</u>](https://brightdata.com/?hs_signup=1\&utm_source=docs) with \$5 credits, no credit card required. We’ll match your first account deposit up to \$500 !
</Note>

<Info>
  For billing, settings and user access, visit the [account management](https://docs.brightdata.com/general/account/api-token) section.
</Info>

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


# Custom CDP Functions
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/cdp-functions/custom

In addition to the [standard CDP Functions](/scraping-automation/scraping-browser/cdp-functions/standard), Browser API also provides some powerful custom CDP Functions.

## Captcha Solver

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.
    Use this command to return the status after the captcha was solved, failed, or not detected.

    <CodeGroup>
      ```js Captcha.solve
      Captcha.solve({
          detectTimeout?: number // Detect timeout in millisecond for solver to detect captcha  
          options?: CaptchaOptions[] // Configuration options for captcha solving  
      }) : SolveResult
      ```

      ```js SolveResult
      SolveResult : {  
        status: SolveStatus // Detect and solve status  
        type?: string // Detected captcha type  
        error?: string // Error if captcha was not solved  
      }
      ```

      ```js SolveStatus
      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
      const page = await browser.newPage();
      const client = await page.target().createCDPSession();
      await page.goto('[https://site-with-captcha.com](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 client = await page.target().createCDPSession();  
      const {status} = await client.send('Captcha.solve', {detectTimeout: 30*1000});   
      console.log(`Captcha solve status: ${status}`)
      ```

      ```python Python - Playwright
      page = await browser.new_page()   
      client = await page.context.new_cdp_session(page)   
      await page.goto('[https://site-with-captcha.com](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  
      client = await page.context.new_cdp_session(page)  
      solve_result = await client.send('Captcha.solve', { 'detectTimeout': 30*1000 })   
      status = solve_result['status']   
      print(f'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
          // 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
          # 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
        # 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
      Captcha.setAutoSolve({  
        autoSolve: boolean // Whether to automatically solve captcha after navigate  
        options?: CaptchaOptions[] // Configuration options for captcha auto-solving  
      }) : void
      ```

      ```js CaptchaOptions
      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
      // 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
      # 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
      # 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
      // 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
      # 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
      // 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
      # 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
      # 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
        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
        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)
        { // 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>

## Emulation Functions

<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
    Emulation.getSupportedDevices().then(devices => { 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
      Emulation.setDevice({device: '[device_name]'});
      ```

      ```js Example
      Emulation.setDevice({device: 'iPhone X'});
      ```
    </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
    Emulation.setDevice({device: 'iPhone X landscape'});
    ```
  </Accordion>
</AccordionGroup>

## Ad Blocker

Enabling our `AdBlock` feature can help **reduce bandwidth** usage and **improve performance** on ad-heavy websites.

### 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
// Enable ad blocking before navigating
const client = await page.createCDPSession();

try {
    await client.send('Unblocker.enableAdBlock', {
        list: [null],
    });
} 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).

## Session Persistence

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.

### 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
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>

## File Download

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.

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

### CDP Commands

* `Input.type` - Sends keystrokes or simulates typing the specified text into the currently focused element.

```js Example
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
    Browser.addCertificate(params: {
      cert: string // base64 encoded certificate file
      pass: string // password for the certificate
    }) : void
    ```
  </Accordion>

  <Accordion title="Code examples">
    * Replace placeholder 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
        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
        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

Explore essential CDP functions for Browser API, from setting cookies to country targeting. Learn to optimize web scraping with these common Puppeteer and 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
    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
    // node.js puppeteer   
    const page = await page.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
    // node.js puppeteer   
    const page = await page.newPage();  
    await page.goto('https://example.com');  
    await page.evaluate(()=>window.scrollBy(0, window.innerHeight));
    ```
  </Accordion>

  <Accordion title="Take Screenshot">
    <CodeGroup>
      ```js NodeJS - Puppeteer
      // More info at https://pptr.dev/api/puppeteer.page.screenshot  
      await page.screenshot({ path: 'screenshot.png', fullPage: true });
      ```

      ```python Python - Playwright
      # More info at <https://playwright.dev/python/docs/screenshots>  
      await page.screenshot(path='screenshot.png', full_page=True)
      ```

      ```cs C# - PuppeteerSharp
      await page.ScreenshotAsync("screenshot.png", new ()  
      {  
          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
    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
    // 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
    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
    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 detailed code examples for using Bright Data's Browser API with various technologies, including Playwright, Puppeteer, and Selenium.

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 cols={3}>
  <Card title="Nodejs Puppeteer Example" icon="code" iconType="regular" href="https://github.com/luminati-io/bright-data-scraping-browser-nodejs-puppeteer-project" cta="Try Browser API in less than 2 minutes" />

  <Card title="Node.js Playwright Example" icon="code" iconType="regular" href="https://github.com/luminati-io/bright-data-scraping-browser-nodejs-playwright-project" cta="Try Browser API in less than 2 minutes" />

  <Card title="Node.js Selenium Example" icon="code" iconType="regular" href="https://github.com/luminati-io/bright-data-scraping-browser-nodejs-selenium-project" cta="Try Browser API in less than 2 minutes" />
</CardGroup>

<Tabs>
  <Tab title="Basic">
    Simple scraping of targeted page

    ### Select your pefered tech-stack

    <Tabs>
      <Tab title="NodeJS">
        <CodeGroup>
          ```js Playwright
          #!/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
          #!/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
          #!/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
          #!/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
          #!/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
          #!/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
          #!/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
          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
          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
          #!/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
          #!/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
          #!/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
          #!/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
          #!/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
          #!/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
          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
          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.solve"},
                          {"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 pefered tech-stack

    <Tabs>
      <Tab title="NodeJS">
        <CodeGroup>
          ```js Playwright
          #!/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
          #!/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
          #!/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
          #!/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
          #!/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
          #!/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
          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
          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
       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
      # 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
     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
     // 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
 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 Cached Pages Efficiently**

One common inefficiency in scraping jobs is the repeated downloading of the same page during a single session.

Leveraging cached pages - a version of a previously scraped page - can significantly increase your scraping efficiency, as it can be used to avoid repeated network requests to the same domain. Not only does it save on bandwidth by avoiding redundant fetches, but it also ensures faster and more responsive interactions with the preloaded content.

#### **Code Example**

<Note>
  The selectors used in this example (.product-name, .product-price, .product-link, .apply-coupon-button) are generic placeholders. Please update these to match the actual HTML structure of the website you are scraping.
  Also, make sure to replace [**https://example.com**](https://example.com) with your target URL.
</Note>

```js Puppeteer
const puppeteer = require('puppeteer-core');
const AUTH = 'USER:PASS';
const SBR_WS_ENDPOINT = `wss://${AUTH}@brd.superproxy.io:9222`;

async function scrapeProductDetails(link) {
    console.log('Connecting to Scraping Browser...');
    const browser = await puppeteer.connect({
        browserWSEndpoint: SBR_WS_ENDPOINT,
    });
    try {
        console.log(`Connected! Navigating to: ${link}`);
        await page.goto(link, { timeout: 2 * 60 * 1000 });

        // Wait for and extract product name
        await page.waitForSelector('.product-name', { timeout: 30000 });
        const productName = await page.$eval('.product-name', el => el.textContent.trim());

        // Try to apply coupon if button exists
        const couponButton = await page.$('.apply-coupon-button');
        if (couponButton) {
            await couponButton.click();
        }

        // Extract price
        await page.waitForSelector('.product-price', { timeout: 30000 });
        const productPrice = await page.$eval('.product-price', el => el.textContent.trim());

        return { productName, productPrice, link };
    } catch (error) {
        console.error(`Error scraping ${link}:`, error.message);
        return null;
    } finally {
        await browser.close();
    }
}

async function main() {
    console.log('Connecting to Scraping Browser...');
    const browser = await puppeteer.connect({
        browserWSEndpoint: SBR_WS_ENDPOINT,
    });

    try {
        console.log('Connected! Navigating to listing page...');
        const page = await browser.newPage();
        await page.goto('https://example.com', {
            timeout: 2 * 60 * 1000
        });

        await page.waitForSelector('.product-link', { timeout: 30000 });

        // Extract product links from the listing page
        const productLinks = await page.$$eval('.product-link', links =>
            links.map(link => link.href).slice(0, 10) // Limit to first 10 for testing
        );

        console.log(`Found ${productLinks.length} products`);
        await browser.close();

        // Scrape product details in parallel
        const productDetailsPromises = productLinks.map(link => scrapeProductDetails(link));
        const productDetails = await Promise.all(productDetailsPromises);

        // Filter out any null results from failed scrapes
        const validProductDetails = productDetails.filter(details => details !== null);

        console.log('Scraped product details:', validProductDetails);
    } catch (error) {
        console.error('Error during the main process:', error);
    }
}

main();
```

***

### **Other Strategies**

* **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

Learn how to set up and configure Bright Data's Browser API with your credentials, run sample scripts, and navigate live browser sessions. Ensure efficient web scraping with our detailed instructions.

To get started, grab your credentials - the Username and Password you will use with your web automation tool. You can find them in the Browser API zone you just created, in the "Overview" tab. We assume that you aleady have your preferred web automation tool installed. If not, please instal it.

## 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**](https://docs.brightdata.com/scraping-automation/scraping-browser/cdp-functions/custom#captcha-solver)**,** see the [Code Examples](https://docs.brightdata.com/scraping-automation/scraping-browser/code-examples) section.
</Tip>

<Tabs>
  <Tab title="NodeJS">
    <CodeGroup>
      ```js Puppeteer
      #!/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
      #!/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
      #!/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
      #!/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
      #!/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
      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
      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
      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>

## Single Navigation Per Session

Browser API sessions are structured to allow one initial navigation per session. This initial navigation refers to the first instance of loading the target site from which data is to be extracted. Following this, users are free to navigate the site using clicks, scrolls, and other interactive actions within the same session. However, to start a new scraping job, either on the same site or a different one, from the initial navigation stage, 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 30 minutes. Once the maximum session time is reached the session will automatically timeout.


# Browser API FAQs
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/faqs

Find answers to common questions about Bright Data's Browser API, including supported languages, 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](https://docs.brightdata.com/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.](https://docs.brightdata.com/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](https://docs.brightdata.com/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](https://docs.brightdata.com/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
      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 src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3759089ff3e4caf5fb7215348326e7f4" alt="chrome-devtools-debugger.png" width="1111" height="626" data-path="images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=280&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a8aa92c87ecc992d1ad179b0ff2c7836 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=560&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=af7f099ba10a62471b87132b05137d16 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=840&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=12615e64adf87432e5bc0b703c682edd 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=1100&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=72e87aa83c54d5db8531d848cc7c1fc5 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=1650&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=1baa8d713834f6764840edbf4696bb54 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/chrome-devtools-debugger.png?w=2500&maxW=1111&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=55e0708a8f748a53bff2fd4aaeada736 2500w" data-optimize="true" data-opv="2" />

          **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
            // 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
            // 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
            # 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
            // 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
            // 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 src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=73be8cd05bfbc078b67cfd45646feb42" alt="test-sites.png" width="955" height="411" data-path="images/scraping-automation/scraping-browser/features/debugger/test-sites.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=280&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=97bf18869d563134b4a7516269bbec3c 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=560&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=dcc656cc62a699b7b5944571f1db6316 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=840&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e6862147f7242a688333ba04b66b0aef 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=1100&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=bc1141f5905fc019e8f27a8c9bf0d477 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=1650&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c373be4ec6b3cdae31f8f65256647662 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=2500&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3e999b6e99516a6c44496570bb63a66f 2500w" data-optimize="true" data-opv="2" />
  </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
    // 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
        // 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.](https://docs.brightdata.com/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
      // node.js puppeteer - Navigate to site with 2 min timeout  
      page.goto('<https://example.com>', { timeout: 2*60*1000 });  
      ```

      ```python Playwright
      # python playwright - Navigate to site with 2 min timeout   
      page.goto('<https://example.com>', timeout=2*60*1000)  
      ```

      ```cs PuppeteerSharp
      // 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 are the most Common Error codes?">
    |                                 |                                         |                                                                                                                                                  |
    | ------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
    | **Error Code**                  | **Meaning**                             | **What can you do about it?**                                                                                                                    |
    | Unexpected server response: 407 | An issue with the remote browser's port | Please check your remote browser's port.  The correct port for Browser API is port:9222                                                          |
    | Unexpected server response: 403 | Authentication Error                    | Check authentication credentials (username, password) and check that you are using the correct "Browser API" zone from 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
    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](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](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
    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.**](https://docs.brightdata.com/scraping-automation/scraping-browser/code-examples#optimizing-bandwidth-usage-with-browser-api)\
    For instructions and code on blocking ads using CDP custom functions, see our custom [**Ad Blocker**](https://docs.brightdata.com/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](https://docs.brightdata.com/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](https://docs.brightdata.com/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](https://docs.brightdata.com/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](https://docs.brightdata.com/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](https://docs.brightdata.com/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:33335`, 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
      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>
</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
* 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 src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/captcha-solver/automatic-captcha-solving.png?maxW=641&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=02ec5c6548ff70cb930730fecb9e998a" alt="automatic-captcha-solving.png" width="641" height="325" data-path="images/scraping-automation/scraping-browser/features/captcha-solver/automatic-captcha-solving.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/captcha-solver/automatic-captcha-solving.png?w=280&maxW=641&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=635d970fb10ddba6c5dae02bb645f9b4 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/captcha-solver/automatic-captcha-solving.png?w=560&maxW=641&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c93dca581c47b4921ffff358b96aaeb3 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/captcha-solver/automatic-captcha-solving.png?w=840&maxW=641&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e15209f2fd55bbc014d246b1849f2ac3 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/captcha-solver/automatic-captcha-solving.png?w=1100&maxW=641&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=ee0c2051b717f4782af050b308b9862f 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/captcha-solver/automatic-captcha-solving.png?w=1650&maxW=641&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=81ab5eff07e1dceb14c91aa24e1fc44f 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/captcha-solver/automatic-captcha-solving.png?w=2500&maxW=641&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=aac6650d8bd28d1d4b434dd219f74530 2500w" data-optimize="true" data-opv="2" />
  </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

Experiment with Browser API using the Playground. Run or edit scripts, view real-time logs, and browser interactions. Currently supports Puppeteer and JavaScript.

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.

### Playground Features

* 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 src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/playground/playground-features.png?maxW=1303&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9328f3467c31c8a9167ae1b5d39f1144" alt="playground-features.png" width="1303" height="636" data-path="images/scraping-automation/scraping-browser/features/playground/playground-features.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/playground/playground-features.png?w=280&maxW=1303&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=bdc44bf81a7957857baccf7f25dea3cb 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/playground/playground-features.png?w=560&maxW=1303&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e733e0391c71c1fc530528d39f751cc1 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/playground/playground-features.png?w=840&maxW=1303&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9304ab513b0bb15b1dc9ea0e80de9d4e 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/playground/playground-features.png?w=1100&maxW=1303&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=2c1eafd40ed6d2dcbda613ca15fae8e5 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/playground/playground-features.png?w=1650&maxW=1303&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=78cd8fffc2a92a2d3283e879f5d861ba 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/playground/playground-features.png?w=2500&maxW=1303&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=d81d161f5afc88e9047e6662b55fb6a6 2500w" data-optimize="true" data-opv="2" />
</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.

### Code Editing

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

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 Browser API resources.

### 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 id="premium_domains">Loading...</div>


# Geolocation targeting
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/features/proxy-location

Target specific peers in countries or geographical locations for precise geo-targeted data collection.

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

## 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
  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.`

## Geolocation radius

Use the `Proxy.setLocation` function to dynamically change the location of your proxies using an exact latitude, longitude, and radius.

### Parameters

<ParamField path="lat" type="float">
  Specifies the latitude of the desired proxy location.
</ParamField>

<ParamField path="lon" type="float">
  Specifies the longitude of the desired proxy location.
</ParamField>

<ParamField path="distance" type="float">
  Defines the maximum distance from the provided coordinates within which the proxy can be located.
  <Note>Unit: Kilometers.</Note>
</ParamField>

<ParamField path="strict" type="boolean" default="true">
  Defines the desired behavior in case no peers are available in the specified distance.

  `strict: true` - our system 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>

### Usage

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
  export AUTH=brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```sh CMD
  set AUTH=brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```powershell Powershell
  $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
  #!/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
  #!/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
  #!/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>


# Browser API Troubleshooting
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/features/troubleshooting

Get troubleshooting tips for Browser API. Learn how to use the debugger, analyze error codes, and optimize your 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 src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/devtool_buttonm_mk1_browser_api.png?maxW=1316&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=db604d3715e726c536cf519e43780116" alt="" width="1316" height="513" data-path="devtool_buttonm_mk1_browser_api.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/devtool_buttonm_mk1_browser_api.png?w=280&maxW=1316&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=8a5db47d07a7c354b2fa847ab155af61 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/devtool_buttonm_mk1_browser_api.png?w=560&maxW=1316&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=86d527c8eae999e127bd5de2cfa2cee8 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/devtool_buttonm_mk1_browser_api.png?w=840&maxW=1316&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=3a8a693fb22873a91e84a943c73a025f 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/devtool_buttonm_mk1_browser_api.png?w=1100&maxW=1316&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=a83905549af5928f22c2de09aa5cb0e1 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/devtool_buttonm_mk1_browser_api.png?w=1650&maxW=1316&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=747cd14ef1fa289953d6b3294328ea6e 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/devtool_buttonm_mk1_browser_api.png?w=2500&maxW=1316&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=5b59d8dd5971729e492b752a84305c19 2500w" data-optimize="true" data-opv="2" />

    ### 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 src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/all-set.png?maxW=825&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3f07792ce4f16cebbc50d191f68ee109" alt="" width="825" height="496" data-path="images/scraping-automation/scraping-browser/features/debugger/all-set.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/all-set.png?w=280&maxW=825&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=245430ae5d0e187b795c40201e245bcb 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/all-set.png?w=560&maxW=825&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=d0ef0bcc668a6a743b710a2e2c4b6e7e 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/all-set.png?w=840&maxW=825&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=35bd9b983c72e010dbc28c3abb97e765 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/all-set.png?w=1100&maxW=825&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=da5e834597c6e578a034a0e0788756e9 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/all-set.png?w=1650&maxW=825&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f4956d265211b71177fbc38fddecaaaf 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/all-set.png?w=2500&maxW=825&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=339992b603aada66916830386d37b67d 2500w" data-optimize="true" data-opv="2" />
        </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
      // 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
      # 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#
      // 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 src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=73be8cd05bfbc078b67cfd45646feb42" alt="test-sites.png" width="955" height="411" data-path="images/scraping-automation/scraping-browser/features/debugger/test-sites.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=280&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=97bf18869d563134b4a7516269bbec3c 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=560&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=dcc656cc62a699b7b5944571f1db6316 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=840&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e6862147f7242a688333ba04b66b0aef 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=1100&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=bc1141f5905fc019e8f27a8c9bf0d477 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=1650&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c373be4ec6b3cdae31f8f65256647662 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/scraping-browser/features/debugger/test-sites.png?w=2500&maxW=955&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3e999b6e99516a6c44496570bb63a66f 2500w" data-optimize="true" data-opv="2" />
</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
// 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');
```

### Debugger Walkthrough

Check out the Browser API Debugger in action below

<Frame>
  <iframe width="660" height="350" src="https://www.youtube.com/embed/68Kom7tS-QY" title="Debugger Walkthrough" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen />
</Frame>

## Error codes

Analyze some of the popular error codes you might be receiving below:

| Error Code | Meaning                                 | What can you do about it?                                                                                                                                          |
| ---------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `407`      | An issue with the remote browser's port | Please check your remote browser's port. The correct port for Browser API is either the default port:9222 OR if you are using Selenium specifically, use port:9515 |
| `403`      | Authentication Error                    | Check authentication credentials (username, password) and check that you are using the correct "Browser API" zone from Bright Data control panel                   |
| `503`      | Service Unavailable                     | We are likely scaling browsers right now to meet demand. Try to reconnect in 1 minute.                                                                             |

## 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


# Introduction to Browser API
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/introduction

Learn how Bright Data's Browser API simplifies multi-step data collection with robust proxy networks, browser automation, and full unblocking capabilities.

Browser API is part of our [unlocker scraping suite](/scraping-automation/introduction) and is designed to simplify your **multi-step data collection** from browsers.

Your scraping code runs seamlessly on our dedicated browsers, leveraging multiple proxy networks (including residential IPs) and managing the full unblocking of every page including custom headers, fingerprinting, CAPTCHA solving, and more.

Effortlessly access and navigate your target websites via standard browsing libraries like `puppeteer`, `playwright`, and `selenium` (see our [full list here](https://docs.brightdata.com/scraping-automation/scraping-browser/faqs#which-programming-languages-libraries-and-browser-automation-tools-are-supported-by-browser-api)), to extract the precise data you need at unlimited **scale** and unlimited **concurrent sessions.**

### Best for

* Seamlessly navigating websites, filling out forms, clicking buttons, scrolling to load full pages, hovering, solving CAPTCHAs, and more interactive actions
* `Puppeteer`, `playwright`, and `selenium` integration with the flexibility to scale the number of active browser sessions up or down as needed.
* Teams without a reliable, scalable in-house browser unblocking infrastructure


# How to Get Started with Browser API
Source: https://docs.brightdata.com/scraping-automation/scraping-browser/quickstart

Get started with Bright Data's Browser API in just a few steps. Follow this guide to set up your proxy and start scraping right away.

<Steps>
  <Step title={<a href="https://brightdata.com/?hs_signup=1">Sign in</a>}>
    <Tip>
      If you’re new, [sign up for free](https://brightdata.com/?hs_signup=1) to get started and receive a \$2 bonus. Add your payment information for an additional \$5 in bonus funds.
    </Tip>

    <Note>
      If you already have an account, [log in here](https://brightdata.com/cp/start).
    </Note>
  </Step>

  <Step title={<>Navigate to <a href="https://brightdata.com/cp/zones">My Zones</a></>}>
    <Accordion title="In My Zones page, under Browser API click Get started">
      <Warning>
        If you already have an active proxy, simply choose **Add** at the top right corner
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/BrowserAPi.png?maxW=885&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=11c20fe09ad8f8c05edf394d89f070e3" alt="Get Started" title="" className="mx-auto" style={{ width:"100%" }} width="885" height="671" data-path="BrowserAPi.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/BrowserAPi.png?w=280&maxW=885&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=5dd1efadb0747ffad20b88702e4d5601 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/BrowserAPi.png?w=560&maxW=885&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=a8558d6a06d89397066499fbd83a72d2 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/BrowserAPi.png?w=840&maxW=885&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=a7827f430bff03a6ffcbfe4d542029de 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/BrowserAPi.png?w=1100&maxW=885&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=5fdd9737084aca009c63a2eafbd91cfd 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/BrowserAPi.png?w=1650&maxW=885&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=48c447295bb67de747f03deb18dde1e3 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/BrowserAPi.png?w=2500&maxW=885&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=4ff24d4855a8cf303b8a12fd4d85c5fc 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="Assign a name to your Browser API">
    <Warning>
      Please select a meaningful name, as the zone's name cannot be changed once created.
    </Warning>
  </Step>

  <Step title="Click Add">
    <Accordion title="On the “Add new zone” page, click Add">
      <Frame>
        <img src="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/addbrowserapi.png?maxW=1176&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=0d7590ba31d8253fd8e6357f14e28b3c" alt="Get Started" title="" className="mx-auto" style={{ width:"100%" }} width="1176" height="591" data-path="addbrowserapi.png" srcset="https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/addbrowserapi.png?w=280&maxW=1176&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=3264d1b4280a1f507668d76b7e9ce321 280w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/addbrowserapi.png?w=560&maxW=1176&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=c7a526351259010538eefe2b0037bce5 560w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/addbrowserapi.png?w=840&maxW=1176&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=b698256675b557645e5d2af1c9c3e5a1 840w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/addbrowserapi.png?w=1100&maxW=1176&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=42fab3292350f94b8c0b3949b9a0813b 1100w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/addbrowserapi.png?w=1650&maxW=1176&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=dad0ab1925d226c9288be12d1a98d69b 1650w, https://mintcdn.com/brightdata/a-wmt8sZJyXzLgP2/addbrowserapi.png?w=2500&maxW=1176&auto=format&n=a-wmt8sZJyXzLgP2&q=85&s=b9cbd2e770dafa46e590e155c661b4ac 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="Start using your Browser API">
    <Note>
      Your Browser API zone is now ready! Open the zone dashboard to view your credentials and follow our [configuration examples](https://docs.brightdata.com/scraping-automation/scraping-browser/configuration) to start making browser requests.
    </Note>
  </Step>
</Steps>


# Asynchronous Requests
Source: https://docs.brightdata.com/scraping-automation/serp-api/asynchronous-requests

In this article, we'll explain the difference between sync and async requests, highlight the benefits of the async flow, and describe key parameters with examples.

<Note>
  Async is supported by both **Unlocker API** and **SERP API** products
</Note>

## Async VS Sync requests

There are 2 ways for us to handle your 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 102 status code.

<Note>
  We store responses for up to 48 hours from the time the request was sent.
</Note>

### Getting started

<Steps>
  <Step title="Enable &#x22;Asynchronous requests&#x22;">
    Within your specific Unlocker API or SERP API [zone](https://brightdata.com/cp/zones), under "Advanced settings", enable the "Asynchronous requests" toggle.
        <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/asynchronous-requests/async_request_CP.png?maxW=969&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=7395c81bb67a58bc6f1c695488671224" alt="" width="969" height="510" data-path="images/scraping-automation/serp-api/asynchronous-requests/async_request_CP.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/asynchronous-requests/async_request_CP.png?w=280&maxW=969&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c49e0bb39d6535e7f7c5e82ea8d25788 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/asynchronous-requests/async_request_CP.png?w=560&maxW=969&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=1638a5272637874dabe517661cd2a6f1 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/asynchronous-requests/async_request_CP.png?w=840&maxW=969&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a3a8210441a1889bb9c9963fc964d8b9 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/asynchronous-requests/async_request_CP.png?w=1100&maxW=969&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=fd636c3faa70e5419237ad0da8ed82e9 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/asynchronous-requests/async_request_CP.png?w=1650&maxW=969&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=cb5a68064425f4f18f27ebb066ff46e4 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/asynchronous-requests/async_request_CP.png?w=2500&maxW=969&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8cd4aea79067fd9ae59a8777802d97cc 2500w" data-optimize="true" data-opv="2" />
  </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](https://docs.brightdata.com/general/account/api-token) for authentication. See a basic example below (for more request parameters see below):

    ```sh
    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
      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">
    Using the `RESPONSE_ID` received in step 3, send the following:

    ```sh
    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
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                                                                                                                  |

### SERP-specific parameters

| Parameter  | Type        | Description                 |
| ---------- | ----------- | --------------------------- |
| query (\*) | Object      |                             |
| brd\_json  | 1 or "html" | Defines the response format |

```sh SERP Example
curl -i --silent --compressed "https://api.brightdata.com/serp/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
curl -k -v --compressed "https://api.brightdata.com/serp/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. |

## Multiple queries in a single request

<Note>
  SERP API only
</Note>

Async supports sending 2 parallel query requests within one API request using the `multi` parameter instead of `query`.

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.

**Conditions:**

1. Supported only for a zone with Async enabled (as shown above)
2. Supported only for Google Search
3. Limited to 2 requests
4. Billed as 2 requests

**parameter usage:**

<CodeGroup>
  ```js Same Keyword
  multi: [
    {"keyword":"pizza","num":20},
    {"keyword":"pizza","num":100}
  ]
  ```

  ```js Different Keyword
  multi: [
    {"keyword":"pizza"},
    {"keyword":"burger"}
  ]
  ```
</CodeGroup>

**request example:**

```sh Sample Request
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}]}"
```

###


# SERP API Configuration
Source: https://docs.brightdata.com/scraping-automation/serp-api/configuration

Configure the SERP API to maximize efficiency with async requests, access hotel and enhanced ad data, and understand key parameters with examples.

## Enhanced Ads (Google only)

<Card>
  <CardGroup>
    <Card title="Off (Default)">
      Fetches both organic search results and ads, encompassing a broad geographical scope.
    </Card>

    <Card title="On">
      Fetches a larger more diverse range of search results and ads, mimicking an incognito browsing scenario without cookies.
    </Card>
  </CardGroup>
</Card>

## Asynchronous Requests

Requests are handled seamlessly in the background, allowing for 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)

<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 API FAQs
Source: https://docs.brightdata.com/scraping-automation/serp-api/faqs

Discover how to effectively use Bright Data's SERP API with detailed FAQs on setup, troubleshooting, and advanced search techniques, including Google Image and hotel data scraping.

<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 72 million+ real user 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
      curl -v --compressed --proxy brd.superproxy.io:33335 --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
      curl -v --compressed --proxy brd.superproxy.io:33335 --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}'
      ```

      ```sh Adding a query to the image
      <insert-code-here>
      ```
    </CodeGroup>

    See the rest of our [Google Image SERP features.](/api-reference/serp/images)
  </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 src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=65a519d4d1df376be92072f37e960564" alt="hotels-html.png" width="1485" height="825" data-path="images/scraping-automation/serp-api/parsing-search-results/hotels-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=280&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ea51010d652f7efb5fc2e53f7f9c2b3d 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=560&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e53526df0ebde2a6e5585a80b88c8925 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=840&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=239d278dd1edd6249281f2c725600f54 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=1100&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=948e3112a099ec78602f0c4169bb55d6 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=1650&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9e47d7829affa1e15fb7f963d55a827c 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=2500&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=afe375ec32d8742412037efe2a68cd87 2500w" data-optimize="true" data-opv="2" />

        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/parsing-search-results#hotels).

                <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=18fa40bdcd198e4d337ccb5301902634" alt="hotels-availability.png" width="548" height="666" data-path="images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=280&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=55ad6ed979ae83dcbbdc244da9856b96 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=560&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=75d638ee411bca2c0cd3aa33c51754b5 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=840&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b053d968ea76d60b4cfa30860de4f7ad 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=1100&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f6b7e3482c9b500e8f4bfd5f5e8efe5b 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=1650&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1d1d2097689da1396849b05b074526bd 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=2500&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ce827ec1b01d6a89cbb5e127939d9c9c 2500w" data-optimize="true" data-opv="2" />
      </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/parsing-search-results#hotels).

                <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/hotel-info.png?maxW=1234&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=91a2eaa3ee96b6957ab7a45a4381837c" alt="hotel-info.png" width="1234" height="807" data-path="images/scraping-automation/serp-api/faqs/hotel-info.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/hotel-info.png?w=280&maxW=1234&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=4b8aecd955cb38186418e3afd3e7d5fa 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/hotel-info.png?w=560&maxW=1234&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=abc3fda52a0c0dab6f99719d94b58773 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/hotel-info.png?w=840&maxW=1234&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=ee405cee51d157de903957512d51caf3 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/hotel-info.png?w=1100&maxW=1234&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=510fb8ed724b32d2b09f07ed9933dbce 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/hotel-info.png?w=1650&maxW=1234&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=cbed79f0f9b11862d458b3a5d3126b05 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/hotel-info.png?w=2500&maxW=1234&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e73f8f6e3f8e3ccd84304cbf85538990 2500w" data-optimize="true" data-opv="2" />
      </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
      curl "https://www.google.com/search?q=pizza&lum_json=1" -v --insecure --compressed --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
      ```

      ```js NodeJS
      process.env.NODE_TLS_REJECT_UNAUTHORIZED = 0;
      ```

      ```java Java
      -Dcom.sun.net.ssl.checkRevocation=false
      ```

      ```cs C#
      ServicePointManager.ServerCertificateValidationCallback += (sender, cert, chain, sslPolicyErrors) => true;
      ```

      ```python Python
      # for native `request` library:
      import 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
        curl -v --compressed "https://www.google.com/search?q=pizza&lum_json=1" --cacert “{cert file path}“ --proxy brd.superproxy.io:33335 --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
          %JAVA_HOME% Keystore (mostly the cacerts file in ..\lib\security\).
          ```

          ```sh Keytool Command Example
          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](https://docs.brightdata.com/general/account/ssl-certificate) to your local machine's Trusted Root Certification Authorities.

        ```sh Shell
        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/parsing-search-results)
  </Accordion>

  <Accordion title="How to send multiple queries in an identical API request?">
    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
      multi:[
        {
          "keyword": "pizza",
          "num": 20
        },
        {
          "keyword": "pizza",
          "num": 100
        }
      ]

      ```

      ```json Different keyword
      multi:[
        {
          "keyword": "pizza"
        },
        {
          "keyword": "burger"
        }
      ]
      ```
    </CodeGroup>

    **Sample Code:**

    <CodeGroup>
      ```sh Send request
      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
      # 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 is making some changes to SERP results. Are you going to continue to support the SERP 'num' parameter?">
    Absolutely!

    Bright Data has developed a backup feature for the 'num' parameter which will kick in, in the event that Google stops supporting the 'num' parameter in the future.

    Our new feature will seamlessly compensate for any ‘num’ parameter limitations found in the initial SERP response data and send 9 additional requests (10 results each), combine them together, and return the full 100 results to you as a consolidated and comprehensive response. This new response will have the identical appearance and functionality of a response with the ‘ num=100’ parameter working flawlessly.

    <Accordion title="So, will there be any change to pricing due to this new feature?">
      Nope! Despite the additional requests involved in this new feature and providing the combined responses, there will be no change in pricing and this request will count for you as a single regular request for billing purposes. We understand the importance of maintaining costs and will absorb any additional costs here without passing them on to our customers.
    </Accordion>

    <Note>
      If you having issues with the ‘num’ parameter please reach out to your Bright Data account manager, and we will activate the feature for you.
    </Note>
  </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 src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/bing-exact-date-filter.png?maxW=1022&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=75661a89fca5b18d040fb9642e8c76c4" alt="bing-exact-date-filter.png" width="1022" height="233" data-path="images/scraping-automation/serp-api/faqs/bing-exact-date-filter.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/bing-exact-date-filter.png?w=280&maxW=1022&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=4905244fd2b5ad0b6583c39b7f92f704 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/bing-exact-date-filter.png?w=560&maxW=1022&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=dc24a9ffe778c01c4d5c963df6db0584 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/bing-exact-date-filter.png?w=840&maxW=1022&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=69b361343966022617cd9b480455d9b5 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/bing-exact-date-filter.png?w=1100&maxW=1022&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=97a54338cb9ced86ef9d0d0bdf65aece 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/bing-exact-date-filter.png?w=1650&maxW=1022&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=5685b133f3ce62d3bb4f1c431864e16c 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/faqs/bing-exact-date-filter.png?w=2500&maxW=1022&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=7bca1c07793bc7db8eee4ddfbe8b8bc0 2500w" data-optimize="true" data-opv="2" />
        </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;?" defaultOpen="false">
    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](https://docs.brightdata.com/scraping-automation/serp-api/query-parameters).
  </Accordion>

  <Accordion title="How can I see more ads in Google search results using the SERP API?" defaultOpen="false">
    {/* TAGS: "sposnored ads"; "google ads"; "ad results"; "google promoted results"; */}

    If you're monitoring ads in Google search results and want to maximize visibility, consider using our Enhanced Ads feature for Google.com SERP API requests.

    Default SERP Behavior:

    * Retrieves both organic search results and ads across a broad geographical scope.
      With Enhanced Ads Enabled:
    * Expands the range of search results and ads, simulating an incognito browsing experience without cookies.

    To activate this feature, navigate to your SERP API zone in the [control panel](https://brightdata.com/cp/zones) and enable it from the configuration tab.

    [Learn More](https://docs.brightdata.com/scraping-automation/serp-api/parsing-search-results#ads)
  </Accordion>
</AccordionGroup>


# 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 cols={3}>
  <Card title="Postman Example" icon="user-astronaut" iconType="regular" href="https://www.postman.com/bright-data-api/bright-data-api/request/uzaea2u/bing-search" cta="Try Bing SERP API in less than 1 minute" />

  <Card title="Node.js Example" icon="code" iconType="regular" href="https://github.com/brightdata/bright-data-bing-serp-api-nodejs-project" cta="Try Bing SERP API in less than 2 minutes" />

  <Card title="Python Example" icon="code" iconType="regular" href="https://github.com/brightdata/bright-data-bing-serp-api-python-project" cta="Try Bing SERP API in less than 5 minutes" />
</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
    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
  (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

  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 cols={3}>
  <Card title="Postman Example" icon="user-astronaut" iconType="regular" href="https://www.postman.com/bright-data-api/bright-data-api/request/kpq952m/google-search" cta="Try Google SERP API in less than 1 minute" />

  <Card title="Node.js Example" icon="code" iconType="regular" href="https://github.com/luminati-io/bright-data-serp-api-nodejs-project" cta="Try Google SERP API in less than 2 minutes" />

  <Card title="Python Example" icon="code" iconType="regular" href="https://github.com/brightdata/bright-data-serp-api-python-project" cta="Try Google SERP API in less than 5 minutes" />
</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
    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
  (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

  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)


# Introduction to SERP API
Source: https://docs.brightdata.com/scraping-automation/serp-api/introduction

Collect search results without managing proxies, CAPTCHAs, or parsing. Start in minutes with a single endpoint.

Collect search results from Google, Bing, DuckDuckGo, Yandex, Baidu, Yahoo, and Naver without managing proxies, CAPTCHAs, or parsing. Choose Markdown, raw HTML or parsed JSON.

<Tip>
  You only pay for successful requests.
</Tip>

## Quickstart

A minimal request with cURL. Replace `<BRIGHT_DATA_API_KEY>` and `zone` with your values:

<CodeGroup>
  ```shell cURL
  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
  // 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
  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 <code>"format": "json"</code> to receive a parsed SERP structure.
</Tip>

<CardGroup cols={3}>
  <Card title="Run in Postman" icon="rocket" href="https://www.postman.com/bright-data-api/bright-data-api/request/kpq952m/google-search" cta="Open Postman" />

  <Card title="Node.js example" icon="code" href="https://github.com/luminati-io/bright-data-serp-api-nodejs-project" cta="Open repo" />

  <Card title="Python example" icon="code" href="https://github.com/brightdata/bright-data-serp-api-python-project" cta="Open repo" />
</CardGroup>

## Before you start

1. Sign in: [https://brightdata.com/cp/start](https://brightdata.com/cp/start)
2. Create a SERP API zone: [https://brightdata.com/cp/zones](https://brightdata.com/cp/zones)
3. Get your API key: [/api-reference/authentication](/api-reference/authentication#how-do-i-generate-a-new-api-key?)

<Tip>
  New to Bright Data? See the step-by-step guide: [/scraping-automation/serp-api/quickstart](/scraping-automation/serp-api/quickstart)
</Tip>

## What you'll get (parsed JSON preview)

A compact look at the parsed structure you can expect:

```json
{
  "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/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)

## 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 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.
* **Still stuck?** See FAQs: [/scraping-automation/serp-api/faqs](/scraping-automation/serp-api/faqs)

## Next steps

<CardGroup cols={3}>
  <Card title="Send your first request" icon="bolt" href="/scraping-automation/serp-api/send-your-first-request" cta="Open guide" />

  <Card title="Query parameters (Google)" icon="sliders" href="/scraping-automation/serp-api/query-parameters/google" cta="Open docs" />

  <Card title="Parsed JSON results" icon="list" href="/scraping-automation/serp-api/parsing-search-results" cta="Open schema" />

  <Card title="Asynchronous requests" icon="clock" href="/scraping-automation/serp-api/asynchronous-requests" cta="Open guide" />

  <Card title="Quick Start" icon="road" href="/scraping-automation/serp-api/quickstart" cta="Open steps" />

  <Card title="FAQs" icon="circle-question" href="/scraping-automation/serp-api/faqs" cta="Open FAQs" />
</CardGroup>


# Microsoft Bing API to Bright Data SERP API migration guide
Source: https://docs.brightdata.com/scraping-automation/serp-api/parsed-json-results/bing-to-bright-data-serp-migration-guide

Step-by-step guide to migrate your Bing Search API to Bright Data Bing SERP API.

<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/signup) 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
    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

<Accordion title="1.1 Create Bright Data account">
  1. Visit [brightdata.com/signup](https://brightdata.com/signup)
  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
  Ocp-Apim-Subscription-Key: YOUR_BING_KEY
  ```

  **After (Bright Data):**

  ```http
  Authorization: Bearer YOUR_BRIGHTDATA_API_KEY
  ```
</Accordion>

### Step 2: Update request format

<Tabs>
  <Tab title="cURL">
    **Before (Bing API):**

    ```bash
    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
    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
    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
    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
    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
    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
  {
    "_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
  # 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

In this article, we will cover the basics of parsing with SERP API and see real JSON examples of parsed data.

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

## Send a Basic Parsed Request

The following is the simplest GET parsed request with SERP API using either `brd_json=1` OR  `brd_json=html`:

<CodeGroup>
  ```sh brd_json=1
  # Returns a single parsed JSON (instead of a raw HTML)

  curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> -k "https://www.google.com/search?q=pizza&brd_json=1"
  ```

  ```sh brd_json=html
  # Returns a single parsed JSON which contains an "html" field 
  # (with the raw HTML in addition to the other parsed fields)

  curl -k --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> "https://www.google.com/search?q=pizza&brd_json=html"
  ```
</CodeGroup>

<Tip>Parsing is supported for both **Google** and **Bing** search engines</Tip>

<Info>
  The above request is a **synchronous** request (the response is received in real-time). If you are looking to send an **asynchronous** parsed request see [here](/scraping-automation/serp-api/asynchronous-requests).
</Info>

***

## Basic Request - Breakdown

|                                                                                                                                                                                                |                                                                                                                        |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `brd.superproxy.io`                                                                                                                                                                            | Address of our load balancer that will find the fastest Super Proxy for your request                                   |
| <Tooltip tip="Port 33335 replacing port 22225 deprecated on Sep 2026, click to read more">[`33335`](https://docs.brightdata.com/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                              \`               |
| `brd_json=1`                                                                                                                                                                                   | Returns parsed JSON **instead** of raw HTML                                                                            |
| `brd_json=html`                                                                                                                                                                                | Returns parsed JSON + full nested HTML                                                                                 |

***

## Expected Parsed Output when using `brd_json=1`

The following is the exact JSON response received when sending the request above:

<Accordion title="JSON Response">
  ```JSON
  {
    "general": {
      "search_engine": "google",
      "results_cnt": 1980000000,
      "search_time": 0.57,
      "language": "en",
      "mobile": false,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Google Search",
      "code_version": "1.90",
      "timestamp": "2023-06-30T08:58:41.786Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&brd_json=1",
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12) AppleWebKit/608.2.11 (KHTML, like Gecko) Version/13.0.3 Safari/608.2.11",
      "request_id": "hl_1a1be908_i00lwqqxt1"
    },
    "organic": [
      {
        "link": "https://www.pizzahut.com/",
        "display_link": "https://www.pizzahut.com",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "image": "data:image/jpeg;base64,/9j/4AAQSk...",
        "image_alt": "pizza from www.pizzahut.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSk...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.dominos.com/en/",
        "display_link": "https://www.dominos.com › ...",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Chicken & 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": "data:image/jpeg;base64,/9j/4AAQSk...",
        "image_alt": "pizza from www.dominos.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSk...",
        "rank": 2,
        "global_rank": 3
      },
      {
        "link": "https://en.wikipedia.org/wiki/Pizza",
        "display_link": "https://en.wikipedia.org › wiki › Pizza",
        "title": "Pizza - Wikipedia",
        "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 ...",
        "image": "data:image/jpeg;base64,/9j/4AAQSk...",
        "image_alt": "pizza from en.wikipedia.org",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSk...",
        "rank": 3,
        "global_rank": 4
      },
      {
        "link": "https://www.papajohns.com/",
        "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 ...",
        "rank": 4,
        "global_rank": 5
      },
      {
        "link": "https://littlecaesars.com/",
        "display_link": "https://littlecaesars.com",
        "title": "Little Caesars® Pizza: Best Value Delivery and Carryout",
        "description": "Your home for HOT-N-READY® pizzas, EXTRAMOSTBESTEST® pizzas, DEEP!DEEP!™ Dish pizzas, Crazy Bread® and MORE! Order online for no-contact delivery or ...",
        "rank": 5,
        "global_rank": 6
      },
      {
        "link": "https://www.blazepizza.com/",
        "display_link": "https://www.blazepizza.com",
        "title": "Blaze Pizza - Fast-Fire'd Pizzas - Order Online | Blaze Pizza",
        "description": "Get fired up with Fast-Fire'd Pizzas from Blaze! Made just the way you want. Order online for delivery or pickup.",
        "rank": 6,
        "global_rank": 7
      },
      {
        "link": "https://www.theguardian.com/food/2023/jun/28/rightwingers-say-pink-haired-liberals-are-killing-new-york-pizza-heres-whats-really-happening",
        "display_link": "https://www.theguardian.com › food › jun › rightwing...",
        "title": "Rightwingers say 'pink-haired liberals' are killing New York ...",
        "description": "The pizza pile-on was sparked by a inaccuracy-riddled report ... 'This is not legislation that will corrode the New York pizza scene,' says ...",
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "20 hours ago",
            "rank": 1
          }
        ],
        "rank": 7,
        "global_rank": 8
      },
      {
        "link": "https://www.youtube.com/watch?v=oxLzRjYBxQQ",
        "display_link": "https://www.youtube.com › watch",
        "title": "Barstool Pizza Review - YouTube",
        "description": "YouTube",
        "extensions": [
          {
            "type": "text",
            "text": "One Bite Pizza Reviews",
            "rank": 1
          },
          {
            "type": "text",
            "text": "1 day ago",
            "rank": 2
          }
        ],
        "image": "https://i.ytimg.com/vi/oxLzRjYBxQQ/mqdefault.jpg?sqp=-oaymwEFCJQBEFM&rs=AMzJL3lRRTbw1I91F1168NO_w1YftuPlgA",
        "image_url": "https://i.ytimg.com/vi/oxLzRjYBxQQ/mqdefault.jpg?sqp=-oaymwEFCJQBEFM&rs=AMzJL3lRRTbw1I91F1168NO_w1YftuPlgA",
        "duration": "11:14",
        "duration_sec": 674,
        "rank": 8,
        "global_rank": 12
      },
      {
        "link": "https://www.youtube.com/watch?v=9X56jc_68EU",
        "display_link": "https://www.youtube.com › watch",
        "title": "Barstool Pizza Review - NYC Pizza Kitchen (New York, NY)",
        "description": "YouTube",
        "extensions": [
          {
            "type": "text",
            "text": "One Bite Pizza Reviews",
            "rank": 1
          },
          {
            "type": "text",
            "text": "3 days ago",
            "rank": 2
          }
        ],
        "image": "https://i.ytimg.com/vi/9X56jc_68EU/mqdefault.jpg?sqp=-oaymwEFCJQBEFM&rs=AMzJL3lO46CkRjZWL3FEQeeQkBJgCxZzeQ",
        "image_url": "https://i.ytimg.com/vi/9X56jc_68EU/mqdefault.jpg?sqp=-oaymwEFCJQBEFM&rs=AMzJL3lO46CkRjZWL3FEQeeQkBJgCxZzeQ",
        "duration": "4:10",
        "duration_sec": 250,
        "rank": 9,
        "global_rank": 13
      }
    ],
    "recipes": {
      "title": "Recipes",
      "items": [
        {
          "title": "Homemade Pizza & Pizza Dough",
          "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS47CWfkHqjbfUIaFrK8RjTm_KngqQxsXQ2OTmW7q1lrTebxVxzzYG3mmpj4g&s",
          "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS47CWfkHqjbfUIaFrK8RjTm_KngqQxsXQ2OTmW7q1lrTebxVxzzYG3mmpj4g&s",
          "link": "https://www.simplyrecipes.com/recipes/homemade_pizza/",
          "rating": 4.8,
          "reviews_cnt": 90,
          "source": "Simply Recipes",
          "cook_time": "2 hr 30 min",
          "ingredients": [
            "Italian sausage",
            "pizza dough",
            "pesto",
            "feta cheese",
            "bell peppers"
          ],
          "rank": 1,
          "global_rank": 9
        },
        {
          "title": "Pizza Dough",
          "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQHSV3fiR1QKeO5Gu7eVRg66v32XW049i_F8_sAYXxXHxS1oRwZ3IS0mTPY&s",
          "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQHSV3fiR1QKeO5Gu7eVRg66v32XW049i_F8_sAYXxXHxS1oRwZ3IS0mTPY&s",
          "link": "https://www.foodnetwork.com/recipes/bobby-flay/pizza-dough-recipe-1921714",
          "rating": 4.5,
          "reviews_cnt": 1600,
          "source": "Food Network",
          "cook_time": "1 hr 30 min",
          "ingredients": [
            "Bread flour",
            "olive oil",
            "sugar",
            "dry yeast"
          ],
          "rank": 2,
          "global_rank": 10
        },
        {
          "title": "Easy Homemade Pizza Dough",
          "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTzzGNfXoRqbKBti55KO34rb_SW-xePkIvSMgef0AsbRArRcu9nMLpyr8-Iyw&s",
          "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTzzGNfXoRqbKBti55KO34rb_SW-xePkIvSMgef0AsbRArRcu9nMLpyr8-Iyw&s",
          "link": "https://www.allrecipes.com/recipe/20171/quick-and-easy-pizza-crust/",
          "rating": 4.7,
          "reviews_cnt": 3900,
          "source": "Allrecipes",
          "cook_time": "45 min",
          "ingredients": [
            "Bread flour",
            "olive oil",
            "active dry yeast",
            "white sugar"
          ],
          "rank": 3,
          "global_rank": 11
        }
      ]
    },
    "knowledge": {
      "name": "Pizza",
      "subtitle": "Dish",
      "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, which is then baked at a high temperature, traditionally in a wood-fired oven.",
      "description_source": "Wikipedia",
      "description_link": "https://en.wikipedia.org/wiki/Pizza",
      "images": [
        {
          "link": "https://www.google.com/search?q=pizza&hl=en&tbm=isch&source=iu&ictx=1&vet=1&fir=vwyNmrlxb87lKM%252C5xpz_Vm2ema2NM%252C%252Fm%252F0663v%253BefJ23c2_JH_n7M%252CbBq_NwtYzsoXvM%252C_%253B4T1KqgPBvr4X6M%252CJGW8XVFocJC4wM%252C_%253B7mn1Wr2V2et-TM%252CCk5z3mFwtc-sLM%252C_%253BHAxRWExZGt4a0M%252CTQkQ0B0M4aWgcM%252C_%253BAOp1u9WxhkknqM%252CDnbYrezaqAeTBM%252C_%253BZiJze8NWYgm1BM%252CmUmiEmWVfPIjPM%252C_&usg=AI4_-kQ40qSc7MuZBzNVnuLne9fo9Vl5gA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ_B16BAhUEAE#imgrc=vwyNmrlxb87lKM",
          "image": "data:image/jpeg;base64,/9j/4AAQSk...",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSk..."
        },
        {
          "link": "https://www.google.com/search?q=pizza&hl=en&tbm=isch&source=iu&ictx=1&vet=1&fir=efJ23c2_JH_n7M%252CbBq_NwtYzsoXvM%252C_%253B4T1KqgPBvr4X6M%252CJGW8XVFocJC4wM%252C_%253B7mn1Wr2V2et-TM%252CCk5z3mFwtc-sLM%252C_%253BHAxRWExZGt4a0M%252CTQkQ0B0M4aWgcM%252C_%253BAOp1u9WxhkknqM%252CDnbYrezaqAeTBM%252C_%253BZiJze8NWYgm1BM%252CmUmiEmWVfPIjPM%252C_&usg=AI4_-kRwEYdg29oH_CmkbTMQheFOmeF4NA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ_h16BAhWEAE#imgrc=efJ23c2_JH_n7M",
          "image": "data:image/jpeg;base64,/9j/4AAQSk...",
          "image_alt": "Classic Cheese Pizza",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSk..."
        },
        {
          "link": "https://www.google.com/search?q=pizza&hl=en&tbm=isch&source=iu&ictx=1&vet=1&fir=efJ23c2_JH_n7M%252CbBq_NwtYzsoXvM%252C_%253B4T1KqgPBvr4X6M%252CJGW8XVFocJC4wM%252C_%253B7mn1Wr2V2et-TM%252CCk5z3mFwtc-sLM%252C_%253BHAxRWExZGt4a0M%252CTQkQ0B0M4aWgcM%252C_%253BAOp1u9WxhkknqM%252CDnbYrezaqAeTBM%252C_%253BZiJze8NWYgm1BM%252CmUmiEmWVfPIjPM%252C_&usg=AI4_-kRwEYdg29oH_CmkbTMQheFOmeF4NA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ_h16BAhYEAE#imgrc=4T1KqgPBvr4X6M",
          "image": "data:image/jpeg;base64,/9j/4AAQSk...",
          "image_alt": "Homemade Pepperoni Pizza",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSk..."
        },
        {
          "link": "https://www.google.com/search?q=pizza&hl=en&tbm=isch&source=iu&ictx=1&vet=1&fir=efJ23c2_JH_n7M%252CbBq_NwtYzsoXvM%252C_%253B4T1KqgPBvr4X6M%252CJGW8XVFocJC4wM%252C_%253B7mn1Wr2V2et-TM%252CCk5z3mFwtc-sLM%252C_%253BHAxRWExZGt4a0M%252CTQkQ0B0M4aWgcM%252C_%253BAOp1u9WxhkknqM%252CDnbYrezaqAeTBM%252C_%253BZiJze8NWYgm1BM%252CmUmiEmWVfPIjPM%252C_&usg=AI4_-kRwEYdg29oH_CmkbTMQheFOmeF4NA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ_h16BAhaEAE#imgrc=7mn1Wr2V2et-TM",
          "image": "data:image/jpeg;base64,/9j/4AAQSk...",
          "image_alt": "Homemade Pepperoni Pizza",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSk..."
        },
        {
          "link": "https://www.google.com/search?q=pizza&hl=en&tbm=isch&source=iu&ictx=1&vet=1&fir=efJ23c2_JH_n7M%252CbBq_NwtYzsoXvM%252C_%253B4T1KqgPBvr4X6M%252CJGW8XVFocJC4wM%252C_%253B7mn1Wr2V2et-TM%252CCk5z3mFwtc-sLM%252C_%253BHAxRWExZGt4a0M%252CTQkQ0B0M4aWgcM%252C_%253BAOp1u9WxhkknqM%252CDnbYrezaqAeTBM%252C_%253BZiJze8NWYgm1BM%252CmUmiEmWVfPIjPM%252C_&usg=AI4_-kRwEYdg29oH_CmkbTMQheFOmeF4NA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ_h16BAhZEAE#imgrc=HAxRWExZGt4a0M",
          "image": "data:image/jpeg;base64,/9j/4AAQSk...",
          "image_alt": "Pizza Dough recipe",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSk..."
        },
        {
          "link": "https://www.google.com/search?q=pizza&hl=en&tbm=isch&source=iu&ictx=1&vet=1&fir=efJ23c2_JH_n7M%252CbBq_NwtYzsoXvM%252C_%253B4T1KqgPBvr4X6M%252CJGW8XVFocJC4wM%252C_%253B7mn1Wr2V2et-TM%252CCk5z3mFwtc-sLM%252C_%253BHAxRWExZGt4a0M%252CTQkQ0B0M4aWgcM%252C_%253BAOp1u9WxhkknqM%252CDnbYrezaqAeTBM%252C_%253BZiJze8NWYgm1BM%252CmUmiEmWVfPIjPM%252C_&usg=AI4_-kRwEYdg29oH_CmkbTMQheFOmeF4NA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ_h16BAhXEAE#imgrc=AOp1u9WxhkknqM",
          "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSBTiGlL3eQeQk_UYQGpoyg3OE6RQsOhx60YyUbNvPFng&s",
          "image_alt": "Chicken Alfredo Pizza",
          "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSBTiGlL3eQeQk_UYQGpoyg3OE6RQsOhx60YyUbNvPFng&s"
        },
        {
          "link": "https://www.google.com/search?q=pizza&hl=en&tbm=isch&source=iu&ictx=1&vet=1&fir=efJ23c2_JH_n7M%252CbBq_NwtYzsoXvM%252C_%253B4T1KqgPBvr4X6M%252CJGW8XVFocJC4wM%252C_%253B7mn1Wr2V2et-TM%252CCk5z3mFwtc-sLM%252C_%253BHAxRWExZGt4a0M%252CTQkQ0B0M4aWgcM%252C_%253BAOp1u9WxhkknqM%252CDnbYrezaqAeTBM%252C_%253BZiJze8NWYgm1BM%252CmUmiEmWVfPIjPM%252C_&usg=AI4_-kRwEYdg29oH_CmkbTMQheFOmeF4NA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ_h16BAhQEAE#imgrc=ZiJze8NWYgm1BM",
          "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcShqNOrnCWng5zaBj2reNeU2QHAMaeyj1EJJhqbunN9kg&s",
          "image_alt": "Classic Cheese Pizza",
          "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcShqNOrnCWng5zaBj2reNeU2QHAMaeyj1EJJhqbunN9kg&s"
        }
      ],
      "facts": [
        {
          "key": "Origin",
          "key_link": "https://www.google.com/search?hl=en&q=pizza+origin&stick=H4sIAAAAAAAAAOPgE-LQz9U3MDMzLtOSySi30k_Oz8lJTS7JzM_TT8kszkgttsovykzPzFvEylOQWVWVqADhAgAjO0XtOQAAAA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ6BMoAHoECEcQAg",
          "predicate": "hw:/collection/dishes:origin",
          "value": [
            {
              "text": "Italy",
              "link": "https://www.google.com/search?hl=en&q=Italy&si=AMnBZoFk_ppfOKgdccwTD_PVhdkg37dbl-p8zEtOPijkCaIHMj99cmEC8YmqzIntfXVZNtU5L5s_BYkw6CsmIn-L56QSbpr6PIZUjdVkuKrffw6c1CKZ_9pKBFW4qlnB9Bhm0MDfT6vScNQrXeycat32kzuoKi0SbwH1ZOSp7Rw9H4b-NlpUU9DyezwS3Hx3MvdZtCWf0TlV&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQmxMoAXoECEcQAw"
            }
          ]
        }
      ],
      "widgets": [
        {
          "type": "carousel",
          "key": "downwards",
          "predicate": "kc:/common:downwards",
          "key_link": "https://www.google.com/search?hl=en&q=where+to+buy+neapolitan+pizza+dough&stick=H4sIAAAAAAAAAD3IMQrCMBQAUIoUOosHCHVziSJ06GVCmnySkJ_Q5Ma7HEcPYHH08nt8YbDcZBJXqfp_hj_upyimaXhlJhmy42aXm15d7ffIYKpgUlG4oZgHaisCbDI4jnnQE7FrACDCwvCqz83DyuIymLZnoJAZ8ZQNYkc9l0Ly5vzn777AncBsYyJAAAA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQMSgAegQIQxAB",
          "title": "where to buy neapolitan pizza dough",
          "items": [
            {
              "title": "Delallo Pizza Dough Kit",
              "link": "https://www.google.com/search?hl=en&q=Delallo+Pizza+Dough+Kit&stick=H4sIAAAAAAAAAONgFmJQ4tVP1zc0zDArSa-KL7TUYljEKu6SmpOYk5OvEJBZVZWo4JJfmp6h4J1ZsoOVEQCmdWPwMgAAAA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQxA16BAhDEAQ",
              "image": "data:image/jpeg;base64,/9j/4AAQSk...",
              "image_alt": "Delallo Pizza Dough Kit",
              "image_base64": "data:image/jpeg;base64,/9j/4AAQSk...",
              "rank": 1
            },
            {
              "title": "King Arthur Flour Piz...",
              "link": "https://www.google.com/search?hl=en&q=King+Arthur+Flour+Pizza&stick=H4sIAAAAAAAAAONgFmJQ4tVP1zc0zM4wNjQsiS_WYljEKu6dmZeu4FhUklFapOCWkw8kAzKrqhJ3sDICAJ9B7QQyAAAA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQxA16BAhDEAY",
              "image": "data:image/jpeg;base64,/9j/4AAQSk...",
              "image_alt": "King Arthur Flour Pizza",
              "image_base64": "data:image/jpeg;base64,/9j/4AAQSk...",
              "rank": 2
            },
            {
              "title": "Pizza Buddy Pizza Do...",
              "link": "https://www.google.com/search?hl=en&q=Pizza+Buddy+Pizza+Dough&stick=H4sIAAAAAAAAAONgFmJQ4tVP1zc0TM9IKkwqsjTQYljEKh6QWVWVqOBUmpJSqQBhu-SXpmfsYGUEAHLKv6oyAAAA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQxA16BAhDEAg",
              "image": "data:image/jpeg;base64,/9j/4AAQSk...",
              "image_alt": "Pizza Buddy Pizza Dough",
              "image_base64": "data:image/jpeg;base64,/9j/4AAQSk...",
              "rank": 3
            },
            {
              "title": "Pillsbury Classic Pizza Cr...",
              "link": "https://www.google.com/search?hl=en&q=Pillsbury+Classic+Pizza+Crust&stick=H4sIAAAAAAAAAONgFmJQ4tVP1zc0LDExNjTNqsjTYljEKhuQmZNTnFRaVKngnJNYXJyZrBCQWVWVqOBcVFpcsoOVEQCR9ToAOAAAAA&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQxA16BAhDEAo",
              "image": "data:image/jpeg;base64,/9j/4AAQSk...",
              "image_alt": "Pillsbury Classic Pizza Crust",
              "image_base64": "data:image/jpeg;base64,/9j/4AAQSk...",
              "rank": 4
            }
          ],
          "rank": 1,
          "global_rank": 2
        }
      ]
    },
    "snack_pack_map": {
      "image": "data:image/png;base64,iVBOR...",
      "image_alt": "Map of pizza",
      "image_base64": "data:image/png;base64,iVBOR...",
      "link": "https://www.google.com/search?hl=en&q=pizza&npsic=0&rflfq=1&rldoc=1&rllag=40711584,-74006968,203&tbm=lcl&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQtgN6BAgWEAI",
      "latitude": 40.711584,
      "longitude": -74.006968,
      "altitude": 203
    },
    "pagination": {
      "current_page": 1,
      "next_page_link": "https://www.google.com/search?q=pizza&hl=en&ei=P5meZMuIMLyiptQP89muyA0&start=10&sa=N",
      "next_page_start": 10,
      "next_page": 2
    },
    "related": [
      {
        "text": "Family-friendly dinner near New York",
        "list_group": true,
        "image": "https://lh5.googleusercontent.com/p/AF1QipN9vMB3YUcI2E2RBZYuhQcpa9q3yCLDClsVS20_=w40-h40-n-k-no",
        "image_url": "https://lh5.googleusercontent.com/p/AF1QipN9vMB3YUcI2E2RBZYuhQcpa9q3yCLDClsVS20_=w40-h40-n-k-no",
        "rank": 1,
        "global_rank": 14
      },
      {
        "text": "Quick bites near New York",
        "list_group": true,
        "image": "https://lh5.googleusercontent.com/p/AF1QipM0BsBfNtUBmGyzowDeE9Zkp30pYTdtbTJCpqai=w40-h40-n-k-no",
        "image_url": "https://lh5.googleusercontent.com/p/AF1QipM0BsBfNtUBmGyzowDeE9Zkp30pYTdtbTJCpqai=w40-h40-n-k-no",
        "rank": 2,
        "global_rank": 15
      },
      {
        "text": "Pizza takeaway near New York",
        "list_group": true,
        "image": "https://lh5.googleusercontent.com/p/AF1QipO_5JRLn_XOBC5luGuOcIG_JCdfGoeBOggO69Ly=w40-h40-n-k-no",
        "image_url": "https://lh5.googleusercontent.com/p/AF1QipO_5JRLn_XOBC5luGuOcIG_JCdfGoeBOggO69Ly=w40-h40-n-k-no",
        "rank": 3,
        "global_rank": 16
      },
      {
        "text": "Best restaurants near New York",
        "list_group": true,
        "image": "https://lh5.googleusercontent.com/p/AF1QipNgm_8G1gbEVoaG2CvygurS-TZpEIohi2zrx6tz=w40-h40-n-k-no",
        "image_url": "https://lh5.googleusercontent.com/p/AF1QipNgm_8G1gbEVoaG2CvygurS-TZpEIohi2zrx6tz=w40-h40-n-k-no",
        "rank": 4,
        "global_rank": 17
      },
      {
        "list_group": false,
        "link": "https://www.google.com/search?hl=en&q=Domino%27s+Pizza+Pakistan&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ1QJ6BAg4EAE",
        "text": "domino's pizza pakistan",
        "rank": 5,
        "global_rank": 18
      },
      {
        "list_group": false,
        "link": "https://www.google.com/search?hl=en&q=Domino%27s+pizza+near+me&sa=X&ved=2ahUKEwiLpJav0Or_AhU8kYkEHfOsC9kQ1QJ6BAg3EAE",
        "text": "domino's pizza near me",
        "rank": 6,
        "global_rank": 19
      }
    ]
  }
  ```
</Accordion>

Next, we will examine a number of the important fields within the parsed JSON data to understand the type of structured data we have to offer.

***

## A Comprehensive Guide to Parsed Google SERP JSON Data

At the top of the JSON response, you can find the `general` field, which contains details about the search you ran and also includes the "results count" from the response.

<Frame>
    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/general-field.png?maxW=686&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=eaa23c72b9c23b3e6ef1d9e2efbcba62" alt="General-Field" width="686" height="475" data-path="images/scraping-automation/serp-api/parsing-search-results/general-field.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/general-field.png?w=280&maxW=686&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d504f7339ca1540eb1314705c757e5f1 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/general-field.png?w=560&maxW=686&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=4ca4f87b9a398a9b663c969da6337989 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/general-field.png?w=840&maxW=686&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=144872548edef0c4584f499d019d88ad 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/general-field.png?w=1100&maxW=686&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f0d58cc1de586d4f07beef7c132add5a 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/general-field.png?w=1650&maxW=686&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d48a1de3bcbc96fc51070cc22a8076da 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/general-field.png?w=2500&maxW=686&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ad6dba22f82583284c675c026904df6f 2500w" data-optimize="true" data-opv="2" />
</Frame>

The following fields can be found in the `general` field

|                         |                                                                                                                                                   |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `general.search_engine` | the search engine used for the search                                                                                                             |
| `general.query`         | the keywords used for the search                                                                                                                  |
| `general.results_cnt`   | the results count<br /><Info>Google doesn't display results count for Mobile, so this field is supported only with desktop search results.</Info> |
| `general.search_time`   | the response time to get the results page                                                                                                         |
| `general.language`      | the language that was set for the search, <br /><br />**Default**: `hl=en`                                                                        |
| `general.location`      | the location that was targeted with the search,(based on the `localization` and `geo-location` parameters)                                        |
| `general.mobile`        | the device the search was performed with (desktop/mobile)                                                                                         |
| `general.basic_view`    | deprecated                                                                                                                                        |
| `general.search _type`  | the type of search that was set to the request                                                                                                    |
| `general.Page_title`    | results page title                                                                                                                                |
| general.Code\_version   | Bright data parser version                                                                                                                        |
| `general.Timestamp`     | the time when the search executed                                                                                                                 |
| Input.original\_url     | the url used for the search, this url includes all parameters applied for the search.applied for the search.                                      |

## Starter fields to know

|                 |                                                                 |
| --------------- | --------------------------------------------------------------- |
| **JSON field**  | **Description**                                                 |
| `type`          | The field type (site\_link, text, rating, etc.)                 |
| `title`         | The text header, mostly the link text.                          |
| `description`   | The description under the link                                  |
| `referral_link` | Redirection link                                                |
| `image`         | This field can contain the image base64 string or the Image url |
| `image_alt`     | Image alternative name                                          |

## Explanation of other `fields`

<AccordionGroup>
  <Accordion title="rank">
    |               |                                                                                                       |
    | ------------- | ----------------------------------------------------------------------------------------------------- |
    | `rank`        | indicates the position of the element in accordance with the other elements **within** that component |
    | `global_rank` | indicates the position of the element in accordance with **all** the elements in the SERP             |

    <Frame>
            <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rank-field.png?maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=0140578f985a05c0c5de988045f72a26" alt="Rank-Field" width="429" height="628" data-path="images/scraping-automation/serp-api/parsing-search-results/rank-field.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rank-field.png?w=280&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5aec929460eec2acd2d19d60675107f5 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rank-field.png?w=560&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=fc82fe8c6da4be28b72da1a0aa65ccb6 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rank-field.png?w=840&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f6085716bd327c2360d3cf3ca170957e 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rank-field.png?w=1100&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=fe69f3288de4c48ea204ee68ce302cc6 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rank-field.png?w=1650&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=bce0d4d0d50a06fd5b6f2cb4023bd7ff 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rank-field.png?w=2500&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b4b4d274bb1fae1c7a3b537642f44f5a 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>

  <Accordion title="spelling">
    When your search terms are inaccurate, Google suggests other search terms, which will show under the `spelling` field.

    **Subfields:**

    |                       |                                         |
    | --------------------- | --------------------------------------- |
    | `Original_text`       | the text that was searched              |
    | `Original_empty`      | true, means that no results were found. |
    | `Auto_corrected_link` | link to suggested result                |
    | `auto_corrected_text` | the suggested link text                 |

    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-html.png?maxW=496&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a3aa86133e59b20411a77e6043f97f2f" alt="Spelling-HTML" width="496" height="254" data-path="images/scraping-automation/serp-api/parsing-search-results/spelling-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-html.png?w=280&maxW=496&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=63fc4d71586f6ad2e367a16ff080ca34 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-html.png?w=560&maxW=496&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=414a55cd2ebb6e46884f76b72702170d 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-html.png?w=840&maxW=496&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c46ab82f52d1ebd861794729e2b048b2 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-html.png?w=1100&maxW=496&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=59d63b972e7f88c04fb9001e855b6637 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-html.png?w=1650&maxW=496&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=0359220b0066025cf1cadda260882ab7 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-html.png?w=2500&maxW=496&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=cb557771128e727fb7de0f6e46de109c 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-json.png?maxW=781&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8a132f601a05977bb61699361b68f97f" alt="Spelling-JSON" width="781" height="135" data-path="images/scraping-automation/serp-api/parsing-search-results/spelling-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-json.png?w=280&maxW=781&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8d8db016613562c819af0b6ed826234e 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-json.png?w=560&maxW=781&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=86034cd436487dcd26cd4c6b0d9c96af 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-json.png?w=840&maxW=781&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=76ae55a0e9c66d62baf01972afefd15c 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-json.png?w=1100&maxW=781&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=408273d1b37c6b9ada4538b8b32bc819 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-json.png?w=1650&maxW=781&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=55b24f1e7844055b1eab7f50f3749d70 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/spelling-json.png?w=2500&maxW=781&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1dfd1be7a682421880cc29873701e3e0 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="rating & reviews">
    Some of the components within a SERPs can include the `reviews` and `rating` fields

    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rating-reviews-html.png?maxW=366&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1addedb0972d777e56fa14eb09a41422" alt="Rating-Reviews-HTML" width="366" height="28" data-path="images/scraping-automation/serp-api/parsing-search-results/rating-reviews-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rating-reviews-html.png?w=280&maxW=366&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=dcbd6fc82af2a791cb72ad291ff5e17f 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rating-reviews-html.png?w=560&maxW=366&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=583e44e1cfffdb30e06459ade95b698f 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rating-reviews-html.png?w=840&maxW=366&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ff251b619c4fcc6d736c60a90805104f 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rating-reviews-html.png?w=1100&maxW=366&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=53cdbeadb1007d726d1b2abd04ed51e7 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rating-reviews-html.png?w=1650&maxW=366&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e481a96b44b89a28605167c4b9c63e87 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/rating-reviews-html.png?w=2500&maxW=366&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=56beba3cbd8b3a632c5d31d2e59ca243 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ratings-reviews-json.png?maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=37eca3158aa0c4c502fdfb6e7533abc9" alt="Rating-Reviews-JSON" width="429" height="628" data-path="images/scraping-automation/serp-api/parsing-search-results/ratings-reviews-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ratings-reviews-json.png?w=280&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8e888a525e131c03e976036f37a6150f 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ratings-reviews-json.png?w=560&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=111bff45aeb9470cd9be79941a598d2d 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ratings-reviews-json.png?w=840&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a062172af9fac704a272f62fe7632a85 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ratings-reviews-json.png?w=1100&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=63261ff9b200cc650a237ef7223c45c4 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ratings-reviews-json.png?w=1650&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=15f3f665b73e57c9a3ff3fc5eeb82ff8 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ratings-reviews-json.png?w=2500&maxW=429&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f45c252645673bc6bfc25cf6188aa7db 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="extensions">
    Some SERP results could include site sub-links (AKA site links) that are displayed as a vertical or horizontal list

    <Tab title="Vertical - marked with extended:true">
      <Tabs>
        <Tab title="HTML">
          <Frame>
                        <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-html.png?maxW=610&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=332ffc6555ba4d530a86cefa94e1bfea" alt="Extensions-Vertical-HTML" width="610" height="375" data-path="images/scraping-automation/serp-api/parsing-search-results/ext-vertical-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-html.png?w=280&maxW=610&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=34fdf472a4c120d9b952e5aa4fc30cbf 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-html.png?w=560&maxW=610&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=2dfa5fc8bac3519cb2304466e69d638c 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-html.png?w=840&maxW=610&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e8d432ac8453a9034746682add142c30 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-html.png?w=1100&maxW=610&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=111377ba742cfb28b68edf65fe20021f 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-html.png?w=1650&maxW=610&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c6460a165bafad7c12a3736ecb6b10d4 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-html.png?w=2500&maxW=610&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=216c080a2eb9b330cb75180ad6f9fe74 2500w" data-optimize="true" data-opv="2" />
          </Frame>
        </Tab>

        <Tab title="JSON">
          <Frame>
                        <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-json.png?maxW=715&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9e41c3c59d5a44470a21c31a498ef757" alt="Extensions-Vertical-JSON" width="715" height="621" data-path="images/scraping-automation/serp-api/parsing-search-results/ext-vertical-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-json.png?w=280&maxW=715&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1d8e13127dbd58887acca21f9e5b0601 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-json.png?w=560&maxW=715&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5716b6a2054585059c0b41c03b4936ff 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-json.png?w=840&maxW=715&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=95b5d1753660fed7cb6b603a9623e4d5 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-json.png?w=1100&maxW=715&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=3572dfce7bc6dbcdf432b4161157c4bd 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-json.png?w=1650&maxW=715&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=134c1a28f0306f3e1c0676d51f4e4d21 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/ext-vertical-json.png?w=2500&maxW=715&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d36a6bbcda41b61f1e45125dc71d66df 2500w" data-optimize="true" data-opv="2" />
          </Frame>
        </Tab>
      </Tabs>
    </Tab>

    <Tab title="Horizontal - not marked with `extended:true`">
      <Tabs>
        <Tab title="HTML">
          <Frame>
                        <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-html.png?maxW=557&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=90dbc9c364fb2051c327c550f955a861" alt="Extensions-Horizontal-HTML" width="557" height="139" data-path="images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-html.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-html.png?w=280&maxW=557&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=167a255737cc0eb7cd2827bcf0158d21 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-html.png?w=560&maxW=557&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8fbba38922d81efe3c054337d16fe542 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-html.png?w=840&maxW=557&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3442cd417f5fdc6b1a580b9ab4c40e95 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-html.png?w=1100&maxW=557&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=762940d039e1def0fa642b38fda5e516 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-html.png?w=1650&maxW=557&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=2fd7ad25025e02ab0f9994cdc446bd5b 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-html.png?w=2500&maxW=557&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=805f57c6db71ad76617ed1fab4cccc04 2500w" data-optimize="true" data-opv="2" />
          </Frame>
        </Tab>

        <Tab title="JSON">
          <Frame>
                        <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-json.png?maxW=752&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=bbec2f9253c80461235ee39073de3021" alt="Extensions-Horizontal-JSON" width="752" height="584" data-path="images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-json.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-json.png?w=280&maxW=752&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f093f96cad7823712e70853c4c236039 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-json.png?w=560&maxW=752&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=0a223f514630a8f76d1ffae6a124a4cc 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-json.png?w=840&maxW=752&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=93b35c0320d5327324b18c9ddbf276d8 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-json.png?w=1100&maxW=752&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a1a57720e51689803304c444d39fcf50 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-json.png?w=1650&maxW=752&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c36e025f4b3792e038689f6170450313 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/ext-horizontal-json.png?w=2500&maxW=752&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f99e93d3ef99e6740d3cc69e0b69f48f 2500w" data-optimize="true" data-opv="2" />
          </Frame>
        </Tab>
      </Tabs>
    </Tab>
  </Accordion>

  <Accordion title="display_link">
    These are breadcrumbs from the URL in the result:

    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-html.png?maxW=965&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=da1aecda11967b7f7db5db963396cef1" alt="Display-Link-HTML" width="965" height="572" data-path="images/scraping-automation/serp-api/parsing-search-results/display-link-html.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-html.png?w=280&maxW=965&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=3575089e4c29f929e6681d9659b65558 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-html.png?w=560&maxW=965&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9c75adfbd4eb14239c1a7456abde83c9 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-html.png?w=840&maxW=965&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=8b15e13968749a4da495e9a838740cc1 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-html.png?w=1100&maxW=965&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=85532ae2fcc6dd27f84eda3672db92c6 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-html.png?w=1650&maxW=965&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=47f3152c36bb884246e4142d3af31b83 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-html.png?w=2500&maxW=965&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=cad83d249fc9e5271a45aca0d0014fac 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-json.png?maxW=783&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=c444d04557357d4cb3b18095307cd6be" alt="Display-Link-JSON" width="783" height="439" data-path="images/scraping-automation/serp-api/parsing-search-results/display-link-json.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-json.png?w=280&maxW=783&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=d8edb5254eb762386285dc7b91e208ec 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-json.png?w=560&maxW=783&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=a969e17776de3849bbceddf135757120 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-json.png?w=840&maxW=783&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=d372c7d648978e9cc4460ed967728ed4 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-json.png?w=1100&maxW=783&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=5933bea0bc91d78412861601e7f84d51 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-json.png?w=1650&maxW=783&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=150e4ae9f8e758eff4d7eb3f7012394c 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/display-link-json.png?w=2500&maxW=783&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=076fffefd3518037add18d19fb82ef0f 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="organic">
    Main search results are called organic results and are located in the organic json node.

    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-html.jpg?maxW=758&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=932af4e587710ea1f0b2b3598bf807cb" alt="Orgranic-HTML" width="758" height="734" data-path="images/scraping-automation/serp-api/parsing-search-results/organic-html.jpg" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-html.jpg?w=280&maxW=758&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e127997b2cc2b804b03801372ab46075 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-html.jpg?w=560&maxW=758&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8d0d4d96618a798e7b5bd2ee730bb17c 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-html.jpg?w=840&maxW=758&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f6abb02b71ab7e7f6ca850cf410d7e07 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-html.jpg?w=1100&maxW=758&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=4959acfd7b77adebf89031acd330fb58 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-html.jpg?w=1650&maxW=758&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=457da038000ff7aeb26a8bd1bf79245d 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-html.jpg?w=2500&maxW=758&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f97ad7a8813663c27e813c9da1f55962 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-json.jpg?maxW=761&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=57e4724262c305d0c942d0dda3a60d0e" alt="Orgranic-JSON" width="761" height="663" data-path="images/scraping-automation/serp-api/parsing-search-results/organic-json.jpg" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-json.jpg?w=280&maxW=761&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=70351bf190a333ed26149235ab560654 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-json.jpg?w=560&maxW=761&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=2a022b7340bcea747ac8bc342db8f51c 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-json.jpg?w=840&maxW=761&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e55eb505e3098194ae4504ed429ded83 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-json.jpg?w=1100&maxW=761&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=40be6e88431aa792ea0504ed56a3593f 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-json.jpg?w=1650&maxW=761&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7bf3f1c8f1252ce74a6227f71d7b1b3a 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/organic-json.jpg?w=2500&maxW=761&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ab9bd0089418c0ba901ba9a4fd33acee 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="ads">
    There are four different locations for ads within a SERP and each are parsed separately:

    |               |                                                                                                                                                   |
    | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
    | `top_ads`     | Ads that are located at the top of the SERP                                                                                                       |
    | `top_pla`     | Ads that are located within a special carousel at the top of a SERP                                                                               |
    | `jackpot_pla` | Ads that are located within the right side panel in **shopping** ads. It usually appears when a particular product matches your search perfectly. |
    | `bottom_ads`  | Ads that are located at the bottom of the SERP                                                                                                    |

    <Note>
      By default, SERP API displays "organic" adds (based on IP location and cookies, etc). If you wish SERP API to display ads in different ways (incognito, adtest) you can change this in your SERP API zone on the control panel.
    </Note>

    <AccordionGroup>
      <Accordion title="top_ads">
        <Tabs>
          <Tab title="HTML">
            <Frame>
                            <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-html.jpg?maxW=751&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=108cb006ad8a83cc2cf7ff8e7062bfe2" alt="Top-Ads-HTML" width="751" height="590" data-path="images/scraping-automation/serp-api/parsing-search-results/top-ads-html.jpg" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-html.jpg?w=280&maxW=751&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=181f11d0a77f018dc351c86710237470 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-html.jpg?w=560&maxW=751&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7a2a1354a85249ec8cf577862376f197 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-html.jpg?w=840&maxW=751&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=36c09be08927edf812d4011be4f36171 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-html.jpg?w=1100&maxW=751&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=90a6aa6ca04e75145bda72c51dc4d031 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-html.jpg?w=1650&maxW=751&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a7eed5da155595f06bc0072b759407f4 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-html.jpg?w=2500&maxW=751&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ad60d144dd28059f4215417ebcf33fd9 2500w" data-optimize="true" data-opv="2" />
            </Frame>
          </Tab>

          <Tab title="JSON">
            <Frame>
                            <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-json.jpg?maxW=774&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ef471b861a719f1a2b729abf064b7e57" alt="Top-Ads-JSON" width="774" height="601" data-path="images/scraping-automation/serp-api/parsing-search-results/top-ads-json.jpg" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-json.jpg?w=280&maxW=774&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8b9e874d8e0922cbb8b4171ceb27a1ae 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-json.jpg?w=560&maxW=774&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=58b115264c11e5107879797d0d6fb94c 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-json.jpg?w=840&maxW=774&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=313f3f3612fdc594445b76258c9418d8 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-json.jpg?w=1100&maxW=774&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b2bd1fddb8b574ed34cd9f2f26b91cab 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-json.jpg?w=1650&maxW=774&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b7111cbf2fd14196d74e9639ba47c773 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-ads-json.jpg?w=2500&maxW=774&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c916ed443b53ae355c1c3f38c359b92a 2500w" data-optimize="true" data-opv="2" />
            </Frame>
          </Tab>
        </Tabs>
      </Accordion>

      <Accordion title="top_pla">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-pla.png?maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=62766a789e156d04fbd5aedf0bc706c3" alt="Top-PLA" width="1600" height="471" data-path="images/scraping-automation/serp-api/parsing-search-results/top-pla.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-pla.png?w=280&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=3cd9e0c674662d2ab8d0d4e13697a7c5 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-pla.png?w=560&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=04aa10b3e4660aef3cb019afe721d374 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-pla.png?w=840&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=0ada00da3e364dc0da9e6224ffb22ea7 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-pla.png?w=1100&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=cf1777a6cc1ebe5df388f823b9c4a815 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-pla.png?w=1650&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d0fb59657fc9c547684f48a9b935ed53 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-pla.png?w=2500&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d02577c90d8958c5d7715d9d406867fb 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="jackpot_pla">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/jackpot-pla.png?maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9b11af57d2b0ba033e9df7b8aa23116c" alt="Jackpot-PLA" width="1600" height="663" data-path="images/scraping-automation/serp-api/parsing-search-results/jackpot-pla.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/jackpot-pla.png?w=280&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1740bc2fc04be9f68d5fb85c36f87cf6 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/jackpot-pla.png?w=560&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5fe4f3304acd52c84f36e3228172d0c9 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/jackpot-pla.png?w=840&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=675364d1fa519b8e666f49f3b33c78e2 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/jackpot-pla.png?w=1100&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=50d3e4455269bab45a669c56d15972d0 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/jackpot-pla.png?w=1650&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7492fb264cd7653d0aa3a57c1594c1c3 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/jackpot-pla.png?w=2500&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e149b70d236694556055618a1ed21d6b 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>

      <Accordion title="bottom_ads">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/bottom-ads.png?maxW=1600&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=5775b23e9a84e15179ed761b20fa0b2a" alt="Bottom-Ads" width="1600" height="599" data-path="images/scraping-automation/serp-api/parsing-search-results/bottom-ads.png" srcset="https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/bottom-ads.png?w=280&maxW=1600&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=50dfcee40dc3c90452aecab3027a3bde 280w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/bottom-ads.png?w=560&maxW=1600&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=7562a71402b1c905f6264f2c7306ddd8 560w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/bottom-ads.png?w=840&maxW=1600&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=e4948b9e1a6ab4f401432328481387b2 840w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/bottom-ads.png?w=1100&maxW=1600&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=9cc369a379be81dd84faf6356323aea2 1100w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/bottom-ads.png?w=1650&maxW=1600&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=913b5634c05ce552be7c7e890b6acad8 1650w, https://mintcdn.com/brightdata/YUhP5HZ1PAScLcu8/images/scraping-automation/serp-api/parsing-search-results/bottom-ads.png?w=2500&maxW=1600&auto=format&n=YUhP5HZ1PAScLcu8&q=85&s=f8006dbbf9e281a37fc94baaa5f2e890 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="people_also_ask">
    The `people_also_ask` section includes questions Google automatically generates based on queries it believes are related to your question.

    ### `answers`

    In a SERP,  the PAA box questions are connected to answers that users can click to read. This can help people better understand their initial question without clicking on other results. Each question here has its answer under the “answers” element.

    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-html.png?maxW=624&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1ee62cb886198ccedda1603cac220e88" alt="People-Also-Ask-HTML" width="624" height="502" data-path="images/scraping-automation/serp-api/parsing-search-results/people-also-ask-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-html.png?w=280&maxW=624&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8c21050f179d8b03c46cda9d9253d6fb 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-html.png?w=560&maxW=624&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=799739cc7c79ade14a42bf6414a56c87 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-html.png?w=840&maxW=624&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=cc8aef982d50f872dc94b7adae2fd8ac 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-html.png?w=1100&maxW=624&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=17b970ccfeeb72b0bbbb38edd3f4e5f9 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-html.png?w=1650&maxW=624&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7c1773a03f7f7e7093129af2dd9c5ed6 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-html.png?w=2500&maxW=624&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=45c87b5c616afa099d80545518952866 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-json.png?maxW=676&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9caac338374b7d71a2bf7e12227cf38d" alt="People-Also-Ask-JSON" width="676" height="634" data-path="images/scraping-automation/serp-api/parsing-search-results/people-also-ask-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-json.png?w=280&maxW=676&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d81f54264952e3da506eda9ecae8678e 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-json.png?w=560&maxW=676&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5eccce1c4bf05f9033f40ddd18d5fbfc 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-json.png?w=840&maxW=676&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9d7676898c77afdb4efd2714e9757186 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-json.png?w=1100&maxW=676&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=47f5dd5d9f8192204a02d7925c3ed440 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-json.png?w=1650&maxW=676&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=39642e2c03eb8ba7c7609b94f5145ae4 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/people-also-ask-json.png?w=2500&maxW=676&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=163d97360b3417a3aa1f5a0ece48cf85 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="videos">
    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-html.png?maxW=724&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b1cc197615658d63702de46f0cbf6f31" alt="Videos-HTML" width="724" height="639" data-path="images/scraping-automation/serp-api/parsing-search-results/videos-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-html.png?w=280&maxW=724&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d99f1d635795e58081972e4d8f7d34fd 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-html.png?w=560&maxW=724&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=44bbbd52596ca3279a88f979560ad25f 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-html.png?w=840&maxW=724&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=121d084d823b610aa64510822dd1dd52 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-html.png?w=1100&maxW=724&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=283fb4b38924329abd0eabe95a86911a 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-html.png?w=1650&maxW=724&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=94eb4ba92d9f32c998e063bfc66b7497 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-html.png?w=2500&maxW=724&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=4f5980a2fba6d1edfd11675b08978b70 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-json.png?maxW=703&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=636aad9d7e448c777ddb54cc60f6fd16" alt="Videos-JSON" width="703" height="648" data-path="images/scraping-automation/serp-api/parsing-search-results/videos-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-json.png?w=280&maxW=703&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b0866cab6f88ea62023307ec42bca59f 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-json.png?w=560&maxW=703&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1d4538ac5420815819469d55a6c70264 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-json.png?w=840&maxW=703&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ab89d45f07836b18f476340db538e590 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-json.png?w=1100&maxW=703&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ffcb4f19a6da15b8a861ef900295231b 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-json.png?w=1650&maxW=703&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=58d739c2fa839b2d72af4b0fe3227ed0 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/videos-json.png?w=2500&maxW=703&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b9531199244644f9f91cd97622e3cdd8 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="twitter">
    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-html.png?maxW=647&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a431398dc8e7add26dc845543727cc5f" alt="Twitter-HTML" width="647" height="301" data-path="images/scraping-automation/serp-api/parsing-search-results/twitter-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-html.png?w=280&maxW=647&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=aa5d9dc1ac9ce3437f8f9adc2a719db1 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-html.png?w=560&maxW=647&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7502cb4d548c15b5958905cb627c3fd3 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-html.png?w=840&maxW=647&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=cb6c1db0455a07c4dd7f8d94c3c2d491 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-html.png?w=1100&maxW=647&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f0f3558f36cf0b37a1dded8d7056a5b9 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-html.png?w=1650&maxW=647&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1f29040d4e865a0bc198133b84754c2c 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-html.png?w=2500&maxW=647&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8cd3d40cb39bed0040d9ce15ba525016 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-json.png?maxW=783&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d49417f7939f9b904eed91f7d848c696" alt="Twitter-JSON" width="783" height="559" data-path="images/scraping-automation/serp-api/parsing-search-results/twitter-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-json.png?w=280&maxW=783&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5dd11d532e40af8ae696c827f7524f31 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-json.png?w=560&maxW=783&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a1bff14a0bad521a1d5e61b8d0823a03 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-json.png?w=840&maxW=783&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d43f978f165070566ddd8e64d92841bc 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-json.png?w=1100&maxW=783&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a520c29f365efad2e5d52323627732f2 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-json.png?w=1650&maxW=783&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=cf1a72a601f1022e5fae50078f691c01 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/twitter-json.png?w=2500&maxW=783&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7eac6f3b1bef5ba281e053ebc1e55f36 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="top_stories">
    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-html.png?maxW=511&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d6e72070250cba8ce2f8343b0c9bbc8f" alt="Top-Stories-HTML" width="511" height="567" data-path="images/scraping-automation/serp-api/parsing-search-results/top-stories-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-html.png?w=280&maxW=511&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=6671caed4a8f40f6bb9575f7dd294dfd 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-html.png?w=560&maxW=511&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=519b91135d360a05fe36620f373fb3bf 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-html.png?w=840&maxW=511&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c0250c7bdda7469e0eac7459901988ab 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-html.png?w=1100&maxW=511&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=3dc90443282c4fd6824745c98e3bc131 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-html.png?w=1650&maxW=511&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=329547ccc19c949221719680c1fbe2ee 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-html.png?w=2500&maxW=511&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ca2f622e13d0fd3d55cb20e1a717cffd 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-json.png?maxW=786&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a679543ad933991dc01117fd7bb95561" alt="Top-Stories-JSON" width="786" height="536" data-path="images/scraping-automation/serp-api/parsing-search-results/top-stories-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-json.png?w=280&maxW=786&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7417f34c897ee2ea8da505f410f1f57f 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-json.png?w=560&maxW=786&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ca6954924897ac5d5ad2f8a4dd8f965d 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-json.png?w=840&maxW=786&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=19648fdf35913d98317018aa8a36167d 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-json.png?w=1100&maxW=786&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e77599bd408fbf0c6cbdf2a027cd74bc 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-json.png?w=1650&maxW=786&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=acaec31be92203d02a30726685a018ab 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/top-stories-json.png?w=2500&maxW=786&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=28edfc5a022f5e4b9a3a48e61448ea90 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="knowledge">
    Provides a brief overview of the searched topic in a knowledge panel (desktop- on the right side, mobile - at the top)

    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-html.png?maxW=479&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=af621c0bc698b6278ad35199dd3982fd" alt="Knowledge-HTML" width="479" height="520" data-path="images/scraping-automation/serp-api/parsing-search-results/knowledge-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-html.png?w=280&maxW=479&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=25203d7b8ce85b451baa60cc7d633865 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-html.png?w=560&maxW=479&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f76e3dd0ea7e804310b9e8585f03bb3b 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-html.png?w=840&maxW=479&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=36f3705a2554673a8d2f6a3af40df4ae 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-html.png?w=1100&maxW=479&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9f6a8984a69b0416af309d6a3f01096a 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-html.png?w=1650&maxW=479&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=dd6bf68d859bd8c55c511d727d36682c 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-html.png?w=2500&maxW=479&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=96b637c8e85b905ff661a1893fec8191 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-json.png?maxW=305&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ddf6b596685a4c029cba8a713cdf5313" alt="Knowledge-JSON" width="305" height="548" data-path="images/scraping-automation/serp-api/parsing-search-results/knowledge-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-json.png?w=280&maxW=305&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=300b7229d65a514c304ec286da3b97f9 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-json.png?w=560&maxW=305&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=31174a74338e54026a0c218dac41311f 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-json.png?w=840&maxW=305&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=06efcec60ec335337948134d3d57c86b 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-json.png?w=1100&maxW=305&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=69973b94c6deca05d2d88c8b1ca99fd7 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-json.png?w=1650&maxW=305&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=78d1f7bdce01502c943343533242ebda 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/knowledge-json.png?w=2500&maxW=305&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=df2d3ee2bb40f48ae1c039ef433235a0 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>

    ### `widgets`

    |                                           |                   |
    | ----------------------------------------- | ----------------- |
    | `knowledge.widgets.social_media_presence` | includes profiles |
    | `knowledge.widgets.sideways_refinements`  | people also ask   |
  </Accordion>

  <Accordion title="recipes">
    When searching for food items the SERP might contain also recipes

    <Frame>
            <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/recipes.png?maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=af99462ed7720260f2a1faf5e1c5848b" alt="Recipes" width="1600" height="491" data-path="images/scraping-automation/serp-api/parsing-search-results/recipes.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/recipes.png?w=280&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b00392c1a1f72f2f503c4f1fdfc37ddd 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/recipes.png?w=560&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ba3dffab2de388b7845a20e3b60c7a7c 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/recipes.png?w=840&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f390667ce473007a79b5d82a67827f5b 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/recipes.png?w=1100&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a459b39cd9b9db7ddcf25d548bb74ecd 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/recipes.png?w=1650&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=2f6336ff5ece2577bea8463f51c0311a 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/recipes.png?w=2500&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=71c6f8c7ed4c4eda8e211626b6cb16e2 2500w" data-optimize="true" data-opv="2" />
    </Frame>
  </Accordion>

  <Accordion title="snack_pack_map & snack_pack">
    Relates to the Google maps displayed in a SERP.

    ### `snack_pack_map`

    This map part is displayed in the JSON and includes the coordinates of the map location.

    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=cbea8ec3c762484bf1a70f2c1be0dbe4" alt="Snackpack-Map-HTML" width="687" height="718" data-path="images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=280&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f93d9faa6031d141243b598d49444b07 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=560&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1155ac85c51cb03cfab4591f0a74f638 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=840&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=70f2cac5aadfc3cc2a18fa2ded54f5e5 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=1100&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e8355c1d9009a0d5dcaa6ba77e9b046c 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=1650&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=865ebdaa73c7c56fe313f5305a450ca3 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=2500&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5911114035a7285265fab667d094ed63 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=3f6bc95cc6d5a74ea981723bd40b67c1" alt="Snackpack-Map-JSON" width="798" height="504" data-path="images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=280&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=72c606e73a275fc8a48afa70b3ec4d91 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=560&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ea60c7f4f6289508d18a3d5956a1865a 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=840&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8735ca6a9d68fd46344c03282da2a4ba 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=1100&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=47bd6bb41913695b7d956bb337a58962 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=1650&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9a1d0a2ca3feb2db2e98779f18bfd7cf 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=2500&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c8129be60b5793be346b90bf53d8891e 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>

    ### `snack_pack`

    If the map includes **pins** of specific locations, the JSON will include a `snack_pack` field for each location with additional details like open hours, contact details, tags etc.

    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=cbea8ec3c762484bf1a70f2c1be0dbe4" alt="Snackpack-HTML" width="687" height="718" data-path="images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=280&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f93d9faa6031d141243b598d49444b07 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=560&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1155ac85c51cb03cfab4591f0a74f638 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=840&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=70f2cac5aadfc3cc2a18fa2ded54f5e5 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=1100&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e8355c1d9009a0d5dcaa6ba77e9b046c 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=1650&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=865ebdaa73c7c56fe313f5305a450ca3 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-html.png?w=2500&maxW=687&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5911114035a7285265fab667d094ed63 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=3f6bc95cc6d5a74ea981723bd40b67c1" alt="Snackpack-JSON" width="798" height="504" data-path="images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=280&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=72c606e73a275fc8a48afa70b3ec4d91 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=560&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ea60c7f4f6289508d18a3d5956a1865a 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=840&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8735ca6a9d68fd46344c03282da2a4ba 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=1100&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=47bd6bb41913695b7d956bb337a58962 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=1650&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9a1d0a2ca3feb2db2e98779f18bfd7cf 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/snack-pack-map-json.png?w=2500&maxW=798&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c8129be60b5793be346b90bf53d8891e 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="related">
    At the bottom of SERPs, Google also provides users with a “related searches” portion, prompting other search queries related to the initial search.

    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-html.png?maxW=691&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=12fb8fd40a2c0020a09d51040aaa74c2" alt="Related-HTML" width="691" height="301" data-path="images/scraping-automation/serp-api/parsing-search-results/related-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-html.png?w=280&maxW=691&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ee4ef791d80f83d196c0d55e481ba0e3 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-html.png?w=560&maxW=691&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=bde83b511832dbcd5cb978e392eea11d 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-html.png?w=840&maxW=691&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=bee987ab5aa7c39a4f537910f2b8bfc9 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-html.png?w=1100&maxW=691&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1299a7977367f8cb54c21b801d86864e 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-html.png?w=1650&maxW=691&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=eb93dbff38f159a7a6208f187e911159 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-html.png?w=2500&maxW=691&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=760121c146f09def60147ba8f279c3b1 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-json.png?maxW=680&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c30a5629704c66c035dc28b377e0c3e9" alt="Related-JSON" width="680" height="688" data-path="images/scraping-automation/serp-api/parsing-search-results/related-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-json.png?w=280&maxW=680&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f6585c4b26163bd5fedb993daad2eb32 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-json.png?w=560&maxW=680&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ea8b55e1e7527b2b8a68a6797cb4dc5d 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-json.png?w=840&maxW=680&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a924b35121745b64c7b371b5b5b4d27f 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-json.png?w=1100&maxW=680&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e42e84377cb8b3f283d5ed0494013fe1 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-json.png?w=1650&maxW=680&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=91ada88068170fffc38b948316ec23a4 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/related-json.png?w=2500&maxW=680&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=4e6345e7fe449f3471227e4696126246 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>

    <Note>
      | `List_group` | Description                                                                   |
      | ------------ | ----------------------------------------------------------------------------- |
      | `true`       | when the elements are grouped as at the top of the following screenshot       |
      | `false`      | when the elements aren't grouped as at the bottom of the following screenshot |

      <Frame>
                <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/list-group.png?maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=90febdf89882a6f92dfddeac4e90ea83" alt="List-Group" width="1600" height="520" data-path="images/scraping-automation/serp-api/parsing-search-results/list-group.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/list-group.png?w=280&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=128c3d7b329efe00a0187404e984e2e6 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/list-group.png?w=560&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b38b2c3216f5cef8adc01c7aec106f73 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/list-group.png?w=840&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=0a87a9bdec90acba1284b958ef0602d2 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/list-group.png?w=1100&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5cbfa31b4a310992ed7e0fd3566086e6 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/list-group.png?w=1650&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=2c5553f18605ed6cbe4cbfb7a140af2a 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/list-group.png?w=2500&maxW=1600&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=fa645c6f5f647354648bf4dc1c734c91 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Note>
  </Accordion>

  <Accordion title="flights">
    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-html.png?maxW=517&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=4ce78d0969174687fe396bc3036d710f" alt="Flights-HTML" width="517" height="379" data-path="images/scraping-automation/serp-api/parsing-search-results/flights-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-html.png?w=280&maxW=517&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b6f2e1d24005121d65a74d3f924497ca 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-html.png?w=560&maxW=517&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a37abce23f2697ec0afe0b54457607a9 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-html.png?w=840&maxW=517&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=6de564bb8fc76c9480c9113bed2c393e 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-html.png?w=1100&maxW=517&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=65c6ac60875e70fe819f319954d800a2 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-html.png?w=1650&maxW=517&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b254f8f3c8472fa94db7e9b3a534645d 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-html.png?w=2500&maxW=517&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1a716dcb93e01894f64ce03027fce733 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-json.png?maxW=771&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c252435942c8cfcd0205202ea247b309" alt="Flights-JSON" width="771" height="560" data-path="images/scraping-automation/serp-api/parsing-search-results/flights-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-json.png?w=280&maxW=771&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=6a5d876a9aba45e8a107eecc8ce39814 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-json.png?w=560&maxW=771&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d3ccb85a6d086114c754593a5cad00fb 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-json.png?w=840&maxW=771&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=22bd3e74e6d437ce344b47a67370f1dc 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-json.png?w=1100&maxW=771&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7ba83dbb19e6aca9645d7e89f24ef7dc 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-json.png?w=1650&maxW=771&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=83c82254827ab345bf051a196808668f 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/flights-json.png?w=2500&maxW=771&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=05dbe370dec926f8cb7ee98dbe9b41fd 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="hotels">
    Bright Data's SERP API makes it easy to collect hotel data, like prices, availability, reviews, and more.

    Here's how to collect the data from the hotel knowledge graph using Google Search and how to get even more details from the hotel page on Google Travel.

    When you search for a hotel using Google Search, its details and reviews appear in the resulting knowledge graph on the right.

    <Frame>
            <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=65a519d4d1df376be92072f37e960564" alt="Hotels-HTML" width="1485" height="825" data-path="images/scraping-automation/serp-api/parsing-search-results/hotels-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=280&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ea51010d652f7efb5fc2e53f7f9c2b3d 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=560&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e53526df0ebde2a6e5585a80b88c8925 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=840&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=239d278dd1edd6249281f2c725600f54 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=1100&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=948e3112a099ec78602f0c4169bb55d6 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=1650&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9e47d7829affa1e15fb7f963d55a827c 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-html.png?w=2500&maxW=1485&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=afe375ec32d8742412037efe2a68cd87 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    Setting arrival and departure dates along with the number of guests lets you see and compare some of the hotel's prices.

    With SERP API, you can set these fields to collect different price combinations using dedicated parameters.

    <Frame>
            <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=18fa40bdcd198e4d337ccb5301902634" alt="Hotels-Availability" width="548" height="666" data-path="images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=280&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=55ad6ed979ae83dcbbdc244da9856b96 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=560&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=75d638ee411bca2c0cd3aa33c51754b5 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=840&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b053d968ea76d60b4cfa30860de4f7ad 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=1100&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f6b7e3482c9b500e8f4bfd5f5e8efe5b 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=1650&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1d1d2097689da1396849b05b074526bd 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/hotels-availability.png?w=2500&maxW=548&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ce827ec1b01d6a89cbb5e127939d9c9c 2500w" data-optimize="true" data-opv="2" />
    </Frame>

    The SERP API also lets you target the hotel page in Google Travel, where you can find more prices and search by more 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. Go to the [API Guide](https://brightdata.com/cp/serp_api/api/google/hotels) to learn more.
  </Accordion>

  <Accordion title="pagination">
    <Tabs>
      <Tab title="HTML">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-html.png?maxW=533&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=28427e8a436f0b63b00f02e91c6333f0" alt="Pagination-HTML" width="533" height="138" data-path="images/scraping-automation/serp-api/parsing-search-results/pagination-html.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-html.png?w=280&maxW=533&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f94521f0a0d2e6eddd883642c4595fd9 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-html.png?w=560&maxW=533&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ce8a921b6cd44cd9b46b6f5b448e7333 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-html.png?w=840&maxW=533&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=624fead96dcbd78eb058c5dc9caf7456 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-html.png?w=1100&maxW=533&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=585194aee30f7861c5f3ee040ef630f5 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-html.png?w=1650&maxW=533&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8bf39e70eb8fe57a5c0f15c4f9c576bc 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-html.png?w=2500&maxW=533&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f0796ba6c9f9e7dc478a15a747fa0e79 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>

      <Tab title="JSON">
        <Frame>
                    <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-json.png?maxW=566&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=e9690b38b9cb43ceffb34dc8acb70429" alt="Pagination-JSON" width="566" height="508" data-path="images/scraping-automation/serp-api/parsing-search-results/pagination-json.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-json.png?w=280&maxW=566&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ed7bea5e663bd41d15c010fe2f4d56da 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-json.png?w=560&maxW=566&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=c515193ef2930c850b21c38f9a8bd0d8 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-json.png?w=840&maxW=566&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=57ff9dcc47155e573f52424f3d07be7b 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-json.png?w=1100&maxW=566&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=39fa0798ac5fdb620259f66b76bf2d21 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-json.png?w=1650&maxW=566&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=fbafbb09a6f2da70283e5c6c33d45bb1 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/parsing-search-results/pagination-json.png?w=2500&maxW=566&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=ec0e42243806ee981004605d872cb9ac 2500w" data-optimize="true" data-opv="2" />
        </Frame>
      </Tab>
    </Tabs>

    Pagination indexes can be found in the bottom JSON section:

    |                                          |                                                          |
    | ---------------------------------------- | -------------------------------------------------------- |
    | `current_page`                           | the requested page location within the search            |
    | `first_page_link`                        | Link of the first page                                   |
    | `prev_page_link`<br />`next_page_link`   | referring to requested page                              |
    | `prev_page_start`<br />`next_page_start` | first searched results number in previous and next pages |
    | `prev_page`<br />`next_page`             | number of pages for previous and next pages              |
    | `page`                                   | page number                                              |
    | `link`                                   | link to page                                             |
    | `start`                                  | first result in the page                                 |
  </Accordion>

  <Accordion title="AI Overview">
    \###`ai_overview`

    Google's Generative [AI Overviews](/scraping-automation/serp-api/query-parameters/google#ai-overview) are shown on various SERPs when the query aligns with topics Google considers suitable for generative answers.

    <Frame>
            <img src="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/scraping-automation/serp-api/parsing-search-results/serp-ai-overview.png" alt="Hotels-HTML" />
    </Frame>

    ## AI Overviews Response Example Schema

    <CodeGroup>
      ```sh Exists
      {
        "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 Error: Doesn't exist
      {
        "ai_overview": {
          "error": "AI Overview did not appear on original SERP"
        }
      }
      ```
    </CodeGroup>
  </Accordion>
</AccordionGroup>

## Light Parser for Google

Add the `x-unblock-data-format: parsed_light` header to your HTTP requests.

* Focus on Top 10 results: Extracts only the top 10 organic search results from Google.
* Optimized speed: Approximately 50% faster latency compared to standard parsing.

<CodeGroup>
  ```sh Direct API
  # Returns a single parsed JSON 
  curl -k --proxy brd.superproxy.io:33335 --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"

  ```

  ```sh Native Proxy Interface
  # Returns a single parsed JSON 

  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",
    "headers": {
      "x-unblock-data-format": "parsed_light"
    }
  }'

  ```

  ```sh JSON Response
  {
  "organic": [
      {
          "link": "https://en.wikipedia.org/wiki/Pizza",
          "title": "Pizza",
          "description": "an Italian, specifically Neapolitan, dish typically consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients",
          "extensions": [
              {
                  "type": "site_link",
                  "link": "https://en.wikipedia.org/wiki/Pizzeria",
                  "text": "Pizzeria"
              },
              {
                  "type": "site_link",
                  "link": "https://en.wikipedia.org/wiki/Neapolitan_pizza",
                  "text": "Neapolitan pizza"
              },
              {
                  "type": "site_link",
                  "link": "https://en.wikipedia.org/wiki/Pizza_Margherita",
                  "text": "Pizza Margherita"
              },
              {
                  "type": "site_link",
                  "link": "https://en.wikipedia.org/wiki/Pizza_marinara",
                  "text": "Pizza marinara"
              }
          ],
          "global_rank": 1
      },
      {
          "link": "https://www.tripadvisor.com/Restaurants-g293763-c31-Luanda_Luanda_Province.html",
          "title": "THE 10 BEST Pizza Places in Luanda (Updated 2025)",
          "description": "Pizza il Forno serves delicious pizza, with a thin crust and fresh ingredients... Good pizza in loud surroundings ┬╖ 2. O Toscano. 3.8. (24 ...",
          "global_rank": 2
      },
      {
          "link": "https://debonairspizza.co.ao/",
          "title": "Debonairs Pizza Angola ΓÇô Pizza Sit Down & Delivery Eatery",
          "description": "A Nossa Hist├│ria ┬╖ Nossas Lojas ┬╖ Promessa de Qualidade. Vamos Conversar. Atendimento ao Cliente ┬╖ Encontre um restaurante.",
          "global_rank": 6
      },
      {
          "link": "https://www.foodandwine.com/cooking-techniques/pizza-guide",
          "title": "The F&W Guide to Making Pizza at Home",
          "description": "Apr 29, 2025 ΓÇö A super-flavorful and forgiving pizza dough is the key to pro-level pies. Food & Wine Test Kitchen pros share each step for making and ...",
          "global_rank": 7
      },
      {
          "link": "https://www.youtube.com/watch?v=4mA54Uy3YGY&pp=0gcJCfwAo7VqN5tD",
          "title": "Classic New York Pizza At Home",
          "description": "This is everything you want in New York-style pizza: a crispy crust, a light, foldable center, and bubbling cheese ΓÇö all made right at home.",
          "global_rank": 8
      },
      {
          "link": "https://www.pizzahut.com/",
          "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
          "description": "Large Hut Lover's Pizzas. $12.99 each. Limited time only. Additional charge for extra toppings, Pan crust, Stuffed crust, and extra cheese.",
          "global_rank": 9
      },
      {
          "link": "https://www.bbcgoodfood.com/recipes/pizza-margherita-4-easy-steps",
          "title": "Pizza Margherita in 4 easy steps recipe",
          "description": "Even a novice cook can master the art of perfect pizza with our step-by-step guide. This homemade pizza recipe features a simple pizza dough and toppings.",
          "global_rank": 10
      },
      {
          "link": "https://www.facebook.com/PizzaHutAngola/",
          "title": "Pizza Hut Angola | Luanda",
          "description": "RODÍZIO PIZZA HUT: ✓Pizzas Ilimitadas ✓Entrada ✓Sobremesa Tudo isso por apenas 15.900Kz por pessoa! Junta os teus, senta, relaxa e deixa a pizza vir até ti.",
          "global_rank": 11
      },
      {
          "link": "https://www.instagram.com/debonairspizza_ao/?hl=en",
          "title": "Debonairs Pizza Angola 🇦🇴 (@debonairspizza_ao)",
          "description": "Refeição de Valor Uma Pizza pequena de frango ou carne com uma bebida por apenas 3450Kz! Visite-nos no centro shoprite mais perto de ti, aberto todos os dias ...",
          "global_rank": 12
      }
  ],
  "videos": [
      {
          "link": "https://www.youtube.com/watch?v=HLfRhp4EGlo",
          "title": "SECRET TO CRISPY PIZZA AT HOME | ONLY PIZZA RECIPE ...",
          "global_rank": 3
      },
      {
          "link": "https://www.youtube.com/watch?v=4mA54Uy3YGY",
          "title": "Classic New York Pizza At Home",
          "global_rank": 4
      },
      {
          "link": "https://www.youtube.com/watch?v=ICHxQHsf7E4",
          "title": "Creative Pizza Making (Neapolitan Pizzette)",
          "global_rank": 5
      }
  ]
  }

  ```
</CodeGroup>


# SERP API Bing Query Parameters
Source: https://docs.brightdata.com/scraping-automation/serp-api/query-parameters/bing

Configure Bing search queries with Bright Data's SERP API, including parameters for localization, geo-location, pagination, device targeting, and custom data output options.

<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
    curl --proxy brd.superproxy.io:33335 --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
    curl --proxy brd.superproxy.io:33335 --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
    curl --proxy brd.superproxy.io:33335 --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
    curl --proxy brd.superproxy.io:33335 --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`

    A number of search results to return in the response. The default is 10 and the maximum value is 50. The actual number delivered may be less than requested.

    > #### Examples:
    >
    > `count=30` - request 30 results \
    > `count=50` - request 50 results

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&count=50"
    ```

    ### `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
    curl --proxy brd.superproxy.io:33335 --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
    curl --proxy brd.superproxy.io:33335 --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
    curl --proxy brd.superproxy.io:33335 --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
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&brd_browser=chrome"
    ```
  </Accordion>

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

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

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

    ```sh
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza?brd_json=1"
    ```
  </Accordion>
</AccordionGroup>


# SERP API DuckDuckGo Query Parameters
Source: https://docs.brightdata.com/scraping-automation/serp-api/query-parameters/duckduckgo

Configure DuckDuckGo search queries with Bright Data's SERP API, including parameters for localization, safe search, time range, and device targeting, tailored to meet your data extraction needs.

## 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
    curl --proxy brd.superproxy.io:33335 --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
    curl --proxy brd.superproxy.io:33335 --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
    curl --proxy brd.superproxy.io:33335 --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 2 weeks \
    > `w` - Past month \
    > `m` - Past 3 months \
    > `w` - Past 6 months

    ```sh
    curl --proxy brd.superproxy.io:33335 --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
    curl --proxy brd.superproxy.io:33335 --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
    curl --proxy brd.superproxy.io:33335 --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 Google search, maps, trends, reviews, lens, hotels, and flights with Bright Data's SERP API, including parameters for localization, pagination, device type, parsing, and more.

## Search

<AccordionGroup>
  <Accordion title="Localization" icon="flag">
    <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
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/hotels+new+york/?gl=us"
    ```

    ***

    ### `hl`

    Two-letter language code used to define the page languages

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

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

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

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

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

    ### `ibp`

    Use the `ibp` parameter for Jobs search type.

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

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

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

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

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

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

    ***

    ### `num`

    Defines the number of results to return.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    ***

    ### `hotel_dates`

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

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

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

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

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

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

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

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

    ### `multi`

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

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

    To initiate a request, perform:

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

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

    ```sh
    curl -v --compressed "https://api.brightdata.com/serp/get_result?customer=<customer-id>&zone=<zone-name>&response_id=${RESPONSE_ID}" -H "Authorization: Bearer API_KEY"
    ```
  </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
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=does+honey+ever+expire&brd_ai_overview=2"
    ```
  </Accordion>
</AccordionGroup>

## Maps

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

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

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

    ***

    ### `hl`

    Two-letter language code used to define the page languages

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

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

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

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

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

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

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

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

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

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

    ***

    ### `num`

    Defines the number of results to return.

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

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

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

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

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

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

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

    Accomodation type: Hotels or Vacation Rentals.

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

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

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

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

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

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

## Trends

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

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

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

    #### `timeseries`

    #### `geo_map`

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

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

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

    Location of interest, two-letter country code

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

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

    Preferred language, two-letter language code

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

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

    Time range to search.

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

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

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

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

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

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

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

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

## Reviews

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

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

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

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

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

    Preferred language, two-letter language code

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

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

    The way reviews are sorted.

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

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

    ### `filter`

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

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

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

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

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

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

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

    ### `num`

    Defines the number of results to return.

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

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

## Lens

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

    URL of image you want to search

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

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

    Preferred language, two-letter language code

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

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

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

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

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

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

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

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

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

    The `brd_lens` parameter in your request fetches specific Google Lens **tab results** by specifying a tab value (e.g. `products`, `homework`, `visual_matches`, `exact_matches`).
        <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/query_parameters/Google_Lens_Tab_paramater_brd_lens.png?maxW=1399&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=edff5f4f9bee2570c2c9cd986bd9c6d2" alt="brd_lens" width="1399" height="605" data-path="images/scraping-automation/serp-api/query_parameters/Google_Lens_Tab_paramater_brd_lens.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/query_parameters/Google_Lens_Tab_paramater_brd_lens.png?w=280&maxW=1399&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=d962bdcba834c8c0383967bbc021ef89 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/query_parameters/Google_Lens_Tab_paramater_brd_lens.png?w=560&maxW=1399&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1498fafef7526bf289eba80f8706e469 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/query_parameters/Google_Lens_Tab_paramater_brd_lens.png?w=840&maxW=1399&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=df810f498e026dcf98788fd8219a7d74 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/query_parameters/Google_Lens_Tab_paramater_brd_lens.png?w=1100&maxW=1399&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=0f9ea0f33af1b3f93179ab5de8a60203 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/query_parameters/Google_Lens_Tab_paramater_brd_lens.png?w=1650&maxW=1399&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=56bf03de798b5061f09704a92a0b1b2e 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/query_parameters/Google_Lens_Tab_paramater_brd_lens.png?w=2500&maxW=1399&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=8fb2bceb368577273dfb00d94c93e117 2500w" data-optimize="true" data-opv="2" />

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

## Hotels

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

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

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

    ### `hl`

    Two-letter language code used to define the page language

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

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

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

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

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

    ### `brd_occupancy`

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

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

    Also supports a comma-separated list of integers where:

    * first value is a number of adult guests

    * subsequent values are ages of children

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

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

    ### `brd_free_cancellation`

    Show only offers with free cancellation.

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

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

    ### `brd_accomodation_type`

    Accomodation type: Hotels or Vacation Rentals.

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

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

    ### `brd_currency`

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

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

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

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

    Define what device type to be represented in user-agent

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

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

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

    ### `brd_json`

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

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

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

## Flights

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

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

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

    ### `hl`

    Two-letter language code used to define the page language

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

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

    String representing flight search parameters

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

    ### `curr`

    Defines the currency of returned prices

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


# SERP API Yandex Query Parameters
Source: https://docs.brightdata.com/scraping-automation/serp-api/query-parameters/yandex

Explore Yandex query parameters for SERP API, including localization, pagination, time range, and device targeting, to optimize your search results efficiently.

## Search

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

    Region or country to search.

    > #### Examples:
    >
    > `1` - Moscow \
    > `2` - Saint-Petersburg \
    > `84` - USA \
    > `95` - Canada \
    > `134` - China

    ```sh
    curl --proxy brd.superproxy.io:33335 --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
    curl --proxy brd.superproxy.io:33335 --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
    curl --proxy brd.superproxy.io:33335 --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
    curl --proxy brd.superproxy.io:33335 --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
    curl --proxy brd.superproxy.io:33335 --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
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.yandex.com/search/?text=pizza&brd_browser=chrome"
    ```
  </Accordion>
</AccordionGroup>


# How to Get Started with SERP API
Source: https://docs.brightdata.com/scraping-automation/serp-api/quickstart

Get started quickly with Bright Data's SERP API by following these simple steps. Sign in, create your proxy, and verify your account to begin collecting search engine data effortlessly.

<Tip>
  if you haven't yet signed up for Bright Data, you can [sign up for
  free](https://brightdata.com/), and when adding your payment method, you'll
  receive a \$5 credit to get you started!
</Tip>

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

  <Step title={<>Navigate to <a href="https://brightdata.com/cp/zones">My Zones</a></>}>
    {/* In [My Zones](https://brightdata.com/cp/zones) page, under `Residential Proxies` click `Get started` */}

    <Accordion title="In My Zones page, under SERP API click Get started">
      <Warning>
        If you already have an active proxy, simply choose **Add** at the top right corner
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/get-started.png?maxW=846&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f78109e376c33dcb1a852caedec55ef4" alt="Get Started" width="846" height="911" data-path="images/scraping-automation/serp-api/quick-start/get-started.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/get-started.png?w=280&maxW=846&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=83396e664721aa5063f93125eb9fcc00 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/get-started.png?w=560&maxW=846&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5d95d3e6a2358e56899f66407fdb4044 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/get-started.png?w=840&maxW=846&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7dd11ed02ede86bd8ea68f147d0e2770 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/get-started.png?w=1100&maxW=846&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=3f0978b511859486364348a5c6d14c18 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/get-started.png?w=1650&maxW=846&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=7336cb3c61286fb6a24860b57e235e7b 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/quick-start/get-started.png?w=2500&maxW=846&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=a6910bf71137179337b30434a4bf2dda 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="Assign a name to your SERP API">
    <Warning>
      Please select a meaningful name, as the zone's name cannot be changed once created.
    </Warning>
  </Step>

  <Step title="Click Add" />
</Steps>

<Accordion title="Before continuing, verify your account">
  If you haven’t yet added a payment method, you’ll be prompted to add one at this point to verify your account. If it’s your first time using Bright Data, then you’ll also receive a \$5 bonus credit to get you started!

  <Tip>
    You will not be charged anything at this point and this is solely for verification purposes
  </Tip>
</Accordion>

<Note>
  Don't worry, we'll cover all the configurations in the next section [Configure your Proxy](/scraping-automation/serp-api/configuration)
</Note>


# Send Your First Request with Bright Data's SERP API
Source: https://docs.brightdata.com/scraping-automation/serp-api/send-your-first-request

A step-by-step guide to sending your first SERP API request with easy-to-follow code examples

## Make your first request in minutes

Test the SERP API in minutes with this ready-to-use code example.

<CardGroup cols={3}>
  <Card title="Postman Example" icon="user-astronaut" iconType="regular" href="https://www.postman.com/bright-data-api/bright-data-api/request/kpq952m/google-search" cta="Try SERP API in less than 1 minute" />

  <Card title="Node.js Example" icon="code" iconType="regular" href="https://github.com/luminati-io/bright-data-serp-api-nodejs-project" cta="Try SERP API in less than 2 minutes" />

  <Card title="Python Example" icon="code" iconType="regular" href="https://github.com/luminati-io/bright-data-web-unlocker-python-project" cta="Try SERP API in less than 5 minutes" />
</CardGroup>

Bright Data offers two methods for accessing SERP API, both delivering **identical** results while catering to different customer workflows:

<CardGroup cols={2}>
  <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.

### Best for:

* 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](https://docs.brightdata.com/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 src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/send-your-first-request/serp_api_zone_overview_code_example.png?maxW=1504&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=b9e1456d55f468bd2b6f26abe51ac813" alt="SERP API Overview tab" width="1504" height="831" data-path="images/scraping-automation/serp-api/send-your-first-request/serp_api_zone_overview_code_example.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/send-your-first-request/serp_api_zone_overview_code_example.png?w=280&maxW=1504&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=2ab38db162276592e743f66ac8e6f280 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/send-your-first-request/serp_api_zone_overview_code_example.png?w=560&maxW=1504&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=5602fa052eeef576cc690e366e2dd1ed 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/send-your-first-request/serp_api_zone_overview_code_example.png?w=840&maxW=1504&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=bdd6aeb6e265b737ec1fd4ba79da521c 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/send-your-first-request/serp_api_zone_overview_code_example.png?w=1100&maxW=1504&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1bcab4d0d9346a90c2f90970cd26ae82 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/send-your-first-request/serp_api_zone_overview_code_example.png?w=1650&maxW=1504&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=209f01ce029bdd91f9828081541341aa 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/send-your-first-request/serp_api_zone_overview_code_example.png?w=2500&maxW=1504&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=2ca89f035caee5160e4980e139d19990 2500w" data-optimize="true" data-opv="2" />
</Frame>

The following is an example of a simple SERP API cURL request:

```sh Direct API access - cURL

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 src="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/send-your-first-request/serp_api_zone_overview_api_token.png?maxW=1504&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=9498382eb6016d4261fd9b9e10c5beba" alt="SERP API key" width="1504" height="831" data-path="images/scraping-automation/serp-api/send-your-first-request/serp_api_zone_overview_api_token.png" srcset="https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/send-your-first-request/serp_api_zone_overview_api_token.png?w=280&maxW=1504&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=f4def9dde00b69136b806cebadbabe1e 280w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/send-your-first-request/serp_api_zone_overview_api_token.png?w=560&maxW=1504&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=836dccdfa519f837b2f8300dbebfc6af 560w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/send-your-first-request/serp_api_zone_overview_api_token.png?w=840&maxW=1504&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=aa8423b7e08928e0f4d9849eaf532020 840w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/send-your-first-request/serp_api_zone_overview_api_token.png?w=1100&maxW=1504&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=53cfe8d13ba48db17dff384c7fe7de87 1100w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/send-your-first-request/serp_api_zone_overview_api_token.png?w=1650&maxW=1504&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=99f9efbbae9688113ba16e0eec823a6d 1650w, https://mintcdn.com/brightdata/_dGTsheeDiM8MlIC/images/scraping-automation/serp-api/send-your-first-request/serp_api_zone_overview_api_token.png?w=2500&maxW=1504&auto=format&n=_dGTsheeDiM8MlIC&q=85&s=1377eed93a87827418164e849f7862d5 2500w" data-optimize="true" data-opv="2" />
</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

#### 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 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
  curl "https://www.google.com/search?q=pizza" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> -k
  ```

  ```js Node.js
  #!/usr/bin/env node

  require('request-promise')({
      url: 'https://www.google.com/search?q=pizza',
      proxy: 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:33335',
    })
    .then(function (data) {
        console.log(data);
      },
      function (err) {
        console.error(err);
      });
  ```

  ```python Python
  import pprint
  import requests


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

  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

  <?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:33335');
  curl_setopt($curl, CURLOPT_PROXYUSERPWD, 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>');
  curl_exec($curl);
  ?>
  ```

  ```ruby Ruby
  #!/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', 33335, '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#
  using System;
  using System.Net;

  class Example {
    static void Main() {
      var client = new WebClient();
      client.Proxy = new WebProxy("brd.superproxy.io:33335");
      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
  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", 33335);
          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
  #!/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:33335");
  print $agent->get('https://www.google.com/search?q=pizza')->content();
  ```

  ```vb VBA
  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:33335")
          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>


# Unlocker API Configuration
Source: https://docs.brightdata.com/scraping-automation/web-unlocker/configuration

Configure Unlocker API with Premium Domains, Geolocation, and advanced settings for custom headers, cookies, and auto-throttling.

## Premium Domains

Some domains are more challenging to unblock than others, so we offer a separate premium pricing tier for [these domains](https://docs.brightdata.com/scraping-automation/web-unlocker/features#current-list-of-premium-domains). 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 differently. Requests to other domains will be kept at the default lower tier.</Note>

## Advanced options

### Asynchronous requests

Requests are handled seamlessly in the background, allowing you to collect responses at a later more convenient time via a designated endpoint, increasing stability, flexibility, and efficiency.

Learn more about [asynchronous requests](/scraping-automation/serp-api/asynchronous-requests).

### Custom Unlocker API

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

#### Allow custom Headers & Cookies

1. Access Your Control Panel: Log in to your Bright Data control panel.
2. Select Your Zone: Choose the specific zone where you want to enable this feature.
3. Enable the Feature: Under **Advanced Options**, find and activate the 'Custom headers & cookies' permission within the zone settings.

#### Control Over Auto-Throttling

Unlocker API includes an auto-throttling mechanism designed to maintain efficient scraping and performance. This system operates as follows:

<Tabs>
  <Tab title="Automatic Adjustment">
    The system automatically searches for and implements better-performing configurations.
  </Tab>

  <Tab title="Upon Low Success Rates">
    If the success rate for any given target site falls below a certain percentage, the system will begin to throttle requests. This is to avoid wasting resources on configurations that are failing.
  </Tab>

  <Tab title="Customizable Threshold">
    The default threshold for this mechanism is set at 70%.

    However, with the 'Custom headers & cookies' permission enabled, you have the flexibility to adjust this threshold to any percentage you prefer, especially since you'll be charged for all requests regardless of their success.
  </Tab>
</Tabs>


# Web Unlocker API Features
Source: https://docs.brightdata.com/scraping-automation/web-unlocker/features

Explore Web Unlocker API's advanced features like CAPTCHA solving, Premium Domains, Headers & Cookies management, and Browser Rendering for efficient web scraping.

## 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 src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/automatic-captcha-solving.png?maxW=641&auto=format&n=ilemiSHw8UogZ13k&q=85&s=aa4d095fa9c18fce9431567328be7dcf" alt="automatic-captcha-solving.png" width="641" height="325" data-path="images/scraping-automation/web-unlocker/features/automatic-captcha-solving.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/automatic-captcha-solving.png?w=280&maxW=641&auto=format&n=ilemiSHw8UogZ13k&q=85&s=73e6e2fc5095e7ba859092515281be5a 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/automatic-captcha-solving.png?w=560&maxW=641&auto=format&n=ilemiSHw8UogZ13k&q=85&s=445c66ea23792faaf804d05957fa693d 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/automatic-captcha-solving.png?w=840&maxW=641&auto=format&n=ilemiSHw8UogZ13k&q=85&s=98dc7b0b67de5a674fc8427f20eec23f 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/automatic-captcha-solving.png?w=1100&maxW=641&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d72e63cb53a636795079a97c756b8d33 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/automatic-captcha-solving.png?w=1650&maxW=641&auto=format&n=ilemiSHw8UogZ13k&q=85&s=bbdbcf1cf27c9918daffb3af1886c4b3 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/automatic-captcha-solving.png?w=2500&maxW=641&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f794f9ed48797cb284185caa4031c8b2 2500w" data-optimize="true" data-opv="2" />
  </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 id="premium_domains">
    Loading...
  </div>
</Accordion>

### Enable Premium Domains

When creating your Web Unlocker API zone, check the 'Premium Domains' box under Special features

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/premium-domains.png?maxW=692&auto=format&n=ilemiSHw8UogZ13k&q=85&s=86bc0a8a214124210be7da8fa946771b" alt="Enable Premium Domains" width="692" height="901" data-path="images/scraping-automation/web-unlocker/features/premium-domains.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/premium-domains.png?w=280&maxW=692&auto=format&n=ilemiSHw8UogZ13k&q=85&s=e078cee2cf9a56b28f469ce6c8082d65 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/premium-domains.png?w=560&maxW=692&auto=format&n=ilemiSHw8UogZ13k&q=85&s=b642616148ed6cbf2e4e04cd6539aff9 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/premium-domains.png?w=840&maxW=692&auto=format&n=ilemiSHw8UogZ13k&q=85&s=d943446e458229aa3570f212a923dabe 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/premium-domains.png?w=1100&maxW=692&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6100978e8bbe401b70c6e624a60831a3 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/premium-domains.png?w=1650&maxW=692&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9c6011c1e999eaa34b745675e50652ec 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/premium-domains.png?w=2500&maxW=692&auto=format&n=ilemiSHw8UogZ13k&q=85&s=fbc09354d928a3857e32fd85af89a300 2500w" data-optimize="true" data-opv="2" />
</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](https://docs.brightdata.com/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
  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
  curl -vk \
      -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:33335 \
      -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
  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
  curl -k \
      -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:33335 \
      -H 'x-unblock-data-format: screenshot' \
      https://example.com > example_com.png
  ```
</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.

#### Custom features:

* [Manual headers & cookies](/scraping-automation/web-unlocker/features#manual-headers-and-cookies)
* [Manual ‘expect’ elements](/scraping-automation/web-unlocker/features#manual-expect-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 src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/custom-expect.png?maxW=696&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6dd81332d89062996bbb4fbec7b349f3" alt="Enable Premium Domains" width="696" height="389" data-path="images/scraping-automation/web-unlocker/features/custom-expect.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/custom-expect.png?w=280&maxW=696&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a8227fded8bdf05e5281a2ea55b70380 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/custom-expect.png?w=560&maxW=696&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6fc17ed1e93f0e50c1b5f00697c22157 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/custom-expect.png?w=840&maxW=696&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f608d4d6d6db1c0ab65ab25073b5cba8 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/custom-expect.png?w=1100&maxW=696&auto=format&n=ilemiSHw8UogZ13k&q=85&s=b8cf1c137ff29f9faaf886dd5d3da6f6 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/custom-expect.png?w=1650&maxW=696&auto=format&n=ilemiSHw8UogZ13k&q=85&s=cc782db5a9f5278b5a99911f7a2d8a22 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/custom-expect.png?w=2500&maxW=696&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9515263b191fd63877be39cebd507157 2500w" data-optimize="true" data-opv="2" />

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) procedure.

#### Billing

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 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
  curl -vk \
      -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:33335 \
      -H 'x-unblock-expect: {"element": ".some-css-selector"}' \
      https://example.com
  ```

  ```shell Page must include text
  curl -vk \
      -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:33335 \
      -H 'x-unblock-expect: {"text": "items in stock"}' \
      https://example.com
  ```
</CodeGroup>

### Amazon-specific geolocation headers

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.

<CodeGroup>
  ```shell Example
  curl -vk \
  -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:33335 \
  -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 src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/Traffic.png?maxW=1450&auto=format&n=ilemiSHw8UogZ13k&q=85&s=2703844db1f3e3f93d91a7f98d0a9f1e" alt="" width="1450" height="676" data-path="images/scraping-automation/web-unlocker/features/Traffic.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/Traffic.png?w=280&maxW=1450&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0b874ba1d9d6c89416ee35f25f3d802d 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/Traffic.png?w=560&maxW=1450&auto=format&n=ilemiSHw8UogZ13k&q=85&s=c50db3514f336bacaf24b893e9836c52 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/Traffic.png?w=840&maxW=1450&auto=format&n=ilemiSHw8UogZ13k&q=85&s=efd5c05f905b45deba3b0e0f9e676399 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/Traffic.png?w=1100&maxW=1450&auto=format&n=ilemiSHw8UogZ13k&q=85&s=58f7b8d5172e225cfe23235fc43552ad 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/Traffic.png?w=1650&maxW=1450&auto=format&n=ilemiSHw8UogZ13k&q=85&s=347a1f281a200d95d28a6d957cf6e2b0 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/features/Traffic.png?w=2500&maxW=1450&auto=format&n=ilemiSHw8UogZ13k&q=85&s=5764fbfff7089255b7853f3b7fe6dcd2 2500w" data-optimize="true" data-opv="2" />
</Frame>

### Understanding usage

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` header for this purpose.

To activate the headers, add `-debug-full` to your proxy username.

<Note>
  This feature is only available for the Unlocker API and is NOT available for our proxy products.
</Note>

```shell Enabling debug headers in your request
curl -vk \
    -x brd-customer-$CUSTOMER_ID-zone-$ZONE-debug-full:$PASSWORD@brd.superproxy.io:33335 \
    https://example.com
```

The format of the `x-brd-debug` header looks like this:

```
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 our system. 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 our system recorded while processing this request                                                                                        |
| bytes\_down        | The amount of incoming traffic our system recorded while processing this request                                                                                        |
| billed             | Whether our system considers this a billable request or not                                                                                                             |
| destination\_ip    | The IP address of the remote server used to fetch this data                                                                                                             |
| used\_req\_headers | Which request headers (if any) were used in the final request. This mainly applies when using Custom Web Unlocker API                                                   |
| 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`  `411`  `444`                                | 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
< 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](https://docs.brightdata.com/general/account/api-token#bright-datas-api-token)

**How to get statistics for a single domain?**

<CodeGroup>
  ```shell Request
      curl "https://api.brightdata.com/unblocker/success_rate/example.com" -H "Content-Type: application/json" -H "Authorization: Bearer API_KEY"
  ```

  ```shell Response
      {"amazon.com":0.9835556363554884} 
  ```
</CodeGroup>

**How to get statistics for all monitored top level domains?**

<CodeGroup>
  ```shell Request
      curl "https://api.brightdata.com/unblocker/success_rate/example.*" -H "Content-Type: application/json" -H "Authorization: Bearer API_KEY"
  ```

  ```shell Response
      {{"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>


# Introduction to Bright Data's Unlocker API
Source: https://docs.brightdata.com/scraping-automation/web-unlocker/introduction

See how Bright Data's Unlocker API simplifies data collection with intelligent proxy management, avoiding blocks while delivering clean HTML/JSON responses

{/* tags: unblocker; unblocker service; unblocking website; how can i use the unblocker; Unlocker is the same as web unblocker*/}

Unlocker API is part of our [unlocker scraping suite](/scraping-automation/introduction) and is designed to help you focus on your data collection while we take care of the full proxy and unblocking infrastructure for you.

You send a single API request with the target website and we'll return to you a clean `HTML`/`JSON` back. It's that simple!

Behind the scenes, our Unlocker API's intelligent algorithm seamlessly manages the dynamic process of finding the optimal proxy network, customizing headers, fingerprinting, CAPTCHAs, and more.

## Best for

* Scraping data from any website without getting blocked

* Emulating real-user web behavior to "unlock" websites that use sophisticated detection methods

* Teams that don't have a scalable proxy & unblocking infrastructure in-house

* Paying only for successful requests

<Note>
  Unlocker API is not made for [use on browsers](https://docs.brightdata.com/integrations) or 3rd party tools like [Adspower](https://docs.brightdata.com/integrations/adspower), [Puppeteer](https://docs.brightdata.com/integrations/puppeteer), [Playwright](https://docs.brightdata.com/integrations/playwright), or [Multilogin (MLA)](https://docs.brightdata.com/integrations/multilogin). If you need a solution that interacts with a browser and uses tools like this, check out our [Browser API](https://brightdata.com/products/scraping-browser), or review our [other web data products](https://brightdata.com/) that can give you complete data sets.
</Note>

<Tip>
  If you are looking for an unlocking solution specifically for **search engines**, check out our [SERP API](scraping-automation/serp-api)
</Tip>

<Tip>
  **Did you know?**

  On Unlocker API and [SERP API](/scraping-automation/serp-api/), you only pay for successful requests to your target domain—ensuring you get maximum value for every API interaction!
</Tip>


# Quick Start Guide for Bright Data's Unlocker API
Source: https://docs.brightdata.com/scraping-automation/web-unlocker/quickstart

Get started with Bright Data's Unlocker API quickly. Follow our step-by-step guide to set up your proxy and start collecting data today.

<Tip>
  if you haven't yet signed up for Bright Data, you can [sign up for
  free](https://brightdata.com/), and when adding your payment method, you'll
  receive a \$5 credit to get you started!
</Tip>

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

  <Step title={<>Navigate to <a href="https://brightdata.com/cp/zones">My Zones</a></>}>
    <Accordion title="In My Zones view, under Unlocker API click Get started">
      <Warning>
        If you already have an active proxy, simply choose **Add** at the top right corner
      </Warning>

      <Frame>
        <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/get-started.png?maxW=1157&auto=format&n=ilemiSHw8UogZ13k&q=85&s=6b1f6e13127d60f09f3810b6d5ea7fba" alt="Get Started" width="1157" height="888" data-path="images/scraping-automation/web-unlocker/quick-start/get-started.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/get-started.png?w=280&maxW=1157&auto=format&n=ilemiSHw8UogZ13k&q=85&s=57958d0417b522230803021b04464185 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/get-started.png?w=560&maxW=1157&auto=format&n=ilemiSHw8UogZ13k&q=85&s=1fbad7d25bd6f65f8cde5df456317258 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/get-started.png?w=840&maxW=1157&auto=format&n=ilemiSHw8UogZ13k&q=85&s=eb7eb97fc2d2125686a7d45f91992114 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/get-started.png?w=1100&maxW=1157&auto=format&n=ilemiSHw8UogZ13k&q=85&s=37daaf3be28a90210b2e4b30b19d543b 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/get-started.png?w=1650&maxW=1157&auto=format&n=ilemiSHw8UogZ13k&q=85&s=9d32f38d8971dfe50b27336250c4874b 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/quick-start/get-started.png?w=2500&maxW=1157&auto=format&n=ilemiSHw8UogZ13k&q=85&s=180a557e1014d9575ec0cc83ec1e3996 2500w" data-optimize="true" data-opv="2" />
      </Frame>
    </Accordion>
  </Step>

  <Step title="Assign a name to your Unlocker API">
    <Warning>
      Please select a meaningful name, as the zone's name cannot be changed once created.
    </Warning>
  </Step>

  <Step title="Click Add" />
</Steps>

<Accordion title="Before continuing, verify your account">
  If you haven't yet added a payment method, you'll be prompted to add one at this point to verify your account. If it's your first time using Bright Data, then you'll also receive a \$5 bonus credit to get you started!

  <Tip>
    You will not be charged anything at this point and this is solely for verification purposes
  </Tip>
</Accordion>

<Note>
  Don't worry, we'll cover all the configurations in the next section, [Configuration](/scraping-automation/web-unlocker/configuration).
</Note>


# Send Your First Request with Bright Data's Web Unlocker API
Source: https://docs.brightdata.com/scraping-automation/web-unlocker/send-your-first-request

A step-by-step guide to sending your first Web Unlocker API request with easy-to-follow code examples

## Make your first request in minutes

Test the Unlocker API in minutes with these ready-to-use code examples.

<CardGroup cols={3}>
  <Card title="Postman Example" icon="user-astronaut" iconType="regular" href="https://www.postman.com/bright-data-api/bright-data-api/request/f0g939o/unlock-website" cta="Try Unlocker API in less than 1 minute" />

  <Card title="Node.js Example" icon="code" iconType="regular" href="https://github.com/luminati-io/bright-data-web-unlocker-nodejs-project" cta="Try Unlocker API in less than 2 minutes" />

  <Card title="Python Example" icon="code" iconType="regular" href="https://github.com/luminati-io/bright-data-web-unlocker-python-project" cta="Try Unlocker API in less than 5 minutes" />
</CardGroup>

Bright Data offers two methods for accessing Web Unlocker API, both delivering **identical** results while catering to different customer workflows:

<CardGroup cols={2}>
  <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.

### Best for:

* 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](https://docs.brightdata.com/scraping-automation/web-unlocker/quickstart) your Web Unlocker API zone, you'll find a working Web Unlocker API request example and your API key within your zone's **Overview** tab:

<Frame>
    <img src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/send-first-request/web_unlocker_api_overview.png?maxW=1694&auto=format&n=ilemiSHw8UogZ13k&q=85&s=1dc020cf24c9e5255fb204d6cff3f1b8" alt="Web Unlocker API Overview tab" width="1694" height="638" data-path="images/scraping-automation/web-unlocker/send-first-request/web_unlocker_api_overview.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/send-first-request/web_unlocker_api_overview.png?w=280&maxW=1694&auto=format&n=ilemiSHw8UogZ13k&q=85&s=74caa55ef0de1b262fe587e2b8bb9f58 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/send-first-request/web_unlocker_api_overview.png?w=560&maxW=1694&auto=format&n=ilemiSHw8UogZ13k&q=85&s=f0e05614c235f62d77ccdca9a83fdbb9 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/send-first-request/web_unlocker_api_overview.png?w=840&maxW=1694&auto=format&n=ilemiSHw8UogZ13k&q=85&s=5d34c4152138279955a6f2f019d41882 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/send-first-request/web_unlocker_api_overview.png?w=1100&maxW=1694&auto=format&n=ilemiSHw8UogZ13k&q=85&s=0f61e1e04befae561bfd073311fc2ffa 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/send-first-request/web_unlocker_api_overview.png?w=1650&maxW=1694&auto=format&n=ilemiSHw8UogZ13k&q=85&s=2b6a922f58e5323456ce8896584ebe95 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/send-first-request/web_unlocker_api_overview.png?w=2500&maxW=1694&auto=format&n=ilemiSHw8UogZ13k&q=85&s=a70aeeb17303ddc25641500b49bf9075 2500w" data-optimize="true" data-opv="2" />
</Frame>

The following is an example of a simple Web Unlocker API cURL request:

```sh Direct API access - cURL
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 src="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/send-first-request/web_unlocker_api_token.png?maxW=1694&auto=format&n=ilemiSHw8UogZ13k&q=85&s=5740dd0aa934f0b27ea7e20f2472cad4" alt="Web Unlocker API key" width="1694" height="638" data-path="images/scraping-automation/web-unlocker/send-first-request/web_unlocker_api_token.png" srcset="https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/send-first-request/web_unlocker_api_token.png?w=280&maxW=1694&auto=format&n=ilemiSHw8UogZ13k&q=85&s=3858726703253087abf64b5c0ccba8ce 280w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/send-first-request/web_unlocker_api_token.png?w=560&maxW=1694&auto=format&n=ilemiSHw8UogZ13k&q=85&s=8839c84752c1625ba53d4c9e11399fe0 560w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/send-first-request/web_unlocker_api_token.png?w=840&maxW=1694&auto=format&n=ilemiSHw8UogZ13k&q=85&s=800c3152dcfe6414c90d43476a5191bd 840w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/send-first-request/web_unlocker_api_token.png?w=1100&maxW=1694&auto=format&n=ilemiSHw8UogZ13k&q=85&s=88c5944bfec90983dc1d0ba753528e66 1100w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/send-first-request/web_unlocker_api_token.png?w=1650&maxW=1694&auto=format&n=ilemiSHw8UogZ13k&q=85&s=83193e40cf194a190c938a355541b3ab 1650w, https://mintcdn.com/brightdata/ilemiSHw8UogZ13k/images/scraping-automation/web-unlocker/send-first-request/web_unlocker_api_token.png?w=2500&maxW=1694&auto=format&n=ilemiSHw8UogZ13k&q=85&s=80acc6283edb1eac541ba0cf1770e3b0 2500w" data-optimize="true" data-opv="2" />
</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

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

#### 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#how-to-download-the-ssl-certificate).

Alternatively, you can  [ignore SSL errors](/general/account/ssl-certificate#how-to-ignore-ssl-errors).

#### 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

    curl  "http://lumtest.com/myip.json"  --proxy brd.superproxy.io:33335  --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>

    ```

    ```javascript Node.js

    #!/usr/bin/env node

      

    require('request-promise')({

    url: 'http://lumtest.com/myip.json',

    proxy: 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:33335',

    })

    .then(function (data) {

    console.log(data);

    },

    function (err) {

    console.error(err);

    });

    ```

    ```python Python

    import pprint

    import requests

      
      

    host = 'brd.superproxy.io'

    port = 33335

      

    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://lumtest.com/myip.json"

    response = requests.get(url, proxies=proxies)

    pprint.pprint(response.json())

      

    ```

    ```php PHP

      

    <?php

    echo  'To enable your free eval account and get CUSTOMER, YOURZONE and '

    .'YOURPASS, please contact sales@brightdata.com';

    $curl = curl_init('http://lumtest.com/myip.json');

    curl_setopt($curl, CURLOPT_PROXY, 'http://brd.superproxy.io:33335');

    curl_setopt($curl, CURLOPT_PROXYUSERPWD, 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>');

    curl_exec($curl);

    ?>

      

    ```

    ```ruby Ruby

    #!/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://lumtest.com/myip.json')

    proxy = Net::HTTP::Proxy('brd.superproxy.io', 33335, '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#

    using System;

    using System.Net;

      

    class Example {

    static void Main() {

    var client = new WebClient();

    client.Proxy = new WebProxy("brd.superproxy.io:33335");

    client.Proxy.Credentials = new NetworkCredential(

    "brd-customer-<customer_id>-zone-<zone_name>",

    "<zone_password>"

    );

    Console.WriteLine(client.DownloadString("http://lumtest.com/myip.json"));

    }

    ```

    ```java Java

    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", 33335);

    String res = Executor.newInstance()

    .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")

    .execute(Request.Get("http://lumtest.com/myip.json").viaProxy(proxy))

    .returnContent().asString();

    System.out.println(res);

    }

    }

    ```

    ```perl Perl

    #!/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:33335");

    print  $agent->get('http://lumtest.com/myip.json')->content();

    ```

    ```vb VBA

    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:33335")

    Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")

    Console.WriteLine(Client.DownloadString("http://lumtest.com/myip.json"))

    End Sub

    End Module

    ```
  </CodeGroup>

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

  ```json Output

  {

  "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://lumtest.com/myip.json”](https://lumtest.com/myip.json”) with the website of your choice.
</Accordion>


# Best practices for Unlocker API
Source: https://docs.brightdata.com/scraping-automation/web-unlocker/troubleshooting

Learn best practices for targeting API endpoints with Bright Data's Unlocker API, including troubleshooting tips and alternative methods for data extraction.

## Overview

When using Unlocker API, targeting specific API endpoints of product or other pages is a common strategy to extract necessary data efficiently. In most scenarios, 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 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. 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 Unlocker API with Browsers (e.g. Chrome) or Browser Automation Libraries (e.g., Puppeteer, Playwright, Selenium)?

**No.** You should not use the 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).

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 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)](hhttps://docs.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 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](https://docs.brightdata.com/scraping-automation/scraping-browser/introduction)


# Python SDK
Source: https://docs.brightdata.com/sdk-quickstart





# Search API
Source: https://docs.brightdata.com/search-api-quickstart





# Unlocker API
Source: https://docs.brightdata.com/unlocker-api-quickstart