# Proxy Integration

**Browser Swarm** provides flexible proxy integration options, allowing you to route your automation traffic through various proxy types to enhance anonymity, control geolocation, and improve reliability.

***

### 🧰 Proxy Configuration Options

With **Browser Swarm**, you can:

* **Use Built-in Proxies**: Effortlessly route traffic through our managed residential proxies.
* **Bring Your Own Proxies**: Utilize custom HTTP/HTTPS proxies for greater control over network routing.
* **Combine Multiple Proxies**: Set custom routing rules to direct traffic through different proxies based on domain or location.

Proxies are configured when creating a session through the API or SDK.

***

### Example

{% tabs %}
{% tab title="Node.js" %}

```javascript
import { BrowserSwarm } from 'browser-swarm-sdk';

const bs = new BrowserSwarm({ apiKey: process.env.BROWSER_SWARM_API_KEY });

const session = await bs.sessions.create({
  projectId: process.env.BROWSER_SWARM_PROJECT_ID,
  proxies: [
    {
      type: 'custom',
      url: 'http://username:password@proxy.example.com:8080'
    }
  ]
});
```

{% endtab %}

{% tab title="Python" %}

```python
from browser_swarm import BrowserSwarm
import os

bs = BrowserSwarm(api_key=os.environ["BROWSER_SWARM_API_KEY"])

session = bs.sessions.create(
    project_id=os.environ["BROWSER_SWARM_PROJECT_ID"],
    proxies=[
        {
            "type": "custom",
            "url": "http://username:password@proxy.example.com:8080"
        }
    ]
)
```

{% endtab %}
{% endtabs %}

***

### 🌍 Geolocation Control

To simulate browsing from specific locations, you can configure proxies with geolocation settings:

```javascript
proxies: [
  {
    type: 'browserbase',
    geolocation: {
      city: 'New York',
      state: 'NY',
      country: 'US'
    }
  }
]
```

This setup is particularly useful for testing localized content or accessing region-restricted websites.

***

### ⚙️ Advanced Proxy Routing

For more granular control, **Browser Swarm** allows domain-specific proxy routing:

```javascript
proxies: [
  {
    type: 'custom',
    url: 'http://proxy1.example.com:8080',
    domains: ['example.com', 'testsite.com']
  },
  {
    type: 'custom',
    url: 'http://proxy2.example.com:8080',
    domains: ['anothersite.com']
  }
]
```

This configuration directs traffic to specified domains through designated proxies, optimizing performance and reliability.

***

### 📊 Monitoring Proxy Usage

Track your proxy data consumption via the **Browser Swarm Dashboard**, which provides real-time insights into:

* **Data Usage**: Monitor the amount of data transmitted through proxies.
* **Session Metrics**: Analyze session durations, statuses, and resource consumption.
* **Geolocation Distribution**: Visualize traffic distribution across different regions.

Regular monitoring helps in optimizing proxy usage and managing associated costs.

***

### 💡 Best Practices

* **Rotate Proxies**: Regularly change proxies to avoid IP bans and maintain anonymity.
* **Use Residential Proxies**: For higher success rates, especially when dealing with sophisticated anti-bot systems.
* **Monitor Performance**: Keep an eye on proxy response times and success rates to ensure optimal performance.

By effectively integrating proxies into your browser automation workflows, **Browser Swarm** empowers you to navigate the web with enhanced control and reliability.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://browserswarm.gitbook.io/docs/proxy-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.