OpenAny
Add OpenAny to Grok BotGet API key

1688 Cross-border Image Search API (V2)

Search for 1688 cross-border products by image with language selection, pagination, sorting and sourcing filters. Supply an img URL. Sample fields include prices and titles. Use it in visual discovery or a media workflow. The GET request schema also lists imgUrl, 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
Image reference returned by Image Conversion with searchApiEndpoint=cross_border_v2. Convert full image URLs before searching.
Optional parameters (11)
Output language. Available Values: - `en`: English - `zh`: Chinese - `ru`: Russian - `vi`: Vietnamese - `ja`: Japanese - `ko`: Korean
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 price filter in CNY.
Maximum price filter in CNY.
Filter for support for dropshipping.
Filter by factory status.
Filter for verified sellers.
Filter for free shipping.
Filter for new products.

Sample response

{
  "code": 0,
  "data": {
    "cat_id": null,
    "filters": {},
    "has_next_page": true,
    "items": [
      {
        "category_path": [
          "54",
          "201152912"
        ],
        "currency": null,
        "delivery_info": {
          "area_from": [
            "河北",
            "辛集市"
          ],
          "free_shipping": false,
          "ship_in_48h": true
        },
        "img": "https://cbu01.alicdn.com/O1CN01oeRfyV1svjiDWKPYC_!!2207466555829-0-cib.jpg",
        "item_id": 613944241512,
        "item_repurchase_rate": "60%",
        "low_refund_rate": false,
        "moq": null,
        "one_piece_min_order": false,
        "price": "0.65",
        "price_info": {
          "origin_price": "",
          "price": "0.65",
          "sale_price": "0.65"
        },
        "product_url": "https://detail.1688.com/offer/613944241512.html",
        "quantity_begin": null,
        "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": 7
        },
        "title": "Children's knitted mask wholesale dustproof Ice Silk Cotton black female spring and summer sun protection anti-haze breathable washable adjustable",
        "title_origin": "儿童针织口罩批发防尘冰丝棉黑女春夏防晒防雾霾透气可水洗可调节"
      },
      {
        "category_path": [
          "54",
          "201152912"
        ],
        "currency": null,
        "delivery_info": {
          "area_from": [
            "河北",
            "辛集市"
          ],
          "free_shipping": false,
          "ship_in_48h": true
        },
        "img": "https://cbu01.alicdn.com/O1CN01kIJVz225BYpyXeY8d_!!2220406857488-0-cib.jpg",
        "item_id": 984357743692,
        "item_repurchase_rate": "0%",
        "low_refund_rate": false,
        "moq": null,
        "one_piece_min_order": false,
        "price": "0.70",
        "price_info": {
          "origin_price": "",
          "price": "0.70",
          "sale_price": "0.70"
        },
        "product_url": "https://detail.1688.com/offer/984357743692.html",
        "quantity_begin": null,
        "sale_info": {
          "sale_quantity_90days": ""
        },
        "ship_in_48h": true,
        "shop_info": {
          "company_name": "辛集市猴开心商贸有限公司",
          "is_powerful_seller": false,
          "is_super_factory": false,
          "score_info": {
            "composite_score": "3.5"
          },
          "shop_years": 2
        },
        "title": "Children's Knitted Masks Wholesale Dust-Proof Ice Silk Cotton Autumn and Winter Sun Protection Warm Breathable Washable Adjustable 3D Stereo",
        "title_origin": "儿童针织口罩批发防尘冰丝棉秋冬防晒保暖透气可水洗可调节3D立体"
      },
      {
        "category_path": [
          "54",
          "201152912"
        ],
        "currency": null,
        "delivery_info": {
          "area_from": [
            "河北",
            "辛集市"
          ],
          "free_shipping": false,
          "ship_in_48h": true
        },
        "img": "https://cbu01.alicdn.com/O1CN010C59CZ25BYpqpsJY4_!!2220406857488-0-cib.jpg",
        "item_id": 982904273110,
        "item_repurchase_rate": "0%",
        "low_refund_rate": false,
        "moq": null,
        "one_piece_min_order": false,
        "price": "0.70",
        "price_info": {
          "origin_price": "",
          "price": "0.70",
          "sale_price": "0.70"
        },
        "product_url": "https://detail.1688.com/offer/982904273110.html",
        "quantity_begin": null,
        "sale_info": {
          "sale_quantity_90days": "10+"
        },
        "ship_in_48h": true,
        "shop_info": {
          "company_name": "辛集市猴开心商贸有限公司",
          "is_powerful_seller": false,
          "is_super_factory": false,
          "score_info": {
            "composite_score": "3.5"
          },
          "shop_years": 2
        },
        "title": "Wholesale Trendy Masks for Men and Women, Autumn and Winter, Dustproof, Water-Resistant, Breathable, Washable, Adjustable, Face-Slimming, 3D Design",
        "title_origin": "网红口罩批发男女秋冬天防尘防泼水透气可水洗可调节显脸小3D立体"
      },
      {
        "category_path": [
          "54",
          "201152912"
        ],
        "currency": null,
        "delivery_info": {
          "area_from": [
            "河北",
            "辛集市"
          ],
          "free_shipping": false,
          "ship_in_48h": true
        },
        "img": "https://cbu01.alicdn.com/O1CN01hIEfQI1vHNeOycJRl_!!2208378466147-0-cib.jpg",
        "item_id": 888687307059,
        "item_repurchase_rate": "100%",
        "low_refund_rate": false,
        "moq": null,
        "one_piece_min_order": false,
        "price": "1.35",
        "price_info": {
          "origin_price": "",
          "price": "1.35",
          "sale_price": "1.35"
        },
        "product_url": "https://detail.1688.com/offer/888687307059.html",
        "quantity_begin": null,
        "sale_info": {
          "sale_quantity_90days": "30+"
        },
        "ship_in_48h": true,
        "shop_info": {
          "company_name": "辛集市美吉特服装厂",
          "is_powerful_seller": false,
          "is_super_factory": false,
          "score_info": {
            "composite_score": "4.5"
          },
          "shop_years": 7
        },
        "title": "Fashion mask simple personality dust-proof sunscreen breathable washable adjustable star ice silk cotton mask wholesale",
        "title_origin": "时尚口罩简约个性防尘防晒透气可水洗可调节明星款冰丝棉口罩批发"
      },
      {
        "category_path": [
          "54",
          "201152912"
        ],
        "currency": null,
        "delivery_info": {
          "area_from": [
            "河北",
            "辛集市"
          ],
          "free_shipping": false,
          "ship_in_48h": true
        },
        "img": "https://cbu01.alicdn.com/O1CN01BltcRA1svjksbtlRZ_!!2207466555829-0-cib.jpg",
        "item_id": 791461170891,
        "item_repurchase_rate": "38%",
        "low_refund_rate": false,
        "moq": null,
        "one_piece_min_order": false,
        "price": "0.90",
        "price_info": {
          "origin_price": "",
          "price": "0.90",
          "sale_price": "0.90"
        },
        "product_url": "https://detail.1688.com/offer/791461170891.html",
        "quantity_begin": null,
        "sale_info": {
          "sale_quantity_90days": "7K+"
        },
        "ship_in_48h": true,
        "shop_info": {
          "company_name": "辛集市知意服饰有限公司",
          "is_powerful_seller": false,
          "is_super_factory": false,
          "score_info": {
            "composite_score": "4.0"
          },
          "shop_years": 7
        },
        "title": "Ice silk cotton masks for men and women with spring and summer dustproof sunscreen water-repellent breathable washable adjustable factory wholesale",
        "title_origin": "冰丝棉口罩男女同款春夏防尘防晒防泼水透气可水洗可调节厂家批发"
      },
      {
        "category_path": [
          "70",
          "124014010"
        ],
        "currency": null,
        "delivery_info": {
          "area_from": [
            "安徽",
            "安庆市"
          ],
          "free_shipping": false,
          "ship_in_48h": false
        },
        "img": "https://cbu01.alicdn.com/O1CN01wy2Sr32GuPRHx4RZu_!!2218876039075-0-cib.jpg",
        "item_id": 1054177038458,
        "item_repurchase_rate": "6%",
        "low_refund_rate": false,
        "moq": null,
        "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/1054177038458.html",
        "quantity_begin": null,
        "sale_info": {
          "sale_quantity_90days": "29K+"
        },
        "ship_in_48h": false,
        "shop_info": {
          "company_name": "桐城市沐沐塑料包装有限公司",
          "is_powerful_seller": false,
          "is_super_factory": false,
          "score_info": {
            "composite_score": "4.5"
          },
          "shop_years": 2
        },
        "title": "Morandi 3D Masks, Three-Dimensional, Disposable, Breathable, Face-Slimming, Cute, Fashionable, High-Value, Protective, Individually Packaged, Wholesale",
        "title_origin": "莫兰迪3d口罩立体一次性透气廋脸可爱时尚高颜值防护独立包装批发"
      },
      {
        "category_path": [
          "70",
          "124014010"
        ],
        "currency": null,
        "delivery_info": {
          "area_from": [
            "安徽",
            "安庆市"
          ],
          "free_shipping": false,
          "ship_in_48h": true
        },
        "img": "https://cbu01.alicdn.com/O1CN01N1tK3V2ATwrV52huP_!!2212501788205-0-cib.jpg",
        "item_id": 673880158129,
        "item_repurchase_rate": "17%",
        "low_refund_rate": false,
        "moq": null,
        "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/673880158129.html",
        "quantity_begin": null,
        "sale_info": {
          "sale_quantity_90days": "100K+"
        },
        "ship_in_48h": true,
        "shop_info": {
          "company_name": "桐城市沐秋塑料有限公司",
          "is_powerful_seller": false,
          "is_super_factory": true,
          "score_info": {
            "composite_score": "4.5"
          },
          "shop_years": 6
        },
        "title": "Morandi 3d stereo mask disposable breathable thin face cute fashion high value protection independent packaging wholesale",
        "title_origin": "莫兰迪3d立体口罩一次性透气廋脸可爱时尚高颜值防护独立包装批发"
      },
      {
        "category_path": [
          "15",
          "1556"
        ],
        "currency": null,
        "delivery_info": {
          "area_from": [
            "湖北",
            "仙桃市"
          ],
          "free_shipping": false,
          "ship_in_48h": true
        },
        "img": "https://cbu01.alicdn.com/O1CN01YeSjsU1Q1ZwozS5uu_!!2212981301916-0-cib.jpg",
        "item_id": 777506886274,
        "item_repurchase_rate": "24%",
        "low_refund_rate": false,
        "moq": null,
        "one_piece_min_order": false,
        "price": "0.07",
        "price_info": {
          "origin_price": "",
          "price": "0.07",
          "sale_price": "0.07"
        },
        "product_url": "https://detail.1688.com/offer/777506886274.html",
        "quantity_begin": null,
        "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": 5
        },
        "title": "3D Stereo Mask for Women, High Appearance Value, Slimming Effect, Makes Face Look Smaller, Brightens Complexion, Disposable, Individually Packaged, Thin, Breathable, Does Not Hurt Ears",
        "title_origin": "3D立体口罩女高颜值显瘦显脸小显白一次性独立包装薄款透气不勒耳"
      },
      {
        "category_path": [
          "54",
          "201152912"
        ],
        "currency": null,
        "delivery_info": {
          "area_from": [
            "河北",
            "辛集市"
          ],
          "free_shipping": false,
          "ship_in_48h": true
        },
        "img": "https://cbu01.alicdn.com/O1CN01imPox11svjkukCRbN_!!2207466555829-0-cib.jpg",
        "item_id": 635989559409,
        "item_repurchase_rate": "44%",
        "low_refund_rate": false,
        "moq": null,
        "one_piece_min_order": false,
        "price": "0.85",
        "price_info": {
          "origin_price": "",
          "price": "0.85",
          "sale_price": "0.85"
        },
        "product_url": "https://detail.1688.com/offer/635989559409.html",
        "quantity_begin": null,
        "sale_info": {
          "sale_quantity_90days": "9K+"
        },
        "ship_in_48h": true,
        "shop_info": {
          "company_name": "辛集市知意服饰有限公司",
          "is_powerful_seller": false,
          "is_super_factory": false,
          "score_info": {
            "composite_score": "4.0"
          },
          "shop_years": 7
        },
        "title": "Dust-Proof Ice Silk Cotton Knitted Mask Wholesale Women's Summer Warm Anti-Smog Breathable Washable Adjustable 3D Black Mask",
        "title_origin": "防尘冰丝棉针织口罩批发女夏保暖防雾霾透气可水洗可调节3D黑口罩"
      },
      {
        "category_path": [
          "54",
          "201152912"
        ],
        "currency": null,
        "delivery_info": {
          "area_from": [
            "浙江",
            "金华市"
          ],
          "free_shipping": false,
          "ship_in_48h": false
        },
        "img": "https://cbu01.alicdn.com/O1CN011LFwyR1n3cuSVkYtY_!!2219393165034-0-cib.jpg",
        "item_id": 1008615019596,
        "item_repurchase_rate": "7%",
        "low_refund_rate": false,
        "moq": null,
        "one_piece_min_order": false,
        "price": "8.50",
        "price_info": {
          "origin_price": "",
          "price": "8.50",
          "sale_price": "8.50"
        },
        "product_url": "https://detail.1688.com/offer/1008615019596.html",
        "quantity_begin": null,
        "sale_info": {
          "sale_quantity_90days": "400+"
        },
        "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": "Trendy Jiaoping 3D Three-Dimensional Disposable Masks with Genuine Guarantee, Breathable and Dustproof, Available for Wholesale and Dropshipping",
        "title_origin": "网红款焦芃3D立体一次性正品保障蕉芃口罩透气防尘一件代发批发"
      }
    ],
    "keyword": "",
    "page": 1,
    "page_size": 10,
    "sort": "default",
    "total_count": 700
  },
  "message": null,
  "openany_cost": 15385,
  "recordTime": "2026-11-06T21:17:57.793388447",
  "requestId": "1b622e5c904b49c5a76a453dd99ca635",
  "requestParams": {
    "body": null,
    "query": {
      "imgUrl": "/search/imgextra5/1286908880505784607.jpg",
      "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[]
      • currencynull
      • delivery_infoobject
        • area_fromstring[]
        • free_shippingboolean
        • ship_in_48hboolean
      • imgstring
      • item_idinteger
      • item_repurchase_ratestring
      • low_refund_rateboolean
      • moqnull
      • one_piece_min_orderboolean
      • pricestring
      • price_infoobject
        • origin_pricestring
        • pricestring
        • sale_pricestring
      • product_urlstring
      • quantity_beginnull
      • 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
      • imgUrlstring
      • 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 Image Search API (V2) with your agent

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