Buytaobao1688 API version 2.1

Check previous version here

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

Buytaobao1688 system API / Get a product info

URL https://www.buytaobao1688.com/systemapi/getproduct.php
Request example https://www.buytaobao1688.com/systemapi/getproduct.php?key=*&product_id=*
Request parameter
key (Required. The API key you can get in user center)
product_id (Required. The product ID in buytaobao1688.com system, not taobao.com or 1688.com 's product ID)
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 this product

Buytaobao1688 system API / Get order products

URL https://www.buytaobao1688.com/systemapi/getorderproducts.php
Request example https://www.buytaobao1688.com/systemapi/getorderproducts.php?key=*&order_id=*
Request parameter
key (Required. The API key you can get in user center)
order_id (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 this product

Buytaobao1688 system API / Get products by status

URL https://www.buytaobao1688.com/systemapi/getproducts.php
Request example https://www.buytaobao1688.com/systemapi/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 this product

Buytaobao1688 system API / Create order

URL https://www.buytaobao1688.com/systemapi/createorder.php
Request example https://www.buytaobao1688.com/systemapi/createorder.php?key=*&order_note=*order_id=*&is_ship=*&ship_id=*&recipient=*&company=*&street=*&city=*&state=*&country_code=*&zipcode=*&phone=*& price[0]=*&qty[0]=*&local_ship_fee[0]=*&store[0]=*&product_note[0]=*&title[0]=*&link[0]=*&imglink[0]=*& price[1]=*&qty[1]=*&local_ship_fee[1]=*&store[1]=*&product_note[1]=*&title[1]=*&link[1]=*&imglink[1]=*...
Request parameter
key (Required. The API key you can get in user center)
order_note (Optional. make some special instruction for this order)
order_id (Optional. Order ID of your own website)
is_ship (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)
country_code (Required, Such as "United state"-> "US" The country ISO code list is shown at the bottom)
zipcode (Required)
phone (Required)
ship_id (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)
local_ship_fee[] (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

Buytaobao1688 system API / Insert products to order

URL https://www.buytaobao1688.com/systemapi/insertproducts.php
Request example https://www.buytaobao1688.com/systemapi/insertproducts.php?key=*&order_id=*& price[0]=*&qty[0]=*&local_ship_fee[0]=*&store[0]=*&product_note[0]=*&title[0]=*&link[0]=*&imglink[0]=*& price[1]=*&qty[1]=*&local_ship_fee[1]=*&store[1]=*&product_note[1]=*&title[1]=*&link[1]=*&imglink[1]=*...
Request parameter
key (Required. The API key you can get in user center)
order_id (Required. )
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)
local_ship_fee[] (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)
product_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

Buytaobao1688 system API / Set custom declaration

URL https://www.buytaobao1688.com/systemapi/setcustom.php
Request example https://www.buytaobao1688.com/systemapi/setcustom.php?key=*&order_id=*&name_en[0]=*&name_cn[0]=*&qty[0]=*&value[0]=*&name_en[1]=*&name_cn[1]=*&qty[1]=*&value[1]=*...
Request parameter
key (Required. The API key you can get in user center)
order_id (Required. )
name_en[] (Required. Declared name for custom in English)
name_cn[] (Optional. Declared name for custom in Chinese)
qty[] (Required. Declare quantity for custom)
value[] (Required. Declared Value for one unit/pcs )
Success return example
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter
{"status":515} -- Cannot find suitable order

Buytaobao1688 system API / Ship an order

URL https://www.buytaobao1688.com/systemapi/shiporder.php
Request example https://www.buytaobao1688.com/systemapi/shiporder.php?key=*order_id=*&recipient=*&company=*&street=*&city=*&state=*&country_code=*&zipcode=*&phone=*&ship_id=*
Request parameter
key (Required. The API key you can get in user center)
order_id (Required.)
recipient (Required)
company (Optional)
street (Required)
city (Required)
state (Required)
country_code (Required, Such as "United state"-> "US" The country ISO code list is shown at System API appendices->country)
zipcode (Required)
phone (Required)
ship_id (Required, The ID of shipping way. The shipping way list is shown below . System API appendices->shipping method)
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

Buytaobao1688 system API / Mark order as received

URL https://www.buytaobao1688.com/systemapi/markreceived.php
Request example https://www.buytaobao1688.com/systemapi/markreceived.php?key=*&order_id=*
Request parameter
key (Required. The API key you can get in user center)
order_id (Required.)
Success return example { "status": 200, "order_id": 1435, "st": 70 }
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter

Buytaobao1688 system API / Request product return

URL https://www.buytaobao1688.com/systemapi/requestreturn.php
Request example https://www.buytaobao1688.com/systemapi/requestreturn.php?key=*&product_id=*
Request parameter
key (Required. The API key you can get in user center)
product_id (Required.)
Success return example { "status": 200, "product_id": 12323, "st": 27 }
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter

Buytaobao1688 system API / Request product exchange

URL https://www.buytaobao1688.com/systemapi/requestexchange.php
Request example https://www.buytaobao1688.com/systemapi/requestexchange.php?key=*&product_id=*
Request parameter
key (Required. The API key you can get in user center)
product_id (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

Buytaobao1688 system API / Get the info of an order

URL https://www.buytaobao1688.com/systemapi/getorder.php
Request example https://www.buytaobao1688.com/systemapi/getorder.php?key=*&order_id=*
Request parameter
key (Required. The API key you can get in user center)
order_id (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

Buytaobao1688 system API / Get orders by status

URL https://www.buytaobao1688.com/systemapi/getorders.php
Request example https://www.buytaobao1688.com/systemapi/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

Buytaobao1688 system API / Get shipping quote 1

URL https://www.buytaobao1688.com/systemapi/getordership.php
Request example https://www.buytaobao1688.com/systemapi/getordership.php?key=*&order_id=*&country_code=*
Request parameter
key (Required. The API key you can get in user center)
order_id (Required. The ID of order you want to check)
country_code (Required. The country that this order is shipping to)
Note Get all the available shipping method of an order
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

Buytaobao1688 system API / Get shipping quote 2

URL https://www.buytaobao1688.com/systemapi/getship.php
Request example https://www.buytaobao1688.com/systemapi/getship.php?key=*&country_code=*&weight=*&lenght=*&width=*&height=*product_type=*
Request parameter
key (Required. The API key you can get in user center)
country_code (Required. The country that this order is shipping to)
weight (Required. Weight /g )
lenght (Optional. Lenth cm )
width (Optional. Width cm )
height (Optional. Height cm )
product_type (Optional. Default is 1; 1-normal product, 2-brand product, 3-famous brand product, 4-with battery/magnetic, 5-pure battery, 6-liquid or powder)
Note Get shipping fee normally by weight and size
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
{"status":530} -- The shipping method you request do not support the country or the weight range

{"status":533} -- Can not find the country code

Buytaobao1688 system API / Get shipping rate

URL https://www.buytaobao1688.com/systemapi/getshiprate.php
Request example https://www.buytaobao1688.com/systemapi/getshiprate.php?key=*
Request parameter
key (Required. The API key you can get in user center)
Note
This is all the orginal shipping rate data from our SQL database
You can save in your own database, and get any shipping cost from your own server.
We don't usually change the data, so you update it over 30 days a time should be OK.
But it's not easy to understand how to calculate
Reference
PHP Example code to
calculate a shipping cost
PHP Example code to calculate
a list shipping quote for all
available shipping method

Buytaobao1688 system API / Send order message

URL https://www.buytaobao1688.com/systemapi/sendormessage.php
Request example https://www.buytaobao1688.com/systemapi/sendormessage.php?key=*&order_id=*&message=*
Request parameter
key (Required. The API key you can get in user center)
order_id (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

Buytaobao1688 system API / Send product message

URL https://www.buytaobao1688.com/systemapi/sendprmessage.php
Request example https://www.buytaobao1688.com/systemapi/sendprmessage.php?key=*&product_id=*&message=*
Request parameter
key (Required. The API key you can get in user center)
product_id (Required. The product 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

Buytaobao1688 system API / Read order message

URL https://www.buytaobao1688.com/systemapi/readormessage.php
Request example https://www.buytaobao1688.com/systemapi/readormessage.php?key=*&order_id=*
Request parameter
key (Required. The API key you can get in user center)
order_id (Required. The product ID which this message belong to)
message (Required. Content of the message to remind something of this order to our worker )
Success return example
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter

Buytaobao1688 system API / Read product message

URL https://www.buytaobao1688.com/systemapi/readprmessage.php
Request example https://www.buytaobao1688.com/systemapi/readprmessage.php?key=*&product_id=*
Request parameter
key (Required. The API key you can get in user center)
product_id (Required. The product ID which this message belong to)
message (Required. Content of the message to remind something of this order to our worker )
Success return example
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter

Buytaobao1688 system API / Get finance bill record

URL https://www.buytaobao1688.com/systemapi/getbillrecord.php
Request example https://www.buytaobao1688.com/systemapi/getbillrecord.php?key=*&time1=*&time2=*
Request parameter
key (Required. The API key you can get in user center)
time1 (Required, Unix timestamp, from time range time1-time2)
time2 (Required, Unix timestamp, from time range time1-time2)
Success return example
Fail return example {"status":500} -- Other error
{"status":501} -- API key is not correct
{"status":505} -- Miss required parameter
bill_type 2- paypal, 14 credit card, 19-Manual Recharge, 20-Shipping fee adjust, 21- Shipping fee payment...
Here is the array for all type in javascript:

Appendices / Product datasheet

product_id ID of product in our system
order_id An order may inlcude many products. This is the order ID that this product belong to
st Status of this product.
0-pending, 20-Buying, 21-On the way, 22-Arrive at our warehouse,23-Request exchange,24-We confirm exchange ,25-exchanging 26-exchanged.,27-request return,28-We confirm return,29-Returned, 30-No stock/not available, 50-Submit to ship out from our warehouse, 60-Shipped out from our warehouse, 70-Customer received
time1 The time that this product created in our system
time2 Time that the product arrive at our warehouse
time3 The time that we buy this product
time4 The time that customer submit to ship out from our warehouse
title Title of the product
price Price of the product for one unit
qty Quantity of the product
local_ship_fee Local shipping cost of the product / shipping cost from seller to our warehouse
link The URL link of the orginal product
imglink The URL link of the picture of the orginal product
store The store name that this product belong to
product_note Note, requirements for the product

Appendices / Order datasheet

order_id ID of the order(waybill/shipment) in our system
time1 Time that when this order is created in our system
time3 Time that order finish collecting and we finish packing and entering the weight,size data to system
time4 Time that this order finish collecting/all products of this order arrive at our warehouse
time5 Time that customer submit to ship this order
time6 Time that we shipped this order
st 20-Buying, 40-order finish collecting, 50-Customer submit to ship, 60-We shipped, 70-Customer received
weight Final weight of this order after packaging
Length Final size of this order after packaging
width Final size of this order after packaging
height Final size of this order after packaging
products_amount Total product cost + local shipping fee in this order
commission our service fee for buying
ship_fee Shipping cost that ship out from our warehouse, Usually is international shipping
zipcode part of the shipping address
ship_id Shipping method ID
product_type 1-normal product, 2-brand product, 3-famous brand product, 4-with battery/magnetic, 5-pure battery, 6-liquid or powder
track_number Tracking number of this order when we ship out from our warehouse
recipient part of the shipping address
company part of the shipping address
street part of the shipping address
city part of the shipping address
state part of the shipping address
zipcode part of the shipping address
phone part of the shipping address
order_note Note for the order
is_ship 1-Auto submit to ship when this order finish collecting. 0- Not auto submit to ship

Appendices / Finance bill datasheet

bill_id ID of this row
bill_type 2- paypal, 14 credit card, 19-Manual Recharge, 20-Waybill Fee Adjust, 21- Pay fulfillment shipping cost...
Here is the array for all type in javascript:
note Note for this record
amount The amount that changed in this row
balance The remain balance after this change
time Time when this operation happen

Appendices / Shipping methods

In API, you must fill the shipping method ID instead of name
1."DHL", 2."UPS", 3."TNT", 4."FEDEX", 5."ARAMEX",6."EMS",7."China Post Air Mail", 8."HongKong Post Air Mail", 9."ePacket", 10."Road Freight To Door", 11."Road Freight", 12."Air Freight To Door", 13."Air Freight", 14."Ocean Freight To Door",15."Ocean Freight", 16."Normal Express",17."SF-express", 18."dhl global mail",19."Fedex packet", 20."UK packet",21."Normal packet",22."PostNL", 23."Epacket-fast",24."Malaysia post", 25."Singapore Post",26."Sweden Post", 27."USPS packet",28."DPEX", 29."Road Freight To Door(tax free)", 30."Air Freight To Door(tax free)", 31."Ocean Freight To Door(tax free)", 32."Pick up",33."Air Freight(tax free)", 34."Ocean Freight(tax free)", 35."STO(申通)", 36."YT(圆通)",37."ZTO(中通)", 38."BEST(百世)", 39."YUNDA(韵达)", 40."TK(天天)",41."DEPPON(德邦)", 42."ANE(安能)" 43. "SF-packet ,44. “SF-E-commerce” 45. "China post by sea" 46. "LWE express"

Here is the array for all in javascript :

Appendices /Country


Country ID list in javascript:


Country code -> Country ID in PHP:


Country ID -> Country code in PHP:

Taobao/Tmall API /Get a product info

URL https://www.buytaobao1688.com/taobaoapi/getproductinfo.php
Request example https://www.buytaobao1688.com/taobaoapi/getproductinfo.php?key=*&item_id=*&lang=*
Request parameter
key (Required. The API key you can get in user center)
item_id (Required. The product ID of taobao product, for example:item_id is 567101167363 in this taobao product URL --https://item.taobao.com/item.htm?spm=a230r.1.999.16.5bb9523cKFfufi&id=567101167363&ns=1#detail)
lang (Optional. Default is "en", "cn"--Chinese, "ru"--Russian... )
Note This API is not free. We will charge 5CNY for 100 times request. Require your account balance >=5 CNY to use this API.
This API is not very stable. There is a small chance that will fail to get the info. It's important to check the result success or not in programming
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. Make sure your account balance >=5 CNY
{"status":544} -- Fail to get

Taobao/Tmall API /Get products from store

URL https://www.buytaobao1688.com/taobaoapi/getstoreproduct.php
Request example https://www.buytaobao1688.com/taobaoapi/getstoreproduct.php?key=*&lang=*&seller_name=*&page=*&start_price=*&end_price=*&key_word=*&catalog_id=*
Request parameter
key (Required. The API key you can get in user center)
seller_name (Required. Seller nick name, not store name)
page (Required. 0,1,2,3... Result usually have more than 1 page. So this reference tell us which page result you need to feedback )
lang (Optional. Default is "en", "cn"--Chinese, "ru"--Russian... )
start_price (Optional. The price range which can fiter the products)
end_price (Optional. The price range which can fiter the products)
key_word (Optional. Search by this key word which can fiter the products)
catalog_id (Optional. Catalog id which can fiter the products)
Note This API is not free. We will charge 5CNY for 100 times request. Require your account balance >=5 CNY to use this API.
This API is not very stable. There is a small chance that will fail to get the info. It's important to check the result success or not in programming
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. Make sure your account balance >=5 CNY
{"status":544} -- Fail to get

Taobao/Tmall API /Search products by keyword

URL https://www.buytaobao1688.com/taobaoapi/searchproduct.php
Request example https://www.buytaobao1688.com/taobaoapi/searchproduct.php?key=*&lang=*&page=*&start_price=*&end_price=*&key_word=*&catalog_id=*
Request parameter
key (Required. The API key you can get in user center)
page (Required. 0,1,2,3... Result usually have more than 1 page. So this reference tell us which page result you need to feedback )
key_word (Required. )
lang (Optional. Default is "en", "cn"--Chinese, "ru"--Russian... )
start_price (Optional. The price range which can fiter the products)
end_price (Optional. The price range which can fiter the products)
key_word (Optional. Search by this key word which can fiter the products)
catalog_id (Optional. Catalog id which can fiter the products)
Note This API is not free. We will charge 5CNY for 100 times request. Require your account balance >=5 CNY to use this API.
This API is not very stable. There is a small chance that will fail to get the info. It's important to check the result success or not in programming
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. Make sure your account balance >=5 CNY
{"status":544} -- Fail to get

Taobao/Tmall API /Search keyword suggestion

URL https://www.buytaobao1688.com/taobaoapi/keywordsuggest.php
Request example https://www.buytaobao1688.com/taobaoapi/keywordsuggest.php?key=*&key_word=*
Request parameter
key (Required. The API key you can get in user center)
key_word (Required)
Note This API is not free. We will charge 5CNY for 100 times request. Require your account balance >=5 CNY to use this API.
This API is not very stable. There is a small chance that will fail to get the info. It's important to check the result success or not in programming
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. Make sure your account balance >=5 CNY
{"status":544} -- Fail to get

1688 API /Get a product info

URL https://www.buytaobao1688.com/1688api/getproductinfo.php
Request example https://www.buytaobao1688.com/1688api/getproductinfo.php?key=*&item_id=*&lang=*
Request parameter
key (Required. The API key you can get in user center)
item_id (Required. The product ID of taobao product, for example:item_id is 553645344170 in this taobao product URL --https://detail.1688.com/offer/553645344170.html?spm=b26110380.sw1688.mof001.22.102a12abrwE91b)
lang (Optional. Default is "en", "cn"--Chinese, "ru"--Russian... )
Note This API is not free. We will charge 5CNY for 100 times request. Require your account balance >=5 CNY to use this API.
This API is not very stable. There is a small chance that will fail to get the info. It's important to check the result success or not in programming
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. Make sure your account balance >=5 CNY
{"status":544} -- Fail to get

1688 API /Get products from store

URL https://www.buytaobao1688.com/1688api/getstoreproduct.php
Request example https://www.buytaobao1688.com/1688api/getstoreproduct.php?key=*&lang=*&seller_name=*&page=*&start_price=*&end_price=*&key_word=*&catalog_id=*
Request parameter
key (Required. The API key you can get in user center)
seller_name (Required. Seller nick name, not store name)
page (Required. 0,1,2,3... Result usually have more than 1 page. So this reference tell us which page result you need to feedback )
lang (Optional. Default is "en", "cn"--Chinese, "ru"--Russian... )
start_price (Optional. The price range which can fiter the products)
end_price (Optional. The price range which can fiter the products)
key_word (Optional. Search by this key word which can fiter the products)
catalog_id (Optional. Catalog id which can fiter the products)
Note This API is not free. We will charge 5CNY for 100 times request. Require your account balance >=5 CNY to use this API.
This API is not very stable. There is a small chance that will fail to get the info. It's important to check the result success or not in programming
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. Make sure your account balance >=5 CNY
{"status":544} -- Fail to get

1688 API /Search products by keyword

URL https://www.buytaobao1688.com/1688api/searchproduct.php
Request example https://www.buytaobao1688.com/1688api/searchproduct.php?key=*&lang=*&page=*&start_price=*&end_price=*&key_word=*&catalog_id=*
Request parameter
key (Required. The API key you can get in user center)
page (Required. 0,1,2,3... Result usually have more than 1 page. So this reference tell us which page result you need to feedback )
key_word (Required. )
lang (Optional. Default is "en", "cn"--Chinese, "ru"--Russian... )
start_price (Optional. The price range which can fiter the products)
end_price (Optional. The price range which can fiter the products)
key_word (Optional. Search by this key word which can fiter the products)
catalog_id (Optional. Catalog id which can fiter the products)
Note This API is not free. We will charge 5CNY for 100 times request. Require your account balance >=5 CNY to use this API.
This API is not very stable. There is a small chance that will fail to get the info. It's important to check the result success or not in programming
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. Make sure your account balance >=5 CNY
{"status":544} -- Fail to get

1688 API /Search keyword suggestion

URL https://www.buytaobao1688.com/1688api/keywordsuggest.php
Request example https://www.buytaobao1688.com/1688api/keywordsuggest.php?key=*&key_word=*
Request parameter
key (Required. The API key you can get in user center)
key_word (Required)
Note This API is not free. We will charge 5CNY for 100 times request. Require your account balance >=5 CNY to use this API.
This API is not very stable. There is a small chance that will fail to get the info. It's important to check the result success or not in programming
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. Make sure your account balance >=5 CNY
{"status":544} -- Fail to get

Aliexpress API /Get a product info

URL https://www.buytaobao1688.com/aliexpressapi/getproductinfo.php
Request example https://www.buytaobao1688.com/aliexpressapi/getproductinfo.php?key=*&item_id=*
Request parameter
key (Required. The API key you can get in user center)
item_id (Required. The product ID of taobao product, for example:item_id is 32988018364 in this taobao product URL --https://www.aliexpress.com/item/Sandals-Women-Wedges-Shoes-Pumps-High-Heels-Sandals-Summer-2019-Flip-Flop-Chaussures-Femme-Platform-Sandals/32988018364.html)
Note This API is not free. We will charge 5CNY for 100 times request. Require your account balance >=5 CNY to use this API.
This API is not very stable. There is a small chance that will fail to get the info. It's important to check the result success or not in programming
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. Make sure your account balance >=5 CNY
{"status":544} -- Fail to get

aliexpress API /Search products by keyword

URL https://www.buytaobao1688.com/aliexpressapi/searchproduct.php
Request example https://www.buytaobao1688.com/aliexpressapi/searchproduct.php?key=*&page=*&start_price=*&end_price=*&key_word=*&catalog_id=*
Request parameter
key (Required. The API key you can get in user center)
page (Required. 0,1,2,3... Result usually have more than 1 page. So this reference tell us which page result you need to feedback )
key_word (Required. )
start_price (Optional. The price range which can fiter the products)
end_price (Optional. The price range which can fiter the products)
key_word (Optional. Search by this key word which can fiter the products)
catalog_id (Optional. Catalog id which can fiter the products)
Note This API is not free. We will charge 5CNY for 100 times request. Require your account balance >=5 CNY to use this API.
This API is not very stable. There is a small chance that will fail to get the info. It's important to check the result success or not in programming
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. Make sure your account balance >=5 CNY
{"status":544} -- Fail to get