JSON POST request example
POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/aliexpress/search with Content-Type: application/json and your Authorization: Bearer header.
{
"query": "coffee mug"
}// request reference
AliExpress Search parameters
Send query parameters with GET /api/aliexpress/search. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.
POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.
Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.
Request parameters
queryProduct keywords to search for.
Type string · GET query or POST JSON
- Minimum characters: 1
- Maximum characters: 500
pageOne-based result page.
Type integer · GET query or POST JSON · Default 1
- Minimum: 1
- Maximum: 100
// response
Work with the complete JSON response
Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.
Response groups include search_metadata, search_parameters, products, pagination, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.
Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.
Illustrative success response. Result groups and optional fields depend on upstream content.
{
"search_metadata": {
"retailer": "AliExpress",
"provider_url": "https://www.aliexpress.com/w/wholesale-coffee-mug.html?page=1",
"total_time_taken": 1.84
},
"search_parameters": {
"query": "coffee mug",
"page": 1
},
"products": [
{
"product_id": "3256813114203051",
"title": "1PC Pumpkin Ceramic Coffee Mug Cute Pumpkin Shaped Fall Tea Cup, Microwave, Halloween Thanksgiving Christmas Gift Home Decor",
"url": "https://www.aliexpress.com/item/3256813114203051.html",
"image": "https://ae-pic-a1.aliexpress-media.com/kf/S6f9d3df50807410fa7e5a6fb7133342ep.jpg",
"price": {
"amount": 3.73,
"currency": "USD",
"text": "US $3.73"
},
"original_price": {
"amount": 50.73,
"currency": "USD"
}
},
{
"product_id": "3256809857674133",
"title": "Japanese Style Ceramic Tea Cup Kiln Transformation Espresso Cup Porcelain Kung Fu Teacup Pottery Coffee Mug Wine Drinkware",
"url": "https://www.aliexpress.com/item/3256809857674133.html",
"image": "https://ae-pic-a1.aliexpress-media.com/kf/S39f1193adbf847689c05b991486a0cb44.jpg",
"price": {
"amount": 1.33,
"currency": "USD",
"text": "US $1.33"
},
"original_price": {
"amount": 10.72,
"currency": "USD"
}
},
{
"product_id": "3256813107898640",
"title": "V8 Engine Stainless Steel Coffee Mug, 3D Metal Mechanical Car Engine Water Bottle, Unique Automotive Enthusiast Gift For Fathers Day, Novelty Collectible Mug For Car Guys & Mechanics, Perfect For Hot/Cold Beverages",
"url": "https://www.aliexpress.com/item/3256813107898640.html",
"image": "https://ae-pic-a1.aliexpress-media.com/kf/S1ce995985a0244359d7fa315b8537e2cI.jpg",
"price": {
"amount": 7.59,
"currency": "USD",
"text": "US $7.59"
},
"original_price": {
"amount": 50.78,
"currency": "USD"
}
}
],
"pagination": {
"current": 1,
"next_page": 2,
"total_results": 32962
},
"submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}