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