Get your 1688 orders and shipments through an API

What you can build on 1688

• Get purchased orders

  Build this

  Reads your orders as a buyer in 已买到货品 (purchased goods): each order with its seller, status, items and amounts.

  Takes

  Status (optional), ordered from and to (optional)

  Returns

  Order number, seller company, order date, status, items, quantity, total, shipping fee, refund status

• Get the shipping of an order

  Build this

  Opens one purchased order and reads its logistics: carrier, tracking number, shipping status and the time it was sent.

  Takes

  Order number

  Returns

  Order number, carrier, tracking number, shipping status, sent at

• Get sold orders

  Build this

  Reads your orders as a seller in 已卖出货品 (sold goods): each order with its buyer, status, items and amounts.

  Takes

  Status (optional), ordered from and to (optional)

  Returns

  Order number, buyer company, order date, status, items, quantity, total, refund status

• Ship an order with your own carrier

  Build this

  Opens one order in 已卖出货品 that is 等待卖家发货, ships it with your own carrier and enters the carrier and tracking number.

  Takes

  Order number, carrier, tracking number

  Returns

  Order number, status, carrier, tracking number

Automate 1688 with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

• Sold orders still 等待卖家发货, every morning

  Build this

  Starts

  Every weekday at 8:30, Asia/Shanghai

  Step 1

  Get the sold orders in status 等待卖家发货.

  Step 2

  Stop when there are none.

  Step 3

  Email you the list with order number, buyer company, order date, items and total.

• Shipped purchase orders, posted to your ERP

  Build this

  Starts

  Every day at 18:00, Asia/Shanghai

  Step 1

  Get the purchased orders in status 等待买家收货.

  Step 2

  Keep the orders that were not there on the last run.

  Step 3

  For each one, get its shipping: carrier and tracking number.

  Step 4

  Post order number, seller, items, carrier and tracking number to your ERP or warehouse webhook.

• Refund changes on purchased orders, weekly

  Build this

  Starts

  Every Monday at 9:00, Asia/Shanghai

  Step 1

  Get the purchased orders of the last 60 days with their refund status.

  Step 2

  Keep the orders whose refund status changed since the last run.

  Step 3

  Email you each one with order number, seller, total and refund status.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get purchased orders” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "login.1688.com/get_purchased_orders",
    "input": {
      "status": "等待买家收货",
      "ordered_from": "2026-11-01"
    }
  }'

{
  "status": "completed",
  "data": {
    "orders": [
      {
        "order_number": "3104827715560938471",
        "seller_company": "Northwind Packaging Co., Ltd.",
        "order_date": "2026-11-06T10:42:00+08:00",
        "status": "等待买家收货",
        "items": "Kraft mailer box, 30 x 20 x 10 cm",
        "quantity": 2000,
        "total": 1780,
        "shipping_fee": 60,
        "currency": "CNY",
        "refund_status": null
      }
    ],
    "count": 1
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

1688’s own options

Alibaba runs the 1688 Open Platform (阿里巴巴开放平台), with APIs for orders from the buyer's and the seller's side, logistics and shipping, products and members. To use it you register as a developer with a 1688 account bound to an enterprise-verified Alipay account, register an app and submit it for review. Some APIs, such as order detail, need a separate permission application.

Read on November 12, 2026: 1688 Open Platform: app onboarding (APP接入说明), 1688 Open Platform: authorization (API授权说明), 1688 Open Platform: order APIs.

Signing in to 1688

1688 signs you in on Taobao's sign-in page, with 密码登录 (password), 短信登录 (a text-message code) or by scanning a QR code with the 1688 or Taobao app. 1688 and Taobao share one account system. With Fous you sign in once through 1688's own sign-in with your own account, and the login is sealed with AES-256, never returned by the API or written to logs.

Worth knowing

Buyer and seller orders are separate lists

Purchased orders are in 已买到货品 and sold orders in 已卖出货品. A method reads one list or the other, so describe which side you need.

The API's order list has no tracking numbers

On the Open Platform, the buyer's order list returns basic order information only. Logistics and invoice details come from the order detail, so tracking needs one more call per order.

Many kinds of order

Orders carry a business type: ordinary orders, large wholesale orders, sample orders, custom processing orders, agreement purchasing and more. Name the kinds you want when you describe a method.

Open Platform tokens and limits

An access token lasts 10 hours and a refresh token as long as the app subscription. A new app starts with a call limit of 5,000; after review it rises to 100,000, and more can be requested.

More in Distribution: specialty wholesale and B2B marketplaces

• Tradeplace
• Alibaba.com supplier back end
• IndiaMART Seller Panel
• JOOR
• NuORDER
• Trek B2B
• Ingram iPage
• FTD Mercury
• Covetrus
• MWI Animal Health
• Patterson Veterinary
• SanMar
• Faire

Other industries: TikTok Shop Seller Center, Submit learner data, PG&E online account, DoorDash Merchant Portal, BB Digital PJ, Elavon Payments Insider.