獲取商品詳情資訊API介面：1688開放平臺功能解析
隨著網際網路技術的發展，電商平臺已經成為人們購物的主要渠道。在這個背景下，1688開放平臺提供了豐富的API介面，幫助開發者更好地與平臺互動，獲取所需資料。本文將重點關注如何獲取商品詳情資訊的API介面。
一、介面概述
透過1688開放平臺的商品詳情資訊API介面，開發者可以獲取商品的詳細資訊，包括商品名稱、價格、庫存、描述、引數等。這對於電商應用、比價工具、資料分析等方面具有很大價值。使用該介面需要向平臺申請許可權，並遵循相應的呼叫規則。
二、請求引數
在呼叫商品詳情資訊API介面時，需要傳入相應的請求引數。通常包括商品ID、呼叫時間戳、金鑰等。確保傳入的引數準確無誤，以保證介面的正常執行。
1.公共引數
|
名稱
|
型別
|
必須
|
描述
|
|
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版本
|
2.請求引數
請求引數：num_iid=610947572360
引數說明：num_iid:1688商品ID
sales_data:&sales_data=1 獲取近30天成交資料
agent:&agent=1 獲取1688分銷代發價格資料
三、響應資料
當請求成功後，API介面會返回相應的響應資料。這些資料通常包括商品的詳細資訊，如商品名稱、價格、庫存、描述、引數等。開發者可以根據實際需求，解析並處理這些資料，以實現相應的功能。
Version: Date:
|
名稱
|
型別
|
必須
|
示例值
|
描述
|
|
item |
item[]
|
0
|
|
寶貝詳情資料
|
|
num_iid |
String
|
0
|
|
寶貝ID
|
|
title |
String
|
0
|
|
商品標題
|
|
desc_short |
String
|
0
|
|
商品簡介
|
|
price |
Float
|
0
|
|
價格
|
|
total_price |
Float
|
0
|
|
|
|
suggestive_price |
Float
|
0
|
|
|
|
orginal_price |
Float
|
0
|
|
原價
|
|
nick |
String
|
0
|
|
賣家暱稱
|
|
num |
Int
|
0
|
|
|
|
detail_url |
String
|
0
|
|
寶貝連結
|
|
pic_url |
String
|
0
|
|
寶貝圖片
|
|
brand |
String
|
0
|
|
品牌
|
|
brandId |
Int
|
0
|
|
品牌id
|
|
rootCatId |
Int
|
0
|
|
頂 級分類ID
|
|
cid |
Int
|
0
|
|
|
|
desc |
String
|
0
|
|
|
|
item_imgs |
Mix
|
0
|
|
商品圖片
|
|
item_weight |
String
|
0
|
|
|
|
post_fee |
Float
|
0
|
|
郵費
|
|
express_fee |
Float
|
0
|
|
EMS費用
|
|
ems_fee |
Float
|
0
|
|
物流費用
|
|
shipping_to |
String
|
0
|
|
發貨至
|
|
video |
video[]
|
0
|
|
商品影片
|
|
sample_id |
String
|
0
|
|
|
|
props_name |
String
|
0
|
|
商品屬性名
|
|
prop_imgs |
prop_imgs[]
|
0
|
|
商品屬性圖片列表
|
|
property_alias |
String
|
0
|
|
屬性別名
|
|
props |
Mix
|
0
|
|
商品詳情
|
|
total_sold |
Int
|
0
|
|
|
|
scale |
Int
|
0
|
|
|
|
sellUnit |
Int
|
0
|
|
|
|
skus |
skus[]
|
0
|
|
商品規格資訊列表
|
|
seller_id |
Int
|
0
|
|
賣家ID
|
|
sales |
Int
|
0
|
|
銷售額
|
|
shop_id |
Int
|
0
|
|
店鋪ID
|
|
props_list |
Mix
|
0
|
|
商品屬性
|
|
seller_info |
seller_info[]
|
0
|
|
賣家資訊
|
|
tmall |
Boolean
|
0
|
|
是否天貓
|
|
data_from |
String
|
0
|
|
錯誤資訊
|
|
error |
String
|
0
|
|
錯誤資訊
|
|
unit |
String
|
0
|
|
單位
|
|
is_support_mix |
Boolean
|
0
|
|
|
|
mix_amount |
Int
|
0
|
|
|
|
mix_Begin |
Int
|
0
|
|
|
|
mix_number |
Int
|
0
|
|
|
|
sales_data |
Date
|
0
|
|
|
|
location |
String
|
0
|
|
發貨地
|
|
props_img |
Mix
|
0
|
|
屬性圖片
|
|
sales_info |
Mix
|
0
|
|
|
|
desc_img |
Mix
|
0
|
|
詳情圖片列表
|
|
shop_item |
Mix
|
0
|
|
|
|
relate_items |
Mix
|
0
|
|
|
四、呼叫示例與程式碼解析
以下是呼叫商品詳情資訊API介面的示例程式碼：
import requests
def get_product_detail(product_id, timestamp, api_key):
url = f"https://api.1688.com/product/detail?productId={product_id}×tamp={timestamp}&apiKey={api_key}"
response = requests.get(url)
if response.status_code == 200:
return response.json()
else:
return None-- 請求示例 url 預設請求引數已經URL編碼處理 curl -i "https://api-gw.onebound.cn/1688/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=610947572360"
響應示例
{
"item": {
"num_iid": "610947572360",
"title": "廠家直銷小米有品Qin2 Pro智慧手機學生機老人機備用機小愛同學4G",
"desc_short": "",
"price": "799.00",
"total_price": 0,
"suggestive_price": 0,
"orginal_price": "799.00",
"nick": "qin多親科技",
"num": "1763",
"detail_url": "https://detail.1688.com/offer/610947572360.html",
"pic_url": "
"brand": "",
"brandId": "",
"rootCatId": "",
"cid": "50903",
"desc": "<div id=\"offer-template-0\"></div><p><span><span>深圳市多親科技有限公司（簡稱“多親科技”)成立於2014年9月是國內領先的人工智慧硬體解決方案供應商。多親科技積極推動人工智慧技術的創新研發，在人工智慧終端裝置、系統軟體的研發和生產領域，具有深厚的技術沉澱與實力。</span></span></p><p><span> </span></p><p><span> 多親產品銷售網路覆蓋全國各地乃至遠銷海外，歡迎企業定製、團購、經銷代理。</span></p><p><span> 優質的產品、過硬的技術、完善的服務、是我們合作雙贏的開篇。</span></p><p><span> <span ><strong><span >歡迎有意向者實地考察，垂詢電話：13662284449.</span></strong></span></span></p><p><span> </span></p><p><span>溫馨提示：</span></p><p><span><span><span>1、可定製--</span></span>承接各種訂單訂製！為客戶定製機身、開機畫面、預裝軟體、包裝等定製！</span><br /><span><span><span>2、質量保證--</span></span>本公司專注通訊行業10年，線下線下百花齊放，客戶復購率達30%以上。</span><br /><span><span><span>3、價格實惠--</span></span>本店是工廠直供，沒有中間商差價，一站到客，薄利多銷。</span><br /><span><span><span>4、售後服務--</span></span>本店出售的所有產品均提供1年的質保。因質量原因退換貨（非人為因素）30天內換新。</span></p><p> </p><p><span><img alt=\"undefined\" height=\"446.22866894197955\" src=\"\" width=\"790\" /><br /><img alt=\"undefined\" height=\"457.5154730327144\" src=\"\" width=\"790\" /><br /><img alt=\"undefined\" height=\"443.2365499573014\" src=\"\" width=\"790\" /><br /><img alt=\"undefined\" height=\"440.350569675723\" src=\"\" width=\"790\" /><br /></span></p><p><img alt=\"undefined\" src=\"\" /></p><p><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /></p><p><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /></p><p><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /></p><p><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><img alt=\"undefined\" src=\"\" /><br /><br /><br /></p>",
"item_imgs": [
{
"url": "
},
{
"url": "
},
{
"url": "
},
{
"url": "
},
{
"url": "
}
],
"item_weight": "",
"post_fee": "",
"express_fee": "",
"ems_fee": "",
"shipping_to": "",
"video": [],
"sample_id": "",
"props_name": "0:0:機身記憶體:64GB;1:0:顏色:鐵灰色;1:1:顏色:瓷白色",
"prop_imgs": {
"prop_img": []
},
"property_alias": "0:0:64GB;1:0:鐵灰色;1:1:瓷白色",
"props": [
{
"name": "品牌",
"value": "多親"
},
{
"name": "型號",
"value": "Qin 2 Pro"
},
{
"name": "手機型別",
"value": "老人手機"
},
{
"name": "外形",
"value": "直板"
},
{
"name": "主屏尺寸",
"value": "大螢幕(5.0英寸—5.9英寸)"
},
{
"name": "網路制式",
"value": "移動4G(TD-LTE),聯通/電信4G(FDD-LTE)"
},
{
"name": "作業系統",
"value": "Android 9.0系統"
},
{
"name": "電池容量",
"value": "2100"
},
{
"name": "攝像頭畫素",
"value": "1200萬-1999萬"
},
{
"name": "儲存卡",
"value": "支援儲存卡"
},
{
"name": "處理器核心",
"value": "八核"
},
{
"name": "執行記憶體",
"value": "2GB"
},
{
"name": "手機版本",
"value": "大陸行貨"
},
{
"name": "售後型別",
"value": "全國聯保"
},
{
"name": "上市時間",
"value": "2019"
},
{
"name": "適用送禮場合",
"value": "員工福利,頒獎紀念,廣告促銷,節日,展銷會,公關策劃,生日,商務饋贈"
},
{
"name": "3C證書編號",
"value": "2019161606319519"
},
{
"name": "CPU品牌",
"value": "展訊"
},
{
"name": "運營商",
"value": "中國移動,中國電信,中國聯通"
},
{
"name": "網路模式",
"value": "單卡單模"
},
{
"name": "機身記憶體",
"value": "64GB"
},
{
"name": "顏色",
"value": "鐵灰色,瓷白色"
},
{
"name": "電信裝置進網許可證編號",
"value": "02-B613-192425"
}
],
"total_sold": "1",
"scale": "",
"sellUnit": "",
"skus": {
"sku": [
{
"price": "799.00",
"total_price": 0,
"sales": "55",
"properties": "0:0;1:1",
"properties_name": "0:0:機身記憶體:64GB;1:1:顏色:瓷白色",
"quantity": "932",
"sku_id": "4309097072612",
"spec_id": "63828b15ad641fdb131775f32e4c050c"
},
{
"price": "799.00",
"total_price": 0,
"sales": "159",
"properties": "0:0;1:0",
"properties_name": "0:0:機身記憶體:64GB;1:0:顏色:鐵灰色",
"quantity": "831",
"sku_id": "4302217872901",
"spec_id": "0eb631954bfe8fb00a45824fc6193f2f"
}
]
},
"seller_id": "2206619673102",
"sales": 30,
"shop_id": "",
"props_list": {
"0:0": "機身記憶體:64GB",
"1:0": "顏色:鐵灰色",
"1:1": "顏色:瓷白色"
},
"seller_info": {
"nick": "qin多親科技",
"user_num_id": "2206619673102",
"sid": "b2b-2206619673102e9470",
"title": "深圳多親科技實力賣場",
"zhuy": "https://winport.m.1688.com/page/index.html?memberId=b2b-2206619673102e9470",
"shop_name": "qin多親科技"
},
"tmall": "",
"data_from": "1688app",
"error": "",
"unit": "部",
"is_support_mix": null,
"mix_amount": null,
"mix_begin": null,
"mix_number": null,
"min_num": "2",
"sales_data": "",
"location": "廣東省 深圳市",
"props_img": [],
"sales_info": {
"seller_num": "",
"repeat_rate_purchase": "",
"per_capita_purchases": "",
"comment_num": "",
"comment_url": ""
},
"desc_img": [
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
""
],
"shop_item": [],
"relate_items": []
},
"secache": "f75c59301daa3fc1610a8563c998f851",
"secache_time": 1608276252,
"secache_date": "2020-12-18 15:24:12",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:12 max:10000",
"execution_time": 6.65,
"server_time": "Beijing/2020-12-18 15:24:17",
"client_ip": "182.111.155.89",
"call_args": {
"num_iid": "610947572360",
"area_id": "440111"
},
"api_type": "1688",
"translate_language": "zh-CN",
"translate_engine": "google_cn",
"server_memory": "4.44MB",
"request_id": "gw-2.5fdc591b3bdb0"
}異常示例
{
"error": "item-not-found",
"reason": "商品沒找到",
"error_code": "2000",
"success": 0,
"cache": 0,
"api_info": "today:0 max:10000",
"execution_time": 0.081,
"server_time": "Beijing/2020-06-10 23:44:00",
"call_args": [],
"api_type": "1688",
"request_id": "15ee0ffc041242"
}錯誤碼解釋
|
狀態程式碼(error_code)
|
狀態資訊
|
詳細描述
|
是否收費
|
|
0000
|
success
|
介面呼叫成功並返回相關資料
|
是
|
|
2000
|
Search success but no result
|
介面訪問成功，但是搜尋沒有結果
|
是
|
|
4000
|
Server internal error
|
伺服器內部錯誤
|
否
|
|
4001
|
Network error
|
網路錯誤
|
否
|
|
4002
|
Target server error
|
目標伺服器錯誤
|
否
|
|
4003
|
Param error
|
使用者輸入引數錯誤
|
忽略
|
|
4004
|
Account not found
|
使用者帳號不存在
|
忽略
|
|
4005
|
Invalid authentication credentials
|
授權失敗
|
忽略
|
|
4006
|
API stopped
|
您的當前API已停用
|
忽略
|
|
4007
|
Account stopped
|
您的賬戶已停用
|
忽略
|
|
4008
|
API rate limit exceeded
|
併發已達上限
|
忽略
|
|
4009
|
API maintenance
|
API維護中
|
忽略
|
|
4010
|
API not found with these values
|
API不存在
|
忽略
|
|
4012
|
Please add api first
|
請先新增api
|
忽略
|
|
4013
|
Number of calls exceeded
|
呼叫次數超限
|
忽略
|
|
4014
|
Missing url param
|
引數缺失
|
忽略
|
|
4015
|
Wrong pageToken
|
引數pageToken有誤
|
忽略
|
|
4016
|
Insufficient balance
|
餘額不足
|
忽略
|
|
4017
|
timeout error
|
請求超時
|
否
|
|
5000
|
unknown error
|
未知錯誤
|
否
|
五、常見問題與處理方法
在呼叫商品詳情資訊API介面時，可能會遇到一些問題，如請求超時、引數錯誤等。以下是一些常見問題的處理方法：
- 請求超時：檢查網路連線是否正常，同時適當增加請求超時時間。
- 引數錯誤：仔細核對傳入的請求引數，確保與文件要求一致。特別注意商品ID、時間戳和API金鑰的準確性。
- 返回資料異常：檢查響應資料的狀態碼和內容，分析可能的原因。如有需要，可聯絡1688開放平臺技術支援尋求幫助。
六、總結與展望
透過本文的介紹，我們瞭解瞭如何使用1688開放平臺的商品詳情資訊API介面獲取商品詳細資訊。這一功能對於開發者來說具有很高的實用價值，可以幫助實現電商應用、比價工具、資料分析等多種功能。在未來的發展中，隨著電商平臺的不斷壯大和開放平臺技術的持續進步，我們期待看到更多實用、便捷的API介面出現，為開發者提供更多可能性。
來自 “ ITPUB部落格 ” ，連結：http://blog.itpub.net/70026910/viewspace-2996142/，如需轉載，請註明出處，否則將追究法律責任。
相關文章
- 使用1688開放平臺API介面獲取商品詳情資訊API
- 使用商品詳情API介面獲取商品資料API
- 使用API介面獲取拼多多商品詳情API
- 獲取1688商品詳情API：步驟與程式碼示例API
- 用PHP使用API介面獲取蝦皮商品詳情PHPAPI
- 淘寶詳情API介面：一鍵獲取商品資訊的實踐探索API
- python批次採集1688商品詳情資料介面+1688商品列表資料介面+1688商品API資料介面PythonAPI
- 淘寶開放平臺API - 獲取單筆交易的詳細資訊API
- 1688商品詳情API跨境專用介面php javaAPIPHPJava
- 1688詳情api介面API
- 阿里巴巴國際站API詳情介面獲取商品詳情介面阿里API
- 詳情API介面上貨搬運獲取資訊API介面API
- Lazada詳情API介面：一鍵獲取商品資訊的深度實踐API
- 用Java使用API介面獲取Lazada商品詳情JavaAPI
- Temu api介面 獲取商品詳情 資料採集API
- 透過1688店鋪所有商品API介面一鍵獲取店鋪所有商品資訊API
- 如何使用商品詳情API介面來獲取想要的商品資料？API
- Java語言獲取小紅書商品詳情 API介面（商品ID、商品標題等）JavaAPI
- 獲取淘寶商品詳情api、介面獲取寶貝詳情、產品詳細屬性示例說明API
- C++語言亞馬遜獲取AMAZON商品詳情 API介面C++亞馬遜API
- 教您如何使用API介面獲取拼多多商品詳情API
- 商品詳情API介面API
- 各類電商平臺批次獲取商品資訊 API 詳細操作說明API
- 1688 API分享：抓取1688商品詳情頁資料API
- 速賣通API介面解析，實現獲得aliexpress商品詳情APIExpress
- 拼多多API介面解析，實現根據ID取商品詳情API
- 獲取拼多多商品詳情api、介面獲取寶貝詳情、產品詳細屬性Java示例說明APIJava
- 開放平臺API介面API
- 1688商品詳情資料介面、商品列表介面，商品屬性介面、商品優惠券介面
- 如何使用商品詳情API介面獲取商品資料：一篇詳盡的論述API
- 如何獲得淘寶/天貓淘寶商品詳情 API介面API
- 1688商品詳情APIERP選品專用API介面 Python JavaAPIPythonJava
- 阿里巴巴商品採集介面 商品詳情api 商品主圖介面 商品詳情圖介面阿里API
- Java獲取淘寶/天貓商品詳情 API介面（寶貝詳情資料、寶貝ID、寶貝標題、商品簡介等）JavaAPI
- 拼多多根據ID取商品詳情 API介面（item_get-根據ID取商品詳情）API
- 透過API介面獲取阿里巴巴商品詳情示例說明API阿里
- 震坤行API介面聚合解析，實現根據ID取商品詳情API
- 揭秘微店詳情API介面：引領商品資訊獲取新篇章，賦能開發者無限可能API