全网商品查询接口

请求方法

接口地址:http://api.tkurl.top/api/alimama/material

支持格式:json

请求方式:get

请求示例:http://api.tkurl.top/api/alimama/material?appkey=&q=女装&page_size=20&page_no=1&has_coupon=true

请求说明:查询第一页标题等于女装的全部带券商品,每页显示20条

请求参数说明:

名称 类型 是否必须 示例值 描述
appkey String 必填 123456 appkey
start_dsr int 可选 10 店铺dsr评分,筛选高于等于当前设置的店铺dsr评分的商品0-50000之间
page_size int 可选 20 页大小,默认20,1~100
page_no int 可选 1 第几页,默认:1
end_tk_rate int 可选 1234 淘客佣金比率上限,如:1234表示12.34%
start_tk_rate int 可选 1234 淘客佣金比率下限,如:1234表示12.34%
end_price int 可选 10 折扣价范围上限,单位:元
start_price int 可选 10 折扣价范围下限,单位:元
sort String 可选 tk_rate_des 排序_des(降序),排序_asc(升序),销量(total_sales),淘客佣金比率(tk_rate), 累计推广量(tk_total_sales),总支出佣金(tk_total_commi),价格(price)
itemloc String 可选 杭州 所在地
cat String 可选 16,18 后台类目ID,用,分割,最大10个,点击下载后台类目表
q String 可选 女装 查询词 (q参数和cat参数不能同时为空,必须传入一个)
has_coupon Boolean 可选 false 是否有优惠券,设置为true表示该商品有优惠券,设置为false或不设置表示不判断这个属性

响应参数

名称 类型 示例值 描述
total_results int 20 搜索到符合条件的结果总数
coupon_start_time String 2017-10-29 优惠券开始时间
coupon_end_time String 2017-10-30 优惠券结束时间
info_dxjh Json {"19013551":"2850","74510538":"2550"} 定向计划信息
tk_total_sales String 11 淘客30天月推广量
tk_total_commi String 379 月支出佣金
coupon_id String d62db1ab8d9546b1bf0ff49bda5fc33b 优惠券id
num_iid int 556633720749 宝贝id
title String 毛呢阔腿裤港味复古女裤子秋冬九分裤萝卜裤显瘦高腰韩版2017新款 商品标题
pict_url String https://img.alicdn.com/bao/uploaded/i4/xxxxxxx.jpg 商品主图
small_images String [] https://img.alicdn.com/i4/xxxxx.jpg 商品小图列表
reserve_price String 102.00 商品一口价格
zk_final_price String 88.00 商品折扣价格
user_type int 1 卖家类型,0表示集市,1表示商城
provcity String 杭州 宝贝所在地
item_url String https://item.taobao.com/item.htm?id=564591813536 商品地址
include_mkt String false 是否包含营销计划
include_dxjh String false 是否包含定向计划
commission_rate String 5050表示50.5% 佣金比率
volume int 456 30天销量
seller_id int 249657 卖家id
coupon_total_count int 10000 优惠券总量
coupon_remain_count int 5432 优惠券剩余量
coupon_info String 满299元减20元 优惠券面额
commission_type String MKT表示营销计划,SP表示定向计划,COMMON表示通用计划 佣金类型
shop_title String xx旗舰店 店铺名称

响应示例

    {
        "tbk_dg_material_optional_response":{
            "total_results":1212,
            "result_list":{
                "map_data":[
                    {
                        "coupon_start_time":"2017-10-29",
                        "coupon_end_time":"2017-10-29",
                        "info_dxjh":"{\"19013551\":\"2850\",\"74510538\":\"2550\"}",
                        "tk_total_sales":"11",
                        "tk_total_commi":"323",
                        "coupon_id":"d62db1ab8d9546b1bf0ff49bda5fc33b",
                        "num_iid":556633720749,
                        "title":"毛呢阔腿裤港味复古女裤子秋冬九分裤萝卜裤显瘦高腰韩版2017新款",
                        "pict_url":"https:\/\/img.alicdn.com\/bao\/uploaded\/i4\/745957850\/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg",
                        "small_images":{
                            "string":[
                               "https:\/\/img.alicdn.com\/i4\/3077291146\/TB2NA3poDnI8KJjSszgXXc8ApXa_!!3077291146.jpg"
                            ]
                       },
                        "reserve_price":"102.00",
                        "zk_final_price":"88.00",
                        "user_type":1,
                        "provcity":"杭州",
                        "item_url":"https:\/\/item.taobao.com\/item.htm?id=564591813536",
                        "include_mkt":"false",
                        "include_dxjh":"false",
                        "commission_rate":"1550表示15.5%",
                        "volume":123,
                        "seller_id":232332,
                        "coupon_total_count":22323,
                        "coupon_remain_count":111,
                        "coupon_info":"满299元减20元",
                        "commission_type":"MKT表示营销计划,SP表示定向计划,COMMON表示通用计划",
                        "shop_title":"xx旗舰店"
                    }
                ]
            }
        }
    }
   

异常示例

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

错误码解释

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