Start building

1688 Cross-border Image Search API docs

Open Playground →

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/cross-border-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/cross-border-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/O1CN01Zb1jbH1Bs2wE7Uu3W_!!2215541593486-0-cib.jpg",
  "language": "en",
  "pageSize": 20
}
SANDBASE_JSON
)
printf '%s\n' "$result"

2. Authentication

Set your SandBase API key in your server environment. Requests use Bearer authentication.

API key environment variable
export SANDBASE_API_KEY="YOUR_API_KEY"

Keep your key on the server. Do not expose it in browser code.

3. Parameters

imgUrlstringrequired

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

languagestring

Output language.

Default: "en"

Possible values: en, zh, ru, th, pt, es, tr, vi, ja, ko

pageinteger

Page number, starting at 1.

Default: 1

pageSizeinteger

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

Default: 20

sortstring

Product sort order.

Default: "default"

Possible values: default, sales, price_up, price_down

priceStartstring

Minimum price filter in CNY.

priceEndstring

Maximum price filter in CNY.

supportDropshippingboolean

Filter for support for dropshipping.

isFactoryboolean

Filter by factory status.

verifiedSupplierboolean

Filter for verified sellers.

freeShippingboolean

Filter for free shipping.

newArrivalboolean

Filter for new products.

4. Response

Saved example response for this API; no live request is made when viewing it.

No saved response has been published. Run the API in Playground to inspect its response.