公共参数
请求地址: 跨境电商平台接口提供商 数据采集公司 数据接口定制服务 企业级数据服务商
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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.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="
响应示例
异常示例
相关资料
错误码解释
状态代码(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 | 未知错误 | 否 |