AliExpress reference
Every AliExpress operation, from the registry
12 operations wired in the registry, 12 of them proven by real traffic.
Choose a AliExpress operation
Start with the object your task needs. The groups below use the current catalogue; open an endpoint to check accepted identifiers, filters, price and availability before retrieving.
Products and categories
- AliExpress categories — AliExpress's top-level categories with their children and ids for aliexpress/search.
- AliExpress product — One AliExpress product: title, price range and promotion, rating, sales, images and video, properties, description, variants and options, shipping options and the seller.
- AliExpress store products — Products of one AliExpress store, optionally matching a keyword.
Other operations
- AliExpress product description — The full description text and images of an AliExpress product, with its property list.
- AliExpress promotions — The featured AliExpress promotions currently running, with the number of products in each; a name goes to aliexpress/search-promo.
- AliExpress shipping options — Shipping options for an AliExpress product to a country: carrier, fee, days and tracking.
- Similar AliExpress products — Products similar to an AliExpress product (or to a keyword), from the marketplace's own matching.
- AliExpress store — One AliExpress store: name, followers, product count, positive rate and seller level.
Reviews and offers
- AliExpress product reviews — Reviews of an AliExpress product, twenty per page, with the rating distribution and buyer country.
Search and discovery
- AliExpress product search — Products matching a keyword, twenty per page, with price, promotion price, sales, rating and shipping.
- AliExpress hot products — Currently hot AliExpress products, optionally filtered by keyword or category, with prices, discount, sales volume and shop.
- AliExpress promotion products — Products in a named AliExpress promotion, with prices, discount, sales volume and shop.
Check fields and collection limits
Use the endpoint’s declared parameters and returned continuation. Filters from another platform do not automatically apply here. Preserve source identifiers, URLs and warnings; a successful page does not establish complete history. Published response schemas identify whether they come from a reviewed shaper or observed response shapes.
Agents can use get_endpoint for the current contract and get_docs with topic platforms/aliexpress to read this page. The coverage guide explains nulls and partial results, and the production guide covers budgets and recovery.
Operations
AliExpress
Each row is a registry operation: expand it for parameters, a curl built from the registry's own examples, and a Markdown copy of the whole entry. The badge on the right is the operation's state, read at request time — we publish all three rather than rounding up. Recorded proof is historical, not a guarantee of current availability.
- live · proven
- a real upstream response has been served through this API and recorded
- wired · unproven
- a real-data route is registered, but qualifying proof is absent; permission or capacity restrictions may apply
- sample · free
- no live upstream — /v1 refuses it, /sandbox returns a marked sample
AliExpress
12 operationsElsewhere
The same registry, other shapes
- AliExpress overview — supported data categories and use cases for this platform.
- Full endpoint reference — every platform on one page.
/openapi.jsonor/openapi.yaml— the machine-readable contract, for Postman, Insomnia or a client generator.GET /v1/utility/endpoints?platform=aliexpress— the same rows to your code at runtime, for 0 credits.