# High-Bandwidth Proxies

## Getting started

To start using our [**High Bandwidth Proxies**](https://oxylabs.io/products/high-bandwidth-proxies) for video data and audio scraping, contact our sales team to receive your dedicated endpoint. Each customer gets a unique proxy endpoint configured for their specific needs. To directly integrate this solution with `yt_dlp` library, check the [example](#example-integration-youtube-downloader) below, or check out our [Agent Skills](#agent-skills) for AI workflows.

## Endpoint configuration

After receiving your endpoint from the account management team, you'll get:

* A dedicated proxy endpoint
* Your username and password
* Port number (default: `60000`)

## Example integration: YouTube Downloader

Here's an example using `yt-dlp` with our High Bandwidth Proxies for video or audio data scraping:

### Basic Usage

{% tabs %}
{% tab title="Bash" %}

```bash
yt-dlp --proxy username-$(openssl rand -hex 16):password@endpoint:60000 \
"https://www.youtube.com/watch?v=WNCl-69POro"
```

{% endtab %}

{% tab title="Python" %}

```python
import os
import yt_dlp

username = 'YOUR_USERNAME'
password = 'YOUR_PASSWORD'

proxy = f'http://{username}-{os.urandom(16).hex()}:{password}@your-endpoint:60000'

ydl_opts = {
    'proxy': proxy,
}

with yt_dlp.YoutubeDL(ydl_opts) as ydl:
    ydl.download(['https://www.youtube.com/watch?v=WNCl-69POro'])
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
For optimal performance, make sure each video is downloaded using a separate IP address. Refer to the section below for guidance.
{% endhint %}

### Multiple URLs with different IPs

While using High Bandwidth Proxies, every video is downloaded with a separate IP address to ensure the optimal performance. This is achieved by generating a unique session ID for each request, which effectively assigns a new IP address for each download.

{% tabs %}
{% tab title="Bash" %}

```bash
# First video with one IP
yt-dlp --proxy username-$(openssl rand -hex 16):password@endpoint:60000 \
"https://www.youtube.com/watch?v=6stlCkUDG_s"

# Second video with different IP
yt-dlp --proxy username-$(openssl rand -hex 16):password@endpoint:60000 \
"https://www.youtube.com/watch?v=gsnqXt7d1mU"
```

{% endtab %}

{% tab title="Python" %}

```python
import os
import yt_dlp

def download_with_new_ip(url, username, password):
    session_id = os.urandom(16).hex()
    proxy = f'http://{username}-{session_id}:{password}@your-endpoint:60000'

    ydl_opts = {
        'proxy': proxy
    }
    
    with yt_dlp.YoutubeDL(ydl_opts) as ydl:
        try:
            print(f"Downloading {url} with new IP ({username}-{session_id})...")
            ydl.download([url])
            print(f"Successfully downloaded {url}")
        except Exception as e:
            print(f"Error downloading {url}: {str(e)}")

def main():
    username = 'YOUR_USERNAME'
    password = 'YOUR_PASSWORD'
    
    videos = [
        'https://www.youtube.com/watch?v=6stlCkUDG_s',
        'https://www.youtube.com/watch?v=gsnqXt7d1mU'
    ]
    
    for video in videos:
        download_with_new_ip(video, username, password)

if __name__ == "__main__":
    main()

```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
The function includes basic error handling to ensure the process continues even if one download fails.
{% endhint %}

## Agent Skills

To use Oxylabs High Bandwidth proxies in AI workflows you can also employ Agent Skills (`skills.md`) to teach LLMs and AI coding assistants how to configure and interact with Oxylabs products.

The `video-data` agent skill helps your model configure raw video/audio media streaming and downloads through `yt-dlp` without syntax or parameter hallucinations.

{% hint style="info" %}
**Note:** `video-data` skill also includes structured data collection (search results, metadata, transcripts, etc.) through the Web Scraper API. [Learn more](/products/web-scraper-api/solutions-for-ai-workflows/agent-skills.md#video-data).
{% endhint %}

### Installation

#### Claude Code (plugin marketplace)

Inside Claude Code, run the following commands:

```
/plugin marketplace add oxylabs/agent-skills
/plugin install oxylabs@oxylabs-agent-skills
```

This installs all 5 skills as a single plugin:

* [`skills/proxies`](https://github.com/oxylabs/agent-skills/blob/main/skills/proxies/SKILL.md)
* [`skills/web-unblocker`](https://github.com/oxylabs/agent-skills/blob/main/skills/web-unblocker/SKILL.md)
* [`skills/web-scraper-api`](https://github.com/oxylabs/agent-skills/blob/main/skills/web-scraper-api/SKILL.md)
* [`skills/headless-browser`](https://github.com/oxylabs/agent-skills/blob/main/skills/headless-browser/SKILL.md)
* [`skills/video-data`](https://github.com/oxylabs/agent-skills/blob/main/skills/video-data/SKILL.md)

To update skills, run this command:

```
/plugin marketplace update oxylabs-agent-skills
```

#### Other agents (generic)

For other agents and custom environments, load the repository into your project workspace via the standard skills CLI:

```
npx skills add https://github.com/oxylabs/agent-skills.git
```

### Configuration

All Oxylabs Agent Skills authenticate via environment variables defined in a `.env` file. To use `video-data` skills, add these keys to your `.env` file:

| Variable           | Description                                                                                                                                     |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `OXY_HB_ENDPOINT`  | Your High-Bandwidth Proxy gateway                                                                                                               |
| `OXY_WSA_USERNAME` | (Optional) Your Web Scraper API user `username`. [Learn more](/products/web-scraper-api/solutions-for-ai-workflows/agent-skills.md#video-data). |
| `OXY_WSA_PASSWORD` | (Optional) Your Web Scraper API user `password`. [Learn more](/products/web-scraper-api/solutions-for-ai-workflows/agent-skills.md#video-data). |

### How to use

Once the skill is active, you can prompt your AI assistant to generate network-optimized media delivery scripts.

* **Example 1:** "Create a shell script that passes my `OXY_HB_ENDPOINT` gateway configurations directly into `yt-dlp` to download raw videos from a URL."
* **Example 2:** "Write a Python script using `ffmpeg` and proxy rotation to stream large binary video assets through the High-Bandwidth entry node."


---

# 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://developers.oxylabs.io/products/proxies/high-bandwidth-proxies.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.