item_search_tmall - 按關鍵字搜尋天貓商品接口接入說明

一、item_search_tmall - 按關鍵字搜尋天貓商品接口說明：

點選注冊擷取key和secret測試賬号

接口使用說明：用過關鍵詞搜尋天貓商品，不包括淘寶商品（其他的接口可以擷取），可以擷取商品清單，然後再次調用商品詳情接口，可以拿到淘寶天貓整個站的資料，可用于多個業務場景。

二、建議使用場景

1、擷取天貓商品清單，整個天貓站的資料

2、商城系統建設

3、代購系統商城建設

4、ERP系統商品選品

5、行業資料分析

6、商品資料上傳

三、公共參數說明：

名稱 類型 必須 描述

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版本

四、API請求參數說明：

請求參數：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:頁數

五、響應參數：

名稱 類型 示例值 描述

items items[] 按關鍵字搜尋商品

page Int 1 頁碼

page_size Int 44 接口傳回數量

real_total_results Int 1900 寶貝數量

total_results Int 1900 寶貝數量

pagecount Int 120 總頁數

item item[] 寶貝詳情資料

title String 法式複古山本超仙chic仙女赫本網紅初春很仙法國小衆裙子兩件套裝 商品标題

pic_url String //img.alicdn.com/bao/uploaded/i3/3083218865/O1CN012FMDaiwxkenJGaM!!0-item_pic.jpg 寶貝圖檔

promotion_price Float 178.00 優惠價

price Float 178.00 價格

sales Int 890 銷量

num_iid Bigint 577437133060 寶貝ID

sample_id String 商品風格辨別ID

seller_nick String 初穆旗艦店 掌櫃昵稱

post_fee Float 10.00 物流費用

area String 山東 店鋪所在地

detail_url String //detail.tmall.com/item.htm?id=586794298909&ns=1&abbucket=0 寶貝連結

seller_info Mix {“level”: 99, “shop_type”: “B”, “user_num_id”: “2217148345”, “cid”: 0, “delivery_score”: “”, “item_score”: “”, “score_p”: “”} 賣家資訊

六、請求示例：（CURL、PHP 、PHPsdk 、Java 、C# 、Python…)

python

# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 請求示例 url 預設請求參數已經做URL編碼
url = "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="
headers = {
    "Accept-Encoding": "gzip",
    "Connection": "close"
}
if __name__ == "__main__":
    r = requests.get(url, headers=headers)
    json_obj = r.json()
    print(json_obj)
           

響應示例

{
	"page": "1",
	"page_no": "1",
	"real_total_results": "2223909",
	"total_results": "2223909",
	"page_size": "10",
	"pagecount": "100",
	"item": [
		{
			"title": "白色吊帶背心女内搭性感修身莫代爾黑色裹胸短款露臍抹胸打底衫",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i1/2200551933325/O1CN01G7Bk0r1aQtQBJokoK_!!0-item_pic.jpg",
			"promotion_price": "34.0",
			"price": "34.0",
			"sales": "2000+",
			"num_iid": "588547619452",
			"seller_nick": "蝶如雪旗艦店",
			"area": "江蘇 泰州",
			"seller_id": "2200551933325",
			"detail_url": "https://detail.tmall.com/item.htm?id=588547619452&skuId=4012030025243&spm=a1z60.7754815.item.0"
		},
		{
			"title": "2件吊帶背心女内搭打底外穿無袖百搭莫代爾春夏季黑白色吊帶上衣",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i1/667221374/O1CN01SIzTad1M1KrJcMceR_!!0-item_pic.jpg",
			"promotion_price": "39.0",
			"price": "39.0",
			"sales": "1000+",
			"num_iid": "564905521941",
			"seller_nick": "莫代爾官方旗艦店",
			"area": "上海",
			"seller_id": "667221374",
			"detail_url": "https://detail.tmall.com/item.htm?id=564905521941&skuId=0&spm=a1z60.7754815.item.1"
		},
		{
			"title": "大碼胖mm無鋼圈運動内衣女防震跑步聚攏裹胸網紅爆款背心文胸美背",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i2/4145171888/O1CN01jeNuTb1PokGm74cfE_!!0-item_pic.jpg",
			"promotion_price": "38.0",
			"price": "38.0",
			"sales": "100+",
			"num_iid": "586827288475",
			"seller_nick": "狄藍瑟旗艦店",
			"area": "廣東 汕頭",
			"seller_id": "4145171888",
			"detail_url": "https://detail.tmall.com/item.htm?id=586827288475&skuId=4158697742497&spm=a1z60.7754815.item.2"
		},
		{
			"title": "南極人吊帶背心女士夏季純棉薄款白色修身上衣内搭百搭潮打底衫女",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i4/921087833/O1CN01W38MWh27jYujEWJYd_!!0-item_pic.jpg",
			"promotion_price": "39.9",
			"price": "39.9",
			"sales": "200+",
			"num_iid": "595493699016",
			"seller_nick": "南極人樂客專賣店",
			"area": "山東 煙台",
			"seller_id": "921087833",
			"detail_url": "https://detail.tmall.com/item.htm?id=595493699016&skuId=4299100871404&spm=a1z60.7754815.item.3"
		},
		{
			"title": "2021年新款春秋高腰直筒牛仔褲女寬松顯瘦哈倫老爹褲子百搭九分褲",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i1/2994829445/O1CN01f2Y2uI2JdrQO4qNiI_!!0-item_pic.jpg",
			"promotion_price": "79.0",
			"price": "79.0",
			"sales": "100+",
			"num_iid": "591598499229",
			"seller_nick": "正茉旗艦店",
			"area": "廣東 東莞",
			"seller_id": "2994829445",
			"detail_url": "https://detail.tmall.com/item.htm?id=591598499229&skuId=4482736601261&spm=a1z60.7754815.item.4"
		},
		{
			"title": "美背小吊帶背心女内搭網紅爆款帶胸墊白色u型外穿打底夏卡卡内衣",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i1/2206440954960/O1CN01IYwVYe1mVj4PunJQ3_!!0-item_pic.jpg",
			"promotion_price": "39.9",
			"price": "39.9",
			"sales": "100+",
			"num_iid": "603920150873",
			"seller_nick": "般舒旗艦店",
			"area": "山東 青島",
			"seller_id": "2206440954960",
			"detail_url": "https://detail.tmall.com/item.htm?id=603920150873&skuId=0&spm=a1z60.7754815.item.5"
		},
		{
			"title": "南極人吊帶背心女士夏季薄款無痕外穿上衣莫代爾内搭打底衫内衣服",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i2/921087833/O1CN0146QYtE27jYuiivmiE_!!0-item_pic.jpg",
			"promotion_price": "49.9",
			"price": "49.9",
			"sales": "100+",
			"num_iid": "595294400309",
			"seller_nick": "南極人樂客專賣店",
			"area": "山東 煙台",
			"seller_id": "921087833",
			"detail_url": "https://detail.tmall.com/item.htm?id=595294400309&skuId=4657775150889&spm=a1z60.7754815.item.6"
		},
		{
			"title": "劉濤雪紡吊帶背心女網紅爆款西裝内搭外穿小衫打底顯瘦性感上衣夏",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i1/3272298247/O1CN01mEjmcf2AnAxDlBllG_!!3272298247-0-lubanu-s.jpg",
			"promotion_price": "49.0",
			"price": "49.0",
			"sales": "600+",
			"num_iid": "592045748254",
			"seller_nick": "凱袖旗艦店",
			"area": "上海",
			"seller_id": "3272298247",
			"detail_url": "https://detail.tmall.com/item.htm?id=592045748254&skuId=4076557172911&spm=a1z60.7754815.item.7"
		},
		{
			"title": "美背内衣女學生少女裹胸抹胸聚攏運動瑜伽吊帶背心無鋼圈文胸外穿",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i1/3921451270/O1CN019HzAP31LFhbNWnb1g_!!3921451270-0-lubanu-s.jpg",
			"promotion_price": "12.9",
			"price": "12.9",
			"sales": "5",
			"num_iid": "617244976556",
			"seller_nick": "運绯旗艦店",
			"area": "廣東 廣州",
			"seller_id": "3921451270",
			"detail_url": "https://detail.tmall.com/item.htm?id=617244976556&skuId=4527146362707&spm=a1z60.7754815.item.8"
		},
		{
			"title": "新款美背吊帶網紅爆款小背心蕾絲防走光裹胸少女抹胸内衣女 聚攏",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i2/3921451270/O1CN01JJqJcc1LFhbkgOjRM_!!0-item_pic.jpg",
			"promotion_price": "13.9",
			"price": "13.9",
			"sales": "1000+",
			"num_iid": "620389154627",
			"seller_nick": "運绯旗艦店",
			"area": "廣東 廣州",
			"seller_id": "3921451270",
			"detail_url": "https://detail.tmall.com/item.htm?id=620389154627&skuId=4380971580436&spm=a1z60.7754815.item.9"
		}
	],
	"data_from": "tianmiao",
	"error": "",
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:12 max:10000",
	"execution_time": 1.71,
	"server_time": "Beijing/2021-08-08 09:54:30",
	"client_ip": "106.6.39.122",
	"call_args": [],
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"translate_engine": "google_cn",
	"server_memory": "5.55MB",
	"request_id": "gw-4.610f395565254"
}
           

API 工具

API SDK調用示例

APISDK下載下傳

API測試工具

如何開通API測試，*點選立即開通*