Cross-border product sourcing research
Use AliExpress endpoints to turn cross-border product sourcing research into repeatable API requests with documented inputs and JSON responses.
Turn AliExpress's public storefront into structured JSON — discover keyword-specific sort, shipping, Choice, and product-attribute filters, search paginated product cards with prices and sold text, and collect a product's public reviews and rating statistics.
Search AliExpress products with keyword-specific filters, then collect public review records and rating statistics as structured JSON.
Endpoint families
3
Documented params
14
Examples
3
Live catalog snapshot
Active endpoints
3
Methods
GET
Required params
6
Schema refs
3
{
"platform": "AliExpress",
"endpoint": "aliexpress-search",
"method": "GET",
"path": "/aliexpress/search",
"auth": "apiKey"
}Use cases
Search AliExpress products with keyword-specific filters, then collect public review records and rating statistics as structured JSON.
Use AliExpress endpoints to turn cross-border product sourcing research into repeatable API requests with documented inputs and JSON responses.
Use AliExpress endpoints to turn keyword pricing and attribute-facet monitoring into repeatable API requests with documented inputs and JSON responses.
Use AliExpress endpoints to turn product review and rating tracking into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live AliExpress endpoint catalog — 3 endpoints, 14 documented request parameters, and 3 published response schemas — the same catalog Docs and Playground run against.
3 documented AliExpress endpoints, grouped into 3 request families — Reviews, Search and Search Filters.
14 request parameters are documented across those AliExpress endpoints, 6 of them required — the full input contract is public before you write any integration code.
3 of the 3 AliExpress endpoints ship a recorded example response, and 3 carry a documented response schema — you can code against the real JSON before the first request.
AliExpress endpoints document their error responses (400, 429 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
3 hosted MCP tools back the AliExpress endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
/aliexpress/reviews
/aliexpress/search
/aliexpress/search-filters
Endpoint catalog
/aliexpress/searchReturns 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.
MCP tool aliexpress_search
/aliexpress/search-filtersReturns 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.
Response notes
The response lists every value the search endpoint accepts for its sort and boolean filters, and the product-attribute filters AliExpress offers for this keyword. - `sort_options` lists the accepted `sort` values: `best_match`, `orders`, `price_asc`, `price_desc`. - `switches` lists the accepted boolean filter parameters: `free_shipping`, `choice`. - `attribute_groups` lists the keyword's attribute facets (brand, color, style, and so on). Each `values[].value` is ready to pass as `attr` to the search endpoint. Pick at most one value per group. - `attribute_groups` can be empty when AliExpress offers no facets for a keyword. - `total_results` is AliExpress's own estimate for the unfiltered keyword and varies between requests. Price ranges, ships-from, and the 4-star-and-up switch are not exposed: price bounds are separate `min_price` and `max_price` parameters, and the other two did not behave reliably when tested.
MCP tool aliexpress_search_filters
/aliexpress/reviewsReturns one page of public reviews and rating statistics for a numeric AliExpress product id. AliExpress currently returns up to 20 review records per page.
MCP tool aliexpress_reviews
Related APIs
Marketplaces & Retail
Research new, used, and vintage instruments across Reverb listings, seller shops, and the Price Guide. Keep current asking prices separate from historical sales, and preserve model, finish, year, condition, and currency when comparing gear.
Marketplaces & Retail
Collect marketplace product signals from Amazon without building brittle storefront scrapers.
Marketplaces & Retail
Build resale, pricing, and marketplace workflows from structured eBay data.
How to scrape AliExpress
Crawlora's three AliExpress endpoints cover keyword-specific filter discovery, public product search, and reviews as normalized JSON with one API key. In a live check on 2026-10-07, wireless-earbud filters exposed four sort values, the free_shipping and choice switches, and query-dependent attribute groups such as color, brand, connectivity, and style. The same query's estimated result count moved from 16,491 to 10,042 between calls, so treat total_results as a changing source estimate. Fetch /aliexpress/search-filters again with the same q before using attr values; product-detail pages remain unavailable through the supported HTTP profiles.
Call /aliexpress/search-filters with the same q you plan to search. It returns the accepted sort values, free_shipping and choice switches, and keyword-specific attribute groups. Copy an attr value from this response; use at most one per group and do not reuse it for another q. Price bounds are separate min_price and max_price parameters, not filter facets.
Send q to /aliexpress/search for one page of up to 60 public product results — ids, titles, links, images, prices, ratings, and sold text. page is 1-indexed through 200; sort, min_price/max_price, free_shipping, choice, and attr narrow the search. Results use AliExpress's anonymous US English/USD locale.
Pass a numeric product_id (from a search result's id) to /aliexpress/reviews for one page of public reviews and rating statistics — up to 20 review records per page. page pages through further reviews.
FAQ
Not currently — /aliexpress/search-filters discovers query-specific facets, /aliexpress/search returns keyword results, and /aliexpress/reviews returns a product's reviews and rating statistics. Product-detail pages are unavailable through the supported HTTP profiles right now.
Up to 60 products per page for a given keyword, in AliExpress's anonymous US English/USD locale. Use the page parameter to request further pages.
Call /aliexpress/search-filters with the same q as /aliexpress/search, then pass a returned attr value. Values are keyword-specific, at most one can be used per attribute group, and up to five values can be sent. total_results is AliExpress's changing estimate, not a stable inventory count.
Take the numeric id field from a /aliexpress/search result and pass it as product_id to /aliexpress/reviews. AliExpress returns up to 20 review records per page; use page to paginate further.
No — only your Crawlora API key. AliExpress's search and review data are collected from its public, credential-free storefront under its anonymous US locale.