Geolocation

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.

GET https://scrape.shifter.io/v1?api_key=api_key&url=https://httpbin.org/get&country=us&proxy_type=datacenter

⇡ Input

cURL

curl --request GET --url "https://scrape.shifter.io/v1?api_key=api_key&url=https%3A%2F%2Fhttpbin.org%2Fget&country=us&proxy_type=datacenter"

NodeJS

const http = require("https");

const options = {
  "method": "GET",
  "hostname": "scrape.shifter.io",
  "port": null,
  "path": "/v1?api_key=api_key&url=https%3A%2F%2Fhttpbin.org%2Fget&country=us&proxy_type=datacenter",
  "headers": {}
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

Python

import http.client

conn = http.client.HTTPSConnection("scrape.shifter.io")

conn.request("GET", "/v1?api_key=api_key&url=https%3A%2F%2Fhttpbin.org%2Fget&country=us&proxy_type=datacenter")

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://scrape.shifter.io/v1?api_key=api_key&url=https%3A%2F%2Fhttpbin.org%2Fget&country=us&proxy_type=datacenter",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Golang

package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://scrape.shifter.io/v1?api_key=api_key&url=https%3A%2F%2Fhttpbin.org%2Fget&country=us&proxy_type=datacenter"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

Java

HttpResponse<String> response = Unirest.get("https://scrape.shifter.io/v1?api_key=api_key&url=https%3A%2F%2Fhttpbin.org%2Fget&country=us&proxy_type=datacenter")
  .asString();

.NET

var client = new RestClient("https://scrape.shifter.io/v1?api_key=api_key&url=https%3A%2F%2Fhttpbin.org%2Fget&country=us&proxy_type=datacenter");
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);

Ruby

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://scrape.shifter.io/v1?api_key=api_key&url=https%3A%2F%2Fhttpbin.org%2Fget&country=us&proxy_type=datacenter")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

⇣ 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": "httpbin.org",
        "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": "192.3.214.245",
    "url": "https://httpbin.org/get"
}