Proxy Options

Some websites employ bot detection that blocks automated requests. Our proxy options help you access these sites reliably.

Proxy Types

Parameter	Type	Credit Cost	Best For
use_proxy	Datacenter	10 credits	Basic bot protection
use_premium	Residential	20 credits	Cloudflare, Akamai, PerimeterX
use_superior	Mobile	30 credits	Heavily protected sites

When to Use Proxies

Start Without Proxies

Most websites work without proxies. Start with a basic request and only add proxies if you get blocked:

Basic request (no proxy)

curl "https://opengraph.io/api/1.1/site/https%3A%2F%2Fexample.com?app_id=YOUR_APP_ID"

Standard Proxy (use_proxy)

Try this first if you encounter 403 errors or empty responses:

Standard proxy

curl "https://opengraph.io/api/1.1/site/https%3A%2F%2Fexample.com?app_id=YOUR_APP_ID&use_proxy=true"

Residential Proxy (use_premium)

For sites with sophisticated bot detection like Cloudflare or Akamai:

Residential proxy

curl "https://opengraph.io/api/1.1/site/https%3A%2F%2Fexample.com?app_id=YOUR_APP_ID&use_premium=true"

Mobile Proxy (use_superior)

For the most heavily protected sites that block all other methods:

Mobile proxy

curl "https://opengraph.io/api/1.1/site/https%3A%2F%2Fexample.com?app_id=YOUR_APP_ID&use_superior=true"

Recommendation: Use the cheapest option that works. Try them in order: no proxy → use_proxy → use_premium → use_superior.

Auto Proxy

For qualifying plans, OpenGraph.io offers Auto Proxy. This feature automatically selects the appropriate proxy based on the target site.

Auto Proxy is enabled by default on eligible plans. To disable it:

Disable auto proxy

curl "https://opengraph.io/api/1.1/site/https%3A%2F%2Fexample.com?app_id=YOUR_APP_ID&auto_proxy=false"

Combining with Other Options

Proxies can be combined with other parameters like full_render:

Proxy + JavaScript rendering

curl "https://opengraph.io/api/1.1/site/https%3A%2F%2Fexample.com?app_id=YOUR_APP_ID&use_premium=true&full_render=true"

Credit Costs

If the request is cached, it will cost 1 credit.
use_proxy: + full_render: +10 credits (total: 20)
use_premium: +20 credits (total: 30)
use_superior: +30 credits (total: 40)

Troubleshooting Blocked Requests

If you're still getting blocked after using proxies:

Try adding full_render=true for JavaScript-heavy sites
Set an appropriate accept_lang header
Use cache_ok=false to ensure fresh attempts
Contact support if a specific site consistently fails

Scrape API

Web scraping with proxy support.

Caching

Control freshness of proxied requests.

Error Handling

Handle blocked request errors.