会话

在多个请求中传递相同的整数给 session，即可让这些请求全部使用同一个代理 IP。当目标网站在单次导航或登录流程中通过 IP 追踪你时，这个功能非常有用。会话在最后一次使用后 5 分钟过期。

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	你的 Web Scraping API 密钥
url	string	yes	要抓取的目标 URL
session	integer	no	任意整数。重复使用相同的值以复用同一个代理。
country	string	no	创建会话时使用的可选国家代码。
proxy_type	string	no	datacenter（默认）或 residential。

Note

新的整数会创建一个新的会话和新的代理。在流程完成之前，请保持使用相同的整数。

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

• 代理
• 地理位置