imgUrlstringrequired
Image URL or image reference returned by Image Conversion. Convert external images for the selected search target before searching.
1688 Cross-border Image Search
https://api.sandbase.ai/v1/api/1688/search/cross-border-by-imageFind 1688 cross-border products that match an image URL, with translated titles, sorting and sourcing filters such as dropshipping, factory and verified supplier.
- Price
- $0.01USD / call
- Method
- POST
- Response
- JSON
- Parameters
- 1 required · 11 optional
100 free calls / dayFirst 100 calls per day free (shared per organization) · Resets at 00:00 UTC. Pay per call after that.
Playground
Input
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.
Output language. Allowed values: en, zh, ru, th, pt, es, tr, vi, ja, ko.
Page number, starting at 1.
Number of items requested per page. The returned count may differ.
Product sort order. Allowed values: default, sales, price_up, price_down.
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.
OutputReady
Your output will appear here
Complete the inputs, then click Run.
API README
1688 Cross-border Image Search API
Find 1688 cross-border products that match an image URL, with translated titles, sorting and sourcing filters such as dropshipping, factory and verified supplier.
The result is returned in outputs[0].data in the platform's original structure.
Request
curl -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" \
-d '{"imgUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01Zb1jbH1Bs2wE7Uu3W_!!2215541593486-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. |
language | string | No | Output language. |
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. |
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 and empty results are not charged.
Start building
Send your first request
Platform API endpoint with unified authentication and usage tracking.
# 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.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
3. Parameters
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.
Explore more
Related APIs
| API | Price | Response |
|---|---|---|
1688 Cross-border Image SearchThis API 1688 | $0.01 per call | JSON |
1688 | $0.01 per call | JSON |
1688 | $0.01 per call | JSON |
1688 | $0.01 per call | JSON |
1688 | $0.01 per call | JSON |
1688 | $0.01 per call | JSON |
Questions
FAQ
How do I use the 1688 Cross-border Image Search API?
Send a POST request to https://api.sandbase.ai/v1/api/1688/search/cross-border-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 Cross-border 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 Cross-border Image Search API accept?
Required: imgUrl (string). Optional: language (one of en, zh, ru, th, pt, es, tr, vi, ja, ko), page (integer), pageSize (integer), sort (one of default, sales, price_up, price_down), priceStart (string) and priceEnd (string) and 5 more. The Parameters table and the Playground on this page list every field.
What does the 1688 Cross-border 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 Cross-border 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.