taobao.tbk.item.coupon.get (单品加券检索API)

请求方法

接口地址:http://api.tkurl.top/coupon

支持格式:json

请求方式:get

请求示例:http://api.tkurl.top/coupon?appkey=&pid=mm_xxxx_xxx_xxx&q=女装&page_size=20

请求参数说明:

名称 类型 是否必须 示例值 描述
appkey String 必填 123456 appkey
cat String 可选 16,18 后台类目ID,用,分割,最大10个,点击下载后台类目表
page_size int 可选 20 页大小,默认20,1~100
q String 可选 女装 查询词
page_no int 可选 1 第几页,默认:1(当后台类目和查询词均不指定的时候,最多出10000个结果,即page_no*page_size不能超过10000;当指定类目或关键词的时候,则最多出100个结果)
pid String 必填 mm_123_123_123 三方pid,满足mm_xxx_xxx_xxx格式

响应参数

名称 类型 示例值 描述
shop_title String 秉迪数码专营店 店铺名称
small_images String http://img4.tbcdn.cn/tfscom/i3/TB1vPdxHXXXXXbtXpXXXXXXXXXX_!!2-item_pic.png 商品小图列表
user_type int 1 卖家类型,0表示集市,1表示商城
zk_final_price String 158.00 折扣价
title String zoyu kindle保护套 paperwhite1/2/3套958壳KPW3超薄皮套休眠499 标题
nick String 秉迪数码专营店 卖家昵称
seller_id int 1779343388 卖家id
volume int 4792 30天销量
pict_url String http://img03.daily.taobao.net/tfscom/i1/TB1pBadNpXXXXbgaXXXXXXXXXXX_!!0-item_pic.jpg 商品主图
item_url String http://item.taobao.com/item.htm?id=524136796550 商品详情页链接地址
coupon_total_count int 8000 优惠券总量
commission_rate String 50.30 佣金比率(%)
coupon_info String 满16元减10元 优惠券面额
category int 1 后台一级类目
num_iid int 524136796550 itemId
coupon_remain_count int 6859 优惠券剩余量
coupon_start_time String 2016-09-25 优惠券开始时间
coupon_end_time String 2016-09-26 优惠券结束时间
coupon_click_url String https://uland.taobao.com/coupon/edetail?e=xxxxxxxxx 商品优惠券推广链接
item_description String 夏季凉被 全棉亲肤 宝贝描述(推荐理由)
total_results int 100 总请求数

响应示例

{
    "tbk_item_coupon_get_response":{
        "results":{
            "tbk_coupon":[
                {
                    "small_images":{
                        "string":[
                            "http:\/\/img4.tbcdn.cn\/tfscom\/i3\/TB1vPdxHXXXXXbtXpXXXXXXXXXX_!!2-item_pic.png"
                        ]
                    },
                    "shop_title":"秉迪数码专营店",
                    "user_type":1,
                    "zk_final_price":"158.00",
                    "title":"zoyu kindle保护套 paperwhite1\/2\/3套958壳KPW3超薄皮套休眠499",
                    "nick":"秉迪数码专营店",
                    "seller_id":1779343388,
                    "volume":4792,
                    "pict_url":"http:\/\/img03.daily.taobao.net\/tfscom\/i1\/TB1pBadNpXXXXbgaXXXXXXXXXXX_!!0-item_pic.jpg",
                    "item_url":"http:\/\/item.taobao.com\/item.htm?id=524136796550",
                    "coupon_total_count":8000,
                    "commission_rate":"50.30",
                    "coupon_info":"满16元减10元",
                    "category":1,
                    "num_iid":0,
                    "coupon_remain_count":6859,
                    "coupon_start_time":"2016-09-25",
                    "coupon_end_time":"2016-09-26",
                    "coupon_click_url":"https:\/\/uland.taobao.com\/coupon\/edetail?e=NX%2Fo0GUzcHkGQASttHIRqbYlZkeSuQ8GiGZozHNkuvFyvrZzJ209kk89GSPPdaARIn1lCThcaBmD%2ByuIPB7ZA79fwBwwUiqlVFk%2FlIg7J0HYd3v6q6tpEm7PVn13QcLNgPRfTgnhrZM%3D&traceId=0bb75cd915144045746605710e",
                    "item_description":"夏季凉被 全棉亲肤"
                }
            ]
        },
        "total_results":100
    }
}
   

异常示例

{
    "error_response":{
        "sub_msg":"非法参数",
        "code":50,
        "sub_code":"isv.invalid-parameter",
        "msg":"Remote service error"
    }
}
   

错误码解释

错误码 错误描述 解决方案
isv.invalid-parameter 参数填写不正确 参数填写不正确
602 调用次数超出
603 未找到用户或该用户未注册 请输入正确的appkey
604 未知参数错误 建议加入重试机制
404 参数传入错误_未知参数 检查参数类型是否正确