1688 Image Search

Name: 1688 Image Search
Price: 0.013889 USD
Availability: InStock
Author: 1688

https://api.sandbase.ai/v1/api/1688/search/by-image

Find 1688 wholesale products that match an image URL, with prices, minimum order quantity and supplier info. Sort and filter by price, MOQ, factory, verified supplier and shipping.

Try this API Get API key

Price: $0.01USD / callFirst 100 calls per day free (shared per organization)
Method: POST
Response: JSON
Parameters: 1 required · 11 optional

Production route

Try the model

Playground

Open playground

Input

ImgUrl(string)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum

Image URL or image reference returned by Image Conversion. Convert external images for the selected search target before searching.

This field is required.

Page(integer)

Page number, starting at 1.

PageSize(integer)

Number of items requested per page. The returned count may differ.

Sort(string)

Product sort order. Allowed values: default, sales, price_up, price_down.

Moq(integer)

Minimum order quantity filter.

PriceStart(string)

Minimum price filter in CNY.

PriceEnd(string)

Maximum price filter in CNY.

SupportDropshipping(boolean)

Filter for support for dropshipping.

IsFactory(boolean)

Filter by factory status.

VerifiedSupplier(boolean)

Filter for verified sellers.

FreeShipping(boolean)

Filter for free shipping.

NewArrival(boolean)

Filter for new products.

OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price: $0.01 / run
Daily free calls: First 100 calls per day free (shared per organization)

Request & response

Method: POST
Request body: application/json
Response: application/json
Execution: sync

Parameters

imgUrl: string · required
page: integer · optional
pageSize: integer · optional
sort: string (default, sales, price_up, price_down) · optional
moq: integer · optional
priceStart: string · optional
priceEnd: string · optional
supportDropshipping: boolean · optional
isFactory: boolean · optional
verifiedSupplier: boolean · optional
freeShipping: boolean · optional
newArrival: boolean · optional

Access

Provider: 1688
API: Platform API
Base URL: https://api.sandbase.ai
Endpoint: /v1/api/1688/search/by-image
Authentication: Bearer API key

API README

1688 Image Search API

Find 1688 wholesale products that match an image URL, with prices, minimum order quantity and supplier info. Sort and filter by price, MOQ, factory, verified supplier and shipping.

The response is the platform's original data structure.

Request

curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "1688/search/by-image", "imgUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01dVDdAa1g2z0YPmnXe_!!2218348464085-0-cib.jpg"}'

Parameters

Name	Type	Required	Description
`imgUrl`	string	Yes	Image URL or image reference returned by Image Conversion. Convert external images for the selected search target before searching.
`page`	integer	No	Page number, starting at 1.
`pageSize`	integer	No	Number of items requested per page. The returned count may differ.
`sort`	string	No	Product sort order.
`moq`	integer	No	Minimum order quantity filter.
`priceStart`	string	No	Minimum price filter in CNY.
`priceEnd`	string	No	Maximum price filter in CNY.
`supportDropshipping`	boolean	No	Filter for support for dropshipping.
`isFactory`	boolean	No	Filter by factory status.
`verifiedSupplier`	boolean	No	Filter for verified sellers.
`freeShipping`	boolean	No	Filter for free shipping.
`newArrival`	boolean	No	Filter for new products.

Pricing

Flat price per call. Failed calls are not charged.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API

Platform API endpoint

https://api.sandbase.ai/v1/api/1688/search/by-image

Authorization header

Authorization: Bearer $SANDBASE_API_KEY

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/1688/search/by-image" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "page": 1,
  "sort": "default",
  "imgUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01Z5b6Ax1Bs2nVv6E3n_!!2216226597326-0-cib.jpg",
  "pageSize": 20
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs

API	Price	Response	Released
1688 Image SearchThis API `1688`	$0.01 per call	JSON	Oct 29, 2026
1688 Cross-border Product Search `1688`	$0.01 per call	JSON	Oct 29, 2026
1688 Factory Search `1688`	$0.01 per call	JSON	Oct 29, 2026
1688 Product Search `1688`	$0.01 per call	JSON	Oct 29, 2026
1688 Product Details `1688`	$0.01 per call	JSON	Oct 29, 2026
1688 Product Details by URL `1688`	$0.01 per call	JSON	Oct 29, 2026

Questions

FAQ

How do I use the 1688 Image Search API?

Send a POST request to https://api.sandbase.ai/v1/api/1688/search/by-image with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the 1688 Image Search API cost?

$0.01 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the 1688 Image Search API accept?

Required: imgUrl (string). Optional: page (integer), pageSize (integer), sort (one of default, sales, price_up, price_down), moq (integer), priceStart (string) and priceEnd (string) and 5 more. The Parameters table and the Playground on this page list every field.

What does the 1688 Image Search API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a 1688 developer account or API key?

No. 1688 Image Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for 1688 API access separately.