获取淘宝商品搜索（v7）

状态码	说明
-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.items[0].title	商品标题
data.items[0]['pic_url']	商品主图的 URL 地址
data.items[0]['promotion_price']	促销价格
data.items[0]['orginal_price']	原始价格
data.items[0].price	当前售价
data.items[0].sales	销量
data.items[0]['num_iid']	商品ID
data.items[0].area	店铺所在地
data.items[0]['seller_nick']	店铺名称
data.items[0]['seller_id']	店铺ID
data.items[0]['detail_url']	商品详情页链接

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "cost": 100,
        "balance": 3720821,
        "items": [
            {
                "title": "【17】iPhone 17苹果17全网通5G手机2025新款双卡",
                "pic_url": "https://g.search.alicdn.com/img/bao/uploaded/i4/i1/2215145274004/O1CN01EfuCKl1fRszWaOk7Y_!!2215145274004.jpg",
                "promotion_price": 3918,
                "orginal_price": 3918,
                "price": 3918,
                "sales": "1000",
                "num_iid": 1054099022619,
                "area": "广东 深圳",
                "seller_nick": "胖爸手机数码",
                "seller_id": 2215145274004,
                "detail_url": "https://item.taobao.com/item.htm?id=1054099022619"
            },
            {
                "title": "【政府补贴10%+12期免息】Apple/苹果 iPhone 17 Pro Max 手机 2025新款 官方正品 全国联保",
                "pic_url": "https://g.search1.alicdn.com/img/bao/uploaded/i4/i4/686947088/O1CN0117fKgnT886J1chua_!!4611686018427386640-0-item_pic.jpg",
                "promotion_price": 9999,
                "orginal_price": 9999,
                "price": 9999,
                "sales": "1000",
                "num_iid": 975366461946,
                "area": "上海",
                "seller_nick": "Apple产品影音数码专营店",
                "seller_id": 686947088,
                "detail_url": "https://detail.tmall.com/item.htm?id=975366461946"
            },
            {
                "title": "【以旧换新至高补贴1200元】 Apple/苹果 iPhone 17 Pro 5G全网通 2025新品官网全新原封正品手机",
                "pic_url": "https://g.search2.alicdn.com/img/bao/uploaded/i4/i4/713805254/O1CN01QBvmnoQ9ElB1chua_!!4611686018427383238-0-item_pic.jpg",
                "promotion_price": 8999,
                "orginal_price": 8999,
                "price": 8999,
                "sales": "1000",
                "num_iid": 974156407837,
                "area": "浙江 杭州",
                "seller_nick": "中国移动天猫手机官方旗舰店",
                "seller_id": 713805254,
                "detail_url": "https://detail.tmall.com/item.htm?id=974156407837"
            },
            {
                "title": "【12期免息/国补500元】Apple/苹果 iPhone 17 手机 A19芯片 2025新款 全新原封 支持淘金币 国家补贴",
                "pic_url": "https://g.search3.alicdn.com/img/bao/uploaded/i4/i4/2218389186051/O1CN01unP2uB1uZPkfiqhLv_!!4611686018427381251-2-item_pic.png",
                "promotion_price": 5999,
                "orginal_price": 5999,
                "price": 5999,
                "sales": "1000",
                "num_iid": 974192383696,
                "area": "浙江 杭州",
                "seller_nick": "Apple产品潮玩专营店",
                "seller_id": 2218389186051,
                "detail_url": "https://detail.tmall.com/item.htm?id=974192383696"
            },
            {
                "title": "【12期免息｜限时直降1000】Apple/苹果 iPhone 17 Pro Max 手机 全网通 2025 新款 全新国行",
                "pic_url": "https://g.search.alicdn.com/img/bao/uploaded/i4/i2/2200785402219/O1CN01XeLnEBJF1YK32pKq_!!4611686018427386219-2-item_pic.png",
                "promotion_price": 9999,
                "orginal_price": 9999,
                "price": 9999,
                "sales": "1000",
                "num_iid": 986919261724,
                "area": "浙江 杭州",
                "seller_nick": "Apple产品权益智选专营店",
                "seller_id": 2200785402219,
                "detail_url": "https://detail.tmall.com/item.htm?id=986919261724"
            },
            {
                "title": "【国家补贴】Apple/苹果 iPhone 17e 手机",
                "pic_url": "https://g.search1.alicdn.com/img/bao/uploaded/i4/i3/2213124066374/O1CN01OEnOyb1wxLg0XErZ2_!!4611686018427382854-0-item_pic.jpg",
                "promotion_price": 4499,
                "orginal_price": 4499,
                "price": 4499,
                "sales": "1000",
                "num_iid": 1026218406258,
                "area": "北京",
                "seller_nick": "Apple授权专营店",
                "seller_id": 2213124066374,
                "detail_url": "https://detail.tmall.com/item.htm?id=1026218406258"
            },
            {
                "title": "【17PM】Apple/苹果 iPhone 17 Pro Max 苹果17PM 全网通5G手机",
                "pic_url": "https://g.search2.alicdn.com/img/bao/uploaded/i4/i2/424808/O1CN015a9BaS1lO7R4lplou_!!424808.png",
                "promotion_price": 5988,
                "orginal_price": 5988,
                "price": 5988,
                "sales": "1000",
                "num_iid": 1030308501260,
                "area": "广东 深圳",
                "seller_nick": "COCOLA数码21年5皇冠老店",
                "seller_id": 424808,
                "detail_url": "https://item.taobao.com/item.htm?id=1030308501260"
            },
            {
                "title": "【国补立减500元】Apple/苹果 iPhone 17 Pro Max 手机  官方正品全新未拆封 国行正品",
                "pic_url": "https://g.search3.alicdn.com/img/bao/uploaded/i4/i2/2212471406095/O1CN01fxtuGqyxIiE1chua_!!2212471406095.jpg",
                "promotion_price": 9999,
                "orginal_price": 9999,
                "price": 9999,
                "sales": "1000",
                "num_iid": 976011520884,
                "area": "浙江 杭州",
                "seller_nick": "天猫校园教育官方旗舰店",
                "seller_id": 2212471406095,
                "detail_url": "https://detail.tmall.com/item.htm?id=976011520884"
            },
            {
                "title": "【国家补贴15%+大额淘金币】Apple/苹果 iPhone 17 手机 A19 芯片 2025新款 全新未拆封 官方正品 全网通",
                "pic_url": "https://g.search.alicdn.com/img/bao/uploaded/i4/i4/686947088/O1CN01Td9Tph22EMTJRDmVt_!!4611686018427386640-0-item_pic.jpg",
                "promotion_price": 5999,
                "orginal_price": 5999,
                "price": 5999,
                "sales": "1000",
                "num_iid": 976005928364,
                "area": "上海",
                "seller_nick": "Apple产品影音数码专营店",
                "seller_id": 686947088,
                "detail_url": "https://detail.tmall.com/item.htm?id=976005928364"
            },
            {
                "title": "【叠换新补贴至高直降2100】Apple/苹果 iPhone 17 Pro 手机 A19 Pro 芯片 全国联保 支持淘金币",
                "pic_url": "https://g.search1.alicdn.com/img/bao/uploaded/i4/i1/2218389186051/O1CN01jHkCSjbuQ7J1chua_!!4611686018427381251-2-item_pic.png",
                "promotion_price": 8999,
                "orginal_price": 8999,
                "price": 8999,
                "sales": "1000",
                "num_iid": 974199527610,
                "area": "浙江 杭州",
                "seller_nick": "Apple产品潮玩专营店",
                "seller_id": 2218389186051,
                "detail_url": "https://detail.tmall.com/item.htm?id=974199527610"
            }
        ]
    }
}

获取淘宝商品搜索（v7）

JSON 常用字段解析#

请求参数

请求示例代码

返回响应

JSON 常用字段解析