Integration Guides

Simple copy-paste examples to get started quickly.

On this page

Anti-Detect Browser Setup Guides

Running multiple accounts? These step-by-step guides show how to add a BirdProxies residential or ISP proxy to each popular anti-detect browser. Use one proxy per profile, matched to the account's country, for full isolation.

AdsPowerHow to add a BirdProxies proxy to an AdsPower browser profile.
MultiloginHow to add a BirdProxies proxy to a Multilogin (Mimic / Stealthfox) profile.
Dolphin AntyHow to add a BirdProxies proxy to a Dolphin Anty profile.
GoLoginHow to add a BirdProxies proxy to a GoLogin profile.
Octo BrowserHow to add a BirdProxies proxy to an Octo Browser profile.
IncognitonHow to add a BirdProxies proxy to an Incogniton profile.

Quick Start

Connection Details

Residential Proxy: residential.birdproxies.com:8080
ISP Proxy: Use the IP:Port provided in your dashboard
Username: Your BirdProxies username
Password: Your BirdProxies password

Python

Basic Request

python

import requests

proxies = {
    'http': 'http://username:[email protected]:8080',
    'https': 'http://username:[email protected]:8080'
}

response = requests.get('https://httpbin.org/ip', proxies=proxies)
print(response.json())

With Error Handling

python

import requests
from requests.exceptions import RequestException

proxies = {
    'http': 'http://username:[email protected]:8080',
    'https': 'http://username:[email protected]:8080'
}

try:
    response = requests.get('https://httpbin.org/ip', proxies=proxies, timeout=10)
    print(f"Success! Proxy IP: {response.json()['origin']}")
except RequestException as e:
    print(f"Error: {e}")

Node.js

Using Axios

javascript

const axios = require('axios');
const HttpsProxyAgent = require('https-proxy-agent');

const proxyAgent = new HttpsProxyAgent(
    'http://username:[email protected]:8080'
);

axios.get('https://httpbin.org/ip', {
    httpsAgent: proxyAgent,
    timeout: 10000
})
.then(response => {
    console.log('Proxy IP:', response.data.origin);
})
.catch(error => {
    console.error('Error:', error.message);
});

Using node-fetch

javascript

const fetch = require('node-fetch');
const HttpsProxyAgent = require('https-proxy-agent');

const proxyAgent = new HttpsProxyAgent(
    'http://username:[email protected]:8080'
);

fetch('https://httpbin.org/ip', { agent: proxyAgent })
    .then(res => res.json())
    .then(data => console.log('Proxy IP:', data.origin))
    .catch(err => console.error('Error:', err));

cURL

Basic Request

bash

curl -x http://username:[email protected]:8080 https://httpbin.org/ip

With Headers

bash

curl -x http://username:[email protected]:8080 \
     -H "User-Agent: Mozilla/5.0" \
     -H "Accept: application/json" \
     https://httpbin.org/ip

Download File

bash

curl -x http://username:[email protected]:8080 \
     -o output.html \
     https://example.com

Selenium (Browser Automation)

Selenium is perfect for web scraping JavaScript-heavy websites and social media automation.

Chrome with Proxy

python

from selenium import webdriver
from selenium.webdriver.chrome.options import Options

# Setup Chrome options
chrome_options = Options()
chrome_options.add_argument('--proxy-server=http://residential.birdproxies.com:8080')

# Create driver with proxy authentication extension
driver = webdriver.Chrome(options=chrome_options)

# Note: For authenticated proxies, you'll need a Chrome extension
# or use a proxy authentication plugin

Using Selenium Wire (Recommended for Authentication)

python

from seleniumwire import webdriver

# Configure proxy
proxy_options = {
    'proxy': {
        'http': 'http://username:[email protected]:8080',
        'https': 'http://username:[email protected]:8080',
        'verify_ssl': False,
    }
}

# Create driver
driver = webdriver.Chrome(seleniumwire_options=proxy_options)

# Navigate to website
driver.get('https://httpbin.org/ip')
print(driver.page_source)

driver.quit()

Puppeteer

Puppeteer is ideal for web scraping, e-commerce price monitoring, and headless browser automation.

Basic Browser Automation

javascript

const puppeteer = require('puppeteer');

(async () => {
    const browser = await puppeteer.launch({
        args: [
            '--proxy-server=http://residential.birdproxies.com:8080'
        ]
    });

    const page = await browser.newPage();

    // Authenticate proxy
    await page.authenticate({
        username: 'your_username',
        password: 'your_password'
    });

    await page.goto('https://httpbin.org/ip');
    const content = await page.content();
    console.log(content);

    await browser.close();
})();

C# / .NET

Using HttpClient

csharp

using System;
using System.Net;
using System.Net.Http;

class Program
{
    static async Task Main()
    {
        var proxy = new WebProxy
        {
            Address = new Uri("http://residential.birdproxies.com:8080"),
            Credentials = new NetworkCredential("username", "password")
        };

        var handler = new HttpClientHandler
        {
            Proxy = proxy,
            UseProxy = true
        };

        using var client = new HttpClient(handler);
        var response = await client.GetStringAsync("https://httpbin.org/ip");
        Console.WriteLine(response);
    }
}

Go

Basic Request

go

package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
    "net/url"
)

func main() {
    proxyURL, _ := url.Parse("http://username:[email protected]:8080")

    client := &http.Client{
        Transport: &http.Transport{
            Proxy: http.ProxyURL(proxyURL),
        },
    }

    resp, err := client.Get("https://httpbin.org/ip")
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

PHP

Using cURL

php

<?php
$proxy = 'residential.birdproxies.com:8080';
$proxyAuth = 'username:password';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://httpbin.org/ip');
curl_setopt($ch, CURLOPT_PROXY, $proxy);
curl_setopt($ch, CURLOPT_PROXYUSERPWD, $proxyAuth);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'Error: ' . curl_error($ch);
} else {
    echo $response;
}

curl_close($ch);
?>

Using Guzzle

php

<?php
require 'vendor/autoload.php';

use GuzzleHttp\Client;

$client = new Client([
    'proxy' => 'http://username:[email protected]:8080'
]);

$response = $client->request('GET', 'https://httpbin.org/ip');
echo $response->getBody();
?>

Java

Using HttpURLConnection

java

import java.net.*;
import java.io.*;

public class ProxyExample {
    public static void main(String[] args) throws Exception {
        Proxy proxy = new Proxy(Proxy.Type.HTTP,
            new InetSocketAddress("residential.birdproxies.com", 8080));

        Authenticator.setDefault(new Authenticator() {
            @Override
            protected PasswordAuthentication getPasswordAuthentication() {
                return new PasswordAuthentication(
                    "username", "password".toCharArray());
            }
        });

        URL url = new URL("https://httpbin.org/ip");
        HttpURLConnection conn = (HttpURLConnection) url.openConnection(proxy);

        BufferedReader reader = new BufferedReader(
            new InputStreamReader(conn.getInputStream()));
        String line;
        while ((line = reader.readLine()) != null) {
            System.out.println(line);
        }
        reader.close();
    }
}

OpenClaw (AI Agent)

OpenClaw is an open-source AI agent framework for browser automation and web scraping. BirdProxies integrates with both the browser tool and web_fetch HTTP client. See the full OpenClaw proxy setup guide for detailed instructions.

Browser Proxy Configuration

json

{
  "browser": {
    "proxy": {
      "server": "http://gate.birdproxies.com:7777",
      "username": "YOUR_USERNAME",
      "password": "YOUR_PASSWORD"
    }
  }
}

HTTP Proxy (web_fetch)

bash

# Add to your .env file
HTTP_PROXY=http://USER:[email protected]:7777
HTTPS_PROXY=http://USER:[email protected]:7777
NO_PROXY=127.0.0.1,localhost

Important: Set NO_PROXY=127.0.0.1,localhost to prevent proxy routing from breaking OpenClaw's internal CDP health checks.

For sticky sessions (multi-page workflows), append -session-RANDOM to your username. For country targeting, append -country-us or any ISO code.

Troubleshooting

Common Issues

Connection Timeout

Increase timeout to 30 seconds
Check if your IP is whitelisted (ISP proxies)
Verify credentials are correct

Authentication Failed

Check username and password
Ensure proxy format is correct: http://user:pass@host:port
Some tools require URL encoding for special characters in password

SSL Certificate Errors

Add verify=False in Python requests
Use --insecure flag in cURL
Disable SSL verification in your HTTP client (development only)

Proxy Not Working

1. Test with cURL first: curl -x http://user:pass@host:port https://httpbin.org/ip

2. Check if residential proxies are active in your dashboard

3. For ISP proxies, verify the specific IP:Port is correct

4. Contact support if issues persist

**Need more help?** See our Troubleshooting Guide or Best Practices.

Found an issue? Let us know on Discord

Go to Dashboard