High-Bandwidth Proxies

Learn how to use Oxylabs High-Bandwidth Proxies for traffic-intensive tasks, such as video and audio scraping.

Getting started

To start using our 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 below, or check out our 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

Bash

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

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'])

For optimal performance, make sure each video is downloaded using a separate IP address. Refer to the section below for guidance.

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.

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"

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()

The function includes basic error handling to ensure the process continues even if one download fails.

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.

Note: video-data skill also includes structured data collection (search results, metadata, etc.) through the Web Scraper API. Learn more.

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
• skills/web-unblocker
• skills/web-scraper-api
• skills/headless-browser
• skills/video-data

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.
OXY_WSA_PASSWORD	(Optional) Your Web Scraper API user password. Learn more.

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