item_get_sales-获取商品销量详情
taobao.item_get_sales
公共参数
请求地址: https://api-gw-4.cn/taobao/item_get_sales
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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版本 |
请求参数
请求参数:num_iid=520813250866
参数说明:num_iid:淘宝商品ID
monthly:1(获取月销量)
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
item | item[] | 0 | 获取商品销量详情 |
请求示例
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw-3.cn/taobao/item_get_sales/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=520813250866"
响应示例
{ "item": [ { "num_iid": "42402278132", "detail_url": "http://item.taobao.com/item.htm?id=42402278132", "total_sales": "474149" } ], "data_from": "fu", "error": "", "reason": "", "error_code": "0000", "cache": 0, "api_info": "today:9 max:10000 all[20=9+0+11];expires:2030-12-31", "execution_time": "1.816", "server_time": "Beijing/2023-06-21 09:44:00", "client_ip": "115.153.49.96", "call_args": [], "api_type": "taobao", "translate_language": "zh-CN", "translate_engine": "baidu", "server_memory": "6.05MB", "request_id": "gw-1.649255deded03", "last_id": "1822039238" }
异常示例
{ "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 工具
淘宝和天猫提供了API接口供开发者获取商品的销量详情。具体的返回值会根据API的版本和调用方式有所不同。以下是一个简化的示例,展示了可能返回的一些字段,以及它们通常代表的含义:
```json
{
"num_iid": "商品数字ID",
"title": "商品标题",
"sold_num": "最近30天售出数量",
"cumulative_sold_num": "商品累计售出数量",
"nick": "卖家昵称",
"shop_type": "店铺类型",
"price": "商品价格",
"promotion_price": "促销价格",
"pic_url": "商品主图链接",
"detail_url": "商品详情页链接",
"rate": {
"num_ratings": "评价人数",
"score": "商品评分",
"detail": {
"5": "5分评价人数",
"4": "4分评价人数",
"3": "3分评价人数",
"2": "2分评价人数",
"1": "1分评价人数"
}
},
"coupon_info": {
"coupon_count": "优惠券数量",
"coupon_amount": "优惠券面额"
},
"after_service": {
"type": "售后服务类型",
"text": "售后服务说明"
},
// 其他字段...
}
```
请注意,上述示例中的字段并非全部,也不是淘宝/天猫API的官方返回值。实际的API返回值可能会因API版本、请求参数、卖家设置等因素而有所不同。
为了获取准确的API返回值说明,你应该访问淘宝/天猫开放平台的官方文档,并查找相应的API接口文档。这些文档会提供详细的请求参数、返回值字段说明、错误代码等信息。
此外,需要注意的是,淘宝/天猫的API接口通常需要对开发者进行授权和认证,确保调用接口的合法性。在调用API之前,你需要按照淘宝/天猫开放平台的要求完成相应的开发者注册、应用创建、API权限申请等步骤。
最后,由于淘宝/天猫平台的更新和变化,建议你定期查看官方文档以获取最新的API信息和最佳实践。