Proxy Types

The Scraper API integrates seamlessly with Evomi’s global proxy network, giving you access to residential and datacenter proxies across 150+ countries. Choose the right proxy type for your use case to optimize success rates and costs.

Proxy Types

Premium/Residential Proxies (Default)

Real IP addresses from ISPs worldwide, providing the highest success rate against anti-bot protection.

Cost:

• Request mode: 2 credits
• Browser mode: 5 credits (flat rate)
• Auto mode: 2-6 credits

Best For:

• Browser and auto modes (required)
• Geo-restricted content (streaming, e-commerce)
• Sites with strict anti-bot protection
• Social media platforms
• Sneaker sites and ticket vendors
• High-value scraping targets

Example:

curl -X POST "https://scrape.evomi.com/api/v1/scraper/realtime" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "proxy_type": "residential",
    "proxy_country": "US"
  }'

Datacenter Proxies

High-speed datacenter IPs optimized for performance and cost.

Cost: 1 credit (request mode only)

Best For:

• Request mode static scraping
• Public APIs and JSON endpoints
• News sites and blogs
• Documentation and knowledge bases
• High-volume scraping
• Development and testing
• Cost-sensitive projects

Example:

curl -X POST "https://scrape.evomi.com/api/v1/scraper/realtime" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://api.example.com/data",
    "proxy_type": "datacenter",
    "proxy_country": "DE"
  }'

Cost Comparison

Country Selection

Target any country using two-letter ISO 3166-1 alpha-2 codes:

Popular Countries

Example:

{
  "url": "https://example.com",
  "proxy_type": "residential",
  "proxy_country": "JP"
}

Session Management

Maintain the same IP address across multiple requests using session IDs—perfect for multi-step workflows like login flows, shopping carts, or paginated scraping.

Session ID Requirements

• Length: 6-8 characters
• Format: Alphanumeric (a-z, A-Z, 0-9)
• Case-sensitive: session1 ≠ SESSION1
• Persistence: Same ID = same IP across requests

Use Cases

Login and Browse:

# Step 1: Login page
curl -X POST "https://scrape.evomi.com/api/v1/scraper/realtime" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/login",
    "proxy_session_id": "user001",
    "proxy_country": "US"
  }'

# Step 2: Dashboard (same IP)
curl -X POST "https://scrape.evomi.com/api/v1/scraper/realtime" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/dashboard",
    "proxy_session_id": "user001",
    "proxy_country": "US"
  }'

Shopping Cart Flow:

{
  "proxy_session_id": "cart789",
  "proxy_country": "US"
}

Use the same session ID for:

1. Browse products
2. Add to cart
3. View cart
4. Checkout

Paginated Scraping:

{
  "proxy_session_id": "scrape1",
  "proxy_country": "GB"
}

Maintain the same IP when scraping multiple pages of results to avoid detection.

Custom Proxy Override

Bring your own proxy by providing a complete proxy URL:

{
  "url": "https://example.com",
  "proxy_overwrite": "http://username:[email protected]:8080"
}

Supported Protocols:

• http://username:password@host:port
• https://username:password@host:port
• socks5://username:password@host:port

Proxy Behavior by Mode

The proxy configuration applies differently based on the scraping mode:

Best Practices

Choose the Right Proxy Type

Use Datacenter When:

• Using request mode only (datacenter is not supported with browser/auto modes)
• Scraping public content
• Cost optimization is priority
• Target site has minimal anti-bot protection
• High-volume scraping of simple sites

Use Residential When:

• Using browser or auto mode (residential is required)
• Accessing geo-restricted content
• Target has strict anti-bot measures
• Social media or e-commerce scraping
• Success rate is more important than cost

Optimize Session Usage

Do:

• Use sessions for related requests (login → browse → action)
• Keep session IDs unique per workflow
• Reuse sessions within a reasonable timeframe

Don’t:

• Use the same session ID across unrelated workflows
• Share session IDs between different users/accounts
• Keep sessions active indefinitely

Monitor Success Rates

Track which proxy type works best for your targets:

# Python example
results = {
    'datacenter_success': 0,
    'residential_success': 0
}

# Try datacenter first
response = scrape(url, proxy_type='datacenter')
if response.status_code == 200:
    results['datacenter_success'] += 1
else:
    # Fall back to residential
    response = scrape(url, proxy_type='residential')
    results['residential_success'] += 1

Country Selection Strategy

For Geo-Restricted Content:

{
  "proxy_country": "GB"  // Match the target country
}

For General Scraping:

{
  "proxy_country": "US"  // Largest IP pool, best performance
}

For Regional E-commerce:

{
  "proxy_country": "DE"  // Match customer location
}

Proxy Errors

Connection Refused

{
  "success": false,
  "error": "Proxy connection failed"
}

Solutions:

• Try a different proxy_country
• Switch to residential proxies for better success rate
• Check if the target site is blocking your proxy type

Timeout

{
  "success": false,
  "error": "Request timeout"
}

Solutions:

• Increase wait_seconds for slow-loading sites
• Try datacenter proxies for faster connections
• Use async=true for long-running requests