阿里巴巴按圖搜索1688商品(拍立淘)API 返回值說明
阿里巴巴按圖搜索1688商品(拍立淘)API 的返回值通常以 JSON 格式返回,包含搜索結果、商品信息、分頁信息等。以下是具體的返回值說明:
1. 請求狀態信息
code
:狀態碼,通常為?200
?表示請求成功,其他值表示錯誤(如?401
?表示未授權,429
?表示請求頻率過高)。msg
:請求狀態描述信息,例如?"success"
?表示成功,"Unauthorized"
?表示未授權。request_id
:請求的唯一標識符,用于追蹤和調試請求。
2. 搜索結果信息
items
:商品列表,包含搜索到的商品信息,每個商品為一個對象,包含以下字段:num_iid
:商品 ID,1688 平臺上商品的唯一標識。title
:商品標題,商品的名稱或簡短描述。pic_url
:商品主圖 URL,商品的圖片地址。price
:商品價格,商品的售價。original_price
:商品原價(如有)。promotion_price
:促銷價(如有)。sales
:商品銷量,商品的累計銷量。seller_nick
:賣家昵稱,提供該商品的店鋪名稱。area
:賣家所在地,商品的發貨地或賣家所在地。detail_url
:商品詳情頁 URL,點擊后跳轉到商品詳情頁面。similarity_score
(可選):相似度得分,表示上傳圖片與商品的相似程度(通常為 0 到 1 之間的浮點數)。
3. 分頁信息
page_size
:每頁返回的商品數量。page_number
:當前頁碼。total_results
:搜索結果的總商品數量。total_pages
:總頁數。
4. 錯誤信息(如有)
error
:錯誤信息,包含錯誤代碼和錯誤描述。例如:json復制代碼
{
"error": {
"code": 401,
"message": "Unauthorized: Invalid API Key"
}
}
5. 示例返回值
以下是一個示例返回值:
json復制代碼
{ | |
"code": 200, | |
"msg": "success", | |
"request_id": "12345abcde", | |
"items": [ | |
{ | |
"num_iid": "6789012345678", | |
"title": "2024新款秋冬加絨衛衣", | |
"pic_url": "https://img.alicdn.com/imgextra/i1/123456789/O1CN01XXXXXXXXX_XX.jpg", | |
"price": "89.00", | |
"original_price": "129.00", | |
"promotion_price": "79.00", | |
"sales": 1234, | |
"seller_nick": "某某旗艦店", | |
"area": "廣東 廣州", | |
"detail_url": "https://detail.1688.com/offer/123456789.html", | |
"similarity_score": 0.95 | |
}, | |
{ | |
"num_iid": "8765432109876", | |
"title": "秋冬加絨連帽衛衣女", | |
"pic_url": "https://img.alicdn.com/imgextra/i2/234567890/O1CN01YYYYYYYYY_XX.jpg", | |
"price": "99.00", | |
"original_price": "159.00", | |
"promotion_price": "89.00", | |
"sales": 567, | |
"seller_nick": "某某服飾店", | |
"area": "浙江 杭州", | |
"detail_url": "https://detail.1688.com/offer/234567890.html", | |
"similarity_score": 0.92 | |
} | |
], | |
"page_size": 10, | |
"page_number": 1, | |
"total_results": 25, | |
"total_pages": 3 | |
} |
6. 注意事項
- 權限與認證:使用拍立淘 API 需要申請 API Key,并確保 API Key 具有調用權限。可以通過萬邦開放平臺獲取Key賬號和調用權限。
- 請求頻率限制:API 調用有頻率限制,超出限制可能會返回?
429 Too Many Requests
?錯誤。 - 圖片要求:上傳的圖片需清晰、完整,以提高識別準確率。
- 數據準確性:搜索結果可能因圖片質量、算法匹配度等因素而有所差異。
通過以上返回值說明,開發者可以解析 API 返回的數據,并在應用中展示搜索結果,例如商品列表、商品詳情頁鏈接等。