检索精选联盟商品
5508人使用

本接口用于检索小店联盟商品。可根据筛选条件过滤出满足条件的商品,

也可根据排序条件对检索出来的商品进行排序。

接口地址: http://api.tbk.dingdanxia.com/douyin/product_search 在线测试

接口支持https,非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

page

Int64

1

分页(从1开始)

page_size

Int64

20

每页的数量(小于等于20)

title

String

商品标题,返回标题中包含某个关键词的商品

first_cids

String

筛选商品一级类目

second_cids

String

筛选商品二级类目

third_cids

String

筛选商品三级类目

price_min

Int32

筛选价格区间-最小值(单位为分)

price_max

Int32

1000 筛选价格区间-最大值(单位为分)

sell_num_min

Int32

筛选历史销量区间-最小值

sell_num_max

Int32

筛选历史销量区间-最大值

search_type

Int32

召回结果排序条件,0默认排序1历史销量排序2价格排序3佣金金额排序4佣金比例排序;

sort_type

Int32

排序顺序(0升序1降序)

cos_fee_min

Int32

筛选普通佣金区间-最小值(单位为分)

cos_fee_max

Int32

筛选普通佣金区间-最大值(单位为分)

cos_ratio_min

Int32

筛选普通佣金率区间-最小值 (乘100,例如1.1%为110)

cos_ratio_max

Int32

筛选普通佣金率区间-最大值(乘100,例如1.1%为110)

返回参数说明

标记

类型

例子

说明

product_id

Int64

商品id

title

String

商品标题

price

Int64

商品售价(单位为分)

cos_ratio

Double

普通佣金比例(乘100,例如10%为10)

cos_fee

Int64

普通佣金金额(单位为分)

first_cid

Int64

商品一级类目

second_cid

Int64

商品二级类目

third_cid

Int64

商品三级类目

in_stock

Bool

是否有库存

sales

Int64

历史总销量

cover

String

商品主图

detail_url

String

商品链接(普通计划链接)

shop_id

Int64

店铺ID

shop_name

String

店铺名称

coupon_price

Int64

券后价(单位:分)

返回示例
{
    "code": 200,
    "msg": "请求成功【success】",
    "data": [
        {
            "cos_fee": 396,
            "cos_ratio": 40,
            "coupon_price": null,
            "cover": "https://p9-aio.ecombdimg.com/obj/temai/1122d7e59c000e993781346b2ba925a1www800-800",
            "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3453769915167842926&pick_source=8twav4p",
            "first_cid": 20071,
            "in_stock": true,
            "price": 990,
            "product_id": 3453769915167842926,
            "sales": 635876,
            "second_cid": 21265,
            "shop_id": 12548735,
            "shop_name": "兰姐优品",
            "third_cid": 27216,
            "title": "花洒支架免打孔底座浴室花洒支架  万向花洒支架"
        },
        {
            "cos_fee": 406,
            "cos_ratio": 41,
            "coupon_price": null,
            "cover": "https://p3-aio.ecombdimg.com/obj/temai/9b8bacf77ed5cdf89a2b36092d2742a1www800-800",
            "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3454529608907668635&pick_source=8twLURf",
            "first_cid": 20048,
            "in_stock": true,
            "price": 990,
            "product_id": 3454529608907668635,
            "sales": 632381,
            "second_cid": 20815,
            "shop_id": 12547395,
            "shop_name": "妹妹优品",
            "third_cid": 25571,
            "title": "【粉丝福利】一次性保鲜膜套 保鲜膜 保鲜膜套保鲜盖"
        }
    ]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。