在電商領域，抖音作為一個新興的流量入口，其商品搜索功能尤其重要。抖音提供了按圖搜索商品的API接口，允許用戶通過上傳圖片來搜索商品，極大地提升了用戶體驗和購物效率。本文將詳細介紹如何使用抖音按圖搜索商品API，并解析其返回值。
抖音按圖搜索商品API概述
抖音按圖搜索商品API允許用戶通過上傳商品圖片，系統會自動匹配并返回相似商品的詳細信息。這項服務對于希望利用抖音平臺進行商品推廣和銷售的商家來說非常有價值。
如何使用抖音按圖搜索商品API
- 注冊抖音開放平臺賬號：首先，你需要在抖音開放平臺注冊成為開發者，并創建應用以獲取API調用憑證。
- 獲取API調用憑證：在開發者平臺中獲取API密鑰（API Key）或訪問令牌（Access Token）。
- 調用按圖搜索API：使用HTTP請求調用接口，傳入圖片URL和訪問令牌作為參數。
- 處理響應數據：解析返回的JSON數據，提取商品詳情信息。
API返回值說明
抖音按圖搜索商品API返回的數據通常包括以下字段：
- 商品ID（num_iid）：商品的唯一標識符。
- 標題（title）：商品的標題，通常包含關鍵字。
- 價格（price）：商品的價格信息。
- 銷量（sales）：商品的銷售數量。
- 描述（description）：商品的詳細描述。
- 圖片URL（image_url）：商品圖片的URL地址。
- SKU信息（skus）：商品的不同規格和價格。
示例返回值
以下是一個示例的API返回值，展示了獲取商品詳情的結構：
item_search_img-
douyin.item_search_img
公共參數
| 名稱 | 類型 | 必須 | 描述 |
|---|---|---|---|
| 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版本 請求參數 |
請求參數：imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg&cat=
參數說明：imgid: 支持本地圖片、URL圖片地址
響應參數
Version: Date:
| 名稱 | 類型 | 必須 | 示例值 | 描述 |
|---|---|---|---|---|
| items | items[] | 0 | 按圖搜索商品 |
響應示例
{
"items": {
"item": [
{
"title": "衛生紙5斤24卷5層加厚干濕兩用卷紙家用紙巾廁紙卷筒紙家庭裝實惠",
"pic_url": "https://p3-item.ecombdimg.com/img/ecom-shop-material/AgvBPXkH_m_538c7c5f021e459f37fba139dbdf9c5d_sx_335493_www800-800~tplv-5mmsx3fupr-image.jpeg",
"price": 23.99,
"num_iid": "3631161001782720257",
"shop_name": "大龍疆選紙品",
"shop_id": 100128852,
"detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3631161001782720257"
},
{
"title": "懸掛式抽紙家用實惠裝衛生紙親膚柔軟面巾紙原生木漿餐巾紙可代發",
"pic_url": "https://p3-item.ecombdimg.com/img/ecom-shop-material/qKHuWrBe_m_e0e401bcd2550de0274adc34712efe05_sx_551953_www1024-1024~tplv-5mmsx3fupr-image.jpeg",
"price": 19.9,
"num_iid": "3670328250808271281",
"shop_name": "陽光6666",
"shop_id": 17258773,
"detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3670328250808271281"
},
{
"title": "（新疆包郵）24卷衛生紙加厚款家用廁紙干濕兩用家庭裝親膚無芯卷紙",
"pic_url": "https://p3-item.ecombdimg.com/img/ecom-shop-material/QEcpSEf_m_a576e98fc8a75de180e7a3a054e38360_sx_173665_www800-800~tplv-5mmsx3fupr-image.jpeg",
"price": 26.9,
"num_iid": "3678228600483610707",
"shop_name": "新疆一姐百貨",
"shop_id": 208512,
"detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3678228600483610707"
},
{
"title": "欣蜜兒掛抽懸掛式大包紙巾原木抽紙宿舍衛生紙母嬰家用加厚餐巾紙",
"pic_url": "https://p26-item.ecombdimg.com/img/ecom-shop-material/VglVXHkX_m_7e6ac8498c47348f6cd36f78b6d7f86f_sx_409553_www800-800~tplv-5mmsx3fupr-image.jpeg",
"price": 9.9,
"num_iid": "3611090293241330285",
"shop_name": "欣蜜兒紙品濕巾旗艦店",
"shop_id": 8812388,
"detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3611090293241330285"
},
{
"title": "【寵粉福利】愛馬橙懸掛式抽紙家用衛生紙原生木漿紙巾親膚柔韌母嬰",
"pic_url": "https://p26-item.ecombdimg.com/img/ecom-shop-material/xdQwlnYD_m_44b9cb64bac181c9a11173e802f1ca0b_sx_235946_www800-800~tplv-5mmsx3fupr-image.jpeg",
"price": 2.7,
"num_iid": "3685855208195358733",
"shop_name": "敏寶寶百貨",
"shop_id": 173918159,
"detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3685855208195358733"
},
{
"title": "欣蜜兒加大加厚壁掛式抽紙原生木漿家用抽取式衛生紙提裝整箱批發",
"pic_url": "https://p26-item.ecombdimg.com/img/ecom-shop-material/VglVXHkX_m_ce8a34021d96489790351478ae7c319c_sx_164337_www720-720~tplv-5mmsx3fupr-image.jpeg",
"price": 25.4,
"num_iid": "3628852005704999740",
"shop_name": "欣蜜兒紙品濕巾旗艦店",
"shop_id": 8812388,
"detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3628852005704999740"
},
{
"title": "明柔懸掛式綿柔親膚面巾紙家用大包裝餐巾紙抽取式紙巾衛生抽紙",
"pic_url": "https://p3-item.ecombdimg.com/img/ecom-shop-material/qXXRaYM_m_352172ab196ac016616c2b875f35118d_sx_214321_www790-1471~tplv-5mmsx3fupr-image.jpeg",
"price": 79.2,
"num_iid": "3637075582052865691",
"shop_name": "南安康美環宇紙品廠",
"shop_id": 4901975,
"detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3637075582052865691"
},
{
"title": "5斤24大卷無芯卷紙衛生間廁紙五層加厚干濕兩用家用衛生紙實惠裝",
"pic_url": "https://p3-item.ecombdimg.com/img/ecom-shop-material/zLxzdsIk_m_538c7c5f021e459f37fba139dbdf9c5d_sx_335493_www800-800~tplv-5mmsx3fupr-image.jpeg",
"price": 23.99,
"num_iid": "3626875528318978928",
"shop_name": "羽護紙品",
"shop_id": 88061824,
"detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3626875528318978928"
},
{
"title": "【欣蜜兒】大包壁掛式抽紙巾1280張家用懸掛式底部抽紙廁所衛生紙巾",
"pic_url": "https://p26-item.ecombdimg.com/img/ecom-shop-material/fmeXXyNI_m_02636ba97f5d721c572a8feab3716517_sx_134856_www800-800~tplv-5mmsx3fupr-image.jpeg",
"price": 5.9,
"num_iid": "3622604863894080073",
"shop_name": "九零壹零雲夢優選店",
"shop_id": 9173240,
"detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3622604863894080073"
},
{
"title": "【加量3000張】3大提懸掛式實惠裝整箱批發壁掛紙抽紙面巾紙家用",
"pic_url": "https://p3-item.ecombdimg.com/img/ecom-shop-material/DJDUQXqO_m_adb9d1451f5057111c3ae611e0931998_sx_460353_www800-800~tplv-5mmsx3fupr-image.jpeg",
"price": 9.9,
"num_iid": "3652843337016300604",
"shop_name": "津潔生活官方旗艦店",
"shop_id": 86365609,
"detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3652843337016300604"
}
],
"total_results": 200,
"real_total_results": 200,
"page_size": 10,
"pagecount": 20,
"has_more": true,
"page": "2",
"data_from": "leo"
},
"error_code": "0000",
"reason": "ok",
"secache": "786a853f4c64d321050d68e6fa74e1bf",
"secache_time": 1717745342,
"secache_date": "2024-06-07 15:29:02",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"cache": 0,
"api_info": "today: max:15000 all[=++];expires:2031-01-01",
"execution_time": "1.965",
"server_time": "Beijing/2024-06-07 15:29:02",
"client_ip": "127.0.0.1",
"call_args": {
"imgid": "http://gw.alicdn.com/imgextra/i2/3937219703/O1CN01J6n5m42LY1r1rdGUv_!!3937219703-0-C2M.jpg_Q75.jpg"
},
"api_type": "douyin",
"server_memory": "3.31MB",
"last_id": false
}
