OpenAny
Add OpenAny to Grok BotGet API key

1688 Product Search API (V2)

Search for 1688 products by keyword with pagination, sorting, price ranges and optional sourcing filters. Supply a keyword. Sample fields include prices and titles. Use it for catalog research or marketplace monitoring. The GET request schema also lists page, pageSize. Use the results to organize e-commerce research and compare the relevant product, shop, or category records.

Selected price
$0.015385 / callPublished pricing
Providers / implementations
1 / 1
Requests · 30d
—Loading...
Success rate · 30d
—Loading...

Run sends a real API request. Charges follow the published API contract.

Request parameters
Search keyword.
Optional parameters (10)
Page number, starting at 1.
Number of items requested per page. The returned count may differ.
Product sort order. Available Values: - `default`: Default order - `sales`: Sales order - `price_up`: Price ascending - `price_down`: Price descending
Minimum order quantity filter.
Minimum price filter in CNY.
Maximum price filter in CNY.
Filter for new products.
Filter for support for dropshipping.
Filter for free shipping.
Optional super-factory filter.

Sample response

{
  "code": 0,
  "data": {
    "cat_id": null,
    "filters": {},
    "has_next_page": true,
    "items": [
      {
        "category_path": [
          "1043769",
          "10287",
          "201547801"
        ],
        "delivery_info": {
          "area_from": [
            "山东",
            "临沂市"
          ]
        },
        "goods_score": "5.0",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01R7UKQO1pCRnNd1Lsr_!!2218509625324-0-cib.jpg",
        "is_ad": false,
        "item_id": 978957004936,
        "item_repurchase_rate": "7%",
        "moq": 1,
        "price": "4.95",
        "price_info": {
          "origin_price": null,
          "sale_price": "4.95"
        },
        "product_url": "https://detail.1688.com/offer/978957004936.html",
        "quantity_begin": 1,
        "quantity_prices": [
          {
            "begin_num": 1,
            "end_num": null,
            "price": "5.00"
          }
        ],
        "rating_star": "5.0",
        "sale_info": {
          "orders_count": 1541,
          "sale_quantity": "已售6400+件",
          "sale_quantity_int": 6400
        },
        "shop_info": {
          "biz_type": "生产加工",
          "company_name": "临沂瑞业家居用品有限公司",
          "factory_inspection": false,
          "is_factory": true,
          "is_super_factory": false,
          "location": [
            "山东",
            "临沂市"
          ],
          "login_id": "临沂瑞业家居",
          "member_id": "b2b-22185096253244079c",
          "score_info": {
            "composite_new_score": "4.5",
            "consultation_score": "4.0",
            "dispute_score": "5.0",
            "logistics_score": "3.43",
            "return_score": "3.67"
          },
          "service_tags": [],
          "shop_url": "http://lyruiye.1688.com",
          "shop_years": 3
        },
        "tags": [
          "退货包运费",
          "先采后付",
          "回头率62%"
        ],
        "title": "保鲜盒食物塑料盒子长方形冰箱密封收纳盒食品级商用带盖透明饭盒"
      },
      {
        "category_path": [
          "121490001",
          "1548",
          "201547901"
        ],
        "delivery_info": {
          "area_from": [
            "广东",
            "揭阳市"
          ]
        },
        "goods_score": "2.0",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01mHPWGf1CXj7bBdXIv_!!3028750091-0-cib.jpg",
        "is_ad": false,
        "item_id": 961109334208,
        "item_repurchase_rate": "25%",
        "moq": null,
        "price": "4.9",
        "price_info": {
          "origin_price": null,
          "sale_price": "4.9"
        },
        "product_url": "https://detail.1688.com/offer/961109334208.html",
        "quantity_begin": null,
        "quantity_prices": [],
        "rating_star": "2.0",
        "sale_info": {
          "orders_count": 52975,
          "sale_quantity": "已售10万+件",
          "sale_quantity_int": 100000
        },
        "shop_info": {
          "biz_type": "经销批发",
          "company_name": "揭阳市绿创家居用品有限公司",
          "factory_inspection": true,
          "is_factory": false,
          "is_super_factory": false,
          "location": [
            "广东",
            "揭阳市"
          ],
          "login_id": "绿创家居卫士",
          "member_id": "b2b-30287500918b183",
          "score_info": {
            "composite_new_score": "4.0",
            "consultation_score": "3.5",
            "dispute_score": "4.0",
            "logistics_score": "3.57",
            "return_score": "4.0"
          },
          "service_tags": [
            "深度验厂",
            "深度验商"
          ],
          "shop_url": "http://jylcjj.1688.com",
          "shop_years": 10
        },
        "tags": [
          "退货包运费",
          "先采后付",
          "回头率61%"
        ],
        "title": "塑料透明收纳箱带盖家用衣服衣物收纳箱子超大号储物整理箱收纳盒"
      },
      {
        "category_path": [
          "1043982",
          "1548",
          "201547901"
        ],
        "delivery_info": {
          "area_from": [
            "浙江",
            "义乌市"
          ]
        },
        "goods_score": "2.0",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01Qkmh7U26ph00rAiyU_!!2210440927711-0-cib.jpg",
        "is_ad": false,
        "item_id": 802431398791,
        "item_repurchase_rate": "21%",
        "moq": 2,
        "price": "2.07",
        "price_info": {
          "origin_price": null,
          "sale_price": "2.07"
        },
        "product_url": "https://detail.1688.com/offer/802431398791.html",
        "quantity_begin": 2,
        "quantity_prices": [
          {
            "begin_num": 2,
            "end_num": null,
            "price": "0.15"
          }
        ],
        "rating_star": "2.0",
        "sale_info": {
          "orders_count": 699,
          "sale_quantity": "全网10万+件",
          "sale_quantity_int": 100000
        },
        "shop_info": {
          "biz_type": "经销批发",
          "company_name": "义乌市悦动日用百货有限公司",
          "factory_inspection": false,
          "is_factory": false,
          "is_super_factory": false,
          "location": [
            "浙江",
            "义乌市"
          ],
          "login_id": "悦动日用百货",
          "member_id": "b2b-22154705262941f196",
          "score_info": {
            "composite_new_score": "3.5",
            "consultation_score": "1.0",
            "dispute_score": "4.0",
            "logistics_score": "3.71",
            "return_score": "3.33"
          },
          "service_tags": [
            "深度验商"
          ],
          "shop_url": "http://shop52908bfw19166.1688.com",
          "shop_years": 4
        },
        "tags": [
          "退货包运费",
          "先采后付",
          "回头率49%"
        ],
        "title": "桌面收纳箱化妆品家用透明亚克力面膜整理盒零食收纳筐杂物置物架"
      },
      {
        "category_path": [
          "1043982",
          "1548",
          "201547901"
        ],
        "delivery_info": {
          "area_from": [
            "广东",
            "揭阳市"
          ]
        },
        "goods_score": "3.67",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01xCIZBh1K7Aq8mplrd_!!2207609311116-0-cib.jpg",
        "is_ad": false,
        "item_id": 713384221548,
        "item_repurchase_rate": "19%",
        "moq": 2,
        "price": "8.43",
        "price_info": {
          "origin_price": null,
          "sale_price": "8.43"
        },
        "product_url": "https://detail.1688.com/offer/713384221548.html",
        "quantity_begin": 2,
        "quantity_prices": [
          {
            "begin_num": 2,
            "end_num": null,
            "price": "4.80"
          }
        ],
        "rating_star": "3.67",
        "sale_info": {
          "orders_count": 34476,
          "sale_quantity": "全网8.2万+件",
          "sale_quantity_int": 82000
        },
        "shop_info": {
          "biz_type": "生产加工",
          "company_name": "揭阳市嘉尔纳塑业有限公司",
          "factory_inspection": false,
          "is_factory": true,
          "is_super_factory": false,
          "location": [
            "广东",
            "揭阳市"
          ],
          "login_id": "嘉尔塑料制品",
          "member_id": "b2b-22076093111168ec09",
          "score_info": {
            "composite_new_score": "4.5",
            "consultation_score": "3.5",
            "dispute_score": "4.0",
            "logistics_score": "4.0",
            "return_score": "4.0"
          },
          "service_tags": [
            "深度验商"
          ],
          "shop_url": "http://shop75zn831130291.1688.com",
          "shop_years": 7
        },
        "tags": [
          "退货包运费",
          "先采后付",
          "回头率53%"
        ],
        "title": "杂物玩具整理箱宿舍家用衣柜客厅大容量零食储物箱带盖桌面收纳盒"
      },
      {
        "category_path": [
          "121490001",
          "1548",
          "201547901"
        ],
        "delivery_info": {
          "area_from": [
            "山东",
            "临沂市"
          ]
        },
        "goods_score": "3.33",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01XB16fn29CiJ5Y0gut_!!2927788032-0-cib.jpg",
        "is_ad": false,
        "item_id": 995730059114,
        "item_repurchase_rate": "4%",
        "moq": 2,
        "price": "4.05",
        "price_info": {
          "origin_price": null,
          "sale_price": "4.05"
        },
        "product_url": "https://detail.1688.com/offer/995730059114.html",
        "quantity_begin": 2,
        "quantity_prices": [
          {
            "begin_num": 2,
            "end_num": null,
            "price": "4.50"
          }
        ],
        "rating_star": "3.33",
        "sale_info": {
          "orders_count": 2248,
          "sale_quantity": "全网1.7万+件",
          "sale_quantity_int": 17000
        },
        "shop_info": {
          "biz_type": "生产加工",
          "company_name": "临沂新金东家居用品有限公司",
          "factory_inspection": false,
          "is_factory": true,
          "is_super_factory": false,
          "location": [
            "山东",
            "临沂市"
          ],
          "login_id": "临沂金东塑料",
          "member_id": "b2b-2927788032fa8fb",
          "score_info": {
            "composite_new_score": "4.5",
            "consultation_score": "4.0",
            "dispute_score": "4.0",
            "logistics_score": "3.57",
            "return_score": "4.0"
          },
          "service_tags": [],
          "shop_url": "http://jindongsuliao.1688.com",
          "shop_years": 11
        },
        "tags": [
          "退货包运费",
          "先采后付",
          "回头率54%"
        ],
        "title": "手提收纳箱透明食品收纳盒加厚塑料储物箱衣服整理箱带盖玩具箱子"
      },
      {
        "category_path": [
          "1043769",
          "10287",
          "201547801"
        ],
        "delivery_info": {
          "area_from": [
            "山东",
            "临沂市"
          ]
        },
        "goods_score": "3.33",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01oVtywc29CiIzy4QvC_!!2927788032-0-cib.jpg",
        "is_ad": false,
        "item_id": 993440527161,
        "item_repurchase_rate": "8%",
        "moq": 1,
        "price": "4.73",
        "price_info": {
          "origin_price": null,
          "sale_price": "4.73"
        },
        "product_url": "https://detail.1688.com/offer/993440527161.html",
        "quantity_begin": 1,
        "quantity_prices": [
          {
            "begin_num": 1,
            "end_num": null,
            "price": "3.60"
          }
        ],
        "rating_star": "3.33",
        "sale_info": {
          "orders_count": 1125,
          "sale_quantity": "已售6400+件",
          "sale_quantity_int": 6400
        },
        "shop_info": {
          "biz_type": "生产加工",
          "company_name": "临沂新金东家居用品有限公司",
          "factory_inspection": false,
          "is_factory": true,
          "is_super_factory": false,
          "location": [
            "山东",
            "临沂市"
          ],
          "login_id": "临沂金东塑料",
          "member_id": "b2b-2927788032fa8fb",
          "score_info": {
            "composite_new_score": "4.5",
            "consultation_score": "4.0",
            "dispute_score": "4.0",
            "logistics_score": "3.57",
            "return_score": "4.0"
          },
          "service_tags": [],
          "shop_url": "http://jindongsuliao.1688.com",
          "shop_years": 11
        },
        "tags": [
          "退货包运费",
          "先采后付",
          "回头率54%"
        ],
        "title": "保鲜盒商用食品透明塑料盒带盖长方形收纳盒冰箱食物密封分装盒子"
      },
      {
        "category_path": [
          "121490001",
          "1548",
          "201547901"
        ],
        "delivery_info": {
          "area_from": [
            "山东",
            "临沂市"
          ]
        },
        "goods_score": "5.0",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01hciz4f1pCRo54Ul5y_!!2218509625324-0-cib.jpg",
        "is_ad": false,
        "item_id": 1062681564352,
        "item_repurchase_rate": "2%",
        "moq": 2,
        "price": "3.92",
        "price_info": {
          "origin_price": null,
          "sale_price": "3.92"
        },
        "product_url": "https://detail.1688.com/offer/1062681564352.html",
        "quantity_begin": 2,
        "quantity_prices": [
          {
            "begin_num": 2,
            "end_num": null,
            "price": "4.90"
          }
        ],
        "rating_star": "5.0",
        "sale_info": {
          "orders_count": 1194,
          "sale_quantity": "已售4400+件",
          "sale_quantity_int": 4400
        },
        "shop_info": {
          "biz_type": "生产加工",
          "company_name": "临沂瑞业家居用品有限公司",
          "factory_inspection": false,
          "is_factory": true,
          "is_super_factory": false,
          "location": [
            "山东",
            "临沂市"
          ],
          "login_id": "临沂瑞业家居",
          "member_id": "b2b-22185096253244079c",
          "score_info": {
            "composite_new_score": "4.5",
            "consultation_score": "4.0",
            "dispute_score": "5.0",
            "logistics_score": "3.43",
            "return_score": "3.67"
          },
          "service_tags": [],
          "shop_url": "http://lyruiye.1688.com",
          "shop_years": 3
        },
        "tags": [
          "退货包运费",
          "先采后付",
          "回头率62%"
        ],
        "title": "塑料透明手提收纳箱家用放衣服收纳盒玩具储物盒子加厚商用整理箱"
      },
      {
        "category_path": [
          "1043982",
          "1548",
          "201547901"
        ],
        "delivery_info": {
          "area_from": [
            "浙江",
            "义乌市"
          ]
        },
        "goods_score": "2.33",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01XlWWnN1r5EmcSv8UJ_!!2217137195579-0-cib.jpg",
        "is_ad": false,
        "item_id": 1058093824020,
        "item_repurchase_rate": "1%",
        "moq": 2,
        "price": "7.13",
        "price_info": {
          "origin_price": null,
          "sale_price": "7.13"
        },
        "product_url": "https://detail.1688.com/offer/1058093824020.html",
        "quantity_begin": 2,
        "quantity_prices": [
          {
            "begin_num": 2,
            "end_num": 39,
            "price": "7.92"
          },
          {
            "begin_num": 40,
            "end_num": 199,
            "price": "7.72"
          },
          {
            "begin_num": 200,
            "end_num": null,
            "price": "7.43"
          }
        ],
        "rating_star": "2.33",
        "sale_info": {
          "orders_count": 218,
          "sale_quantity": "已售500+件",
          "sale_quantity_int": 500
        },
        "shop_info": {
          "biz_type": "生产加工",
          "company_name": "义乌市呈遇贸易有限公司",
          "factory_inspection": false,
          "is_factory": true,
          "is_super_factory": false,
          "location": [
            "浙江",
            "义乌市"
          ],
          "login_id": "chengnuo轩悦",
          "member_id": "b2b-22104409277119789b",
          "score_info": {
            "composite_new_score": "3.5",
            "consultation_score": "1.5",
            "dispute_score": "4.0",
            "logistics_score": "3.71",
            "return_score": "3.33"
          },
          "service_tags": [
            "深度验商"
          ],
          "shop_url": "http://shop141963nn479v5.1688.com",
          "shop_years": 6
        },
        "tags": [
          "退货包运费",
          "先采后付",
          "回头率46%"
        ],
        "title": "办公室文件收纳盒透明亚克力试卷档案盒置物架纸盒可叠加资料盒A4"
      },
      {
        "category_path": [
          "1043982",
          "1548",
          "201547901"
        ],
        "delivery_info": {
          "area_from": [
            "浙江",
            "金华市"
          ]
        },
        "goods_score": "3.0",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01zGZ0ab1EDEdSwnxRd_!!3549360317-0-cib.jpg",
        "is_ad": false,
        "item_id": 966415952734,
        "item_repurchase_rate": "8%",
        "moq": null,
        "price": "2.7",
        "price_info": {
          "origin_price": null,
          "sale_price": "2.7"
        },
        "product_url": "https://detail.1688.com/offer/966415952734.html",
        "quantity_begin": null,
        "quantity_prices": [],
        "rating_star": "3.0",
        "sale_info": {
          "orders_count": 4745,
          "sale_quantity": "已售2.2万+件",
          "sale_quantity_int": 22000
        },
        "shop_info": {
          "biz_type": "生产加工",
          "company_name": "浦江远矣电子商务有限公司",
          "factory_inspection": true,
          "is_factory": true,
          "is_super_factory": true,
          "location": [
            "浙江",
            "金华市"
          ],
          "login_id": "匠辛日用品",
          "member_id": "b2b-3549360317f0b68",
          "score_info": {
            "composite_new_score": "4.0",
            "consultation_score": "2.5",
            "dispute_score": "4.0",
            "logistics_score": "3.57",
            "return_score": "4.0"
          },
          "service_tags": [
            "深度验厂"
          ],
          "shop_url": "http://shop1599457743ob5.1688.com",
          "shop_years": 4
        },
        "tags": [
          "退货包运费",
          "先采后付",
          "回头率45%"
        ],
        "title": "零食筐透明亚克力收纳盒杂物置物篮橱柜整理盒厨房桌面储物收纳筐"
      },
      {
        "category_path": [
          "121490001",
          "1548",
          "201547901"
        ],
        "delivery_info": {
          "area_from": [
            "浙江",
            "金华市"
          ]
        },
        "goods_score": "2.33",
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01TM4FLhbPc4K1chua_!!2219493330149-0-cib.jpg",
        "is_ad": false,
        "item_id": 899044265823,
        "item_repurchase_rate": "",
        "moq": null,
        "price": "10.01",
        "price_info": {
          "origin_price": null,
          "sale_price": "10.01"
        },
        "product_url": "https://detail.1688.com/offer/899044265823.html",
        "quantity_begin": null,
        "quantity_prices": [],
        "rating_star": "2.33",
        "sale_info": {
          "orders_count": 2009,
          "sale_quantity": "全网1.8万+件",
          "sale_quantity_int": 18000
        },
        "shop_info": {
          "biz_type": "",
          "company_name": "义乌市清欢日用品有限公司",
          "factory_inspection": false,
          "is_factory": false,
          "is_super_factory": false,
          "location": [
            "浙江",
            "金华市"
          ],
          "login_id": "清欢日用品",
          "member_id": "b2b-221949333014996c52",
          "score_info": {
            "composite_new_score": "3.5",
            "consultation_score": "1.0",
            "dispute_score": "4.0",
            "logistics_score": "3.57",
            "return_score": "4.0"
          },
          "service_tags": [],
          "shop_url": "http://shop2b2663483g468.1688.com",
          "shop_years": 2
        },
        "tags": [
          "退货包运费",
          "先采后付",
          "回头率6%"
        ],
        "title": "衣服收纳箱家用大容量超大装衣物整理盒搬家打包袋储物筐箱子神器"
      }
    ],
    "keyword": "收纳盒",
    "page": 1,
    "page_size": 10,
    "sort": "default",
    "total_count": 2000
  },
  "message": null,
  "openany_cost": 15385,
  "recordTime": "2026-11-06T21:15:54.752633536",
  "requestId": "93bb0923d31e49bba98d33a5949dc3b8",
  "requestParams": {
    "body": null,
    "query": {
      "keyword": "收纳盒",
      "pageSize": "10"
    }
  }
}
justoneapiEstimated per call $0.015385

Response result

Response structure

Inferred from examples
  • codeinteger
  • dataobject
    • cat_idnull
    • filtersobject
    • has_next_pageboolean
    • itemsobject[]
      • category_pathstring[]
      • delivery_infoobject
        • area_fromstring[]
      • goods_scorestring
      • imgstring
      • is_adboolean
      • item_idinteger
      • item_repurchase_ratestring
      • moqinteger | null
      • pricestring
      • price_infoobject
        • origin_pricenull
        • sale_pricestring
      • product_urlstring
      • quantity_begininteger | null
      • quantity_pricesobject[]
        • begin_numinteger
        • end_numnull | integer
        • pricestring
      • rating_starstring
      • sale_infoobject
        • orders_countinteger
        • sale_quantitystring
        • sale_quantity_intinteger
      • shop_infoobject
        • biz_typestring
        • company_namestring
        • factory_inspectionboolean
        • is_factoryboolean
        • is_super_factoryboolean
        • locationstring[]
        • login_idstring
        • member_idstring
        • score_infoobject
          • composite_new_scorestring
          • consultation_scorestring
          • dispute_scorestring
          • logistics_scorestring
          • return_scorestring
        • service_tagsstring[]
        • shop_urlstring
        • shop_yearsinteger
      • tagsstring[]
      • titlestring
    • keywordstring
    • pageinteger
    • page_sizeinteger
    • sortstring
    • total_countinteger
  • messagenull
  • openany_costinteger
  • recordTimestring
  • requestIdstring
  • requestParamsobject
    • bodynull
    • queryobject
      • keywordstring
      • pageSizestring

Loading related APIs…

Common questions

Do I need a separate key for every provider?

Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.

Are these providers interchangeable?

No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.

How is this API billed?

API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.

Where do the price and contract come from?

The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.

How do OpenAny Balance and x402 differ?

OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.

Does Playground send a paid request?

Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.

Use 1688 Product Search API (V2) with your agent

Inspect endpoint contracts and confirm availability and pricing before a paid call.