TB/TM按关键字搜索TB商品 API 返回值说明

item_search-按关键字搜索商品

公共参数

名称 类型 必须 描述

key String 是 调用key（必须以GET方式拼接在URL中）

secret String 是 调用密钥

api_name String 是 API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]

cache String 否 [yes,no]默认yes，将调用缓存的数据，速度比较快

result_type String 否 [json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读

lang String 否 [cn,en,ru]翻译语言，默认cn简体中文

version String 否 API版本

请求参数

请求参数：q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter=

参数说明：q:搜索关键字

page:页数【最大翻页100页】

响应参数

Version: Date:

名称 类型 必须 示例值 描述

items

items[] 0 按关键字搜索淘宝商品

page

Int 0 1 页码

real_total_results

Int 0 360000 商品数量

total_results

Int 0 360000 商品数量

page_size

Int 0 10 接口返回数量

pagecount

Int 0 200 总页数

item

item[] 0 商品详情数据

title

String 0 高腰百搭羊羔绒阔腿裤冬季保暖 商品标题

pic_url

String 0 https://img.alicdn.com/img/bao/uploaded/i4/O1CN01TpegE82EAUGWQD2JI_!!0-item_pic.jpg 商品图片

orginal_price

Float 0 50.00 原价

price

Float 0 50.00 价格

num_iid

Bigint 0 756775095301 商品ID

detail_url

String 0 https://item.taobao.com/item.htm?id=756775095301 商品链接

响应示例

{

"items": {

"page": "1",

"real_total_results": "360000",

"total_results": "360000",

"page_size": 10,

"pagecount": "200",

"_ddf": "szx",

"item": [

{

"title": "高腰百搭羊羔绒阔腿裤冬季保暖",

"picurl": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01TpegE82EAUGWQD2JI!!0-item_pic.jpg",

"promotion_price": "50.00",

"orginal_price": "50.00",

"price": "50.00",

"sales": 0,

"num_iid": "756775095301",

"detail_url": "https://item.taobao.com/item.htm?id=756775095301"

},

{

"title": "德绒圆领打底衫短款修身内搭长袖T恤女秋冬纯色弧形小众百搭上衣",

"picurl": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01xuzAuZ2LY21GBhlfE!!3937219703-0-C2M.jpg",

"promotion_price": "44.40",

"orginal_price": "44.40",

"price": "44.40",

"sales": 0,

"num_iid": "825927041956",

"detail_url": "https://item.taobao.com/item.htm?id=825927041956"

},

{

"title": "美式辣妹螺纹修身女打底衫长袖",

"picurl": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN010d2Jxj1ZOJwsXSEHg!!862293184.jpg",

"promotion_price": "58.00",

"orginal_price": "58.00",

"price": "58.00",

"sales": 0,

"num_iid": "735775262176",

"detail_url": "https://item.taobao.com/item.htm?id=735775262176"

},

{

"title": "2024年新款高腰复古牛仔裤女秋季",

"picurl": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01YfwUGX1h1tbd5rczJ!!2206584264218-0-C2M.jpg",

"promotion_price": "59.85",

"orginal_price": "59.85",

"price": "59.85",

"sales": 0,

"num_iid": "837243885999",

"detail_url": "https://item.taobao.com/item.htm?id=837243885999"

},

{

"title": "【秋冬绝美可单穿慵懒小上衣】",

"picurl": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01m6HRZH1zxkhIMd3OG!!0-item_pic.jpg",

"promotion_price": "57.00",

"orginal_price": "57.00",

"price": "57.00",

"sales": 0,

"num_iid": "818387607863",

"detail_url": "https://item.taobao.com/item.htm?id=818387607863"

},

{

"title": "秋季新款复古高腰阔腿牛仔裤女宽松显瘦垂感拖地直筒长裤水洗做旧",

"picurl": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01aJeIvR1mQEi3d7tnq!!2206588314948-2-C2M.jpg",

"promotion_price": "74.85",

"orginal_price": "74.85",

"price": "74.85",

"sales": 0,

"num_iid": "819491929229",

"detail_url": "https://item.taobao.com/item.htm?id=819491929229"

},

{

"title": "美式复古豹纹牛仔裤女男夏季潮牌小众阔腿裤宽松垂感休闲长裤腰带",

"picurl": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01fQC8Vc2LY21fSyrpo!!3937219703-0-C2M.jpg",

"promotion_price": "55.80",

"orginal_price": "55.80",

"price": "55.80",

"sales": 0,

"num_iid": "797999211515",

"detail_url": "https://item.taobao.com/item.htm?id=797999211515"

},

{

"title": "u领冬季白色内搭长袖秋季上衣女秋冬打底衫短款秋衣春秋修身t恤",

"picurl": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01XfN4ys1I8Qr51Xkzq!!0-item_pic.jpg",

"promotion_price": "47.75",

"orginal_price": "47.75",

"price": "47.75",

"sales": 0,

"num_iid": "835469595962",

"detail_url": "https://item.taobao.com/item.htm?id=835469595962"

},

{

"title": "【李佳锜推荐】高领内搭打底衫女",

"picurl": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01X1jpKO1Xzl0WvcLqA!!0-item_pic.jpg",

"promotion_price": "59.00",

"orginal_price": "59.00",

"price": "59.00",

"sales": 0,

"num_iid": "690366689843",

"detail_url": "https://item.taobao.com/item.htm?id=690366689843"

},

{

"title": "高腰休闲宽松条纹运动裤",

"picurl": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01yL3DXE1ToWxdKP8UP!!0-item_pic.jpg",

"promotion_price": "42.78",

"orginal_price": "42.78",

"price": "42.78",

"sales": 0,

"num_iid": "841863957500",

"detail_url": "https://item.taobao.com/item.htm?id=841863957500"

}

],

"item_weight_update": 0

},

"error_code": "0000",

"reason": "ok",

"secache": "a8881ed5637e3c7e84f03acdc86be64f",

"secache_time": 1729489209,

"secache_date": "2024-10-21 13:40:09",

"translate_status": "",

"translate_time": 0,

"language": {

"default_lang": "cn",

"current_lang": "cn"

},

"error": "",

"cache": 0,

"api_info": "today:57 max:10000 all[2982=57 30 2895];expires:2030-10-30",

"execution_time": "1.911",

"server_time": "Beijing/2024-10-21 13:40:09",

"client_ip": "61.131.237.50",

"call_args": {

"q": "女装",

"start_price": "0",

"end_price": "0",

"page": "1",

"cat": "0"

},

"api_type": "taobao",

"translate_language": "zh-CN",

"translate_engine": "",

"server_memory": "4.39MB",

"request_id": "gw-3.6715e9377d64c",

"last_id": "3628047818"

}