拼多多的关键词搜索列表接口主要是通过 `item_search` 接口实现的,以下是关于该接口的关键信息:
接口功能
`item_search` 接口可以根据用户输入的关键词返回符合条件的商品列表,包括商品标题、价格、图片、销量等详细信息。
请求参数
以下是接口的公共参数和请求参数:
公共参数
| 参数名称 | 类型 | 是否必须 | 描述 |
| key | String | 是 | 调用key,必须以GET方式拼接在URL中 |
| secret | String | 是 | 调用密钥 |
| api_name | String | 是 | API接口名称,这里是“item_search” |
| cache | String | 否 | 是否调用缓存数据,默认为“yes” |
| result_type | String | 否 | 返回数据格式,默认为“json” |
| lang | String | 否 | 翻译语言,默认为“cn”(简体中文) |
| version | String | 否 | API版本 |
请求参数
| 参数名称 | 类型 | 是否必须 | 描述 |
| --- | --- | --- | --- |
| q | String | 是 | 搜索关键词 |
| start_price | Float | 否 | 价格区间起始值 |
| end_price | Float | 否 | 价格区间结束值 |
| page | Int | 否 | 页码,默认为1 |
| cat | Int | 否 | 商品分类ID |
| discount_only | Boolean | 否 | 是否仅显示优惠商品 |
| sort | String | 否 | 排序方式(如`bid`按价格排序,`sale`按销量排序) |
| page_size | Int | 否 | 每页商品数量 |
响应参数
返回的数据为JSON格式,包含以下字段:
| 参数名称 | 类型 | 描述 |
| --- | --- | --- |
| items | Array | 商品列表 |
| title | String | 商品标题 |
| pic_url | String | 商品图片链接 |
| price | Float | 商品价格 |
| promotion_price | Float | 优惠价格 |
| sales | Int | 商品销量 |
| num_iid | Bigint | 商品ID |
| detail_url | String | 商品详情页链接 |
示例代码
以下是一个使用Python调用该接口的示例代码:
```python
import requests
url = "https://example.com/pinduoduo/item_search/?key=<您的apiKey>&secret=<您的apiSecret>&q=女装&start_price=0&end_price=0&page=1&cat=0&sort=&page_size=10"
headers = {"Accept-Encoding": "gzip", "Connection": "close"}
response = requests.get(url, headers=headers)
data = response.json()
print(data)
```
#注意事项
1. **API申请**:需要在拼多多开放平台注册开发者账号并获取API密钥(key和secret)。
2. **调用限制**:拼多多API有调用频率限制和权限限制,需遵守平台的使用规范。3. **数据使用**:获取的数据可用于数据分析、商品监控等业务,但需符合拼多多的使用政策。
4.也可以借助第三方数据软件:如鼎点数据,有成熟的接口服务和数据服务,可以直接调用。
如需更详细的信息,建议查阅拼多多开放平台的官方文档或联系其技术支持团队。