OpenAny
Add OpenAny to Grok BotGet API key

1688 Product Search by Image API (V1)

Search for 1688 products by image with pagination, sorting and optional sourcing filters. Supply an img URL. Sample fields include prices and titles. Use it for catalog research or marketplace monitoring. The GET request schema also lists imgUrl, 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
Image URL or image reference returned by Image Conversion. Convert external images for the selected search target before searching.
Optional parameters (11)
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 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": [
          "124264004",
          "1556",
          "15"
        ],
        "delivery_info": {
          "area_from": [
            "安徽",
            "桐城市"
          ]
        },
        "goods_score": null,
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01Xjkpap2BMu3c0Rksz_!!2210916488325-0-cib.jpg",
        "is_ad": true,
        "item_id": 674051327470,
        "item_repurchase_rate": "64%",
        "moq": 10,
        "price": "0.22",
        "price_info": {
          "origin_price": null,
          "sale_price": "0.22"
        },
        "product_url": "https://detail.1688.com/offer/674051327470.html",
        "quantity_begin": 10,
        "quantity_prices": [],
        "rating_star": null,
        "sale_info": {
          "orders_count": 35473,
          "sale_quantity": "38525524",
          "sale_quantity_int": 38525524
        },
        "shop_info": {
          "biz_type": "生产加工",
          "company_name": "安徽瑞尔鑫防护用品有限公司",
          "factory_inspection": true,
          "is_factory": true,
          "is_super_factory": false,
          "location": [
            "安徽",
            "桐城市"
          ],
          "login_id": "瑞尔鑫防护用品",
          "member_id": "b2b-221091648832591bea",
          "score_info": {
            "composite_new_score": "5.0",
            "consultation_score": null,
            "dispute_score": null,
            "logistics_score": null,
            "return_score": null
          },
          "service_tags": null,
          "shop_url": "http://shop70h5731d03926.1688.com?tracelog=p4p",
          "shop_years": 6
        },
        "tags": [
          "先采后付",
          "回头率64%",
          "官方物流"
        ],
        "title": "日本一次性3d立体防护口罩小颜透气防拖妆日系口罩女高颜值批发"
      },
      {
        "category_path": [
          "122396004",
          "201152912",
          "54"
        ],
        "delivery_info": {
          "area_from": [
            "河北",
            "辛集市"
          ]
        },
        "goods_score": null,
        "img": "https://cbu01.alicdn.com/O1CN01BltcRA1svjksbtlRZ_!!2207466555829-0-cib.jpg",
        "is_ad": false,
        "item_id": 791461170891,
        "item_repurchase_rate": "61%",
        "moq": 1,
        "price": "1",
        "price_info": {
          "origin_price": null,
          "sale_price": "1"
        },
        "product_url": "https://detail.1688.com/offer/791461170891.html",
        "quantity_begin": 1,
        "quantity_prices": [],
        "rating_star": null,
        "sale_info": {
          "orders_count": 634,
          "sale_quantity": "98940",
          "sale_quantity_int": 98940
        },
        "shop_info": {
          "biz_type": "生产加工",
          "company_name": "辛集市知意服饰有限公司",
          "factory_inspection": false,
          "is_factory": true,
          "is_super_factory": false,
          "location": [
            "河北",
            "辛集市"
          ],
          "login_id": "童谣商贸",
          "member_id": "b2b-220746655582938a69",
          "score_info": {
            "composite_new_score": "4.0",
            "consultation_score": null,
            "dispute_score": null,
            "logistics_score": null,
            "return_score": null
          },
          "service_tags": null,
          "shop_url": "http://shop29456m6055j83.1688.com",
          "shop_years": 7
        },
        "tags": [
          "先采后付",
          "回头率61%",
          "7天无理由"
        ],
        "title": "冰丝棉口罩男女同款春夏防尘防晒防泼水透气可水洗可调节厂家批发"
      },
      {
        "category_path": [
          "122396004",
          "201152912",
          "54"
        ],
        "delivery_info": {
          "area_from": [
            "河北",
            "辛集市"
          ]
        },
        "goods_score": null,
        "img": "https://cbu01.alicdn.com/O1CN01COKdf225BYpxbAnfg_!!2220406857488-0-cib.jpg",
        "is_ad": false,
        "item_id": 984357743692,
        "item_repurchase_rate": "55%",
        "moq": 1,
        "price": "0.7",
        "price_info": {
          "origin_price": null,
          "sale_price": "0.7"
        },
        "product_url": "https://detail.1688.com/offer/984357743692.html",
        "quantity_begin": 1,
        "quantity_prices": [],
        "rating_star": null,
        "sale_info": {
          "orders_count": 17,
          "sale_quantity": "117",
          "sale_quantity_int": 117
        },
        "shop_info": {
          "biz_type": "生产加工",
          "company_name": "辛集市猴开心商贸有限公司",
          "factory_inspection": false,
          "is_factory": true,
          "is_super_factory": false,
          "location": [
            "河北",
            "辛集市"
          ],
          "login_id": "猴开心手套",
          "member_id": "b2b-22204068574884016a",
          "score_info": {
            "composite_new_score": "3.5",
            "consultation_score": null,
            "dispute_score": null,
            "logistics_score": null,
            "return_score": null
          },
          "service_tags": null,
          "shop_url": "http://shop14vx261505045.1688.com",
          "shop_years": 2
        },
        "tags": [
          "先采后付",
          "回头率55%",
          "7天无理由"
        ],
        "title": "儿童针织口罩批发防尘冰丝棉秋冬防晒保暖透气可水洗可调节3D立体"
      },
      {
        "category_path": [
          "124014012",
          "124014010",
          "70"
        ],
        "delivery_info": {
          "area_from": [
            "安徽",
            "安庆市"
          ]
        },
        "goods_score": null,
        "img": "https://cbu01.alicdn.com/O1CN01bhsSLp2GuPRN503X0_!!2218876039075-0-cib.jpg",
        "is_ad": false,
        "item_id": 1054177038458,
        "item_repurchase_rate": "46%",
        "moq": 100,
        "price": "0.09",
        "price_info": {
          "origin_price": null,
          "sale_price": "0.09"
        },
        "product_url": "https://detail.1688.com/offer/1054177038458.html",
        "quantity_begin": 100,
        "quantity_prices": [],
        "rating_star": null,
        "sale_info": {
          "orders_count": 145,
          "sale_quantity": "38520",
          "sale_quantity_int": 38520
        },
        "shop_info": {
          "biz_type": "",
          "company_name": "桐城市沐沐塑料包装有限公司",
          "factory_inspection": false,
          "is_factory": false,
          "is_super_factory": false,
          "location": [
            "安徽",
            "安庆市"
          ],
          "login_id": "桐城市沐沐医疗有限公司",
          "member_id": "b2b-2218876039075b0755",
          "score_info": {
            "composite_new_score": "4.5",
            "consultation_score": null,
            "dispute_score": null,
            "logistics_score": null,
            "return_score": null
          },
          "service_tags": null,
          "shop_url": "http://shop7p1878v841747.1688.com",
          "shop_years": 2
        },
        "tags": [
          "先采后付",
          "回头率46%",
          "官方物流"
        ],
        "title": "莫兰迪3d口罩立体一次性透气廋脸可爱时尚高颜值防护独立包装批发"
      },
      {
        "category_path": [
          "124014012",
          "124014010",
          "70"
        ],
        "delivery_info": {
          "area_from": [
            "安徽",
            "安庆市"
          ]
        },
        "goods_score": null,
        "img": "https://cbu01.alicdn.com/O1CN01JBffLe2ATwrZTdSY1_!!2212501788205-0-cib.jpg",
        "is_ad": true,
        "item_id": 673880158129,
        "item_repurchase_rate": "44%",
        "moq": 10,
        "price": "0.05",
        "price_info": {
          "origin_price": null,
          "sale_price": "0.05"
        },
        "product_url": "https://detail.1688.com/offer/673880158129.html",
        "quantity_begin": 10,
        "quantity_prices": [],
        "rating_star": null,
        "sale_info": {
          "orders_count": 25074,
          "sale_quantity": "10994423",
          "sale_quantity_int": 10994423
        },
        "shop_info": {
          "biz_type": "生产加工",
          "company_name": "桐城市沐秋塑料有限公司",
          "factory_inspection": true,
          "is_factory": true,
          "is_super_factory": false,
          "location": [
            "安徽",
            "安庆市"
          ],
          "login_id": "安徽沐秋环保科技有限公司",
          "member_id": "b2b-22125017882056f2c0",
          "score_info": {
            "composite_new_score": "4.5",
            "consultation_score": null,
            "dispute_score": null,
            "logistics_score": null,
            "return_score": null
          },
          "service_tags": null,
          "shop_url": "http://shop0y928a0282741.1688.com",
          "shop_years": 6
        },
        "tags": [
          "先采后付",
          "回头率44%",
          "官方物流"
        ],
        "title": "莫兰迪3d立体口罩一次性透气廋脸可爱时尚高颜值防护独立包装批发"
      },
      {
        "category_path": [
          "122396004",
          "201152912",
          "54"
        ],
        "delivery_info": {
          "area_from": [
            "河北",
            "辛集市"
          ]
        },
        "goods_score": null,
        "img": "https://cbu01.alicdn.com/O1CN01imPox11svjkukCRbN_!!2207466555829-0-cib.jpg",
        "is_ad": false,
        "item_id": 635989559409,
        "item_repurchase_rate": "61%",
        "moq": 1,
        "price": "0.85",
        "price_info": {
          "origin_price": null,
          "sale_price": "0.85"
        },
        "product_url": "https://detail.1688.com/offer/635989559409.html",
        "quantity_begin": 1,
        "quantity_prices": [],
        "rating_star": null,
        "sale_info": {
          "orders_count": 8239,
          "sale_quantity": "1157286",
          "sale_quantity_int": 1157286
        },
        "shop_info": {
          "biz_type": "生产加工",
          "company_name": "辛集市知意服饰有限公司",
          "factory_inspection": false,
          "is_factory": true,
          "is_super_factory": false,
          "location": [
            "河北",
            "辛集市"
          ],
          "login_id": "童谣商贸",
          "member_id": "b2b-220746655582938a69",
          "score_info": {
            "composite_new_score": "4.0",
            "consultation_score": null,
            "dispute_score": null,
            "logistics_score": null,
            "return_score": null
          },
          "service_tags": null,
          "shop_url": "http://shop29456m6055j83.1688.com",
          "shop_years": 7
        },
        "tags": [
          "先采后付",
          "回头率61%",
          "7天无理由"
        ],
        "title": "防尘冰丝棉针织口罩批发女夏保暖防雾霾透气可水洗可调节3D黑口罩"
      },
      {
        "category_path": [
          "201345718",
          "127508004",
          "54"
        ],
        "delivery_info": {
          "area_from": [
            "浙江",
            "东阳市"
          ]
        },
        "goods_score": null,
        "img": "https://cbu01.alicdn.com/img/ibank/O1CN01Y4d9Bt1QkSnrXtsy0_!!2218461532014-0-cib.jpg",
        "is_ad": true,
        "item_id": 1059419994174,
        "item_repurchase_rate": "59%",
        "moq": 1,
        "price": "9",
        "price_info": {
          "origin_price": null,
          "sale_price": "9"
        },
        "product_url": "https://detail.1688.com/offer/1059419994174.html",
        "quantity_begin": 1,
        "quantity_prices": [],
        "rating_star": null,
        "sale_info": {
          "orders_count": 26,
          "sale_quantity": "137",
          "sale_quantity_int": 137
        },
        "shop_info": {
          "biz_type": "生产加工",
          "company_name": "简厚(东阳)服饰有限公司",
          "factory_inspection": true,
          "is_factory": true,
          "is_super_factory": false,
          "location": [
            "浙江",
            "东阳市"
          ],
          "login_id": "简厚服饰工厂",
          "member_id": "b2b-2218461532014cf475",
          "score_info": {
            "composite_new_score": "5.0",
            "consultation_score": null,
            "dispute_score": null,
            "logistics_score": null,
            "return_score": null
          },
          "service_tags": null,
          "shop_url": "http://shop0181o09079900.1688.com?tracelog=p4p",
          "shop_years": 3
        },
        "tags": [
          "先采后付",
          "回头率59%",
          "7天无理由"
        ],
        "title": "夏季新款upf50+无痕防晒面罩护眼角立体显瘦挂耳冰丝遮阳口罩批发"
      },
      {
        "category_path": [
          "122396004",
          "201152912",
          "54"
        ],
        "delivery_info": {
          "area_from": [
            "浙江",
            "金华市"
          ]
        },
        "goods_score": null,
        "img": "https://cbu01.alicdn.com/O1CN011LFwyR1n3cuSVkYtY_!!2219393165034-0-cib.jpg",
        "is_ad": false,
        "item_id": 1008615019596,
        "item_repurchase_rate": "41%",
        "moq": 1,
        "price": "8.5",
        "price_info": {
          "origin_price": null,
          "sale_price": "8.5"
        },
        "product_url": "https://detail.1688.com/offer/1008615019596.html",
        "quantity_begin": 1,
        "quantity_prices": [],
        "rating_star": null,
        "sale_info": {
          "orders_count": 218,
          "sale_quantity": "787",
          "sale_quantity_int": 787
        },
        "shop_info": {
          "biz_type": "",
          "company_name": "义乌市双初贸易有限公司",
          "factory_inspection": false,
          "is_factory": false,
          "is_super_factory": false,
          "location": [
            "浙江",
            "金华市"
          ],
          "login_id": "双初123",
          "member_id": "b2b-22193931650341deba",
          "score_info": {
            "composite_new_score": "4.0",
            "consultation_score": null,
            "dispute_score": null,
            "logistics_score": null,
            "return_score": null
          },
          "service_tags": null,
          "shop_url": "http://shop76787j83m3m35.1688.com",
          "shop_years": 2
        },
        "tags": [
          "先采后付",
          "回头率41%",
          "7天无理由"
        ],
        "title": "网红款焦芃3D立体一次性正品保障蕉芃口罩透气防尘一件代发批发"
      },
      {
        "category_path": [
          "124264004",
          "1556",
          "15"
        ],
        "delivery_info": {
          "area_from": [
            "湖北",
            "仙桃市"
          ]
        },
        "goods_score": null,
        "img": "https://cbu01.alicdn.com/O1CN019iqSV51Q1ZwuQxAIr_!!2212981301916-0-cib.jpg",
        "is_ad": false,
        "item_id": 777506886274,
        "item_repurchase_rate": "56%",
        "moq": 10,
        "price": "0.07",
        "price_info": {
          "origin_price": null,
          "sale_price": "0.07"
        },
        "product_url": "https://detail.1688.com/offer/777506886274.html",
        "quantity_begin": 10,
        "quantity_prices": [],
        "rating_star": null,
        "sale_info": {
          "orders_count": 15496,
          "sale_quantity": "6244026",
          "sale_quantity_int": 6244026
        },
        "shop_info": {
          "biz_type": "生产加工",
          "company_name": "湖北佳贝康防护用品有限公司",
          "factory_inspection": true,
          "is_factory": true,
          "is_super_factory": false,
          "location": [
            "湖北",
            "仙桃市"
          ],
          "login_id": "江恒防护用品",
          "member_id": "b2b-2212981301916b42d4",
          "score_info": {
            "composite_new_score": "4.5",
            "consultation_score": null,
            "dispute_score": null,
            "logistics_score": null,
            "return_score": null
          },
          "service_tags": null,
          "shop_url": "http://jiangheng5588.1688.com",
          "shop_years": 5
        },
        "tags": [
          "回头率56%",
          "7天无理由"
        ],
        "title": "3D立体口罩女高颜值显瘦显脸小显白一次性独立包装薄款透气不勒耳"
      },
      {
        "category_path": [
          "122396004",
          "201152912",
          "54"
        ],
        "delivery_info": {
          "area_from": [
            "河北",
            "辛集市"
          ]
        },
        "goods_score": null,
        "img": "https://cbu01.alicdn.com/O1CN010C59CZ25BYpqpsJY4_!!2220406857488-0-cib.jpg",
        "is_ad": false,
        "item_id": 982904273110,
        "item_repurchase_rate": "55%",
        "moq": 1,
        "price": "0.85",
        "price_info": {
          "origin_price": null,
          "sale_price": "0.85"
        },
        "product_url": "https://detail.1688.com/offer/982904273110.html",
        "quantity_begin": 1,
        "quantity_prices": [],
        "rating_star": null,
        "sale_info": {
          "orders_count": 9,
          "sale_quantity": "148",
          "sale_quantity_int": 148
        },
        "shop_info": {
          "biz_type": "生产加工",
          "company_name": "辛集市猴开心商贸有限公司",
          "factory_inspection": false,
          "is_factory": true,
          "is_super_factory": false,
          "location": [
            "河北",
            "辛集市"
          ],
          "login_id": "猴开心手套",
          "member_id": "b2b-22204068574884016a",
          "score_info": {
            "composite_new_score": "3.5",
            "consultation_score": null,
            "dispute_score": null,
            "logistics_score": null,
            "return_score": null
          },
          "service_tags": null,
          "shop_url": "http://shop14vx261505045.1688.com",
          "shop_years": 2
        },
        "tags": [
          "先采后付",
          "回头率55%",
          "7天无理由"
        ],
        "title": "网红口罩批发男女秋冬天防尘防泼水透气可水洗可调节显脸小3D立体"
      }
    ],
    "keyword": "",
    "page": 1,
    "page_size": 10,
    "sort": "default",
    "total_count": 700
  },
  "message": null,
  "openany_cost": 15385,
  "recordTime": "2026-11-06T21:15:51.995293594",
  "requestId": "9f451b549d5f4853952b6c10d4753106",
  "requestParams": {
    "body": null,
    "query": {
      "imgUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01SZaEj31svjKqlsglD_!!2207466555829-0-cib.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[]
      • delivery_infoobject
        • area_fromstring[]
      • goods_scorenull
      • imgstring
      • is_adboolean
      • item_idinteger
      • item_repurchase_ratestring
      • moqinteger
      • pricestring
      • price_infoobject
        • origin_pricenull
        • sale_pricestring
      • product_urlstring
      • quantity_begininteger
      • quantity_pricesunknown[]
      • rating_starnull
      • 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_scorenull
          • dispute_scorenull
          • logistics_scorenull
          • return_scorenull
        • service_tagsnull
        • shop_urlstring
        • shop_yearsinteger
      • tagsstring[]
      • titlestring
    • 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 Product Search by Image API (V1) with your agent

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