淘宝客商品列表API

前往测试接口

onebound.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

请求示例

• Curl
• PHP
• PHPsdk
• JAVA
• C#
• Python

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.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="