Bring Your Own Proxy (BYOP)

Use your own proxy servers with Scrayle browser sessions. Pass a custom proxy URL when creating a session and Scrayle will route all traffic through it.

Using a Custom Proxy

import { Playwright } from '@scrayle/sdk';
import { chromium } from 'playwright-core';

const { browserWSEndpoint } = await Playwright.connect({
  config: { apiKey: process.env.SCRAYLE_API_KEY },
  proxyURL: 'http://username:[email protected]:8080',
});

const browser = await chromium.connectOverCDP(browserWSEndpoint);
const page = await browser.newPage();
await page.goto('https://example.com');
await browser.close();

Supported Proxy Protocols

• HTTP/HTTPS proxies: http://user:pass@host:port
• SOCKS5 proxies: socks5://user:pass@host:port

With Selenium

import { SeleniumBrowser } from '@scrayle/sdk';

const driver = await SeleniumBrowser.launch({
  proxyUrl: 'http://user:[email protected]:8080',
});

await driver.get('https://example.com');
await driver.quit();

Managing Proxy Pools

You can create and manage proxy pools in the dashboard under Proxies. Proxy pools let you group multiple proxy servers and rotate between them automatically.

• Create pools with multiple proxy endpoints
• Reference pools using proxyPoolId when creating sessions
• Proxies in a pool are rotated automatically

const { browserWSEndpoint } = await Playwright.connect({
  config: { apiKey: process.env.SCRAYLE_API_KEY },
  proxyPoolId: 'pool_abc123',
});

User Proxy IDs

Reference saved proxies by their user proxy ID:

const { browserWSEndpoint } = await Playwright.connect({
  config: { apiKey: process.env.SCRAYLE_API_KEY },
  userProxyId: 'uproxy_abc123',
});