item_search_suggest-获得搜索词推荐
pinduoduo.item_search_suggest
公共参数
请求地址: https://api-gw-4.cn/pinduoduo/item_search_suggest
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
key | String | 是 | 调用key(必须以GET方式拼接在URL中) |
secret | String | 是 | 调用密钥 |
api_name | String | 是 | API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默认yes,将调用缓存的数据,速度比较快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读 |
lang | String | 否 | [cn,en,ru]翻译语言,默认cn简体中文 |
version | String | 否 | API版本 |
请求参数
请求参数:q=女装
参数说明:q:搜索关键字
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
items | items[] | 0 | 获得搜索词推荐 |
请求示例
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw-4.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 | 未知错误 | 否 |
API 工具
拼多多(Pinduoduo)是一个中国电商平台,它提供的API接口返回值会因API的具体功能、版本和请求类型而异。如果你指的是拼多多提供的搜索词推荐API的返回值,通常这个API会返回与搜索词相关的商品、店铺或活动信息。
以下是一个简化的拼多多搜索词推荐API返回值示例说明:
```json
{
"status": 0,
"msg": "success",
"result": {
"keywords": ["关键词1", "关键词2", "关键词3"],
"items": [
{
"id": "商品ID1",
"name": "商品名称1",
"price": "商品价格1",
"image_url": "商品图片URL1",
"sales_volume": "销售数量1",
"rating": "评分1",
// 其他商品属性...
},
{
"id": "商品ID2",
"name": "商品名称2",
"price": "商品价格2",
"image_url": "商品图片URL2",
"sales_volume": "销售数量2",
"rating": "评分2",
// 其他商品属性...
},
// ...更多商品信息
]
}
}
```
这个返回值通常包括以下几部分:
- **status**:状态码,通常0表示成功,非0值表示出现错误。
- **msg**:消息文本,提供关于请求结果的额外信息,如"success"表示请求成功。
- **result**:结果数据,包含实际的搜索词推荐内容。
- **keywords**:推荐的关键词列表。
- **items**:与关键词相关的商品列表,每个商品包含ID、名称、价格、图片URL、销售数量、评分等信息。
需要注意的是,实际的API返回值可能更加复杂,并且包含更多的信息,如错误详情、分页参数等。为了获得准确的API返回值说明,你应该参考拼多多的官方API文档或联系他们的技术支持。
此外,API的返回值可能会随着平台的更新而发生变化,所以最好是查阅最新的官方文档来获取准确的信息。