GET/aliexpress/categoriesapiKey3 credits/request
Returns AliExpress's category navigation taxonomy. With no parameters it lists the top-level category tabs (about 24), each with its navigation id, name, numeric platform category id and icon. Pass one tab's id as category_tab to expand that tab into its second- and third-level categories; third-level categories carry the search keyword and a ready-to-use search URL, so they can be passed to the search endpoint as q. Category ids are exposed only where AliExpress's payload actually carries them: second-level categories have no numeric platform id, so none is invented for them. This is a taxonomy surface, not a product listing.
Optional: category_tab.
Sampled 26 Oct 2026: 24 items. Filled in every item: id, name, level, category_id, icon_url. In the sample: name: “Automotive” and 23 other values; icon_url: ae-pic-a1.aliexpress-media.com.
Open in Playground
GET/aliexpress/category-idsapiKey3 credits/request
Returns the AliExpress web category ids that its own product cards carry on one listing page, with each id's parent, depth and full category path. Pass q to discover the categories of products matching a keyword, or category_id to inspect one category listing. Pass exactly one of them. The ids are the same web category ids used in /category/<id>/<slug>.html URLs and by the search endpoint's cat_id parameter; they are NOT the platform/taxonomy ids returned by the categories endpoint. A parent category listing contains products from its descendants, so inspecting a category reveals its child ids, and every returned path names that id's ancestors: the value space is discoverable by walking from a keyword or a category id rather than guessing.
Optional: q, category_id, page.
Sampled 26 Oct 2026: 1 item. Filled in every item: path, leaf_id, depth, products. In the sample: path: median 3 entries.
Open in Playground
GET/aliexpress/category-productsapiKey3 credits/request
Returns one page (up to 60 products) of a public AliExpress category listing with the same product fields as the search endpoint: product id, title, link, image, price, currency, original price, rating, sold text, discount, SKU id, ship-from country and store name when AliExpress lists them. category_id is the AliExpress web category id from a /category/<id>/<slug>.html URL (for example 5090301 for Cellphones); the slug segment is cosmetic (the listing is selected by id) and defaults to products. The listing uses the anonymous US English/USD locale. Product-detail pages are currently unavailable through the supported HTTP profiles.
Required: category_id. Optional: slug, page.
Sampled 26 Oct 2026: 60 items. Filled in every item: product_id, title, url, image_url, price, currency_code, discount_percent, sku_id. Not in every item: rating (44), sold_text (53), ship_from (50), store_name (16). In the sample: ship_from: CN (45), US (5); price: 8.23 to 938.28, median 111.39; sold_text: “760 sold” and 37 other values; url: aliexpress.com; title: median 126 characters; image_url: ae-pic-a1.aliexpress-media.com; discount_percent: 10 to 72, median 48; rating: 1 to 5, median 4.7.
Open in Playground
GET/aliexpress/reviewsapiKey3 credits/request
Returns one page of public reviews and rating statistics for a numeric AliExpress product id. AliExpress currently returns up to 20 review records per page.
Required: product_id. Optional: page.
Sampled 14 Oct 2026: 20 items. Filled in every item: rating, text, translation, country, date, anonymous. In the sample: rating: 4 to 5, median 5; anonymous: true in 15 of 20.
Open in Playground
GET/aliexpress/search-filtersapiKey3 credits/request
Returns every sort value and boolean filter the search endpoint accepts, plus the product-attribute filters (brand, color, style, and so on) AliExpress offers for the keyword, as ready-to-use attr values. Attribute filters differ per keyword, so call this with the same q as the search.
Required: q.
Sampled 14 Oct 2026: 17 items. Filled in every item: attribute_id, title, values. In the sample: title: “Brand” and 16 other values; values: median 7 entries.
Open in Playground
GET/aliexpress/searchapiKey3 credits/request
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.
Required: q. Optional: page, sort (4 allowed values: best_match, orders, price_asc, price_desc), min_price, max_price, free_shipping, choice, attr, cat_id.
Sampled 14 Oct 2026: 60 items. Filled in every item: product_id, title, url, image_url, price, currency_code, sku_id, ship_from. Not in every item: original_price (59), rating (49), sold_text (56), discount_percent (59), store_name (26). In the sample: ship_from: CN (51), US (9); price: 0.33 to 2,476.59, median 6.03; sold_text: “10,000+ sold” and 30 other values; url: aliexpress.com; title: median 124 characters; image_url: ae-pic-a1.aliexpress-media.com; original_price: 2.86 to 3,346.75, median 16.85; rating: 1 to 5, median 4.7.
Open in Playground
GET/aliexpress/suggestapiKey3 credits/request
Returns AliExpress's own search-box keyword completions for a query, with a ready-to-use search URL for each suggestion. This is a suggestion/autocomplete surface, not a product feed: the upstream payload contains keyword strings only, so no product id, title, price or seller is returned. AliExpress usually offers 10-12 suggestions; each suggestion's url is the matching AliExpress search page and can be passed to the search endpoint as q.
Required: q. Optional: limit.
Sampled 26 Oct 2026: 10 items. Filled in every item: keyword, url. In the sample: keyword: “wireless earbuds” and 9 other values; url: aliexpress.com.
Open in Playground
GET/aliexpress/trending-searchesapiKey3 credits/request
Returns AliExpress's own discovery/trending keyword feed from its anonymous search box: the hot-search keywords it groups by category, plus its discovery and shading keyword modules. Each item carries the keyword, its display casing when different, the kind (hot, shading, discovery, history), the module's UI label, the hot-list category, and a ready-to-use search URL; keyword thumbnails are included where AliExpress supplies them. This is a keyword-discovery feed, not a product list and not a personalized recommendation: no product id, title, price or seller is returned, and AliExpress does not promise a stable order between calls. The anonymous feed carries roughly 40 hot keywords plus a few discovery/shading keywords per call; search history is empty for anonymous callers.
Optional: limit.
Sampled 26 Oct 2026: 10 items. Filled in every item: keyword, kind, label, search_url. Not in every item: display_keyword (7), category (7), image_url (7). In the sample: kind: hot (7), discovery (2), shading (1); keyword: “Silicone Mould” and 9 other values; search_url: aliexpress.com; label: Hot for you (7), Discover more (2), Home Shading (1); display_keyword: “Hair Dryer” and 6 other values; image_url: ae-pic-a1.aliexpress-media.com.
Open in Playground