OpenAny
Add OpenAny to Grok BotGet API key

1688 Cross-border Product Search API (V1)

Search for 1688 cross-border products by keyword or category with language selection, pagination and sourcing filters. The sample response includes currency codes, prices and titles. Use it for catalog research or marketplace monitoring. The GET request schema also lists catId, page. 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
Optional parameters (12)
Search keyword. Supply keyword or catId.
1688 category ID. Supply catId or keyword.
Page number, starting at 1.
Number of items requested per page. The returned count may differ.
Output language. Available Values: - `en`: English - `zh`: Chinese - `ru`: Russian - `vi`: Vietnamese - `ja`: Japanese - `ko`: Korean
Product sort order. Available Values: - `default`: Default order - `sales`: Sales order - `price_up`: Price ascending - `price_down`: Price descending
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": 201149004,
    "filters": {},
    "has_next_page": true,
    "items": [
      {
        "category_path": [
          "54",
          "201149004"
        ],
        "currency": "CNY",
        "delivery_info": {
          "area_from": [
            "浙江",
            "义乌市"
          ],
          "free_shipping": false,
          "ship_in_48h": false
        },
        "img": "https://cbu01.alicdn.com/img/ibank/11037330136_1534575820.jpg",
        "item_id": 540846984366,
        "item_repurchase_rate": "40%",
        "low_refund_rate": false,
        "moq": "100",
        "one_piece_min_order": false,
        "price": "0.06",
        "price_info": {
          "origin_price": "",
          "price": "0.06",
          "sale_price": "0.06"
        },
        "product_url": "https://detail.1688.com/offer/540846984366.html",
        "quantity_begin": "100",
        "sale_info": {
          "sale_quantity_90days": "100K+"
        },
        "ship_in_48h": false,
        "shop_info": {
          "company_name": "义乌市杰英若飞贸易有限公司",
          "is_powerful_seller": false,
          "is_super_factory": false,
          "score_info": {
            "composite_score": "4.0"
          },
          "shop_years": 11
        },
        "title": "Factory direct high elastic seamless hair ring towel ring basic hair rope head rope women's simple hair band",
        "title_origin": "厂家直销高弹力无接缝发圈毛巾圈基础款发绳头绳女简约不伤发皮筋"
      },
      {
        "category_path": [
          "54",
          "201149004"
        ],
        "currency": "CNY",
        "delivery_info": {
          "area_from": [
            "浙江",
            "金华市"
          ],
          "free_shipping": false,
          "ship_in_48h": false
        },
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN013VfyBu1iCiXUzHrad_!!2217287404377-0-cib.jpg",
        "item_id": 799063203124,
        "item_repurchase_rate": "38%",
        "low_refund_rate": false,
        "moq": "50",
        "one_piece_min_order": false,
        "price": "0.02",
        "price_info": {
          "origin_price": "",
          "price": "0.02",
          "sale_price": "0.02"
        },
        "product_url": "https://detail.1688.com/offer/799063203124.html",
        "quantity_begin": "50",
        "sale_info": {
          "sale_quantity_90days": "100K+"
        },
        "ship_in_48h": false,
        "shop_info": {
          "company_name": "义乌市芄妍电子商务商行",
          "is_powerful_seller": false,
          "is_super_factory": false,
          "score_info": {
            "composite_score": "4.0"
          },
          "shop_years": 3
        },
        "title": "New Spring and Summer Small Grab Clip Cute Baby Baby Children's Small Clip Girl's Broken Hairpin Hair Accessories Hairpin Grab Hairpin",
        "title_origin": "新款春夏小抓夹儿可爱婴儿宝宝童小夹子女孩碎发夹发饰发卡抓发夹"
      },
      {
        "category_path": [
          "54",
          "201149004"
        ],
        "currency": "CNY",
        "delivery_info": {
          "area_from": [
            "浙江",
            "金华市"
          ],
          "free_shipping": false,
          "ship_in_48h": true
        },
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN018ACa3S1S0mUVzkm0P_!!2220128532185-0-cib.jpg",
        "item_id": 972910216517,
        "item_repurchase_rate": "27%",
        "low_refund_rate": false,
        "moq": "1",
        "one_piece_min_order": false,
        "price": "0.01",
        "price_info": {
          "origin_price": "",
          "price": "0.01",
          "sale_price": "0.01"
        },
        "product_url": "https://detail.1688.com/offer/972910216517.html",
        "quantity_begin": "1",
        "sale_info": {
          "sale_quantity_90days": "100K+"
        },
        "ship_in_48h": true,
        "shop_info": {
          "company_name": "义乌市豫业饰品厂",
          "is_powerful_seller": false,
          "is_super_factory": false,
          "score_info": {
            "composite_score": "4.0"
          },
          "shop_years": 2
        },
        "title": "Children's Hair Rope Little Girl's Braided Double Ponytail Hair Tie Baby Thumb Head Rope High Elasticity and Durability Does Not Hurt the Hair of Girls",
        "title_origin": "儿童发绳小女孩扎辫双马尾发圈宝宝拇指头绳高弹力耐用不伤发女童"
      },
      {
        "category_path": [
          "54",
          "201149004"
        ],
        "currency": "CNY",
        "delivery_info": {
          "area_from": [
            "浙江",
            "义乌市"
          ],
          "free_shipping": false,
          "ship_in_48h": true
        },
        "img": "https://cbu01.alicdn.com/img/ibank/10222496609_366891965.jpg",
        "item_id": 584600106983,
        "item_repurchase_rate": "100%",
        "low_refund_rate": false,
        "moq": "200",
        "one_piece_min_order": false,
        "price": "0.10",
        "price_info": {
          "origin_price": "",
          "price": "0.10",
          "sale_price": "0.10"
        },
        "product_url": "https://detail.1688.com/offer/584600106983.html",
        "quantity_begin": "200",
        "sale_info": {
          "sale_quantity_90days": "100K+"
        },
        "ship_in_48h": true,
        "shop_info": {
          "company_name": "义乌市澜美纸制品有限公司",
          "is_powerful_seller": false,
          "is_super_factory": false,
          "score_info": {
            "composite_score": "4.0"
          },
          "shop_years": 9
        },
        "title": "diy children's ring base family handmade materials pink diy plastic ring resin jewelry accessories",
        "title_origin": "diy儿童戒指底托 家庭手工加工材料 粉色diy塑胶戒指树脂饰品配件"
      },
      {
        "category_path": [
          "54",
          "201149004"
        ],
        "currency": "CNY",
        "delivery_info": {
          "area_from": [
            "浙江",
            "金华市"
          ],
          "free_shipping": false,
          "ship_in_48h": false
        },
        "img": "https://cbu01.alicdn.com/img/ibank/2016/401/392/3452293104_2122251119.jpg",
        "item_id": 524557180096,
        "item_repurchase_rate": "55%",
        "low_refund_rate": false,
        "moq": "1",
        "one_piece_min_order": false,
        "price": "5.00",
        "price_info": {
          "origin_price": "",
          "price": "5.00",
          "sale_price": "5.00"
        },
        "product_url": "https://detail.1688.com/offer/524557180096.html",
        "quantity_begin": "1",
        "sale_info": {
          "sale_quantity_90days": "100K+"
        },
        "ship_in_48h": false,
        "shop_info": {
          "company_name": "义乌市端秀饰品厂",
          "is_powerful_seller": false,
          "is_super_factory": false,
          "score_info": {
            "composite_score": "4.0"
          },
          "shop_years": 11
        },
        "title": "Wholesale acrylic beads transparent color hanging hole cut face nipple pendant children's comfort chain pendant two specifications",
        "title_origin": "批发亚克力珠子透明彩色吊孔切面奶嘴吊坠儿童安抚链挂件两款规格"
      },
      {
        "category_path": [
          "54",
          "201149004"
        ],
        "currency": "CNY",
        "delivery_info": {
          "area_from": [
            "浙江",
            "义乌市"
          ],
          "free_shipping": false,
          "ship_in_48h": true
        },
        "img": "https://global-img-cdn.1688.com/img/ibank/O1CN01PelKnP1fHLPbec1lZ_!!1006933981-0-cib.jpg",
        "item_id": 523039509314,
        "item_repurchase_rate": "41%",
        "low_refund_rate": false,
        "moq": "100",
        "one_piece_min_order": false,
        "price": "0.04",
        "price_info": {
          "origin_price": "",
          "price": "0.04",
          "sale_price": "0.04"
        },
        "product_url": "https://detail.1688.com/offer/523039509314.html",
        "quantity_begin": "100",
        "sale_info": {
          "sale_quantity_90days": "100K+"
        },
        "ship_in_48h": true,
        "shop_info": {
          "company_name": "永嘉县黄田云风水五金厂",
          "is_powerful_seller": true,
          "is_super_factory": false,
          "score_info": {
            "composite_score": "4.5"
          },
          "shop_years": 20
        },
        "title": "Guangdong double fork square clip nickel white KDIY material wholesale accessories 3.5~8cm/cm children's hair clip",
        "title_origin": "广东双叉方夹镍色白KDIY材料批发饰品配件3.5~ 8CM/公分儿童发夹"
      },
      {
        "category_path": [
          "54",
          "201149004"
        ],
        "currency": "CNY",
        "delivery_info": {
          "area_from": [
            "浙江",
            "金华市"
          ],
          "free_shipping": false,
          "ship_in_48h": false
        },
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01uO26rw1Hgx6dm6Z0K_!!2214458300788-0-cib.jpg",
        "item_id": 849251850164,
        "item_repurchase_rate": "34%",
        "low_refund_rate": false,
        "moq": "2",
        "one_piece_min_order": false,
        "price": "0.30",
        "price_info": {
          "origin_price": "",
          "price": "0.30",
          "sale_price": "0.30"
        },
        "product_url": "https://detail.1688.com/offer/849251850164.html",
        "quantity_begin": "2",
        "sale_info": {
          "sale_quantity_90days": "100K+"
        },
        "ship_in_48h": false,
        "shop_info": {
          "company_name": "义乌市柏旗饰品有限公司",
          "is_powerful_seller": true,
          "is_super_factory": false,
          "score_info": {
            "composite_score": "4.0"
          },
          "shop_years": 5
        },
        "title": "Foreign Trade Explosions Handmade Vertical Pattern Flat Angle Swallowtail Bow Hairpin Solid Color Simple Girls' Hairpin Children's Hair Accessories",
        "title_origin": "外贸爆款手工竖纹平角燕尾蝴蝶结发夹 纯色简约女童发夹 儿童发饰"
      },
      {
        "category_path": [
          "54",
          "201149004"
        ],
        "currency": "CNY",
        "delivery_info": {
          "area_from": [
            "浙江",
            "义乌市"
          ],
          "free_shipping": false,
          "ship_in_48h": true
        },
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01b5UpLB1UCLkUGP7Dn_!!2220617982481-0-cib.jpg",
        "item_id": 1001966620091,
        "item_repurchase_rate": "17%",
        "low_refund_rate": false,
        "moq": "10",
        "one_piece_min_order": false,
        "price": "0.08",
        "price_info": {
          "origin_price": "",
          "price": "0.08",
          "sale_price": "0.08"
        },
        "product_url": "https://detail.1688.com/offer/1001966620091.html",
        "quantity_begin": "10",
        "sale_info": {
          "sale_quantity_90days": "100K+"
        },
        "ship_in_48h": true,
        "shop_info": {
          "company_name": "义乌市速欧饰品有限公司",
          "is_powerful_seller": true,
          "is_super_factory": false,
          "score_info": {
            "composite_score": "4.0"
          },
          "shop_years": 2
        },
        "title": "Hair Ties for Children, Korean Girls' Hair Ropes, Elastic Bands for Tying Hair, Red Bean Hair Accessories, Korean-Style Children's Hair Accessories",
        "title_origin": "发圈儿童头绳韩国女童发绳皮筋扎头发红豆头饰品韩系儿童发饰"
      },
      {
        "category_path": [
          "54",
          "201149004"
        ],
        "currency": "CNY",
        "delivery_info": {
          "area_from": [
            "浙江",
            "金华市"
          ],
          "free_shipping": false,
          "ship_in_48h": false
        },
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01aBNwXg1kvipCqfmgG_!!2220184444746-0-cib.jpg",
        "item_id": 948522021881,
        "item_repurchase_rate": "23%",
        "low_refund_rate": false,
        "moq": "100",
        "one_piece_min_order": false,
        "price": "0.02",
        "price_info": {
          "origin_price": "",
          "price": "0.02",
          "sale_price": "0.02"
        },
        "product_url": "https://detail.1688.com/offer/948522021881.html",
        "quantity_begin": "100",
        "sale_info": {
          "sale_quantity_90days": "100K+"
        },
        "ship_in_48h": false,
        "shop_info": {
          "company_name": "义乌市泰萌饰品厂",
          "is_powerful_seller": false,
          "is_super_factory": false,
          "score_info": {
            "composite_score": "4.0"
          },
          "shop_years": 2
        },
        "title": "Colorful Children's Hairpin Clips Hair Accessories for Little Girls Baby Bangs Braiding Small Claw Clips Hair Ornaments",
        "title_origin": "彩色儿童发卡夹子头饰碎发神器发夹小女孩宝宝刘海编发小抓夹发饰"
      },
      {
        "category_path": [
          "54",
          "201149004"
        ],
        "currency": "CNY",
        "delivery_info": {
          "area_from": [
            "浙江",
            "金华市"
          ],
          "free_shipping": false,
          "ship_in_48h": true
        },
        "img": "https://cbu01.alicdn.com/img/ibank/10549756710_72821787.jpg",
        "item_id": 589472099085,
        "item_repurchase_rate": "50%",
        "low_refund_rate": false,
        "moq": "1",
        "one_piece_min_order": false,
        "price": "0.05",
        "price_info": {
          "origin_price": "",
          "price": "0.05",
          "sale_price": "0.05"
        },
        "product_url": "https://detail.1688.com/offer/589472099085.html",
        "quantity_begin": "1",
        "sale_info": {
          "sale_quantity_90days": "100K+"
        },
        "ship_in_48h": true,
        "shop_info": {
          "company_name": "义乌市喜辉电子商务有限公司",
          "is_powerful_seller": false,
          "is_super_factory": false,
          "score_info": {
            "composite_score": "4.0"
          },
          "shop_years": 8
        },
        "title": "12*21mm DIY Acrylic Transparent Pacifier Toy Baby Shower Baby Full Moon Birthday Party Gift",
        "title_origin": "12*21mm DIY亚克力透明奶嘴玩具Baby Shower婴儿满月生日派对礼物"
      }
    ],
    "keyword": "",
    "page": 1,
    "page_size": 10,
    "sort": "default",
    "total_count": 2000
  },
  "message": null,
  "openany_cost": 15385,
  "recordTime": "2026-11-06T21:15:50.072123964",
  "requestId": "e5e3ce900ed04b648456db735ada2c9d",
  "requestParams": {
    "body": null,
    "query": {
      "catId": "201149004",
      "pageSize": "10"
    }
  }
}
justoneapiEstimated per call $0.015385

Response result

Response structure

Inferred from examples
  • codeinteger
  • dataobject
    • cat_idinteger
    • filtersobject
    • has_next_pageboolean
    • itemsobject[]
      • category_pathstring[]
      • currencystring
      • delivery_infoobject
        • area_fromstring[]
        • free_shippingboolean
        • ship_in_48hboolean
      • imgstring
      • item_idinteger
      • item_repurchase_ratestring
      • low_refund_rateboolean
      • moqstring
      • one_piece_min_orderboolean
      • pricestring
      • price_infoobject
        • origin_pricestring
        • pricestring
        • sale_pricestring
      • product_urlstring
      • quantity_beginstring
      • sale_infoobject
        • sale_quantity_90daysstring
      • ship_in_48hboolean
      • shop_infoobject
        • company_namestring
        • is_powerful_sellerboolean
        • is_super_factoryboolean
        • score_infoobject
          • composite_scorestring
        • shop_yearsinteger
      • titlestring
      • title_originstring
    • keywordstring
    • pageinteger
    • page_sizeinteger
    • sortstring
    • total_countinteger
  • messagenull
  • openany_costinteger
  • recordTimestring
  • requestIdstring
  • requestParamsobject
    • bodynull
    • queryobject
      • catIdstring
      • 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 Cross-border Product Search API (V1) with your agent

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