English
中文简体
如何开始
如何使用IpStar代理
常见问题解答
数据 API
通用网页抓取 API 文档
1. 提交爬虫任务 API
POST
https://scraper.ipstar.io/v1/scraper/web/task
Header
| Key | 类型 | 描述 | 示例 |
|---|---|---|---|
| Authorization | string | Bearer + api-key | Bearer |
Body
| Key | 类型 | 描述 | 是否必需 |
|---|---|---|---|
| geo | string | 国家位置编码 | 可选 |
| locale | string | 语言编码 | 可选 |
| js_render | boolean | JS 渲染 | 可选 |
| format | array[string] | 结果格式 | 可选 |
| screen_type | integer |
| 可选 |
| url | string | 链接地址 | 必需 |
2. 爬虫任务列表 API
GET
https://scraper.ipstar.io/v1/scraper/web/tasks
Header
| Key | 类型 | 描述 | 示例 |
|---|---|---|---|
| Authorization | string | Bearer + api-key | Bearer |
Params
| Key | 类型 | 描述 | 是否必需 |
|---|---|---|---|
| start_time | string | 开始时间 | 可选 |
| end_time | string | 结束时间 | 可选 |
| page_index | integer | 分页索引 | 可选 |
| page_size | integer | 分页容量 | 可选 |
Result
| Key | 类型 | 描述 | 是否必需 |
|---|---|---|---|
| code | integer | 200 | |
| msg | string | success | |
| data | object | ||
count | integer | 必需 | |
list | array | ||
| task_id | string | 任务 ID | 必需 |
| url | string | 链接地址 | 必需 |
| status | integer |
| 必需 |
| req_num | integer | 提交数量 | 必需 |
| suc_num | integer | 成功数量 | 必需 |
| formats | array[string] | 结果格式 | 必需 |
| duration | integer | 时长 | 必需 |
| start_time | string | 开始时间 | 必需 |
| end_time | string | 结束时间 | 必需 |
| create_time | string | 创建时间 | 必需 |
| result | object | 必需 | |
| html | string | HTML | 必需 |
| png | string | PNG | 必需 |