python 请求返回的json取值

goods_list-商品列表api

taobaoke.goods_list

公共参数

请求地址: https://api-gw-4.cn/taobaoke/goods_list

请求参数

请求参数：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:

请求示例

-- 请求示例 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="

响应示例异常示例相关资料错误码解释

API 工具

淘宝客（Taobao Affiliate）是淘宝为推广者提供的一种联盟营销方式，允许推广者通过分享淘宝商品链接获取佣金。淘宝客商品列表API是淘宝客开放平台提供的一个接口，用于获取淘宝商品的推广链接。

该API的返回值通常会包含一系列与商品相关的信息。以下是一个简化的返回值示例及说明：

{
    "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返回值可能会与上述示例有所不同，建议参考淘宝客开放平台的官方文档以获取最准确的信息。