关键字搜索:“淘宝商品 API ”

218 阅读4分钟

公共参数

请求地址: api-gw.onebound.cn/taobao/item…

注册获取专属于你的key和secret

名称类型必须描述
keyString调用key(必须以GET方式拼接在URL中)
secretString调用密钥
api_nameStringAPI接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
langString[cn,en,ru]翻译语言,默认cn简体中文
versionStringAPI版本

请求参数

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

参数说明:q:搜索关键字
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,bid2,_bid2,_sale,_credit]
(bid:总价,bid2:商品价格,sale:销量,credit信用,加_前缀为从大到小排序)
page:页数\

响应参数

Version: Date:

名称类型必须示例值描述
titleString0法式复古山本超仙chic仙女赫本网红初春很仙法国小众裙子两件套装商品标题
pic_urlString0//img.alicdn.com/bao/uploaded/i3/3083218865/O1CN012FMDaiwxkenJGaM_!!0-item_pic.jpg宝贝图片
promotion_priceFloat0178.00优惠价
priceFloat0178.00价格
salesInt0890销量
num_iidBigint0577437133060宝贝ID
sample_idString0商品风格标识ID
seller_nickString0初穆旗舰店掌柜昵称
post_feeFloat010.00物流费用
areaString0山东店铺所在地
detail_urlString0//detail.tmall.com/item.htm?id=586794298909&ns=1&abbucket=0宝贝链接
seller_infoMix0{"level": 99, "shop_type": "B", "user_num_id": "2217148345", "cid": 0, "delivery_score": "", "item_score": "", "score_p": ""}卖家信息

请求示例

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/taobao/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter="

响应示例

{
	"page": "1",
	"page_no": "1",
	"real_total_results": "3734231",
	"total_results": "3734231",
	"page_size": "10",
	"pagecount": "100",
	"item": [
		{
			"title": "清仓捡漏专柜撤回正品女装外贸t恤短袖2022新款夏设计感大码上衣",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i4/3245823593/O1CN01giQTBP1cPdfCJOpII_!!0-item_pic.jpg",
			"promotion_price": "9.95",
			"price": "9.95",
			"sales": "800+",
			"num_iid": "618346579721",
			"seller_nick": "飘莉芬旗舰店",
			"area": "广东 广州",
			"seller_id": "3245823593",
			"detail_url": "https://detail.tmall.com/item.htm?id=618346579721&skuId=4382887825548&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.0"
		},
		{
			"title": "史努比短袖t恤女2022夏季新款oversize宽松学生半袖卡通上衣ins潮",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i3/2210899870446/O1CN01GhG6X91FAJOf2zYR3_!!0-item_pic.jpg",
			"promotion_price": "10.9",
			"price": "10.9",
			"sales": "600+",
			"num_iid": "673857603034",
			"seller_nick": "荆懿旗舰店",
			"area": "广东 广州",
			"seller_id": "2210899870446",
			"detail_url": "https://detail.tmall.com/item.htm?id=673857603034&skuId=4844077676113&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.1"
		},
		{
			"title": "2022新款冰丝阔腿裤女宽松垂感高腰夏季薄款九分休闲直筒裤子夏天",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i1/2177707621/O1CN01acG4Ph26AT5Kin9Hj_!!0-item_pic.jpg",
			"promotion_price": "17.9",
			"price": "17.9",
			"sales": "100+",
			"num_iid": "619413775589",
			"seller_nick": "南极人神电专卖店",
			"area": "浙江 金华",
			"seller_id": "2177707621",
			"detail_url": "https://detail.tmall.com/item.htm?id=619413775589&skuId=4540899494610&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.2"
		},
		{
			"title": "大码女装夏装胖妹妹气质显瘦别致不规则中长款白衬衫微喇裤两件套",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i2/2207370049106/O1CN017iuOJg2H8bL24fz7x_!!0-item_pic.jpg",
			"promotion_price": "98.0",
			"price": "98.0",
			"sales": "700+",
			"num_iid": "677690141586",
			"seller_nick": "妍茹蕴旗舰店",
			"area": "广东 广州",
			"seller_id": "2207370049106",
			"detail_url": "https://detail.tmall.com/item.htm?id=677690141586&skuId=4868124917690&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.3"
		},
		{
			"title": "清仓捡漏专柜撤回正品女装外贸白色短袖t恤夏设计感小众上衣ins潮",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i3/3245823593/O1CN01ZmZag41cPdf7kKMP7_!!0-item_pic.jpg",
			"promotion_price": "9.95",
			"price": "9.95",
			"sales": "400+",
			"num_iid": "617387861087",
			"seller_nick": "飘莉芬旗舰店",
			"area": "广东 广州",
			"seller_id": "3245823593",
			"detail_url": "https://detail.tmall.com/item.htm?id=617387861087&skuId=4358001749756&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.4"
		},
		{
			"title": "薄款仙气棉麻连衣裙女2022年春夏季新款休闲减龄国际大牌亚麻裙子",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i2/2895242679/O1CN01UyxEGF1Vf1khvu62Q_!!0-item_pic.jpg",
			"promotion_price": "59.9",
			"price": "59.9",
			"sales": "36",
			"num_iid": "649760276156",
			"seller_nick": "雅宝翡丽旗舰店",
			"area": "广东 广州",
			"seller_id": "2895242679",
			"detail_url": "https://detail.tmall.com/item.htm?id=649760276156&skuId=4863704495928&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.5"
		},
		{
			"title": "2022夏季新款纯棉修身超a上衣高腰网红短袖短款t恤女ins潮酷",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i3/4000223766/O1CN01PH5FVn1dgsKx97ppX_!!0-item_pic.jpg",
			"promotion_price": "5.9",
			"price": "5.9",
			"sales": "700+",
			"num_iid": "612454928242",
			"seller_nick": "施素旗舰店",
			"area": "广东 广州",
			"seller_id": "4000223766",
			"detail_url": "https://detail.tmall.com/item.htm?id=612454928242&skuId=4315137253303&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.6"
		},
		{
			"title": "休闲运动套装女2022年夏季新款时尚大码女装夏装短袖两件套夏天潮",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i3/2999135564/O1CN01SVOMVo1qyMJpJ31lo_!!2999135564-0-lubanu-s.jpg",
			"promotion_price": "76.0",
			"price": "76.0",
			"sales": "200+",
			"num_iid": "616286059137",
			"seller_nick": "韩菲依饰旗舰店",
			"area": "福建 泉州",
			"seller_id": "2999135564",
			"detail_url": "https://detail.tmall.com/item.htm?id=616286059137&skuId=4342571465199&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.7"
		},
		{
			"title": "韩版洋气百搭卡通印花短袖t恤女2022新款宽松大码中长款夏季上衣",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i1/4023193621/O1CN01BSKOKQ1ccSkjtOOUG_!!4023193621-0-lubanu-s.jpg",
			"promotion_price": "9.95",
			"price": "9.95",
			"sales": "400+",
			"num_iid": "618501415158",
			"seller_nick": "沿花小筑旗舰店",
			"area": "广东 广州",
			"seller_id": "4023193621",
			"detail_url": "https://detail.tmall.com/item.htm?id=618501415158&skuId=4363986133619&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.8"
		},
		{
			"title": "欧美原创设计感纯棉短袖t恤女ins潮2022夏季新款韩系chic港味上衣",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i4/3597026214/O1CN01zo7QVk1vm3vCYYKxe_!!0-item_pic.jpg",
			"promotion_price": "15.6",
			"price": "15.6",
			"sales": "2000+",
			"num_iid": "674859178825",
			"seller_nick": "rosetears玫瑰泪旗舰店",
			"area": "浙江 杭州",
			"seller_id": "3597026214",
			"detail_url": "https://detail.tmall.com/item.htm?id=674859178825&skuId=5024074682909&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.9"
		}
	],
	"data_from": "tianmiao",
	"error": "",
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:27 max:10100 all[43=27+4+12];expires:2030-12-31",
	"execution_time": "1.589",
	"server_time": "Beijing/2022-08-01 09:36:54",
	"client_ip": "106.6.35.126",
	"call_args": [],
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"translate_engine": "google_new",
	"server_memory": "5.84MB",
	"request_id": "gw-1.62e72e354ba96",
	"last_id": "1119505524"
}