Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.zenrows.com/llms.txt

Use this file to discover all available pages before exploring further.

Premium Proxy routes your requests through residential IP addresses instead of standard datacenter IPs. These residential IPs come from real Internet Service Provider (ISP) connections assigned to actual households, making them significantly harder for websites to detect and block. When websites implement anti-scraping measures, they typically target datacenter IP ranges first. Premium Proxy addresses this challenge by utilizing IP addresses that appear as regular user traffic, thereby dramatically improving your scraping success rates on protected websites.

​
How Premium Proxy works

Premium Proxy automatically selects residential IP addresses from ZenRows’ global pool when the feature is enabled. Each request routes through a different residential connection, mimicking natural user behavior and avoiding the IP-based blocking that affects datacenter proxies. The system handles IP rotation automatically, so you don’t need to manage proxy lists or worry about IP exhaustion. ZenRows maintains thousands of residential IPs across multiple countries to ensure reliable access to your target websites.

​
Basic usage

Enable Premium Proxy by adding the premium_proxy=true parameter to your ZenRows request: 
# pip install requests
import requests

url = 'https://httpbin.io/anything'
apikey = 'YOUR_ZENROWS_API_KEY'
params = {
    'url': url,
    'apikey': apikey,
    'premium_proxy': 'true',
}
response = requests.get('https://api.zenrows.com/v1/', params=params)
print(response.text)
This example enables Premium Proxy for your request. ZenRows automatically selects an available residential IP and routes your request through it, improving your chances of successful data extraction.

​
When to use Premium Proxy

Premium Proxy is essential in these scenarios:
  • High-security websites - Sites protected by CloudFlare, Akamai, or similar anti-bot systems
  • E-commerce platforms - Online stores that actively block datacenter IPs
  • Social media sites - Platforms with sophisticated bot detection
  • Financial websites - Banking and trading sites with strict access controls
  • Streaming services - Video platforms that block automated access
  • Government websites - Official sites with enhanced security measures

​
Best practices

​
Combine with other features

Premium Proxy works best when combined with other ZenRows features:
Python
params = {
    'url': target_url,
    'apikey': 'YOUR_ZENROWS_API_KEY',
    'premium_proxy': 'true',
    'js_render': 'true',  # For JavaScript-heavy sites
    'wait_for': '.content',  # Wait for specific elements
}

​
Monitor success rates

Track your scraping success to optimize your approach:
Python
successful_requests = 0
total_requests = 0

for url in url_list:
    total_requests += 1
    response = requests.get('https://api.zenrows.com/v1/', params={
        'url': url,
        'apikey': 'YOUR_ZENROWS_API_KEY',
        'premium_proxy': 'true',
    })
    
    if response.status_code == 200:
        successful_requests += 1

success_rate = (successful_requests / total_requests) * 100
print(f"Success rate: {success_rate}%")

​
Troubleshooting

​
Common issues and solutions

IssueCauseSolution
Still getting blockedWebsite uses advanced fingerprintingAdd js_render=true and custom headers
Inconsistent resultsDifferent residential IPs may see different contentUse session management or sticky sessions (session_id), or test using Geolocation
Higher costs than expectedPremium Proxy costs 10x base rateMonitor usage and optimize request frequency

​
Debugging blocked requests

If you’re still getting blocked with Premium Proxy enabled:
1

Add JavaScript rendering

Python
params = {
    'premium_proxy': 'true',
    'js_render': 'true',
}
See more about the js_render parameter here
2

Return the original status from the website

Python
params = {
    'premium_proxy': 'true',
    'original_status': 'true',
}
See more about the original_status parameter here
3

Include realistic headers

Python
params = {
    'premium_proxy': 'true',
    'js_render': 'true',
    'custom_headers': 'true',
}
headers = {
    'referer': 'https://www.google.com'
}
See more about the custom_headers parameter here
4

Add wait times for dynamic content

Python
params = {
    'premium_proxy': 'true',
    'js_render': 'true',
    'wait': '3000',
}

​
Pricing

Premium Proxy requests cost 10 times the standard rate. This pricing reflects the higher cost and limited availability of residential IP addresses compared to datacenter proxies.
You can monitor your ZenRows usage in multiple ways to stay informed about your account activity and prevent unexpected overages.Dashboard monitoring: View real-time usage statistics, remaining requests, success rates, and request history on your Analytics Page. You can also set up usage alerts in your notification settings to receive notifications when you approach your limits.Programmatic monitoring: For automated monitoring in your applications, call the /v1/subscriptions/self/details endpoint with your API key in the X-API-Key header. This returns real-time usage data that you can integrate into your monitoring systems. Learn more about the usage endpoint.Response header monitoring: Track your concurrency usage through response headers included with each request:
  • Concurrency-Limit: Your maximum concurrent requests
  • Concurrency-Remaining: Available concurrent request slots
  • X-Request-Cost: Cost of the current request

​
Frequently Asked Questions (FAQ)

Premium Proxy utilizes residential IP addresses from genuine ISP connections, whereas standard proxies employ data center IPs. Residential IPs are much harder for websites to detect and block, resulting in higher success rates for scraping protected websites.
No, ZenRows automatically selects residential IPs from its pool to ensure optimal performance and avoid IP exhaustion. Manual IP selection could lead to blocking and reduced success rates.
No, Premium Proxy is primarily needed for websites with anti-scraping measures. Simple websites without bot protection can often be scraped successfully using standard datacenter proxies.
Yes, Premium Proxy works with all other ZenRows features, including custom headers, JavaScript rendering, and wait parameters. Combining features often provides the best results.