How To Guides - All Proxies

Learn about the different IP targeting options for Bright Data’s Proxy networks, how to set limits on bandwidth consumption, whitelisting IPs, and more!

Tip
Check out our table of contents on the left to navigate through the sections below that are of interest to you. 

Integrate a new proxy into your code

To integrate the proxies into your code, please visit the API examples page, which can be accessed via your zone's settings, under "access parameters":

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.

Integrate a proxy into 3rd party software

Check out a few examples in the API examples page mentioned above (just choose "other software" in the "language" drop-down menu), or check our Integrations page, where we have specific guides to integrate our proxies within the most popular tools across the industry today. 

Target a Specific Country or City with Bright Data proxies

Country

To target a specific country:

1. Make sure your specific proxy zone is configured to use IPs from that country. You can see this in your proxy zones "Configuration" tab under Geolocation Targeting

2. When sending your request, add the -country flag, after your zone’s name in the request, followed by the 2-letter ISO code 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").

curl--proxy brd.superproxy.io:22225 --proxy-user brd-customer-<CUSTOMER_ID>-zone-<ZONE_NAME>-country-us: <ZONE_PASSWORD>  "http://target.site"

EU region (Relevant for DC, ISP, and Web Unlocker/SERP API)

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

Note: The allocation of a country within the EU is random.

City

In order to target a specific city you will need to use a Shared (pay-per-IP) or Dedicated proxy network.

When configuring your proxy zone, after selecting your preferred country, you can add a city, to further specify your geotargeting

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 for a specific geolocation.

Once configured, you'll be able to send requests from the selected city, using the following syntax

curl --proxy brd.superproxy.io:22225 --proxy-user brd-customer-<CUSTOMER_ID>-zone-<ZONE_NAME>-country-<COUNTRY>-city-<CITY>: <ZONE_PASSWORD> "http://target.site"

Please 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

To view more geotargeting examples, you may want to review our proxy integration examples page.

View your zone's statistics

There are 2 ways to view your zones statistics:

• Via the control panel:
  • To see stats across all your zones, go to your dashboard:
  • To see stats for a specific zone, go to that zone's settings and click the "statistics" tab:
    
• Via API:
  • Please visit this page to see all available API endpoints (in multiple languages) and example responses related to viewing statistics.

Review IPs Allocated to Your Zone

To review the list of IPs allocated to your zone, simply navigate to ‘My proxies page’, click on your Proxy zone, scroll down to the ‘Allocated IPs’ section, then simply click ‘Show allocated IPs’ or ‘Download IPs list'.

View the 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

Go to the "Event Log" tab:

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

100% uptime - Assigning automatic IP fallbacks

Datacenter & ISP

The 100% uptime 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
• 100% uptime will not interrupt a live connection. If the fallback is needed, it will play in once the next connection is established

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.

• To enable 100% uptime:

Navigate to your proxy configuration settings, and under ‘Permissions’ enable ‘100% uptime’

Please note: 100% uptime feature can be turned on or off, via API.

Keep using the same IP in multiple requests

• This can be done by adding the session flag to the proxy username:

  brd.superproxy.io:22225 br-customer-{YOUR_CUSTOMER_ID}-zone-{YOUR_ZONE}-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:

  brd-customer-{YOUR_CUSTOMER_ID}-zone-{YOUR_ZONE}-session-glob_rand39484

  Full request example:

  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.

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'

1. Go to any of your zone's settings by clicking on that zone.
2. Go to the "Access parameters" tab.
3. Scroll down to "Limit", the default value is "unlimited"
4. Click the "edit" button
5. Enable the "spend limit" option.
6. Set the parameters you wish to work with and click "update"
7. You'll see the change back in the "Limit" section and the proxies page, in the "Usage/Spend Limit" column.

Whitelist/blacklist IPs and domains

To add IPs to a zone's blacklist/whitelist, there are 2 ways:

• Via the control panel:
  • Go to any of your zone's settings, and click the "access parameters" tab.
  • Scroll down to the "IPs" and "target host" sections, as they are both responsible for white/blacklisting IPs and domains, respectively:
    

    

    Add all the relevant IPs and domains you'll allow access to with your proxy zone.
• Via API endpoints:
  • Add IP to Zone whitelist
  • Remove IP from Zone whitelist
  • Add IP to Zone blacklist
  • Remove IP from Zone blacklist 
  • Remove domain from Zone whitelist/blacklist 
  • Add domain to Zone whitelist/blacklist

• Important tips re whitelist:
  • IPs that should be whitelisted are your machine's IPs that you'll be sending requests with, not the proxy IPs in your zones.
  • We strongly recommend whitelisting your IPs wherever possible, since when the whitelist is empty, you run the risk of getting your non-whitelisted IPs temporarily blocked in the case where our automatic security blocking system detects any irregular activity. See more info within this video.
  • There is no limit on how many IPs/domains you can add to the whitelist and we also support ranges of IPs.
    
    Example for adding domains:
    
  • Example for adding IPs:
    

    

Supported Ports & Protocols