抖音电商商品搜索接口(v15)

状态码	说明
-1	failed
0	success
400	参数错误
1001	账户余额不足
1002	邮箱/手机号或密码错误
1003	请求频率超过上限
1004	邮箱或手机号已注册
1005	无效的 API Key
1006	用户不存在
1007	登录凭证无效
1008	缺少 API Key
1009	手机或邮箱已存在
1010	需要管理员授权
1011	原密码错误
1012	新密码不能与原密码相同
1013	手机号和uid不能都为空
1014	请填写验证码
1015	验证码错误或已过期
1016	登录失败次数过多，请输入验证码
1017	请填写手机号
1018	请填写邮箱
1019	接口不存在，请检查
5000	服务暂时不可用，请稍后重试
5003	网络连接失败，请稍后重试
6001	修改密码失败，请稍后重试

JSON 关键字段说明

字段路径	示例值	说明
`data.total`	`500`	商品总数
`data.has_more`	`true`	是否还有更多
`data.promotions[].product_id`	`"3775487009729151155"`	商品 ID
`data.promotions[].promotion_id`	`"3775487363879404011"`	推广 ID
`data.promotions[].base_info.title`	`"iQOO120W闪充充电器套装iqooneo7..."`	商品标题
`data.promotions[].base_info.price`	`null`	价格（本接口为 null，实际价格见 marketing_info）
`data.promotions[].base_info.main_img.url_list[0]`	`"https://p3-aio.ecombdimg.com/obj/ecom-shop-material/jpeg_m_..."`	商品主图
`data.promotions[].base_info.detail_url`	`"https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=..."`	商品详情链接
`data.promotions[].base_info.category.first_category.category_name`	`"3C数码及配件"`	一级类目
`data.promotions[].base_info.category.second_category.category_name`	`"手机及配件"`	二级类目
`data.promotions[].base_info.category.third_category.category_name`	`"手机充电器"`	三级类目
`data.promotions[].base_info.category.leaf_layer`	`3`	叶子层级
`data.summary_promotions[].base_model.product_info.month_sale.origin`	`10`	月销量
`data.summary_promotions[].base_model.product_info.good_ratio.origin`	`94.85714285714286`	好评率
`data.summary_promotions[].base_model.promotion_info.cos_info.cos.cos_fee.origin`	`87`	佣金（单位：分）
`data.summary_promotions[].base_model.promotion_info.cos_info.cos.cos_ratio.origin`	`11`	佣金比例（%）
`data.summary_promotions[].base_model.marketing_info.price_desc.price.origin`	`790`	到手价（单位：分，即 7.90 元）
`data.summary_promotions[].base_model.marketing_info.price_desc.price_text`	`"到手价"`	价格文案
`data.summary_promotions[].base_model.shop_info.shop_id`	`180458907`	店铺 ID
`data.summary_promotions[].base_model.shop_info.shop_name`	`"天府家逸数码"`	店铺名称
`data.summary_promotions[].base_model.shop_info.shop_score_info.shop_score.score`	`88`	店铺评分
`data.summary_promotions[].base_model.tag_info.second_tags[].text.text`	`"消费券"`	商品标签（消费券/24小时发货/运费险/包邮等）
`data.summary_promotions[].base_model.tag_info.tag_codes[]`	`"big_promotion_11_tag"`	标签代码列表
`data.extra.search_id`	`"bbb3b32cbc6f220e4ffa9dc3d6925b..."`	搜索 ID
`data.extra.session_id`	`"2240ef2d8a855155c5a83bb0482ffccf..."`	会话 ID
`data.extra.recall_type`	`"Search"`	召回类型
`data.log_id`	`"20261022164456AA764C060AAA22C5E7EC"`	日志 ID

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "cost": 300,
        "balance": 720024,
        "promotions": [
            {
                "product_id": "3775487009729151155",
                "promotion_id": "3775487363879404011",
                "base_info": {
                    "title": "iQOO120W闪充充电器套装iqooneo7 竞速版neo7se neo8 neo9 iqoo11",
                    "price": null,
                    "main_img": {
                        "uri": "ecom-shop-material/jpeg_m_8d7f630b848d0e9dd5627cc739aa192c_sx_130897_www800-800",
                        "url_list": [
                            "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/jpeg_m_8d7f630b848d0e9dd5627cc739aa192c_sx_130897_www800-800"
                        ]
                    },
                    "detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3775487009729151155&origin_type=2631",
                    "category": {
                        "first_category": {
                            "category_id": 1000007020,
                            "category_name": "3C数码及配件"
                        },
                        "second_category": {
                            "category_id": 1000007028,
                            "category_name": "手机及配件"
                        },
                        "third_category": {
                            "category_id": 1000007178,
                            "category_name": "手机充电器"
                        },
                        "fourth_category": {
                            "category_id": 0,
                            "category_name": ""
                        },
                        "leaf_layer": 3
                    }
                }
            },
            {
                "product_id": "3847842541177274644",
                "promotion_id": "3848430747878817888",
                "base_info": {
                    "title": "9新 iQOO  Z8 全网通备用游戏智能严选二手机",
                    "price": null,
                    "main_img": {
                        "uri": "ecom-shop-material/png_m_9fb16ad04ccb519d4cf88fef65256c11_sx_402617_www800-800",
                        "url_list": [
                            "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/png_m_9fb16ad04ccb519d4cf88fef65256c11_sx_402617_www800-800"
                        ]
                    },
                    "detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3847842541177274644&origin_type=2631",
                    "category": {
                        "first_category": {
                            "category_id": 1000007020,
                            "category_name": "3C数码及配件"
                        },
                        "second_category": {
                            "category_id": 1000007628,
                            "category_name": "二手手机"
                        },
                        "third_category": {
                            "category_id": 0,
                            "category_name": ""
                        },
                        "fourth_category": {
                            "category_id": 0,
                            "category_name": ""
                        },
                        "leaf_layer": 2
                    }
                }
            },
            {
                "product_id": "3843744197551194495",
                "promotion_id": "3848259941324423520",
                "base_info": {
                    "title": "【新品上市】iQOO15T 2K珠峰屏自研电竞芯片Q3电竞游戏新品手机xX",
                    "price": null,
                    "main_img": {
                        "uri": "ecom-shop-material/jpeg_m_dba97ce2ec05c04bd90363112716462f_sx_264334_www800-800",
                        "url_list": [
                            "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/jpeg_m_dba97ce2ec05c04bd90363112716462f_sx_264334_www800-800"
                        ]
                    },
                    "detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3843744197551194495&origin_type=2631",
                    "category": {
                        "first_category": {
                            "category_id": 1000007020,
                            "category_name": "3C数码及配件"
                        },
                        "second_category": {
                            "category_id": 1000007028,
                            "category_name": "手机及配件"
                        },
                        "third_category": {
                            "category_id": 1000007172,
                            "category_name": "智能机"
                        },
                        "fourth_category": {
                            "category_id": 0,
                            "category_name": ""
                        },
                        "leaf_layer": 3

🟢200成功

抖音电商商品搜索接口(v15)

JSON 关键字段说明#

请求参数

请求示例代码

返回响应

JSON 关键字段说明