Proxy Pools

Scrayle provides managed proxy pools with residential, datacenter, and IPv6 proxies. Route your browser sessions and scraping requests through proxies with automatic geo-targeting.

Proxy Types

Geo-Targeting

Target proxies by country, state, or city:

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

const client = new ScrayleClient({ apiKey: process.env.SCRAYLE_API_KEY });

// Generate a proxy URL
const proxyUrl = client.proxies.proxy({
  proxyType: 'residential',
  country: 'US',
  state: 'California',
  city: 'Los Angeles',
});

console.log(proxyUrl);
// http://scrayle-type-residential-country-US-state-California-city-Los_Angeles:[email protected]

Session Stickiness

Use session IDs to maintain the same IP across requests:

const sessionId = client.proxies.generateSessionId();

const proxyUrl = client.proxies.proxy({
  proxyType: 'residential',
  country: 'US',
  sessionId: sessionId,
  sessionDuration: 600, // 10 minute sticky session
});

Using with Browser Sessions

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

// Built-in proxy support
const { browserWSEndpoint } = await Playwright.connect({
  proxyCountry: 'US',
  proxyState: 'New York',
});

Using with Scraping

const result = await client.scraping.scrape({
  actor: 'scraper.google.search',
  input: { q: 'web scraping' },
  proxy: {
    country: 'US',
    type: 'residential',
  },
});

Proxy URL Format

http://{username}-type-{proxyType}-country-{country}-state-{state}-city-{city}-session-{sessionId}:{password}@{gateway}:{port}

Default gateway: gate.scrayle.com:7777
Default username: scrayle
Default password: your API key

SDK Reference