Avoid blocks with proxies

By default, FetchFox connects using low-cost proxies. Some sites block those proxies, so you may need a different proxy tier. To pick a proxy explicitly, set the proxy field in visit, crawl, extract, or scrape requests. Example:

curl -X POST https://api.fetchfox.ai/api/crawl \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $FETCHFOX_API_KEY" \
-d '{
    "pattern":"https://pokemondb.net/pokedex/*",
    "proxy": "residential",
    "maxVisits": 50
}'

Different domains need different proxy tiers. Start with cheaper tiers when possible. Current proxy tiers in automatic selection and their costs:

Proxy tier	Cost per GB
`none`	$0.025
`datacenter`	$0.05
`datacenter_shared`	$0.80
`datacenter_dedicated`	$0.05
`isp_dedicated`	$0.05
`residential`	$8.10
`residential_cdp`	$8.20
`residential_cdp_assets`	$8.50
`unblock`	$2.00

If a site is still blocked, try proxy: "auto" to let FetchFox choose.

Try multiple proxies

You can also pass an array to proxy and FetchFox will try multiple tiers concurrently. Example:

curl -X POST https://api.fetchfox.ai/api/extract \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $FETCHFOX_API_KEY" \
-d '{
    "urls": ["https://pokemondb.net/pokedex/pikachu"],
    "template": "pokemon name, number, and basic stats",
    "proxy": ["datacenter", "residential"]
}'

Automatically pick a proxy

Pass proxy: "auto" to let FetchFox choose based on historical success/cost data for that domain.

curl -X POST https://api.fetchfox.ai/api/crawl \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $FETCHFOX_API_KEY" \
-d '{
    "pattern":"https://pokemondb.net/pokedex/*",
    "proxy": "auto",
    "maxVisits": 50
}'

Read our guide on automatic proxy selection for more information on how this works.

​Try multiple proxies

​Automatically pick a proxy

Try multiple proxies

Automatically pick a proxy