获取goods_list-商品列表api
taobaoke.goods_list
公共参数
请求地址: https://api-gw-4.cn/taobaoke/goods_list
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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版本 |
请求参数
请求参数:pageId=1&pageSize=40&sort=&cids=&subcid=&taoQiangGou=&tmall=&tchaoshi=&goldSeller=&haitao=&pre=&brand=&priceLowerLimit=&priceUpperLimit=&couponPriceLowerLimit=&commissionRateLowerLimit=&monthSalesLowerLimit=&version=&appKey=&appSecret=
参数说明: pageSize 每页条数 否 Number 默认为100,最大值200,若小于10,则按10条处理,每页条数仅支持输入10,50,100,200
pageId 分页id 是 String 默认为1,支持传统的页码分页方式和scroll_id分页方式,根据用户自身需求传入值。示例1:商品入库,则首次传入1,后续传入接口返回的pageid,接口将持续返回符合条件的完整商品列表,该方式可以避免入口商品重复;示例2:根据pagesize和totalNum计算出总页数,按照需求返回指定页的商品(该方式可能在临近页取到重复商品)
sort 排序方式 否 String 默认为0,0-综合排序,1-商品上架时间从高到低,2-销量从高到低,3-领券量从高到低,4-佣金比例从高到低,5-价格(券后价)从高到低,6-价格(券后价)从低到高
cids 一级类目id 否 String 大淘客的一级分类id,如果需要传多个,以英文逗号相隔,如:”1,2,3”。当一级类目id和二级类目id同时传入时,会自动忽略二级类目id
subcid 二级类目id 否 Number 大淘客的二级类目id,通过超级分类API获取。仅允许传一个二级id,当一级类目id和二级类目id同时传入时,会自动忽略二级类目id
juHuaSuan 是否聚划算 否 Number 1-聚划算商品,0-所有商品,不填默认为0
taoQiangGou 是否淘抢购 否 Number 1-淘抢购商品,0-所有商品,不填默认为0
tmall 是否天猫商品 否 Number 1-天猫商品,0-所有商品,不填默认为0
tchaoshi 是否天猫超市商品 否 Number 1-天猫超市商品,0-所有商品,不填默认为0
goldSeller 是否金牌卖家 否 Number 1-金牌卖家,0-所有商品,不填默认为0
haitao 是否海淘商品 否 Number 1-海淘商品,0-所有商品,不填默认为0
pre 是否预告商品 否 Number 1-预告商品,0-非预告商品
brand 是否品牌商品 否 Number 1-品牌商品,0-所有商品,不填默认为0
brandIds 品牌id 否 String 当brand传入0时,再传入brandIds将获取不到结果。品牌id可以传多个,以英文逗号隔开,如:”345,321,323”
priceLowerLimit 价格(券后价)下限 否
priceUpperLimit 价格(券后价)上限 否
couponPriceLowerLimit 最低优惠券面额
commissionRateLowerLimit 最低佣金比率
monthSalesLowerLimit 最低月销量
appKey:大淘客key
appSecret:大淘宝密钥
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
num_iid | String | 0 | ||
pageId | String | 0 | ||
pageSiz | String | 0 | ||
sor | String | 0 | ||
cid | String | 0 | ||
subci | String | 0 | ||
taoQiangGo | String | 0 | ||
tmal | String | 0 | ||
tchaosh | String | 0 | ||
goldSelle | String | 0 | ||
haita | String | 0 | ||
pr | String | 0 | ||
bran | String | 0 | ||
priceLowerLimi | String | 0 | ||
priceUpperLimi | String | 0 | ||
couponPriceLowerLimi | String | 0 | ||
commissionRateLowerLimi | String | 0 | ||
monthSalesLowerLimi | String | 0 |
请求示例
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw-4.cn/taobaoke/goods_list/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&pageId=1&pageSize=40&sort=&cids=&subcid=&taoQiangGou=&tmall=&tchaoshi=&goldSeller=&haitao=&pre=&brand=&priceLowerLimit=&priceUpperLimit=&couponPriceLowerLimit=&commissionRateLowerLimit=&monthSalesLowerLimit=&version=&appKey=&appSecret="
响应示例
异常示例
相关资料
错误码解释
状态代码(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 工具
淘宝客(Taobao Affiliate)是淘宝为推广者提供的一种联盟营销方式,允许推广者通过分享淘宝商品链接获取佣金。淘宝客商品列表API是淘宝客开放平台提供的一个接口,用于获取淘宝商品的推广链接。
该API的返回值通常会包含一系列与商品相关的信息。以下是一个简化的返回值示例及说明:
```json
{
"total_results": 100,
"total_pages": 10,
"page_no": 1,
"items": [
{
"num_iid": "526872757572",
"title": "商品标题",
"pic_url": "https://img.taobao.com/xxx.jpg",
"price": "100.00",
"click_url": "https://aff.taobao.com/xxx?spm=a210m.1007.0.0.xxx&id=526872757572&click=y&usertype=1",
"commission_rate": "10.00",
"commission_num": "10.00"
// 其他可能存在的字段,如volume、shop_title、is_tmall等
},
// 其他商品信息...
]
}
```
返回值说明:
* `total_results`: 符合条件的商品总数。
* `total_pages`: 总页数,根据page_size和商品总数计算得出。
* `page_no`: 当前页码。
* `items`: 商品列表数组。
对于`items`中的每一个商品:
* `num_iid`: 商品编号。
* `title`: 商品标题。
* `pic_url`: 商品主图链接。
* `price`: 商品价格。
* `click_url`: 点击链接,用于推广者引导用户点击。
* `commission_rate`: 佣金比率,如10.00表示10%。
* `commission_num`: 佣金金额,根据商品价格和佣金比率计算得出。
除了上述字段,根据API的不同版本和参数,可能还有其他字段,如商品销量(`volume`)、店铺名称(`shop_title`)、是否为天猫商品(`is_tmall`)等。
注意:实际的API返回值可能会与上述示例有所不同,建议参考淘宝客开放平台的官方文档以获取最准确的信息。