Skip to main content
ScrayleScrayle
residential proxygeo-targeting proxyproxy pool managementproxy rotationdatacenter proxy

Proxy Solutions: Geo-Targeting & Pool Management

Route scraping traffic through residential, datacenter, or IPv6 proxies with per-country targeting, sticky sessions, and BYOP support.

Scrayle Team29-Jul-20258 min read

The IP address your scraper uses is the single biggest factor in whether you get blocked. Datacenter IPs are blacklisted by most anti-bot systems. A single IP making hundreds of requests gets rate-limited in minutes. And if the target site is geo-restricted, you need an IP in the right country.

Scrayle's proxy infrastructure gives you three options: managed residential pools, managed datacenter pools, and Bring Your Own Proxy (BYOP). All three integrate directly with browser sessions, the Universal API, and workflows - no extra configuration needed.

Proxy Types

Residential Proxies

Traffic exits through real residential IP addresses (home internet connections). These are the hardest to detect because they look identical to normal user traffic. Use residential proxies when:

  • The target site has aggressive bot detection
  • You need to appear as a real user from a specific country or city
  • You're scraping sites that block datacenter IP ranges

Datacenter Proxies

Traffic exits through datacenter IPs. These are faster and cheaper than residential proxies, but easier to detect. Use datacenter proxies when:

  • The target site has minimal bot detection
  • Speed and cost are more important than stealth
  • You're scraping APIs or data feeds that don't check IP reputation

IPv6 Proxies

IPv6 proxies provide a massive address space, making it nearly impossible for sites to block individual IPs. Each request can come from a different IPv6 address. Use when:

  • You need extremely high request volumes
  • The target site supports IPv6
  • IP-based rate limiting is your primary blocker

Using Proxies with the SDK

Browser Sessions

Pass proxyCountry when creating a browser session to route traffic through a specific country:

import { Scrayle } from '@scrayle/sdk';
const client = new Scrayle();
// Browser session through a US residential proxy
const session = await client.browser.create({
proxyCountry: 'US',
});

Universal Scraping API

The Universal API accepts proxy configuration in the config object:

const result = await client.universal.scrape({
actor: 'unlocker.webUnlocker',
input: { url: 'https://example.co.uk/prices' },
config: {
proxy: {
country: 'GB',
type: 'residential',
},
},
});

Building Proxy URLs Directly

The SDK includes a proxy URL builder for when you need to use Scrayle proxies outside of Scrayle browser sessions - for example, with your own Puppeteer setup or third-party tools:

const client = new Scrayle();
// Build a proxy URL
const proxyUrl = client.proxies.proxy({
proxyType: 'residential',
country: 'US',
state: 'california',
city: 'los-angeles',
});
console.log(proxyUrl);
// http://scrayle:[email protected]:port
// Generate a sticky session ID for session persistence
const sessionId = client.proxies.generateSessionId();
const stickyProxy = client.proxies.proxy({
proxyType: 'residential',
country: 'DE',
sessionId: sessionId,
sessionDuration: 600, // Keep same IP for 10 minutes
});

Geo-Targeting

Scrayle's proxy network covers 195+ countries. You can target by country, and for some regions, by state and city. This matters for:

  • Localized pricing: E-commerce sites show different prices based on location
  • Regional content: News sites, real estate listings, job boards vary by geography
  • Compliance: Some data collection requires requests to originate from specific jurisdictions
  • Ad verification: Verify ad placements appear correctly in target markets
// Target a specific city
const proxyUrl = client.proxies.proxy({
proxyType: 'residential',
country: 'US',
state: 'new-york',
city: 'new-york-city',
});
// Japanese residential IP
const jpProxy = client.proxies.proxy({
proxyType: 'residential',
country: 'JP',
});
// German datacenter IP (cheaper, faster)
const deProxy = client.proxies.proxy({
proxyType: 'datacenter',
country: 'DE',
});

Session Persistence (Sticky Sessions)

By default, each request through the proxy gets a different IP address. For multi-page scraping where you need the same IP across requests (e.g., maintaining a login session), use sticky sessions:

// Generate a unique session ID
const sessionId = client.proxies.generateSessionId();
// All requests with this session ID use the same IP
const proxyUrl = client.proxies.proxy({
proxyType: 'residential',
country: 'US',
sessionId: sessionId,
sessionDuration: 1800, // Keep same IP for 30 minutes
});
// Use this proxy URL for all requests in a scraping session
// The target site sees consistent IP across all page loads

Proxy Management in the Dashboard

The dashboard provides a visual interface for managing proxy configuration:

  • Managed Pools: View available proxy pools (residential, datacenter, IPv6) with real-time availability metrics
  • Bring Your Own Proxy (BYOP): Add your own proxy servers to use with Scrayle browser sessions and workflows. Useful if you have existing proxy infrastructure or need specific IP ranges.
  • Pool Selection: When creating browser sessions or workflows, choose which proxy pool to route through
  • Usage Analytics: Track proxy bandwidth consumption and success rates by country and proxy type

BYOP (Bring Your Own Proxy)

If you have existing proxy infrastructure, you can register your proxies with Scrayle and use them for browser sessions and workflows. This gives you the convenience of Scrayle's browser management with your own IP infrastructure.

To add your own proxies:

  1. Go to Proxy Solutions in the dashboard
  2. Click Add Proxy under the BYOP section
  3. Enter your proxy URL (supports HTTP, HTTPS, and SOCKS5)
  4. Optionally set a label and country tag for organization
  5. Your proxy is now available in the pool selection dropdown when creating sessions

Best Practices

  • Start with residential. They have the highest success rate across all sites. Switch to datacenter only if you're sure the target allows it.
  • Match proxy country to target site. Scraping amazon.de? Use a German proxy. Scraping indeed.com for US jobs? Use a US proxy. Mismatched geography triggers detection.
  • Use sticky sessions for authenticated flows. If you're logging in, use session persistence so the login and subsequent browsing come from the same IP.
  • Rotate freely for unauthenticated scraping. For public data, let Scrayle rotate IPs on every request for maximum anonymity.
  • Monitor success rates. If a specific country's proxies start failing, it may indicate the target site has updated its geo-blocking rules.

What's Next


Proxy dashboard: Manage pools and BYOP at app.scrayle.com.