AliExpress Product Search API and MCP — 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.
- 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 example response below.
| 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 | null | ISO currency code, when the response resolves one for the request locale. Null in the example. |
Example response
A real response, as returned.
{
"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.62 MB",
"machine": {
"total_items": 2,
"items": [
{
"@type": "AliexpressSearchProduct",
"id": "3256812660562508",
"product_url": "https://www.aliexpress.us/item/3256812660562508.html?algo_pvid=dacf4194-d4a7-4cc0-8fa6-b7bd728066ee&algo_exp_id=dacf4194-d4a7-4cc0-8fa6-b7bd728066ee-0&pdp_ext_f=%7B%22order%22%3A%224%22%2C%22eval%22%3",
"product_title": "Ultra Light Gaming Mouse Wireless 59g 12000DPI 3-Mode Connection PAW3311 Sensor RGB Base Station Smart Display Professional Mouse Gamer",
"image": "//ae-pic-a1.aliexpress-media.com/kf/Sb26b6722c2784df8a6d3b4e41252a083V.jpg_480x480q75.jpg_.avif",
"images": [
"//ae-pic-a1.aliexpress-media.com/kf/Sb26b6722c2784df8a6d3b4e41252a083V.jpg_480x480q75.jpg_.avif"
],
"price": 12.41,
"price_text": "$12.41",
"original_price": 54.35,
"original_price_text": "$54.35",
"currency": null
},
{
"@type": "AliexpressSearchProduct",
"id": "3256812760505425",
"product_url": "https://www.aliexpress.us/item/3256812760505425.html?algo_pvid=dacf4194-d4a7-4cc0-8fa6-b7bd728066ee&algo_exp_id=dacf4194-d4a7-4cc0-8fa6-b7bd728066ee-1&pdp_ext_f=%7B%22order%22%3A%225%22%2C%22eval%22%3",
"product_title": "Rapoo VT9 MAX / VT9 Wireless Gaming Mouse True 8K Wireless Polling Rate 53g Lightweight PAW3950/PAW3395 Sensor Up to 750 Hour Battery 10 Programmable Buttons On-Board Memory Esports Laptop Gaming Mice",
"image": "//ae-pic-a1.aliexpress-media.com/kf/S853ba570aed6477ebb1df36230aea4d96.jpg_480x480q75.jpg_.avif",
"images": [
"//ae-pic-a1.aliexpress-media.com/kf/S853ba570aed6477ebb1df36230aea4d96.jpg_480x480q75.jpg_.avif"
],
"price": 21.44,
"price_text": "$21.44",
"original_price": 73.15,
"original_price_text": "$73.15",
"currency": null
}
],
"proxy_traffic_bytes": 1697996
},
"total_points": 2
}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-search, 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.
- —Results reflect the ship_from/country combination requested, not every possible shipping 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.