一、引言
在內(nèi)容電商迅速崛起的當(dāng)下，抖音憑借龐大的用戶基數(shù)和活躍的電商生態(tài)，成為眾多商家和開發(fā)者的必爭之地。抖音商品詳情 API 接口（dy.item_get）的開放，為開發(fā)者獲取抖音平臺商品信息提供了便捷途徑。借助該接口，開發(fā)者能夠獲取抖音商品的全方位數(shù)據(jù)，涵蓋商品的基礎(chǔ)信息、價格詳情、銷量數(shù)據(jù)等，這不僅能助力電商數(shù)據(jù)整合與分析，推動電商導(dǎo)購平臺的搭建，還為直播帶貨選品等場景提供了強(qiáng)有力的數(shù)據(jù)支撐，極大地拓展了電商業(yè)務(wù)的邊界。
二、接口概述
功能介紹
抖音商品詳情 API 接口（dy.item_get）旨在根據(jù)用戶輸入的商品 ID，精準(zhǔn)返回對應(yīng)商品的詳細(xì)信息。其提供的信息豐富多樣，包括商品名稱、商品圖片鏈接、商品描述、商品所屬店鋪名稱、店鋪類型等基礎(chǔ)信息，方便用戶對商品和店鋪有初步認(rèn)識。在價格方面，能獲取商品的原價、現(xiàn)價、促銷價格以及價格區(qū)間等數(shù)據(jù)，為用戶提供全面的價格參考。此外，接口還提供商品的銷量數(shù)據(jù)，如近 30 天的銷量，幫助用戶了解商品的受歡迎程度。同時，接口可返回商品的評價數(shù)量和平均評分，讓用戶直觀了解其他消費(fèi)者對商品的反饋。小編：Taobaoapi2014, 前往體驗(yàn)API：c0b.cc/R4rbK2 。
數(shù)據(jù)輸入
使用該接口時，商品 ID 是必填參數(shù)。商品 ID 作為抖音平臺為每個商品賦予的唯一標(biāo)識，在抖音商品鏈接或商品展示頁面中均可獲取。
數(shù)據(jù)輸出
接口返回的數(shù)據(jù)格式為 JSON，這種格式簡潔且易于在各種編程語言中解析。以一個典型的返回?cái)?shù)據(jù)結(jié)構(gòu)為例：
{
"item": {
"item_id": "123456",
"title": "時尚連衣裙",
"images": ["https://image1.com", "https://image2.com"],
"description": "這款連衣裙采用優(yōu)質(zhì)面料，時尚百搭...",
"shop_name": "時尚女裝店",
"shop_type": "個體店",
"original_price": 299,
"current_price": 199,
"promotion_price": 169,
"sales": 500,
"review_count": 100,
"rating": 4.8
}
}
開發(fā)者可根據(jù)業(yè)務(wù)需要，從返回的 JSON 數(shù)據(jù)中提取相應(yīng)字段，進(jìn)行數(shù)據(jù)展示、分析或其他處理。
三、Python 請求示例
import requests
import hashlib
import time
import json
# 假設(shè) API 接口地址，復(fù)制鏈接獲取測試。
API url=c0b.cc/R4rbK2 wechat id:Taobaoapi2014"
app_key = "your_app_key"
app_secret = "your_app_secret"
# 商品ID
item_id = "123456"
# 生成簽名
timestamp = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
params = {
"app_key": app_key,
"method": "dy.item_get",
"timestamp": timestamp,
"format": "json",
"v": "2.0",
"item_id": item_id
}
param_str = ""
for key in sorted(params.keys()):
param_str += key + str(params[key])
sign_str = app_secret + param_str + app_secret
sign = hashlib.md5(sign_str.encode('utf - 8')).hexdigest().upper()
params["sign"] = sign
# 發(fā)送請求
response = requests.get(url, params = params)
# 解析響應(yīng)數(shù)據(jù)
if response.status_code == 200:
data = json.loads(response.text)
if "item" in data:
item = data["item"]
print("商品名稱:", item["title"])
print("商品價格:", item["current_price"])
print("商品銷量:", item["sales"])
else:
print("未獲取到商品信息，錯誤信息:", data["error_response"]["msg"])
else:
print("請求失敗，狀態(tài)碼:", response.status_code)
上述代碼通過 Python 的requests庫向抖音商品詳情 API 接口發(fā)送 GET 請求。在請求前，按照抖音接口的簽名規(guī)則生成簽名，確保請求的合法性與安全性。若請求成功，接口返回?cái)?shù)據(jù)后，通過json.loads()方法將響應(yīng)內(nèi)容解析為 Python 字典格式，然后提取并打印商品的名稱、價格、銷量等關(guān)鍵信息。若請求失敗，代碼會輸出錯誤狀態(tài)碼或接口返回的錯誤信息，方便開發(fā)者定位與解決問題。借助這個示例，開發(fā)者能夠快速上手，將抖音商品詳情 API 接口集成到自己的 Python 項(xiàng)目中，實(shí)現(xiàn)對抖音商品數(shù)據(jù)的高效獲取與應(yīng)用。
