Endpoint Playground
Test Crawlora's Search AliExpress products API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.
curl "https://api.crawlora.net/api/v1/aliexpress/search?q=wireless+earbuds&sort=best_match" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | Yes | wireless earbuds | Free-text search keywords |
| page | integer | No | 1-indexed result page (1-200), defaults to 1 | |
| sort | string | No | best_match | Sort order. Allowed values: best_match (default), orders, price_asc, price_desc |
| min_price | number | No | Minimum price in USD (0-1000000) | |
| max_price | number | No | Maximum price in USD (0-1000000), not below min_price | |
| free_shipping | boolean | No | Only free-shipping products | |
| choice | boolean | No | Only products in AliExpress's Choice program | |
| attr | string | No | Attribute filter <attributeId>-<valueId>, from the search-filters endpoint for the same q; comma-separate up to 5 values, one per attribute group |
{
"code": 200,
"msg": "OK",
"data": {
"query": "wireless earbuds",
"page": 1,
"page_size": 60,
"total_results": 16889,
"total_pages": 282,
"count": 60,
"filters": {
"sort": "best_match"
},
"source_url": "https://www.aliexpress.com/w/wholesale-wireless-earbuds.html?SearchText=wireless+earbuds&catId=0",
"fetched_at": "2026-10-02T00:00:00Z",
"products": [
{
"product_id": "3256812072210872",
"title": "XIAOMI Redmi Airdots 2 Wireless Bluetooth Headset",
"url": "https://www.aliexpress.com/item/3256812072210872.html",
"image_url": "https://ae-pic-a1.aliexpress-media.com/kf/example.jpg",
"price": 2.18,
"currency_code": "USD",
"original_price": 18.33,
"rating": 4.9,
"sold_text": "3,000+ sold",
"discount_percent": 88,
"sku_id": "12000056622341651",
"ship_from": "CN",
"store_name": "Example Store"
}
]
}
}Public Playground
Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.
Returns one page (up to 60 products) of public keyword search results with product ids, titles, links, images, prices, ratings, sold text, discount, SKU id, ship-from country, and store name when AliExpress lists them. Results can be sorted and filtered by price, free shipping, the Choice program, and product attributes; list the attribute values for a keyword with the search-filters endpoint. The search uses the anonymous US English/USD locale. Product-detail pages are currently unavailable through the supported HTTP profiles.
{
"code": 200,
"msg": "OK",
"data": {
"query": "wireless earbuds",
"page": 1,
"page_size": 60,
"total_results": 16889,
"total_pages": 282,
"count": 60,
"filters": {
"sort": "best_match"
},
"source_url": "https://www.aliexpress.com/w/wholesale-wireless-earbuds.html?SearchText=wireless+earbuds&catId=0",
"fetched_at": "2026-10-02T00:00:00Z",
"products": [
{
"product_id": "3256812072210872",
"title": "XIAOMI Redmi Airdots 2 Wireless Bluetooth Headset",
"url": "https://www.aliexpress.com/item/3256812072210872.html",
"image_url": "https://ae-pic-a1.aliexpress-media.com/kf/example.jpg",
"price": 2.18,
"currency_code": "USD",
"original_price": 18.33,
"rating": 4.9,
"sold_text": "3,000+ sold",
"discount_percent": 88,
"sku_id": "12000056622341651",
"ship_from": "CN",
"store_name": "Example Store"
}
]
}
}curl "https://api.crawlora.net/api/v1/aliexpress/search?q=<q>" \
-H "x-api-key: $CRAWLORA_API_KEY"