网页抓取API
一个端点，覆盖所有页面。该抓取 API 负责代理轮换、无头 Chrome、JavaScript 执行、CAPTCHA 破解和自动重试。
端点
章节标题“端点” GET https://scrape.shifter.io/v1
同时支持 POST 和 PUT 两种方式，参见 POST requests 和 PUT requests。
身份验证
章节标题“身份验证”在每个请求中将您的 API 密钥作为 api_key 查询参数传递。密钥可在面板的 Web Scraping API → API Keys 中管理。
curl "https://scrape.shifter.io/v1?api_key=YOUR_API_KEY&url=https://example.com"核心参数
章节标题“核心参数”| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
api_key | string | 是 | 您的 API 密钥 |
url | string | 是 | 要抓取的 URL |
render_js | 0 | 1 | 否 | 启用无头 Chrome 渲染 |
premium_proxy | 0 | 1 | 否 | 通过住宅 IP 路由（Growth 及以上套餐） |
mobile_proxy | 0 | 1 | 否 | 通过移动 IP 路由（Growth 及以上套餐） |
country | ISO 代码 | 否 | 用于代理地理定位的国家 |
device | desktop | mobile | tablet | 否 | 模拟的设备类型 |
session_id | string | 否 | 跨请求复用 cookie 和代理 |
timeout | ms | 否 | 浏览器最长可用时间，最高 60000 |
wait_for | ms | 否 | 导航后的空闲等待时间（建议 5000-10000） |
wait_for_css | selector | 否 | 阻塞直至出现指定的 CSS 选择器 |
wait_until | string | 否 | 导航等待条件（高级用法） |
keep_headers | 0 | 1 | 否 | 将自定义请求头转发给目标站点 |
custom_headers | JSON | 否 | 自定义请求头（需 URL 编码） |
custom_cookies | string | 否 | Cookie 请求头的值 |
extract_rules | JSON | 否 | 用于解析为结构化 JSON 的 CSS 选择器 |
auto_parser | 0 | 1 | 否 | 自动解析 JSON 响应 |
screenshot | 0 | 1 | 否 | 返回 PNG 而非 HTML |
screenshot_options | JSON | 否 | 截图尺寸与选择器 |
binary_response | 0 | 1 | 否 | 以流式方式返回二进制内容（PDF、图片） |
js_instructions | JSON | 否 | 在抓取前执行滚动/点击/等待操作 |
disable_stealth | 0 | 1 | 否 | 禁用隐身插件 |
webhook | URL | 否 | 响应就绪后将其 POST 到该 URL |
forward_proxy | URL | 否 | 通过您的上游代理进行链式转发 |
任何期望接收 JSON 的参数都必须进行 URL 编码。
快速示例
章节标题“快速示例”curl "https://scrape.shifter.io/v1?api_key=YOUR_API_KEY&url=https://example.com&render_js=1&wait_for_css=h1"端点页面
章节标题“端点页面” 基础请求 Minimal GET with api_key and url.
完整参数 Every parameter documented in detail.
POST 请求 Scrape URLs that require POST bodies.
PUT 请求 Scrape PUT endpoints.
渲染 JavaScript render_js flag and limits.
JavaScript 指令 Scroll, click, wait before capture.
等待 CSS wait_for_css selector syntax.
强制超时 Cap browser time with timeout.
截图 Capture full-page or element PNG.
会话 Hold cookies and IP across requests.
二进制文件 Download PDFs, images, other binaries.
自定义请求头 Forward headers to the target.
自定义 cookie Inject cookies into the request.
代理 Datacenter vs residential vs mobile.
地理定位 country parameter and supported locations.
提取规则 Return parsed JSON.
JSON 自动解析 auto_parser for JSON endpoints.
API 错误 Status codes and retry semantics.