AliExpress Image Search
Pricing
from $2.00 / 1,000 results
AliExpress Image Search
Find matching AliExpress products by uploading a product image or providing an image URL. Returns up to 60 results with prices, images, and direct product links.
Pricing
from $2.00 / 1,000 results
Rating
0.0
(0)
Developer
군 복
Actor stats
0
Bookmarked
2
Total users
1
Monthly active users
2 days ago
Last modified
Categories
Share
AliExpress Image Search Actor
Search AliExpress for products matching a given image — no API key required. Upload a product photo or supply a public image URL and receive up to 60 matching product listings with prices, images, and direct links.
Features
- Image input — base64-encoded image or any public image URL
- Up to 60 results per search
- USD price column for easy comparison across currencies
- Configurable locale / country / currency — works worldwide
- Bot-challenge bypass — handles AliExpress punish redirects automatically
Input
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
imageUrl | string | * | — | Public URL of the product image |
imageBase64 | string | * | — | Base64-encoded image (with or without data:image/...;base64, prefix) |
country | string | KR | ISO 3166-1 alpha-2 ship-to country (e.g. US, GB, DE) | |
currency | string | KRW | ISO 4217 currency code for prices (e.g. USD, EUR) | |
locale | string | ko_KR | Locale for product titles (e.g. en_US, zh_CN) | |
lang | string | ko | Language code matching locale (e.g. en, zh) | |
pageSize | integer | 60 | Number of results (1–60) |
*Either imageUrl or imageBase64 must be provided.
Example input
Output
Each dataset item represents one AliExpress product:
| Field | Type | Description |
|---|---|---|
title | string | Product title |
imageUrl | string | Product thumbnail URL |
price | number | Price in the requested currency |
currency | string | Currency code of price |
priceUSD | number | Approximate USD equivalent |
orders | number | Reported sales / order count |
productUrl | string | Direct AliExpress product page URL |
Error handling
| Error code | Meaning |
|---|---|
SESSION_FAILED | Could not obtain session token — possible IP block |
BLOCKED | AliExpress bot detection bypassed failed |
SEARCH_FAILED | MTOP API returned an error |
On failure the actor throws and logs the error code. Retrying with a different Apify proxy or after a short delay usually resolves transient blocks.
Tips for best results
- Use a clear, well-lit product photo with the item centred and background minimal
- Avoid screenshots of product listings (the actor searches by visual similarity)
- For apparel, a plain-background photo produces significantly more matches
- The actor resizes images to 800×800 px automatically — no need to pre-process
Legal
This actor interacts with AliExpress's public search interface in the same way a browser would. It does not bypass authentication or access non-public data. Use responsibly and in accordance with AliExpress's Terms of Service.
