Sessions

Pass the same integer to session across multiple requests to keep the same proxy IP for all of them. Useful when a target site tracks you by IP within a single navigation or login flow. Sessions expire 5 minutes after their last use.

Endpoint

GET https://scrape.shifter.io/v1?api_key=YOUR_API_KEY&url=<TARGET_URL>&session=<INTEGER>

Parameters

Parameter	Type	Required	Description
api_key	string	yes	Your Web Scraping API key
url	string	yes	Target URL to fetch
session	integer	no	Any integer. Reuse the same value to reuse the same proxy.
country	string	no	Optional country code used when the session is created.
proxy_type	string	no	datacenter (default) or residential.

Note

A new integer creates a new session and a new proxy. Stick with the same integer until your flow is complete.

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&session=100"

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",
    "session": 100,
})
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',
  session: '100',
});
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",
    "Host": "httpbin.org",
    "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4889.0 Safari/537.36"
  },
  "origin": "192.241.96.150",
  "url": "https://httpbin.org/get"
}

See also

• Proxies
• Geolocation