在電商領(lǐng)域，抖音作為一個新興的流量入口，其商品搜索功能尤其重要。抖音提供了按圖搜索商品的API接口，允許用戶通過上傳圖片來搜索商品，極大地提升了用戶體驗(yàn)和購物效率。本文將詳細(xì)介紹如何使用抖音按圖搜索商品API，并解析其返回值。
抖音按圖搜索商品API概述
抖音按圖搜索商品API允許用戶通過上傳商品圖片，系統(tǒng)會自動匹配并返回相似商品的詳細(xì)信息。這項(xiàng)服務(wù)對于希望利用抖音平臺進(jìn)行商品推廣和銷售的商家來說非常有價值。
如何使用抖音按圖搜索商品API
- 注冊抖音開放平臺賬號：首先，你需要在抖音開放平臺注冊成為開發(fā)者，并創(chuàng)建應(yīng)用以獲取API調(diào)用憑證。
- 獲取API調(diào)用憑證：在開發(fā)者平臺中獲取API密鑰（API Key）或訪問令牌（Access Token）。
- 調(diào)用按圖搜索API：使用HTTP請求調(diào)用接口，傳入圖片URL和訪問令牌作為參數(shù)。
- 處理響應(yīng)數(shù)據(jù)：解析返回的JSON數(shù)據(jù)，提取商品詳情信息。
API返回值說明
抖音按圖搜索商品API返回的數(shù)據(jù)通常包括以下字段：
- 商品ID（num_iid）：商品的唯一標(biāo)識符。
- 標(biāo)題（title）：商品的標(biāo)題，通常包含關(guān)鍵字。
- 價格（price）：商品的價格信息。
- 銷量（sales）：商品的銷售數(shù)量。
- 描述（description）：商品的詳細(xì)描述。
- 圖片URL（image_url）：商品圖片的URL地址。
- SKU信息（skus）：商品的不同規(guī)格和價格。
示例返回值
以下是一個示例的API返回值，展示了獲取商品詳情的結(jié)構(gòu)：
item_search_img-
douyin.item_search_img
公共參數(shù)
| 名稱 | 類型 | 必須 | 描述 |
|---|---|---|---|
| key | String | 是 | 調(diào)用key（必須以GET方式拼接在URL中） |
| secret | String | 是 | 調(diào)用密鑰 |
| api_name | String | 是 | API接口名稱（包括在請求地址中）[item_search,item_get,item_search_shop等] |
| cache | String | 否 | [yes,no]默認(rèn)yes，將調(diào)用緩存的數(shù)據(jù)，速度比較快 |
| result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回數(shù)據(jù)格式，默認(rèn)為json，jsonu輸出的內(nèi)容中文可以直接閱讀 |
| lang | String | 否 | [cn,en,ru]翻譯語言，默認(rèn)cn簡體中文 |
| version | String | 否 | API版本 請求參數(shù) |
請求參數(shù)：imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg&cat=
參數(shù)說明：imgid: 支持本地圖片、URL圖片地址
響應(yīng)參數(shù)
Version: Date:
| 名稱 | 類型 | 必須 | 示例值 | 描述 |
|---|---|---|---|---|
| items | items[] | 0 | 按圖搜索商品 |
響應(yīng)示例
{
"items": {
"item": [
{
"title": "衛(wèi)生紙5斤24卷5層加厚干濕兩用卷紙家用紙巾廁紙卷筒紙家庭裝實(shí)惠",
"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": "懸掛式抽紙家用實(shí)惠裝衛(wèi)生紙親膚柔軟面巾紙原生木漿餐巾紙可代發(fā)",
"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卷衛(wèi)生紙加厚款家用廁紙干濕兩用家庭裝親膚無芯卷紙",
"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": "欣蜜兒掛抽懸掛式大包紙巾原木抽紙宿舍衛(wèi)生紙母嬰家用加厚餐巾紙",
"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": "【寵粉福利】愛馬橙懸掛式抽紙家用衛(wèi)生紙原生木漿紙巾親膚柔韌母嬰",
"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": "欣蜜兒加大加厚壁掛式抽紙原生木漿家用抽取式衛(wèi)生紙?zhí)嵫b整箱批發(fā)",
"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": "明柔懸掛式綿柔親膚面巾紙家用大包裝餐巾紙抽取式紙巾衛(wèi)生抽紙",
"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": "南安康美環(huán)宇紙品廠",
"shop_id": 4901975,
"detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3637075582052865691"
},
{
"title": "5斤24大卷無芯卷紙衛(wèi)生間廁紙五層加厚干濕兩用家用衛(wèi)生紙實(shí)惠裝",
"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": "羽護(hù)紙品",
"shop_id": 88061824,
"detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3626875528318978928"
},
{
"title": "【欣蜜兒】大包壁掛式抽紙巾1280張家用懸掛式底部抽紙廁所衛(wèi)生紙巾",
"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": "九零壹零雲(yún)夢優(yōu)選店",
"shop_id": 9173240,
"detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3622604863894080073"
},
{
"title": "【加量3000張】3大提懸掛式實(shí)惠裝整箱批發(fā)壁掛紙抽紙面巾紙家用",
"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
}
