淘寶API的基本調(diào)用

1. API文檔與SDK
淘寶API官方提供了詳細(xì)的API文檔，包含了API的使用說(shuō)明、參數(shù)列表、示例代碼等內(nèi)容。開(kāi)發(fā)者可以通過(guò)文檔了解每個(gè)API接口的具體功能和使用方法。此外，淘寶API還提供了多種編程語(yǔ)言的SDK，方便開(kāi)發(fā)者進(jìn)行快速集成和開(kāi)發(fā)。

2. API調(diào)用方式
淘寶API的調(diào)用方式主要有兩種：GET請(qǐng)求和POST請(qǐng)求。GET請(qǐng)求適用于獲取數(shù)據(jù)類接口，而POST請(qǐng)求適用于修改數(shù)據(jù)類接口。開(kāi)發(fā)者需要根據(jù)不同的接口需求選擇合適的調(diào)用方式，并根據(jù)接口文檔提供的參數(shù)進(jìn)行請(qǐng)求。

3. API調(diào)用限制與注意事項(xiàng)
為了保證API的穩(wěn)定性和安全性，淘寶API設(shè)置了訪問(wèn)頻率限制和調(diào)用次數(shù)限制。開(kāi)發(fā)者在使用API時(shí)需要注意遵守這些限制，避免因頻繁調(diào)用而導(dǎo)致API被封禁或異常。

四、淘寶API實(shí)戰(zhàn)應(yīng)用示例
以商品查詢接口為例，介紹淘寶API的實(shí)際應(yīng)用。首先，開(kāi)發(fā)者需要根據(jù)API文檔獲取調(diào)用該接口所需的參數(shù)和URL。然后，通過(guò)構(gòu)造請(qǐng)求參數(shù)和簽名，使用HTTP協(xié)議發(fā)送請(qǐng)求并獲取API返回的結(jié)果。

item_search - 按關(guān)鍵字搜索淘寶商品

item_get - 獲得淘寶商品詳情

item_review - 獲得淘寶商品評(píng)論

淘寶/天貓按關(guān)鍵字搜索淘寶商品 API 返回值說(shuō)明

請(qǐng)求參數(shù)

請(qǐng)求參數(shù)：q=女裝&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter=

參數(shù)說(shuō)明：q:搜索關(guān)鍵字
cat:分類ID
start_price:開(kāi)始價(jià)格
end_price:結(jié)束價(jià)格
sort:排序[bid,_bid,bid2,_bid2,_sale,_credit]
? (bid:總價(jià),bid2:商品價(jià)格,sale:銷量,credit信用,加_前綴為從大到小排序)
page:頁(yè)數(shù)

API 返回結(jié)果
?
---------------------------------------
Result Object:
---------------------------------------
{
?? ?"item": {
?? ??? ?"num_iid": "652874751412",
?? ??? ?"title": "北歐輕奢布藝沙發(fā) 小戶型簡(jiǎn)約現(xiàn)代客廳ins風(fēng)網(wǎng)紅款三雙人訂制沙發(fā)",
?? ??? ?"desc_short": "",
?? ??? ?"price": "480.00",
?? ??? ?"total_price": 0,
?? ??? ?"suggestive_price": 0,
?? ??? ?"orginal_price": "480.00",
?? ??? ?"nick": "惜情yqq1127",
?? ??? ?"num": "200",
?? ??? ?"min_num": 0,
?? ??? ?"detail_url": "https://item.taobao.com/item.htm?id=652874751412",
?? ??? ?"pic_url": "//img.alicdn.com/imgextra/i4/2568161054/O1CN01aYBriY1Jem9UDtt9e_!!2568161054.jpg",
?? ??? ?"brand": "#0 工廠",
?? ??? ?"brandId": "1435187098",
?? ??? ?"rootCatId": "50008164",
?? ??? ?"cid": "50020632",
?? ??? ?"crumbs": [],
?? ??? ?"created_time": "",
?? ??? ?"modified_time": "",
?? ??? ?"delist_time": "",
?? ??? ?"desc": "<img size=\"27893\">https://img.alicdn.com/imgextra/i3/2568161054/O1CN01LFmSOU1Jem9QOjMPb_!!2568161054.jpg</img><img size=\"132455\">https://img.alicdn.com/imgextra/i3/2568161054/O1CN014vyOOT1Jem9DpHz3Y_!!2568161054.jpg</img><img size=\"2455\">https://img.alicdn.com/imgextra/i1/2568161054/O1CN01B3PpsA1Jem9N8V7uf_!!2568161054.jpg</img><img size=\"117664\">https://img.alicdn.com/imgextra/i2/2568161054/O1CN015JbyeY1Jem9MZshUt_!!2568161054.jpg</img><img size=\"16674\">https://img.alicdn.com/imgextra/i1/2568161054/O1CN01HXSoxx1Jem9RvgzHN_!!2568161054.jpg</img><img size=\"96260\">https://img.alicdn.com/imgextra/i3/2568161054/O1CN01IEultA1Jem9MdEx8R_!!2568161054.jpg</img><img size=\"13573\">https://img.alicdn.com/imgextra/i3/2568161054/O1CN0176K98O1Jem9QOjE69_!!2568161054.jpg</img><img size=\"110974\">https://img.alicdn.com/imgextra/i4/2568161054/O1CN013Pxp1O1Jem9RvgeTv_!!2568161054.jpg</img><img size=\"104198\">https://img.alicdn.com/imgextra/i1/2568161054/O1CN01SfyZ8M1Jem9QOi1Gx_!!2568161054.jpg</img><img size=\"576580\">https://img.alicdn.com/imgextra/i4/2568161054/O1CN01bb1POa1Jem9Sdgve2_!!2568161054.jpg</img><img size=\"676617\">https://img.alicdn.com/imgextra/i3/2568161054/O1CN018Eo9dV1Jem9KV0y79_!!2568161054.jpg</img><img size=\"9125\">https://img.alicdn.com/imgextra/i1/2568161054/O1CN01vuEofr1Jem9Nzy9xY_!!2568161054.jpg</img><img size=\"107197\">https://img.alicdn.com/imgextra/i4/2568161054/O1CN01qw9sAi1Jem8wkNKpy_!!2568161054.jpg</img><img size=\"198877\">https://img.alicdn.com/imgextra/i1/2568161054/O1CN01HeFhFw1Jem8rLnjBY_!!2568161054.jpg</img><img size=\"71423\">https://img.alicdn.com/imgextra/i2/2568161054/O1CN01SNgjoi1Jem9QOil15_!!2568161054.jpg</img><img size=\"37628\">https://img.alicdn.com/imgextra/i2/2568161054/O1CN01RXf3RA1Jem9DpHVwj_!!2568161054.jpg</img><img size=\"170889\">https://img.alicdn.com/imgextra/i4/2568161054/O1CN01gZmZjt1Jem9ISThgm_!!2568161054.jpg</img><img size=\"6378\">https://img.alicdn.com/imgextra/i2/2568161054/O1CN01YL0FHM1Jem9PQTjX9_!!2568161054.jpg</img><img size=\"212074\">https://img.alicdn.com/imgextra/i4/2568161054/O1CN01UhsEhZ1Jem8yvJIhZ_!!2568161054.jpg</img><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-4.64e2b79a30dad&p=1032055816&k=i_key&t=1692579740\" style=\"display:none\" />",
?? ??? ?"desc_img": [],
?? ??? ?"item_imgs": [
?? ??? ??? ?{
?? ??? ??? ??? ?"url": "//img.alicdn.com/imgextra/i4/2568161054/O1CN01aYBriY1Jem9UDtt9e_!!2568161054.jpg"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"url": "//img.alicdn.com/imgextra/i3/2568161054/O1CN01kjOfNb1Jem9DmWn8Y_!!2568161054.jpg"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"url": "//img.alicdn.com/imgextra/i1/2568161054/O1CN01HoB9ha1Jem9DmWn8r_!!2568161054.jpg"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"url": "//img.alicdn.com/imgextra/i4/2568161054/O1CN011PjP2P1Jem9MXEUFT_!!2568161054.jpg"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"url": "//img.alicdn.com/imgextra/i3/2568161054/O1CN01KUfBFL1Jem9KTTMn1_!!2568161054.jpg"
?? ??? ??? ?}
?? ??? ?],
?? ??? ?"item_weight": "",
?? ??? ?"item_size": "",
?? ??? ?"location": "江蘇南通",
?? ??? ?"post_fee": "",
?? ??? ?"express_fee": null,
?? ??? ?"ems_fee": "",
?? ??? ?"shipping_to": "",
?? ??? ?"has_discount": "false",
?? ??? ?"video": {
?? ??? ??? ?"url": null
?? ??? ?},
?? ??? ?"is_virtual": "",
?? ??? ?"sample_id": "",
?? ??? ?"is_promotion": "false",
?? ??? ?"props_name": "31480:14306495906:幾人坐:腳踏90*60*48cm;31480:14306495907:幾人坐:雙人165*95*67cm;31480:14306495908:幾人坐:三人210*95*67cm;31480:14306495909:幾人坐:單人100*95*67cm;31480:21480914361:幾人坐:四人位240*95*67cm;31480:21480914362:幾人坐:大四人320*95*76cm;31480:1387571900:幾人坐:3米貴妃沙發(fā);31480:32527954:幾人坐:定制尺寸;1627207:28321:顏色分類:乳白色 尺寸顏色可定制",
?? ??? ?"prop_imgs": {
?? ??? ??? ?"prop_img": [
?? ??? ??? ??? ?{
?? ??? ??? ??? ??? ?"properties": "1627207:28321",
?? ??? ??? ??? ??? ?"url": "//img.alicdn.com/imgextra/i1/2568161054/O1CN017GTZ4h1Jem9Qra1ap_!!2568161054.jpg"
?? ??? ??? ??? ?}
?? ??? ??? ?]
?? ??? ?},
?? ??? ?"property_alias": "",
?? ??? ?"props": [
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "品牌",
?? ??? ??? ??? ?"value": "#0 工廠"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "型號(hào)",
?? ??? ??? ??? ?"value": "520"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "材質(zhì)",
?? ??? ??? ??? ?"value": "木"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "木質(zhì)材質(zhì)",
?? ??? ??? ??? ?"value": "松木"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "面料",
?? ??? ??? ??? ?"value": "絨布"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "風(fēng)格",
?? ??? ??? ??? ?"value": "北歐"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "幾人坐",
?? ??? ??? ??? ?"value": "腳踏90*60*48cm,雙人165*95*67cm,三人210*95*67cm,單人100*95*67cm,四人位240*95*67cm,大四人320*95*76cm,3米貴妃沙發(fā),定制尺寸"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "顏色分類",
?? ??? ??? ??? ?"value": "乳白色"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "填充物",
?? ??? ??? ??? ?"value": "海綿"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "結(jié)構(gòu)工藝",
?? ??? ??? ??? ?"value": "木質(zhì)工藝"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "是否可定制",
?? ??? ??? ??? ?"value": "是"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "沙發(fā)組合形式",
?? ??? ??? ??? ?"value": "U形"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "是否可拆洗",
?? ??? ??? ??? ?"value": "是"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "適用對(duì)象",
?? ??? ??? ??? ?"value": "成年人"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "是否帶儲(chǔ)物空間",
?? ??? ??? ??? ?"value": "否"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "產(chǎn)地",
?? ??? ??? ??? ?"value": "上海"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "地市",
?? ??? ??? ??? ?"value": "上海市"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "區(qū)縣",
?? ??? ??? ??? ?"value": "奉賢區(qū)"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "是否組裝",
?? ??? ??? ??? ?"value": "否"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "出租車是否可運(yùn)輸",
?? ??? ??? ??? ?"value": "否"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "填充物硬度",
?? ??? ??? ??? ?"value": "軟"
?? ??? ??? ?},
?? ??? ??? ?{
?? ??? ??? ??? ?"name": "款式定位",
?? ??? ??? ??? ?"value": "經(jīng)濟(jì)型"
?? ??? ??? ?}
?? ??? ?],
?? ??? ?"total_sold": "619",
?? ??? ?"skus": {
?? ??? ??? ?"sku": [
?? ??? ??? ??? ?{
?? ??? ??? ??? ??? ?"price": "480",
?? ??? ??? ??? ??? ?"total_price": 0,
?? ??? ??? ??? ??? ?"orginal_price": "480",
?? ??? ??? ??? ??? ?"properties": "31480:14306495906;1627207:28321",
?? ??? ??? ??? ??? ?"properties_name": "31480:14306495906:幾人坐:腳踏90*60*48cm;1627207:28321:顏色分類:乳白色 尺寸顏色可定制",
?? ??? ??? ??? ??? ?"quantity": "200",
?? ??? ??? ??? ??? ?"sku_id": "4881047531343"
?? ??? ??? ??? ?},
?? ??? ??? ??? ?{
?? ??? ??? ??? ??? ?"price": "1688",
?? ??? ??? ??? ??? ?"total_price": 0,
?? ??? ??? ??? ??? ?"orginal_price": "1688",
?? ??? ??? ??? ??? ?"properties": "31480:14306495907;1627207:28321",
?? ??? ??? ??? ??? ?"properties_name": "31480:14306495907:幾人坐:雙人165*95*67cm;1627207:28321:顏色分類:乳白色 尺寸顏色可定制",
?? ??? ??? ??? ??? ?"quantity": "135",
?? ??? ??? ??? ??? ?"sku_id": "4881047531344"
?? ??? ??? ??? ?},
?? ??? ??? ??? ?{
?? ??? ??? ??? ??? ?"price": "2088",
?? ??? ??? ??? ??? ?"total_price": 0,
?? ??? ??? ??? ??? ?"orginal_price": "2088",
?? ??? ??? ??? ??? ?"properties": "31480:14306495908;1627207:28321",
?? ??? ??? ??? ??? ?"properties_name": "31480:14306495908:幾人坐:三人210*95*67cm;1627207:28321:顏色分類:乳白色 尺寸顏色可定制",
?? ??? ??? ??? ??? ?"quantity": "200",
?? ??? ??? ??? ??? ?"sku_id": "4881047531345"
?? ??? ??? ??? ?},
?? ??? ??? ??? ?{
?? ??? ??? ??? ??? ?"price": "968",
?? ??? ??? ??? ??? ?"total_price": 0,
?? ??? ??? ??? ??? ?"orginal_price": "968",
?? ??? ??? ??? ??? ?"properties": "31480:14306495909;1627207:28321",
?? ??? ??? ??? ??? ?"properties_name": "31480:14306495909:幾人坐:單人100*95*67cm;1627207:28321:顏色分類:乳白色 尺寸顏色可定制",
?? ??? ??? ??? ??? ?"quantity": "200",
?? ??? ??? ??? ??? ?"sku_id": "4881047531346"
?? ??? ??? ??? ?},
?? ??? ??? ??? ?{
?? ??? ??? ??? ??? ?"price": "2388",
?? ??? ??? ??? ??? ?"total_price": 0,
?? ??? ??? ??? ??? ?"orginal_price": "2388",
?? ??? ??? ??? ??? ?"properties": "31480:21480914361;1627207:28321",
?? ??? ??? ??? ??? ?"properties_name": "31480:21480914361:幾人坐:四人位240*95*67cm;1627207:28321:顏色分類:乳白色 尺寸顏色可定制",
?? ??? ??? ??? ??? ?"quantity": "200",
?? ??? ??? ??? ??? ?"sku_id": "5039985183001"
?? ??? ??? ??? ?},
?? ??? ??? ??? ?{
?? ??? ??? ??? ??? ?"price": "3188",
?? ??? ??? ??? ??? ?"total_price": 0,
?? ??? ??? ??? ??? ?"orginal_price": "3188",
?? ??? ??? ??? ??? ?"properties": "31480:21480914362;1627207:28321",
?? ??? ??? ??? ??? ?"properties_name": "31480:21480914362:幾人坐:大四人320*95*76cm;1627207:28321:顏色分類:乳白色 尺寸顏色可定制",
?? ??? ??? ??? ??? ?"quantity": "200",
?? ??? ??? ??? ??? ?"sku_id": "5039985183002"
?? ??? ??? ??? ?},
?? ??? ??? ??? ?{
?? ??? ??? ??? ??? ?"price": "3400",
?? ??? ??? ??? ??? ?"total_price": 0,
?? ??? ??? ??? ??? ?"orginal_price": "3400",
?? ??? ??? ??? ??? ?"properties": "31480:1387571900;1627207:28321",
?? ??? ??? ??? ??? ?"properties_name": "31480:1387571900:幾人坐:3米貴妃沙發(fā);1627207:28321:顏色分類:乳白色 尺寸顏色可定制",
?? ??? ??? ??? ??? ?"quantity": "200",
?? ??? ??? ??? ??? ?"sku_id": "5039984824000"
?? ??? ??? ??? ?},
?? ??? ??? ??? ?{
?? ??? ??? ??? ??? ?"price": "3000",
?? ??? ??? ??? ??? ?"total_price": 0,
?? ??? ??? ??? ??? ?"orginal_price": "3000",
?? ??? ??? ??? ??? ?"properties": "31480:32527954;1627207:28321",
?? ??? ??? ??? ??? ?"properties_name": "31480:32527954:幾人坐:定制尺寸;1627207:28321:顏色分類:乳白色 尺寸顏色可定制",
?? ??? ??? ??? ??? ?"quantity": "200",
?? ??? ??? ??? ??? ?"sku_id": "5039985183003"
?? ??? ??? ??? ?}
?? ??? ??? ?]
?? ??? ?},
?? ??? ?"seller_id": "2568161054",
?? ??? ?"sales": 16,
?? ??? ?"shop_id": "567158267",
?? ??? ?"props_list": {
?? ??? ??? ?"31480:14306495906": "幾人坐:腳踏90*60*48cm",
?? ??? ??? ?"31480:14306495907": "幾人坐:雙人165*95*67cm",
?? ??? ??? ?"31480:14306495908": "幾人坐:三人210*95*67cm",
?? ??? ??? ?"31480:14306495909": "幾人坐:單人100*95*67cm",
?? ??? ??? ?"31480:21480914361": "幾人坐:四人位240*95*67cm",
?? ??? ??? ?"31480:21480914362": "幾人坐:大四人320*95*76cm",
?? ??? ??? ?"31480:1387571900": "幾人坐:3米貴妃沙發(fā)",
?? ??? ??? ?"31480:32527954": "幾人坐:定制尺寸",
?? ??? ??? ?"1627207:28321": "顏色分類:乳白色 尺寸顏色可定制"
?? ??? ?},
?? ??? ?"seller_info": {
?? ??? ??? ?"nick": "惜情yqq1127",
?? ??? ??? ?"item_score": "4.9 ",
?? ??? ??? ?"score_p": "4.9 ",
?? ??? ??? ?"delivery_score": "4.9 ",
?? ??? ??? ?"shop_type": "C",
?? ??? ??? ?"user_num_id": "2568161054",
?? ??? ??? ?"sid": "567158267",
?? ??? ??? ?"title": "現(xiàn)代布藝沙發(fā)",
?? ??? ??? ?"zhuy": "https://shop567158267.taobao.com/",
?? ??? ??? ?"shop_name": "現(xiàn)代布藝沙發(fā)"
?? ??? ?},
?? ??? ?"tmall": false,
?? ??? ?"error": "",
?? ??? ?"warning": "",
?? ??? ?"url_log": [],
?? ??? ?"fav_count": "7970",
?? ??? ?"fans_count": "681",
?? ??? ?"freight": "平郵: 快遞包郵",
?? ??? ?"props_imgs": {
?? ??? ??? ?"prop_img": [
?? ??? ??? ??? ?{
?? ??? ??? ??? ??? ?"properties": "1627207:28321",
?? ??? ??? ??? ??? ?"url": "//img.alicdn.com/imgextra/i1/2568161054/O1CN017GTZ4h1Jem9Qra1ap_!!2568161054.jpg"
?? ??? ??? ??? ?}
?? ??? ??? ?]
?? ??? ?},
?? ??? ?"_ddf": "xdl",
?? ??? ?"promo_type": null,
?? ??? ?"props_img": {
?? ??? ??? ?"1627207:28321": "//img.alicdn.com/imgextra/i1/2568161054/O1CN017GTZ4h1Jem9Qra1ap_!!2568161054.jpg"
?? ??? ?},
?? ??? ?"format_check": "ok",
?? ??? ?"shop_item": [],
?? ??? ?"relate_items": []
?? ?},
?? ?"error": "",
?? ?"secache": "4ad7ad2480af253fec9c2fd4daa266bb",
?? ?"secache_time": 1692579740,
?? ?"secache_date": "2023-08-21 09:02:20",
?? ?"translate_status": "",
?? ?"translate_time": 0,
?? ?"language": {
?? ??? ?"default_lang": "cn",
?? ??? ?"current_lang": "cn"
?? ?},
?? ?"reason": "",
?? ?"error_code": "0000",
?? ?"cache": 0,
?? ?"api_info": "today:92 max:10100 all[158=92+40+26];expires:2030-12-31",
?? ?"execution_time": "2.439",
?? ?"server_time": "Beijing/2023-08-21 09:02:20",
?? ?"client_ip": "61.131.236.8",
?? ?"call_args": {
?? ??? ?"num_iid": "652874751412",
?? ??? ?"is_promotion": "1"
?? ?},
?? ?"api_type": "taobao",
?? ?"translate_language": "zh-CN",
?? ?"translate_engine": "baidu",
?? ?"server_memory": "0.93MB",
?? ?"request_id": "gw-4.64e2b79a30dad",
?? ?"last_id": "1968894188"
}