aliexpress.com APIaliexpress.com ↗
Search AliExpress products, fetch details, read customer reviews, and browse categories via a structured JSON API. 5 endpoints, no scraping setup needed.
curl -X GET 'https://api.parse.bot/scraper/f989ff95-1fce-426d-935d-2b3787e3f343/search_products?page=1&query=laptop&sort_by=best_match' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword with pagination and sorting. Returns up to 60 products per page from AliExpress search results.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search keyword (e.g. 'wireless earbuds', 'phone case'). |
| sort_by | string | Sort order. Accepted values: best_match, orders, price_asc, price_desc, newest. |
{
"type": "object",
"fields": {
"total": "integer, number of products returned on this page",
"products": "array of product objects with product_id, title, price, original_price, rating, orders_desc, thumbnail_url, product_url, seller_name"
},
"sample": {
"data": {
"total": 60,
"products": [
{
"price": 2.81,
"title": "Transparent Magnetic Case For iPhone 15 14 13 Pro Max",
"rating": 4.9,
"product_id": "3256806808326673",
"orders_desc": "100K+ sold",
"product_url": "https://www.aliexpress.com/item/3256806808326673.html",
"seller_name": null,
"thumbnail_url": "https://ae-pic-a1.aliexpress-media.com/kf/S49dcaaae862e4baa8f7caf2509ae10c1T.jpg",
"original_price": 6.63
}
]
},
"status": "success"
}
}About the aliexpress.com API
The AliExpress API provides 5 endpoints to search product listings, retrieve product details by ID or URL, read paginated customer reviews, and fetch the top-level category tree. The search_products endpoint returns up to 60 products per page including price, rating, order count, and seller name. It handles the full discovery-to-detail workflow without requiring any AliExpress account or session management.
Search and Product Lookup
The search_products endpoint accepts a query string and optional sort_by parameter with five accepted values: best_match, orders, price_asc, price_desc, and newest. Each product object in the response includes product_id, title, price, original_price, rating, orders_desc, thumbnail_url, product_url, and seller_name. Pagination is controlled via the page parameter.
To get deeper detail on a single item, use get_product_details with a numeric product_id. The response includes name, an images array, product_id, and aliexpress_url. Additional fields — cost, rating, reviews_count, and seller_name — may also appear depending on the product. If you have a full product URL rather than an ID, get_product_by_url accepts the URL directly and returns the same shape, making it useful when working from links rather than search results.
Reviews and Categories
get_product_reviews takes a product_id and optional page number, returning a reviews array where each object contains reviewer_name, rating, review_text, review_date, sku_info, country, and images. The response also includes total_reviews (total count across all pages) and average_rating (out of 5). This is sufficient to build review aggregation, sentiment analysis pipelines, or purchase validation tools.
The get_categories endpoint takes no inputs and returns the top-level AliExpress category tree as an array of objects with id, name, and icon URL. This is useful for populating navigation, mapping category IDs to search queries, or auditing category coverage.
- Build a price comparison tool using
search_productswithprice_ascandprice_descsort to surface cheapest and most expensive listings for a keyword. - Aggregate customer review data with
get_product_reviewsto analyze ratings by country or SKU variant. - Populate a product catalog from AliExpress search results including thumbnails, prices, and seller names.
- Validate supplier listings by cross-referencing
orders_descandaverage_ratingfrom search and review endpoints. - Convert AliExpress product URLs to structured JSON using
get_product_by_urlfor browser extension or link-processing workflows. - Map the AliExpress category tree with
get_categoriesto organize or filter product discovery by category ID. - Track original vs. discounted pricing by comparing
priceandoriginal_pricefields in search results.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does AliExpress have an official developer API?+
What does `get_product_details` return compared to `search_products`?+
search_products returns a broad set of fields across many products — title, price, thumbnail, order count, seller name — suitable for listing pages. get_product_details returns a name, full images array, product_id, and aliexpress_url for a single item, with cost, rating, reviews_count, and seller_name available as conditional fields. It does not currently return variant or specification data like color options or shipping info.Are seller details or store pages covered by the API?+
seller_name as part of search results and optionally in product detail responses, but there are no endpoints for seller profiles, store catalogs, or seller feedback scores. You can fork this API on Parse and revise it to add a seller or store endpoint.How does review pagination work?+
get_product_reviews returns a reviews array for one page at a time. The total_reviews field tells you the full count so you can calculate how many pages to request. Use the page parameter to step through them. Review images and sku_info (the variant the reviewer purchased) are included per review object.Does the API cover product variants, like sizes or colors?+
get_product_details and get_product_by_url endpoints return name, images, and URL-level data, with some conditional pricing and rating fields. Variant-level data (SKU options, stock per variant) is not exposed. You can fork this API on Parse and revise it to add variant extraction from product pages.