合作抓取接口文档

抓取合作接口文档

1. 接口概述

本接口为抓取合作数据的接口，用于抓取指定平台的数据并返回给合作方。

2. 接口地址

http://api.xxx.com/crawl

3. 请求方式

POST

4. 请求参数

参数名 | 参数类型 | 必填 | 描述 ---|---|---|--- platform | String | 是 | 指定要抓取的平台，如：taobao、jd 等 keyword | String | 是 | 搜索关键字，如：手机、电视 等 page | Integer | 否 | 指定搜索结果的页码，从 1 开始，默认为 1 pageSize | Integer | 否 | 指定每页显示的结果数量，默认为 20

5. 请求示例

{
  "platform": "taobao",
  "keyword": "手机",
  "page": 1,
  "pageSize": 20
}

6. 响应参数

参数名 | 参数类型 | 描述 ---|---|--- code | Integer | 接口返回状态码，200 表示成功，其他表示失败 message | String | 接口返回状态信息，如：成功、失败原因等 data | Object | 接口返回数据，具体内容根据请求的平台和关键字不同而不同

7. 响应示例

{
  "code": 200,
  "message": "成功",
  "data": [
    {
      "title": "xxx手机",
      "price": 1999,
      "link": "http://xxx.com/xxx?id=12345",
      "image": "http://xxx.com/xxx.jpg"
    },
    {
      "title": "yyy手机",
      "price": 2999,
      "link": "http://yyy.com/yyy?id=56789",
      "image": "http://yyy.com/yyy.jpg"
    }
  ]
}

8. 备注

• 本接口需要合作方提供有效的平台账号和权限，才能正常进行数据抓取；
• 本接口返回的数据仅供参考，具体数据以平台实际情况为准；
• 本接口不支持对付费商品的抓取