1688 Keyword Search

Keyword search across 1688.com wholesale listings with filters for price, MOQ and verified suppliers. Returns structured supplier and pricing data for sourcing workflows.

Endpoint

Parameters

Sample response

{
  "success": true,
  "data": {
    "page": 1,
    "page_size": 20,
    "total_count": 1000,
    "keyword": "士T恤",
    "sort": "default",
    "cat_id": "null",
    "filters": {},
    "items": [
      {
        "item_id": 973927556856,
        "product_url": "https://detail.1688.com/offer/973927556856.html",
        "title": "【高端系列】双面液氨丝光&80高支莱赛尔长袖T恤男士纯色高端上衣",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01BJ7AAS1YRF4K6UTS4_!!2209657723055-0-cib.jpg",
        "category_path": [
          "315",
          "10165"
        ],
        "price": "68",
        "price_info": {
          "sale_price": "68",
          "origin_price": null
        },
        "moq": 2,
        "quantity_prices": [
          {
            "begin_num": 2,
            "end_num": 199,
            "price": "68.00"
          },
          {
            "begin_num": 200,
            "end_num": 499,
            "price": "65.00"
          },
          {
            "begin_num": 500,
            "end_num": null,
            "price": "62.00"
          }
        ],
        "sale_info": {
          "sale_quantity": "已售500+件",
          "sale_quantity_int": 500,
          "orders_count": 412
        },
        "delivery_info": {
          "area_from": [
            "广东",
            "广州市"
          ]
        },
        "item_repurchase_rate": "15%",
        "rating_star": "4.5",
        "shop_info": {
          "login_id": "广州淘圣男装有限公司",
          "member_id": "b2b-2209657723055e41d3",
          "company_name": "广州淘圣制衣有限公司",
          "shop_url": "http://shop5o52040l89801.1688.com",
          "biz_type": "生产加工",
          "is_factory": true,
          "is_super_factory": false,
          "location": [
            "广东",
            "广州市"
          ],
          "service_tags": [
            "深度验厂"
          ],
          "shop_years": 6,
          "factory_inspection": true,
          "score_info": {
            "composite_score": "4.5",
            "consultation_score": "4.5",
            "dispute_score": "4.0",
            "logistics_score": "4.5",
            "return_score": "4.0"
          }
        },
        "is_ad": false
      },
      {
        "item_id": 915310259717,
        "product_url": "https://detail.1688.com/offer/915310259717.html",
        "title": "夏季短袖T恤男士新款纯色圆领半袖上衣青年休闲百搭打底潮牌体恤",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01BjeeDf1ulmL44FKMD_!!2219543586078-0-cib.jpg",
        "category_path": [
          "315",
          "10165"
        ],
        "price": "12.9",
        "price_info": {
          "sale_price": "12.9",
          "origin_price": null
        },
        "moq": 1,
        "quantity_prices": [
          {
            "begin_num": 1,
            "end_num": 999,
            "price": "12.90"
          },
          {
            "begin_num": 1000,
            "end_num": 9999,
            "price": "11.90"
          },
          {
            "begin_num": 10000,
            "end_num": null,
            "price": "10.90"
          }
        ],
        "sale_info": {
          "sale_quantity": "已售1000+件",
          "sale_quantity_int": 1000,
          "orders_count": 865
        },
        "delivery_info": {
          "area_from": [
            "广东",
            "揭阳市"
          ]
        },
        "item_repurchase_rate": "18%",
        "rating_star": "4.2",
        "shop_info": {
          "login_id": "悦装服装实业有限公司",
          "member_id": "b2b-221954358607802711",
          "company_name": "揭阳市悦装服装实业有限公司",
          "shop_url": "http://shop511x48z085525.1688.com",
          "biz_type": "生产加工",
          "is_factory": true,
          "is_super_factory": true,
          "location": [
            "广东",
            "揭阳市"
          ],
          "service_tags": [
            "深度验厂"
          ],
          "shop_years": 1,
          "factory_inspection": true,
          "score_info": {
            "composite_score": "4.3",
            "consultation_score": "4.0",
            "dispute_score": "4.5",
            "logistics_score": "4.1",
            "return_score": "4.5"
          }
        },
        "is_ad": false
      }
    ]
  },
  "error": null
}