dropship from taobao 1688 by APIDropship from taobao

Dropship API can connect our service to your website.

Dropship taobao and 1688 API version: 1.2


Develop with test account: test@qq.com password: 123456

1. Get a taobao.com or 1688.com product information
URL https://www.buytaobao1688.com/api/getinfo.php
Request example https://www.buytaobao1688.com/api/getinfo.php?key=*&website=*&productid=*
Request parameter
key  (Required. The API key you can get in user center)
website     (Required, fill 1 or 2 or 3 only. 1-get product info from taobao.com, 2- get product info from 188.com, 3- get product info from aliexpress.com)
productid  (Required, the product ID contain in every product URL of taobao.com or 1688.com. If you only have the URL , you need to use Regular Expression to withdraw the product ID exactly from the URL first)
Taobao.com product success return example
1688.com product success return example
aliexpress.com product success return example
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter {"status":510} -- Balance is not enough, require MIN 5.00 yuan in your balance {"status":544} -- Fail to catch the product info
Note This API is not free, it charge 5 yuan/100 times
Need your account has MIN 5 yuan balance there This API is optional, without it, you can still finish the dropship order procedure with other free API
2. Get a product infomation
URL https://www.buytaobao1688.com/api/getproduct.php
Request example https://www.buytaobao1688.com/api/getproduct.php?key=*&productid=*
Request parameter
key  (Required. The API key you can get in user center)
productid  (Required. The product ID in buytaobao1688.com system, not taobao.com or 1688.com 's product ID)
Success return example
Success return parameter {
"id": --The product ID in our website
"wbid": -- The order ID which this product belong to
"st": --The status of this product (0-shopping cart, 20-Submit to buy, 21-On the way to our warehouse, 22-Arrived our warehouse, 23-Request exchange, 24-Ready to exchange,25-Exchanging, 26-Exchanged, 27-Request return, 28-Ready to return, 29-Returned, 30- Out of stock, 50-Pending to ship out from our warehouse, 60- Shipped out, 70- Received)
"time1": --The time you submit this product to our system
"title": --The title of this product
"price": -- Unit price of this product
"qty": -- The quantity you want to buy this product
"shfee": Local shipping fee from seller to our warehouse
"link": --The URL link of this product
"imglink": --The URL link of the product image which will be put in the cover of each product row
"store":-- The name of the store which this product is from
"cnote": --The note along with this product when you submit. Usually is color, size... }
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter {"status":508} -- Cannot find this product
3. Get all products that in an order
URL https://www.buytaobao1688.com/api/getorderproducts.php
Request example https://www.buytaobao1688.com/api/getorderproducts.php?key=*&orderid=*
Request parameter
key (Required. The API key you can get in user center)
orderid (Required. The order ID that you want the products in)
Success return example
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter {"status":508} -- Cannot find any product
4. Get products by status
URL https://www.buytaobao1688.com/api/getproducts.php
Request example https://www.buytaobao1688.com/api/getproducts.php?key=*&st=?
Request parameter
key (Required. The API key you can get in user center)
st (Required. The status of the product)
(0-shopping cart, 20-Submit to buy, 21-On the way to our warehouse, 22-Arrived our warehouse, 23-Request exchange, 24-Ready to exchange,25-Exchanging, 26-Exchanged, 27-Request return, 28-Ready to return, 29-Returned, 30- Out of stock, 50-Pending to ship out from our warehouse, 60- Shipped out, 70- Received)
Success return example
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter {"status":508} -- Cannot find any product
5. Create order
URL https://www.buytaobao1688.com/api/createorder.php
Request example https://www.buytaobao1688.com/api/createorder.php?key=*&ordernote=*orderid=*&isship=*&shipid=*&recipient=*&company=*&street=*&city=*&state=*&countrycode=*&zipcode=*&phone=*& price[0]=*&qty[0]=*&shipfee[0]=*&store[0]=*& note[0]=*&title[0]=*&link[0]=*&imglink[0]=*&price[1]=*&qty[1]=*&shipfee[1]=*&store[1]=*& note[1]=*&title[1]=*&link[1]=*&imglink[1]=*...
Request parameter
key (Required. The API key you can get in user center)
ordernote (Optional. make some special instruction for this order)
orderid (Optional. Order ID of your own website)
isship (Optional.
1 - Ship immediately when this order is ready, if your balance is not enough for international shipping fee or the shipping method you are filling is not support will make the auto shipping fail,
2 - not immediately when this order is ready,)
recipient   (Required)
company   (Optional)
street        (Required)
city            (Required)
state          (Required)
countrycode (Required, Such as "United state"-> "US" The country ISO code list is shown at the bottom)
zipcode     (Required)
phone       (Required)
shipid        (Required, The ID of shipping way, such as 1 (mean DHL). The shipping way list is shown below)
price[] (Required. The unit price of this product, During our buying , if the price is lower than real price, we will charge more from your balance, if your price is higher, we will refund the difference to your balance)
qty[] (Required. The quantity you'd like to buy this product)
shipfee[] (Required. Local shipping fee from seller to our warehouse, if the fee is lower than real cost, we will charge more from your balance, if your fee is higher, we will refund the difference to your balance)
store[] (Optional. The store name where this product from)
note[] (Optional. Note for product, usually fill color, size...)
title[] (Optional. title of the product)
link[] (Required. The product URL you want to buy. Make sure use url encode it before putting it here)
imglink[] (Optional. The cover image in each product row. Make sure use url encode it before putting it here)
Success return example
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter
{"status":510} -- Balance is not enough
{"status":533} -- Can not find the country code
Note When submitting the order, All products cost and local shipping cost will be reduced from your balance
International shipping cost need to be paid after all products in the order arrive at our warehouse to make the order finally finish this order
6. Insert products to exist order
URL https://www.buytaobao1688.com/api/insertproducts.php
Request example https://www.buytaobao1688.com/api/insertproducts.php?key=*&orderid=*& price[0]=*&qty[0]=*&shipfee[0]=*&store[0]=*¬e[0]=*&title[0]=*&link[0]=*&imglink[0]=*& price[1]=*&qty[1]=*&shipfee[1]=*&store[1]=*¬e[1]=*&title[1]=*&link[1]=*&imglink[1]=*
Request parameter
key (Required. The API key you can get in user center)
orderid (Required. The exist order ID you want to insert products to. Only can insert to those order that are not ship out from our warehouse)
price[] (Required. The unit price of this product, During our buying , if the price is lower than real price, we will charge more from your balance, if your price is higher, we will refund the difference to your balance)
qty[] (Required. The quantity you'd like to buy this product)
shipfee[] (Required. Local shipping fee from seller to our warehouse, if the fee is lower than real cost, we will charge more from your balance, if your fee is higher, we will refund the difference to your balance)
store[] (Optional. The store name where this product from)
note[] (Optional. Note for product, usually fill color, size...)
title[] (Optional. title of the product)
link[] (Required. The product URL you want to buy. Make sure use url encode it before putting it here)
imglink[] (Optional. The cover image in each product row. Make sure use url encode it before putting it here)
Success return example
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter
{"status":510} -- Balance is not enough
7. Ship an order
URL https://www.buytaobao1688.com/api/shiporder.php
Request example https://www.buytaobao1688.com/api/shiporder.php?key=*orderid=*&recipient=*&company=*&street=*&city=*&state=*&countrycode=*&zipcode=*&phone=*&shipid=*
Request parameter
key            (Required. The API key you can get in user center)
orderid (Required. The exist order ID you want to ship)
recipient   (Required)
company   (Optional)
street        (Required)
city            (Required)
state          (Required)
countrycode (Required, Such as "United state"-> "US" The country ISO code list is shown at the bottom)
zipcode     (Required)
phone       (Required)
shipid        (Required, The ID of shipping way. The shipping way list is shown below)
Success return example
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter
{"status":510} -- Balance is not enough
{"status":522} -- Cannot find this order
{"status":530} -- The shipping method you request do not support the country or the weight range
{"status":533} -- Can not find the country code
Shipping way list array= ["","DHL","UPS","TNT","FEDEX","ARAMEX","EMS","China Post Air Mail","HongKong Post Air Mail","ePacket","Road Freight To Door","Road Freight","Air Freight To Door","Air Freight","Ocean Freight To Door","Ocean Freight","Normal Express","SF-express","dhl global mail","Fedex packet","UK packet","Normal packet","PostNL","Epacket-fast","Malaysia post","Singapore Post","Sweden Post","USPS","DPEX","Road Freight To Door(tax free)","Air Freight To Door(tax free)","Ocean Freight To Door(tax free)","Pick up","Air Freight(tax free)","Ocean Freight(tax free)","STO(申通)", "YT(圆通)","ZTO(中通)", "BEST(百世)","YUNDA(韵达)", "TK(天天)", "DEPPON(德邦)","ANE(安能)" , "SF-packet" , "SF-E-commerce" ];
Country ID list countryarray= array("","Afghanistan", "Albania", "Algeria", "American Samoa", "Angola", "Anguilla", "Antartica", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Ashmore and Cartier Island", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia and Herzegovina", "Botswana", "Brazil", "British Virgin Islands", "Brunei", "Bulgaria", "Burkina Faso", "Burma", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China Guangdong(广东省)", "Christmas Island", "Clipperton Island", "Cocos (Keeling) Islands", "Colombia", "Comoros", "Congo, Democratic Republic of the", "Congo, Republic of the", "Cook Islands", "Costa Rica", "Cote d'Ivoire", "Croatia", "Cuba", "Cyprus", "Czeck Republic", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Ethiopia", "Europa Island", "Falkland Islands (Islas Malvinas)", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "French Southern and Antarctic Lands", "Gabon", "Gambia, The", "Gaza Strip", "Georgia", "Germany", "Ghana", "Gibraltar", "Glorioso Islands", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Heard Island and McDonald Islands", "Holy See (Vatican City)", "Honduras", "Hong Kong", "Howland Island", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Ireland, Northern", "Israel", "Italy", "Jamaica", "Jan Mayen", "Japan", "Jarvis Island", "Jersey", "Johnston Atoll", "Jordan", "Juan de Nova Island", "Kazakhstan", "Kenya", "Kiribati", "Korea, North", "Korea, South", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macau", "Macedonia, Former Yugoslav Republic of", "Madagascar", "Malawi", "West Malaysia", "Maldives", "Mali", "Malta", "Man, Isle of", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia, Federated States of", "Midway Islands", "Moldova", "Monaco", "Mongolia", "Montserrat", "Morocco", "Mozambique", "Namibia", "Nauru", "Nepal", "Netherlands", "Netherlands Antilles", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palau", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Pitcaim Islands", "Poland", "Portugal", "Puerto Rico", "Qatar", "Reunion", "Romainia", "Russia", "Rwanda", "Saint Helena", "Saint Kitts and Nevis", "Saint Lucia", "Saint Pierre and Miquelon", "Saint Vincent and the Grenadines", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Scotland", "Senegal", "Seychelles", "Sierra Leone", "Singapore", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Georgia and South Sandwich Islands", "Spain", "Spratly Islands", "Sri Lanka", "Sudan", "Suriname", "Svalbard", "Swaziland", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Tobago", "Toga", "Tokelau", "Tonga", "Trinidad", "Tunisia", "Turkey", "Turkmenistan", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "Uruguay", "USA", "Uzbekistan", "Vanuatu", "Venezuela", "Vietnam", "Virgin Islands", "Wales", "Wallis and Futuna", "West Bank", "Western Sahara", "Yemen", "Serbia", "Zambia", "Zimbabwe", "China Anhui(安徽省)","China Beijing(北京市)","China Chongqing(重庆省)","China Fujian(福建省)","China Gansu(甘肃省)","China Guangxi(广西省)","China Guizhou(贵州省)","China Hainan(海南省)","China Hebei(河北省)","China Heilongjiang(黑龙江省)","China Henan(河南省)","China Hubei(湖北省)","China Hunan(湖南省)","China Jiangsu(江苏省)","China Jiangxi(江西省)","China Jilin(吉林省)","China Liaoning(辽宁省)","China Inner Mongol(内蒙古)","China Ningxia(宁夏省)","China Qinghai(青海省)","China Shandong(山东省)","China Shanxi(山西省)","China Shangxi(陕西省)","China Shanghai(上海市)","China Sichuan(四川省)","China Tianjin(天津市)","China Tibet(西藏)","China Sinkiang(新疆)","China Yunnan(云南省)","China Zhejiang(浙江省),"East Malaysia");

countrycodearray=array("","AF","AL","DZ","AS","AO","AI","AQ","AG","AR","AM","AW","AUS","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BA","BW","BR","VG","BN","BG","BF","MM","BI","KH","CM","CA","CV","KY","CF","TD","CL","CN","CX","IP","CC","CO","KM","CD","CG","CK","CR","CI","HR","CU","CY","CZ","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","ET","EU","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GZ","GE","DE","GH","GI","GO","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HQ","HU","IS","IN","ID","IR","IQ","IE","GB2","IL","IT","JM","JN","JP","DQ","JE","JQ","JO","JU","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MK","MG","MW","MY","MV","ML","MT","IM","MH","MQ","MR","MU","YT","MX","FM","UM","MD","MC","MN","MS","MA","MZ","NA","NR","NP","NL","AN","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","RE","RO","RU","RW","SH","KN","LC","PM","VC","WS","SM","ST","SA","GB","SN","SC","SL","SG","SK","SI","SB","SO","ZA","GS","ES","XP","LK","SD","SR","SJ","SZ","SE","CH","SY","TW","TJ","TZ","TH","TT2","TG","TK","TO","TT","TN","TR","TM","TV","UG","UA","AE","GB","UY","US","UZ","VU","VE","VN","VI","WLK","WF","WE","EH","YE","YU","ZM","ZW","CN1","CN2","CN3","CN4","CN5","CN6","CN7","CN8","CN9","CN10","CN11","CN12","CN13","CN14","CN15","CN16","CN17","CN18","CN19","CN20","CN21","CN22","CN23","CN24","CN25","CN26","CN27","CN28","CN29","CN30","MY2");
Note Only when the order st=40 and wei>0 can be shipped (mean all products in this order have arrive at our warehouse and we've packaged it well and take the weight)
The address and shipping method ID in this request will cover and replace the exist address and shipping method ID in this order
8. Get the info of an order
URL https://www.buytaobao1688.com/api/getorder.php
Request example https://www.buytaobao1688.com/api/getorder.php?key=*&orderid=*
Request parameter
key  (Required. The API key you can get in user center)
orderid  (Required.)
Success return example
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter {"status":508} -- Cannot find order
9. Get orders info for certain status
URL https://www.buytaobao1688.com/api/getorders.php
Request example https://www.buytaobao1688.com/api/getorders.php?key=*&st=*
Request parameter
key  (Required. The API key you can get in user center)
st  (Required. status of the order,20-buying, 40-All products arrive and Ready to ship, 50-You have paid internationals shipping cost and submitted to ship, 60- Shipped, 70- received)
Success return example
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter {"status":508} -- Cannot find order
10. Get all the available shipping method of an order
URL https://www.buytaobao1688.com/api/getordership.php
Request example https://www.buytaobao1688.com/api/getordership.php?key=*&orderid=*&countrycode=*
Request parameter
key  (Required. The API key you can get in user center)
orderid  (Required. The ID of order you want to check)
countrycode  (Required. The country that this order is shipping to)
Success return example
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter
{"status":522} -- Cannot find this order
{"status":530} -- The shipping method you request do not support the country or the weight range
{"status":533} -- Can not find the country code
Note Need the order status st=40 and wei> 0 to get the shipping method of this order, or it will return fail
11. Get shipping fee normally by weight and size
URL https://www.buytaobao1688.com/api/getship.php
Request example https://www.buytaobao1688.com/api/getship.php?key=*&countrycode=*&wei=*&len=*&wid=*&hei=*sen=*
Request parameter
key  (Required. The API key you can get in user center)
countrycode  (Required. Such as "United state"-> "US")
wei  (Required. Weight /g )
len  (Optional. Lenth cm )
wid  (Optional. Width cm )
hei  (Optional. Height cm )
sen  (Optional. Default is 1; 1-normal product, 2-brand product, 3-famous brand product, 4-with battery, 5-pure battery, 6-liquid or powder)
Success return example
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter
{"status":530} -- The shipping method you request do not support the country or the weight range
{"status":533} -- Can not find the country code
12. Send an order message to our worker
URL https://www.buytaobao1688.com/api/sendormessage.php
Request example https://www.buytaobao1688.com/api/sendormessage.php?key=*&orderid=*&message=*
Request parameter
key  (Required. The API key you can get in user center)
orderid  (Required. The order ID which this message belong to)
message  (Required. Content of the message to remind something of this order to our worker )
Success return example {"status":200}
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter
13. Send a product message to our worker
URL https://www.buytaobao1688.com/api/sendprmessage.php
Request example https://www.buytaobao1688.com/api/sendprmessage.php?key=*&productid=*&message=*
Request parameter
key  (Required. The API key you can get in user center)
productid  (Required. The product ID which this message belong to)
message  (Required. Content of the message to remind something of this product to our worker )
Success return example {"status":200}
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter
14. Read order message of an order
URL https://www.buytaobao1688.com/api/readormessage.php
Request example https://www.buytaobao1688.com/api/readormessage.php?key=*&orderid=*
Request parameter
key  (Required. The API key you can get in user center)
orderid  (Required. The order ID you want to read the messages)
Success return example
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter
15. Read product message of a product
URL https://www.buytaobao1688.com/api/readprmessage.php
Request example https://www.buytaobao1688.com/api/readprmessage.php?key=*&productid=*
Request parameter
key  (Required. The API key you can get in user center)
productid  (Required. The product ID you want to read the messages)
Success return example
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter
16. Mark order as received
URL https://www.buytaobao1688.com/api/markreceived.php
Request example https://www.buytaobao1688.com/api/markreceived.php?key=*&orderid=*
Request parameter
key (Required. The API key you can get in user center)
orderid (Required. )
Success return example { "status": 200, "orderid": 1435, "st": 70 }
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter
Note The order you marked as received must be in "shipped" status which mean "st" is "60"
17. request return for product that arrived at our warehouse
URL https://www.buytaobao1688.com/api/requestreturn.php
Request example https://www.buytaobao1688.com/api/requestreturn.php?key=*&productid=*
Request parameter
key (Required. The API key you can get in user center)
productid (Required. )
Success return example { "status": 200, "productid": 12323, "st": 27 }
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter
Note The product you request return must be already arrived at our warehouse. which mean "st" should be 22 or 26
If the return request is rejected, the product "st" will be setted back to "22"
18. request exchange for product that arrived at our warehouse
URL https://www.buytaobao1688.com/api/requestexchange.php
Request example https://www.buytaobao1688.com/api/requestexchange.php?key=*&productid=*
Request parameter
key (Required. The API key you can get in user center)
productid (Required. )
Success return example { "status": 200, "productid": 12323, "st": 23 }
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter
Note The product you request return must be already arrived at our warehouse. which mean "st" should be 22 or 26
If the exchange request is rejected, the product "st" will be setted back to "22"