Geolocation

Use the country parameter with a 2-letter ISO country code to send the request from that location. Supported countries depend on the proxy type. Plans without geolocation access get a random country for the chosen pool.

Endpoint

GET https://scrape.shifter.io/v1?api_key=YOUR_API_KEY&url=<TARGET_URL>&country=us&proxy_type=datacenter

Parameters

Parameter	Type	Required	Description
api_key	string	yes	Your Web Scraping API key
url	string	yes	Target URL to fetch
country	string	no	2-letter country code (e.g. us, gb, de).
proxy_type	string	no	datacenter (default) or residential.

Supported countries

• Datacenter: us, ca, gb, de, fr, es, mx, jp, cn, au.
• Residential: us, ca, gb, de, fr, es, jp, cn, au, br, in, mx.

Note

Enterprise plans can access all 195 global geolocations on request.

Example request

curl

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

Python

import requests

r = requests.get("https://scrape.shifter.io/v1", params={
    "api_key": "YOUR_API_KEY",
    "url": "https://httpbin.org/get",
    "country": "us",
    "proxy_type": "datacenter",
})
print(r.json())

Node.js

import fetch from 'node-fetch';

const url = 'https://scrape.shifter.io/v1?' + new URLSearchParams({
  api_key: 'YOUR_API_KEY',
  url: 'https://httpbin.org/get',
  country: 'us',
  proxy_type: 'datacenter',
});
const res = await fetch(url);
console.log(await res.json());

Example response

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

See also

• Proxies
• Sessions