Using the API’s country HTTP GET parameter you can choose a specific country by its 2-letter country code for your scraping request. Please find an example API request on this page, which specifies the US (for the United States) as a proxy location using the default datacenter proxies.

Some plans don’t have access to geolocation targeting, a random country data center or residential IP is assigned to the request.

More information regarding each plan can be found on our pricing page.

Datacenter Proxies Supported Countries

For data center proxies, the API currently supports a total of 10 global geolocations: United States (us), Canada (ca), United Kingdom (gb), Germany (de), France (fr), Spain (es), Mexico (mx), Japan (jp), China (cn), and Australia (au).

Residential Proxies Supported Countries

For premium (residential) proxies, the API currently supports a total of 12 global geolocations. The list includes the United Kingdom (gb), United States of America (us), Canada (ca), Germany (de), France (fr), Japan (jp), China (cn), Australia (au), Spain (es), Brazil (br), India (in) & Mexico (mx).

Access to 195 countries is available to Enterprise customers upon request.

Geolocation examples

Geolocation can be specified with the country parameter.


⇡ Input

curl --request GET --url ""

⇣ Output

    "args": {},
    "headers": {
        "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
        "Accept-Encoding": "gzip, deflate, br",
        "Host": "",
        "Upgrade-Insecure-Requests": "1",
        "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/99.0.4844.0 Safari/537.36",
        "X-Amzn-Trace-Id": "Root=1-6267dc58-3027016b3e1d2f936ac7a94f"
    "origin": "",
    "url": ""

Last updated