# AliExpress API: Search products > Searches AliExpress listings by product words, shipping destination, price range and sort order. Unpriced promotional cards are omitted; free shipping is marked only when the listing explicitly says so. Unofficial. Not affiliated with or endorsed by AliExpress. - Page: https://fous.com/methods/aliexpress.com/search-products - Method: `aliexpress.com/search_products`, version 1 - Website: aliexpress.com - Returns: product name, price, currency, original price, number sold, star rating, free shipping, store, photo, link, product ID - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `sort` | string | no | | Listing order, such as price_low_to_high. One of "best_match", "orders", "price_low_to_high", "price_high_to_low". Default "best_match". | | `query` | string | yes | `"phone case"` | Words to search for, such as phone case. | | `ship_to` | string | no | | Destination country name or two-letter code, such as Canada or CA. Default "United States". | | `max_price` | number | no | | Highest listed price, such as 30. | | `min_price` | number | no | | Lowest listed price, such as 5. | | `max_results` | integer | no | | Maximum number of products to return, such as 20. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "query": "phone case" } ``` Its output: ```json { "products": [ { "price": 1.09, "photo_link": "https://ae-pic-a1.aliexpress-media.com/kf/Sf7615706d428464fab2b660ceeccc18aE.jpg", "product_id": "3256806647441095", "store_name": "SZDBR Store", "number_sold": "50,000+ sold", "star_rating": 4.7, "product_link": "https://www.aliexpress.com/item/3256806647441095.html", "product_name": "Magnetic Luxury Matte Translucent Armor Shockproof Case For iPhone 16 15 14 13 12 17 18Pro Max For Magsafe Wireless Charge Cover", "currency_code": "USD", "free_shipping": false, "original_price": 3.01 }, { "price": 0.33, "photo_link": "https://ae-pic-a1.aliexpress-media.com/kf/S6f0638ad548548fb92bb7f3a1d486687g.jpg", "product_id": "3256808722668670", "store_name": null, "number_sold": "100K+ sold", "star_rating": 4.9, "product_link": "https://www.aliexpress.com/item/3256808722668670.html", "product_name": "Luxury Magnetic Matte Translucent Armor Shockproof Case For iPhone 11 12 13 14 15 16 For Magsafe Wireless Charge Cover", "currency_code": "USD", "free_shipping": false, "original_price": 5.92 }, { "price": 1.09, "photo_link": "https://ae-pic-a1.aliexpress-media.com/kf/Sb92b8f6e6fe94093a6f3989ba70457f24.jpg", "product_id": "3256811990811737", "store_name": "Shop1105233629 Store", "number_sold": "1,000+ sold", "star_rating": 4.9, "product_link": "https://www.aliexpress.com/item/3256811990811737.html", "product_name": "Transparent Original Magnetic Phone Case for iPhone 17 16 15 14 Plus 13 12 mini 11 Pro XS Max XR for Magsafe Acrylic Clear Cover", "currency_code": "USD", "free_shipping": false, "original_price": 11.9 } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"aliexpress.com/search_products","input":{"query":"phone case"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find me USB-C charging cables on AliExpress under $8 that ship to Canada, cheapest first - Show the best-selling mechanical keyboard keycap sets between $15 and $40 shipping to Germany - I need silicone baking mats priced $3 to $12, delivered to Australia — list up to 30 options with ratings and number sold - What are the most expensive LED strip lights shipping to the UK? Give me the top 10 with store names and links - Search aliexpress.com for women's linen summer dresses under 25 dollars shipping to US, sorted by most orders, and tell me which have free shipping ## Input schema ```json { "type": "object", "required": [ "query" ], "properties": { "sort": { "enum": [ "best_match", "orders", "price_low_to_high", "price_high_to_low" ], "type": "string", "default": "best_match", "description": "Listing order, such as price_low_to_high." }, "query": { "type": "string", "description": "Words to search for, such as phone case." }, "ship_to": { "type": "string", "default": "United States", "description": "Destination country name or two-letter code, such as Canada or CA." }, "max_price": { "type": "number", "minimum": 0, "description": "Highest listed price, such as 30." }, "min_price": { "type": "number", "minimum": 0, "description": "Lowest listed price, such as 5." }, "max_results": { "type": "integer", "default": 20, "maximum": 60, "minimum": 1, "description": "Maximum number of products to return, such as 20.", "x-fous-developer": true } }, "additionalProperties": false } ``` ## Output schema ```json { "type": "object", "required": [ "products" ], "properties": { "products": { "type": "array", "items": { "type": "object", "required": [ "product_name", "price", "currency_code", "original_price", "number_sold", "star_rating", "free_shipping", "store_name", "photo_link", "product_link", "product_id" ], "properties": { "price": { "type": "number" }, "photo_link": { "type": [ "string", "null" ] }, "product_id": { "type": "string", "x-fous-developer": true }, "store_name": { "type": [ "string", "null" ] }, "number_sold": { "type": [ "string", "null" ] }, "star_rating": { "type": [ "number", "null" ] }, "product_link": { "type": "string" }, "product_name": { "type": "string" }, "currency_code": { "type": "string" }, "free_shipping": { "type": "boolean", "description": "Whether the search listing explicitly shows free shipping." }, "original_price": { "type": [ "number", "null" ] } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [AliExpress API: Get product](https://fous.com/methods/aliexpress.com/get-product.md): Get one AliExpress product’s prices, variants, reviews, shipping to a chosen country, seller and specifications from its link or the best-selling name match. Sold counts may be rounded, and shipping options are those shown for the displayed variant. - [Alibaba API: Search wholesale products](https://fous.com/methods/alibaba.com/search-products.md): Finds wholesale Alibaba offers for a product, with prices, minimum orders and supplier details. Reads up to 20 public listing pages; minimum-order filtering compares the displayed number without converting packaging units. - [Macy's API: Search products](https://fous.com/methods/macys.com/search-products.md): Searches Macy's products in the site's order with optional USD price bounds, sale-only results and sorting. Prices for products with a range use the lowest shown price. - [Amazon API: Search products](https://fous.com/methods/amazon.com/search-products.md): Searches Amazon products in a chosen country store, with price range, sort, Prime and page options. Returns the listings and prices shown to an anonymous shopper in the store's currency. - [Flipkart API: Search products](https://fous.com/methods/flipkart.com/search-products.md): Searches Flipkart products by keyword, with an optional price range and sort order. Returns current listings in site order. - [Chewy API: Search products](https://fous.com/methods/chewy.com/search-products.md): Search Chewy products by words, pet type, and sort order. Returns up to 72 products in Chewy's order, including listed and first-order Autoship prices when shown. - [IKEA API: Search products](https://fous.com/methods/ikea.com/search-products.md): Searches IKEA products in a chosen country and returns current prices, details, photos and reviews in IKEA's result order. - [Newegg API: Search products](https://fous.com/methods/newegg.com/search-products.md): Searches Newegg US for computer parts and electronics, with optional USD price range, seller restriction and sorting. Returns products in the order shown on the results page. - [All AliExpress methods](https://fous.com/methods/aliexpress.com.md)