拼多多获得搜索词推荐 API

243 阅读3分钟

item_search_suggest-获得搜索词推荐 [查看演示API测试工具 注册开通

onebound.pinduoduo.item_search_suggest

公共参数

请求地址: api-gw.onebound.cn/pinduoduo/i…

名称类型必须描述
keyString调用key(必须以GET方式拼接在URL中)
secretString调用密钥
api_nameStringAPI接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
langString[cn,en,ru]翻译语言,默认cn简体中文
versionStringAPI版本

请求参数

请求参数:q=女装

参数说明:q:搜索关键字\

响应参数

Version: Date:

名称类型必须示例值描述
itemsitems[]0获得搜索词推荐
keywordMix0女装搜索词
resultMix0["女装2019新款潮"]推荐搜索词列表

请求示例

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/pinduoduo/item_search_suggest/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装"

响应示例

{
	"items": {
		"keyword": "女装",
		"result": [
			[
				"女装2021新款潮"
			],
			[
				"女装摩托车"
			],
			[
				"女装三件套洋气"
			],
			[
				"女装卫衣春秋"
			],
			[
				"女装套装"
			],
			[
				"女装春装"
			],
			[
				"女装小个子"
			],
			[
				"女装2021新款外套"
			],
			[
				"女装衬衫长袖洋气"
			],
			[
				"女装羽绒服外套长款"
			],
			[
				"女装t恤新款时尚"
			],
			[
				"女装内裤"
			],
			[
				"女装上衣"
			],
			[
				"女装春秋装"
			],
			[
				"女装衣服外套"
			],
			[
				"女装羽绒服"
			],
			[
				"女装睡衣"
			],
			[
				"女装运动套装"
			],
			[
				"女装卫衣"
			],
			[
				"女装马甲外套"
			]
		]
	},
	"secache": "11d2656d59b74f2c8ea26f48e8a00827",
	"secache_time": 1615362713,
	"secache_date": "2021-03-10 15:51:53",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:31 max:10000",
	"execution_time": 0.098,
	"server_time": "Beijing/2021-03-10 15:51:53",
	"client_ip": "106.6.35.144",
	"call_args": {
		"q": "女装"
	},
	"api_type": "pinduoduo",
	"translate_language": "zh-CN",
	"translate_engine": "baidu",
	"server_memory": "2.85MB",
	"request_id": "gw-1.60487a996c711"
}
```
```
异常示例

```
{
  "error": "item-not-found",
  "reason": "商品没找到",
  "error_code": "2000",
  "success": 0,
  "cache": 0,
  "api_info": "today:0 max:10000",
  "execution_time": 0.081,
  "server_time": "Beijing/2020-06-10 23:44:00",
  "call_args": [],
  "api_type": "taobao",
  "request_id": "15ee0ffc041242"}
```

[]()相关资料错误码解释

| 状态代码(error_code) | 状态信息                               | 详细描述            | 是否收费 |
| ---------------- | ---------------------------------- | --------------- | ---- |
| 0000             | success                            | 接口调用成功并返回相关数据   | 是    |
| 2000             | Search success but no result       | 接口访问成功,但是搜索没有结果 | 是    |
| 4000             | Server internal error              | 服务器内部错误         | 否    |
| 4001             | Network error                      | 网络错误            | 否    |
| 4002             | Target server error                | 目标服务器错误         | 否    |
| 4003             | Param error                        | 用户输入参数错误        | 忽略   |
| 4004             | Account not found                  | 用户帐号不存在         | 忽略   |
| 4005             | Invalid authentication credentials | 授权失败            | 忽略   |
| 4006             | API stopped                        | 您的当前API已停用      | 忽略   |
| 4007             | Account stopped                    | 您的账户已停用         | 忽略   |
| 4008             | API rate limit exceeded            | 并发已达上限          | 忽略   |
| 4009             | API maintenance                    | API维护中          | 忽略   |
| 4010             | API not found with these values    | API不存在          | 忽略   |
| 4012             | Please add api first               | 请先添加api         | 忽略   |
| 4013             | Number of calls exceeded           | 调用次数超限          | 忽略   |
| 4014             | Missing url param                  | 参数缺失            | 忽略   |
| 4015             | Wrong pageToken                    | 参数pageToken有误   | 忽略   |
| 4016             | Insufficient balance               | 余额不足            | 忽略   |
| 4017             | timeout error                      | 请求超时            | 否    |
| 5000             | unknown error                      | 未知错误            | 否