AliExpress Product Search API — Keyword, Shipping & Price Filters
Send a keyword and this source searches AliExpress and returns matching products as data, with filters for sort, price, shipping origin and destination, free shipping, AliExpress Choice, 4-star-and-up rating, and local shipping.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "aliexpress_product_search",
"keyword": "wireless mouse",
"max_items": 2,
"start_page": 1,
"sort": null,
"min_price": null,
"max_price": null,
"currency": null,
"language": null,
"country": null,
"ship_from": null,
"free_shipping": false,
"choice": false,
"four_star_and_up": false,
"local_shipping": false,
"filters": [],
"partial": false,
"human": "# AliExpress product search\n\n- **Search term:** wireless mouse\n- **Starting page:** 1\n- **Max items:** 2\n- **Records returned:** 2\n- **Proxy traffic:** 1.87 MB",
"machine": {
"total_items": 2,
"items": [
{
"@type": "AliexpressSearchProduct",
"id": "3256812854109939",
"product_url": "https://www.aliexpress.us/item/3256812854109939.html?algo_pvid=8ad1a8c0-1717-46d4-affe-aad8bc1ee5ea&algo_exp_id=8ad1a8c0-1717-46d4-affe-aad8bc1ee5ea-0&pdp_ext_f=%7B%22order%22%3A%2212%22%2C%22eval%22%3A%221%22%2C%22orig_sl_item_id%22%3A%221005013040424691%22%2C%22orig_item_id%22%3A%221005012850992838%22%2C%22fromPage%22%3A%22search%22%7D&pdp_npi=6%40dis%21USD%2128.07%216.25%21%21%21187.66%2141.82%",
"product_title": "FocusOnPC 2.4GHz Wireless Gaming Mouse, 6 Programmable Buttons, Adjustable Up to 4000 Max DPI, Black Ergonomic PC Gaming Mice",
"image": "//ae-pic-a1.aliexpress-media.com/kf/S6e1636e09a134ed88ef924f96b360eebq.png_480x480.png_.avif",
"images": [
"//ae-pic-a1.aliexpress-media.com/kf/S6e1636e09a134ed88ef924f96b360eebq.png_480x480.png_.avif"
],
"price": 6.25,
"price_text": "$6.25",
"original_price": 28.07,
"original_price_text": "$28.07",
"currency": null
},
{
"@type": "AliexpressSearchProduct",
"id": "3256812815530963",
"product_url": "https://www.aliexpress.us/item/3256812815530963.html?algo_pvid=8ad1a8c0-1717-46d4-affe-aad8bc1ee5ea&algo_exp_id=8ad1a8c0-1717-46d4-affe-aad8bc1ee5ea-1&pdp_ext_f=%7B%22order%22%3A%2283%22%2C%22eval%22%3A%221%22%2C%22orig_sl_item_id%22%3A%221005013001845715%22%2C%22orig_item_id%22%3A%221005013137188576%22%2C%22fromPage%22%3A%22search%22%7D&pdp_npi=6%40dis%21USD%21108.92%2145.63%21%21%21728.08%21305.",
"product_title": "MCHOSE A7 V2 Lightweight Wireless Gaming Mouse Dual8000Hz Polling Rate PAW3950TI Imported Super Glide Glass Coating Office Mouse",
"image": "//ae-pic-a1.aliexpress-media.com/kf/S1500fac21cef4804be9c9094e570c8d7l.png_480x480.png_.avif",
"images": [
"//ae-pic-a1.aliexpress-media.com/kf/S1500fac21cef4804be9c9094e570c8d7l.png_480x480.png_.avif"
],
"price": 45.63,
"price_text": "$45.63",
"original_price": 108.92,
"original_price_text": "$108.92",
"currency": null
}
],
"proxy_traffic_bytes": 1959062
},
"total_points": 2
}- You send
- A search keyword, with optional sort, price, shipping and rating filters
- You get back
- Matching products with title, product ID, price and images
- Coverage
- AliExpress.com's searchable product catalog.
- Price
- 1 point per returned result, up to 250 per request — $1 per 1,000
- Billed per record actually returned, capped by max_items. A search that matches nothing costs nothing.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Searching the site by hand | Type the keyword, apply filters, scroll, copy | Free, and slow | Nobody keeps a sourcing list current this way |
| Building a scraper | Write it, host it, and repair it when AliExpress changes the results page | Engineering time | A maintenance commitment for something that isn't your product |
| NeuralVerge | One request, keyword and filters as parameters | $1 per 1,000, misses not billed | A broad, filter-light query can hit the time budget and come back partial — narrow it or lower max_items |
What you get back
Every field in the response shown above.
| Field | Type | Description |
|---|---|---|
total_items | number | How many products were returned in this batch (capped by max_items). |
partial | boolean | True if the search hit its time budget and returned only some records — re-run with a smaller max_items for a complete result. |
id | string | AliExpress product ID. |
product_url | string | Direct link to the product page. |
product_title | string | Listing title. |
image | string | Primary product image URL. |
images | array | All product image URLs. |
price | number | Current listed price. |
price_text | string | Current price formatted with a currency symbol. |
original_price | number | Pre-discount price, when the item is on sale. |
original_price_text | string | Pre-discount price formatted with a currency symbol. |
currency | string | ISO currency code, when the response resolves one for the request locale. |
How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
This endpoint is synchronous: the search runs inside the request and the result comes back in the response. If it hits its time budget mid-scrape, the response comes back with partial: true and whatever records were collected so far — re-run with a smaller max_items for a complete result instead of a partial one.
curl -X POST https://api.neuralverge.ai/functions/v1/run-aliexpress-product-search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "keyword": "wireless mouse", "max_items": 25, "sort": "orders", "country": "US" }'What teams use it for
Where this field shows up in an actual workflow.
Find suppliers for a product idea, filtered by ship-from country and shipping cost.
Compare price and shipping origin across sellers of the same product type.
Use four_star_and_up and choice to shortlist sellers before doing further diligence.
See what a category actually looks like on AliExpress, sorted by orders.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
AliExpress.com's searchable product catalog.
Searched at request time.
This source returns publicly visible search results, stamped with the keyword it was read from and a session id you can trace.
- —A broad, filter-light query can take long enough to hit the time budget and return partial: true — narrow it or lower max_items for a complete result.
- —Sponsored placement can affect result order the way it affects the site itself.
- —Shipping cost and time shown reflect the ship_from/country combination requested, not every possible route.
Questions, answered
The response comes back with partial: true and whatever records it collected before the time budget ran out, instead of failing outright. Re-run with a smaller max_items to get a complete, non-partial result.
Related sources
Try aliexpress product search on your own data
One request format across every source in the catalog.