1688 API: Search offers (v1)

Returns the unpaid offers 1688 lists for a keyword, usually 45 to 60, with price, supplier, repeat-buyer rate and sales or minimum order. There are no further pages. A keyword nothing matches returns empty results.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

query*string

A product keyword, up to 60 characters. Chinese matches best, as in 蓝牙耳机 or 手机壳; English such as yoga mat also works. A 1688 search link works too.

Length1 <= length <= 1000

curl -X GET "https://example.com/v1/1688/search?query=%E8%93%9D%E7%89%99%E8%80%B3%E6%9C%BA" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "query": "蓝牙耳机",    "url": "https://www.1688.com/chanpin/-C0B6D1C0B6FABBFA.html",    "count": 45,    "results": [      {        "offer_id": "738026063940",        "title": "华强北高品质pro4四代双耳入耳式超长续航真无线蓝牙耳机厂家批发",        "url": "https://detail.1688.com/offer/738026063940.html",        "image": "https://cbu01.alicdn.com/img/ibank/O1CN017pYgvk2484EoOWwtO_!!2215948597345-0-cib.jpg",        "price": 7.23,        "currency": "CNY",        "sold_label": "1k+件",        "min_order_quantity": 50,        "min_order_unit": "套",        "services": [          "48小时发货"        ],        "supplier_name": "东莞市捣鼓电子科技有限公司",        "repeat_buyer_percent": 10      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}