Scrapinghub Reference Documentation

Crawlera Residential


Crawlera Residential is available as a paid addon to Crawlera Enterprise customers.

Crawlera Residential allows you to send requests using residential IPs, as opposed to the datacenter IPs used by default in Crawlera.

To use it, contact our support team or your account manager. Once Crawlera Residential is enabled for your account, you will have a separate Crawlera user to use for residential requests. This user should only be used for residential requests, as its usage will incur in extra charges.

Differences with Crawlera Datacenter

There are a few important differences between Crawlera Residential and Crawlera Datacenter (the standard Crawlera behaviour).

  • pricing is per bandwidth (GB transferred) instead of successful requests

  • when using the Proxy API, Crawlera residential supports an additional Crawlera header: X-Crawlera-Region which can be used to select the region (country) of the request on the fly, as opposed to having it predefined on the Crawlera user (as is the case with Crawlera Datacenter).

  • there is no automatic retries by default when using Crawlera Residential, but you can enable them through the X-Crawlera-Max-Retries header. This is to prevent customers from incurring into unexpected costs, as residential is charged per GB of bandwidth, not successful requests.