AliExpress Search API
The AliExpress Search API returns AliExpress products for a search, up to 60 per page, for the country they ship to, in its currency and language.
Each product carries its price, original price and discount, rating, number of orders, the country it ships from, a delivery estimate, its badges, category ids and images, and whether it is an ad, an AliExpress Choice product, shows a free shipping badge or shows a new-shopper price.
Sort by best match, best sellers or price, filter by price, free shipping, Choice, ships-from country or the attributes AliExpress lists in filters, and page through up to 60 pages.
When AliExpress translates or corrects the search terms, search_information.translated_query names the terms it searched.
API Parameters
Search Query
-
- Name
-
q - Required
- Required
- Description
-
Parameter defines the search terms, such as
phone caseorwireless earbuds, up to 200 characters.
Localization
-
- Name
-
delivery_country - Required
- Optional
- Description
-
Parameter defines the country the products ship to, as a two-letter country code such as
US,DEorBR. It sets the products, prices and delivery estimates for that country, and the currency and language AliExpress uses there unlesscurrencyorlanguageis given. It defaults toUS. China, Russia and Belarus are not supported.
-
- Name
-
currency - Required
- Optional
- Description
-
Parameter defines the currency of the prices, as a three-letter currency code such as
USD,EUR,GBPorBRL. 83 currencies are supported.
-
- Name
-
language - Required
- Optional
- Description
-
Parameter defines the language of titles, badges and filters. It can be set to
ar_MA,de_DE,en_US,es_ES,fr_FR,he_IL,id_ID,it_IT,ja_JP,ko_KR,nl_NL,pl_PL,pt_BR,th_TH,tr_TRoruk_UA.
Sorting
-
- Name
-
sort_by - Required
- Optional
- Description
-
Parameter defines the order of the products. It can be set to
best_match,best_seller,price_low_to_highorprice_high_to_low, and defaults tobest_match.
Filters
-
- Name
-
price_min - Required
- Optional
- Description
-
Parameter defines the lowest price, in the currency of the results.
-
- Name
-
price_max - Required
- Optional
- Description
-
Parameter defines the highest price, in the currency of the results. It must be at least
price_min.
-
- Name
-
is_free_shipping - Required
- Optional
- Description
-
Parameter keeps only the products with free shipping when set to
true.
-
- Name
-
is_choice - Required
- Optional
- Description
-
Parameter keeps only AliExpress Choice products when set to
true.
-
- Name
-
ships_from - Required
- Optional
- Description
-
Parameter keeps only the products shipping from a country, given as the
valueof an option in theships_fromfilter, such asUS.
-
- Name
-
attribute_ids - Required
- Optional
- Description
-
Parameter filters on product attributes such as brand, color or material, as a comma-separated list of up to 20 option values from the
attribute_idsfilters, such as3079-4148343or3079-4148343,3203-4163876.
Pagination
-
- Name
-
page - Required
- Optional
- Description
-
Parameter defines the page of results, with up to 60 products per page, from 1 to 60. It defaults to
1, andpagination.nextis the next page while there is one.
Engine
-
- Name
-
engine - Required
- Required
- Description
-
Parameter defines an engine that will be used to retrieve real-time data. It must be set to
aliexpress_search.
API key
-
- Name
-
api_key - Required
- Required
- Description
-
The
api_keyauthenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).
Zero Data Retention
-
- Name
-
zero_retention - Enterprise Only
- Enterprise Only
- Required
- Optional
- Description
-
Set this parameter to
trueto disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.
API Examples
Full Response
https://www.searchapi.io/api/v1/search?engine=aliexpress_search&q=phone+case
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "aliexpress_search",
"q": "phone case"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_GgYj5VxWDGhNFpsusHJsZt2L",
"status": "Success",
"created_at": "2026-11-13T12:31:12Z",
"request_time_taken": 2.39,
"parsing_time_taken": 0.02,
"total_time_taken": 2.4,
"request_url": "https://www.aliexpress.com/w/wholesale-phone-case.html",
"html_url": "https://www.searchapi.io/api/v1/searches/search_GgYj5VxWDGhNFpsusHJsZt2L.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_GgYj5VxWDGhNFpsusHJsZt2L"
},
"search_parameters": {
"engine": "aliexpress_search",
"q": "phone case"
},
"search_information": {
"total_results": 100586,
"currency": "USD"
},
"organic_results": [
{
"position": 1,
"product_id": "3256807637171608",
"title": "Luxury Transparent Case For iPhone 16 15 11 12 13 14 Pro Max Soft TPU Silicone For iPhone XR XS Max 8 Plus Back Cover Clear Case",
"link": "https://www.aliexpress.us/item/3256807637171608.html",
"price": "US $0.33",
"extracted_price": 0.33,
"original_price": "US $2.95",
"extracted_original_price": 2.95,
"discount": 88,
"rating": 4.9,
"sold": "50,000+ sold",
"extracted_sold": 63427,
"ships_from": "CN",
"delivery": {
"min_days": 7,
"max_days": 12,
"from_date": "2026-11-20",
"to_date": "2026-11-25"
},
"badges": [
"Save $2.62",
"Fastest delivery in 7 days"
],
"sku_id": "12000042335817323",
"category_ids": [
"202192403",
"202228401",
"380230"
],
"listed_date": "2024-09-29",
"thumbnail": "https://ae-pic-a1.aliexpress-media.com/kf/Sba03fd9e2b8d40aea726e1a6bdd0f922i.jpg",
"images": [
"https://ae-pic-a1.aliexpress-media.com/kf/Sba03fd9e2b8d40aea726e1a6bdd0f922i.jpg",
"..."
],
"is_sponsored": false,
"is_choice": true,
"has_free_shipping_badge": false,
"is_new_shopper_price": false
},
"..."
],
"filters": [
{
"name": "Compatible-Phone Models",
"parameter": "attribute_ids",
"options": [
{
"name": "iPhone 15",
"value": "11745-4352280",
"is_selected": false
},
"..."
]
},
"..."
],
"pagination": {
"current": 1,
"next": 2
}
}
White Earbuds, Cheapest First
https://www.searchapi.io/api/v1/search?attribute_ids=3079-4148343&engine=aliexpress_search&q=wireless+earbuds&sort_by=price_low_to_high
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "aliexpress_search",
"q": "wireless earbuds",
"attribute_ids": "3079-4148343",
"sort_by": "price_low_to_high"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_cxn5GmbsyUyXkQUiBGLLj9rO",
"status": "Success",
"created_at": "2026-11-13T12:32:18Z",
"request_time_taken": 2.58,
"parsing_time_taken": 0.02,
"total_time_taken": 2.6,
"request_url": "https://www.aliexpress.com/w/wholesale-wireless-earbuds.html?sortType=price_asc&attr=3079-4148343",
"html_url": "https://www.searchapi.io/api/v1/searches/search_cxn5GmbsyUyXkQUiBGLLj9rO.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_cxn5GmbsyUyXkQUiBGLLj9rO"
},
"search_parameters": {
"engine": "aliexpress_search",
"q": "wireless earbuds",
"sort_by": "price_low_to_high",
"attribute_ids": "3079-4148343"
},
"search_information": {
"total_results": 2370,
"currency": "USD"
},
"organic_results": [
{
"position": 1,
"product_id": "3256812503886599",
"title": "T2 Tws Wireless Bluetooth Headset Transparent Headphones ENC Power Digital Display Stereo Sound Earphones for All Smartphones",
"link": "https://www.aliexpress.us/item/3256812503886599.html",
"price": "US $0.33",
"extracted_price": 0.33,
"discount": 95,
"rating": 3.7,
"sold": "620 sold",
"extracted_sold": 620,
"ships_from": "CN",
"delivery": {
"min_days": 7,
"max_days": 12,
"from_date": "2026-11-20",
"to_date": "2026-11-25"
},
"badges": [
"Fastest delivery in 7 days",
"Save $7.71"
],
"sku_id": "12000059065807500",
"category_ids": [
"44",
"100000306",
"63705"
],
"listed_date": "2026-07-09",
"thumbnail": "https://ae-pic-a1.aliexpress-media.com/kf/Sf52a0006bc6142dc858e9c67f465ca66s.jpg",
"images": [
"https://ae-pic-a1.aliexpress-media.com/kf/Sf52a0006bc6142dc858e9c67f465ca66s.jpg",
"..."
],
"is_sponsored": false,
"is_choice": true,
"has_free_shipping_badge": false,
"is_new_shopper_price": false
},
"..."
],
"filters": [
{
"name": "Main color",
"parameter": "attribute_ids",
"options": [
{
"name": "White",
"value": "3079-4148343",
"is_selected": true
},
"..."
]
},
"..."
]
}
Shipping to Germany in Euros and German
https://www.searchapi.io/api/v1/search?currency=EUR&delivery_country=DE&engine=aliexpress_search&language=de_DE&q=gaming+mouse
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "aliexpress_search",
"q": "gaming mouse",
"delivery_country": "DE",
"currency": "EUR",
"language": "de_DE"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_6lJ8zpkGDZcN4RA5AGFXvgcn",
"status": "Success",
"created_at": "2026-11-13T12:31:20Z",
"request_time_taken": 1.9,
"parsing_time_taken": 0.03,
"total_time_taken": 1.93,
"request_url": "https://www.aliexpress.com/w/wholesale-gaming-mouse.html",
"html_url": "https://www.searchapi.io/api/v1/searches/search_6lJ8zpkGDZcN4RA5AGFXvgcn.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_6lJ8zpkGDZcN4RA5AGFXvgcn"
},
"search_parameters": {
"engine": "aliexpress_search",
"q": "gaming mouse",
"delivery_country": "DE",
"currency": "EUR",
"language": "de_DE"
},
"search_information": {
"total_results": 48601,
"currency": "EUR"
},
"organic_results": [
{
"position": 1,
"product_id": "1005012841955659",
"title": "AJAZZ AJ159 APEX Esports Gaming-Maus, PAW3950, Kabellos 8K, Leichtgewichtig, Tri-Mode, für Kleine bis Mittelgroße Hände, mit Ladefunktion",
"link": "https://de.aliexpress.com/item/1005012841955659.html",
"price": "€ 62,69",
"extracted_price": 62.69,
"discount": 14,
"rating": 4.9,
"sold": "580 verkauft",
"extracted_sold": 580,
"ships_from": "PL",
"delivery": {
"min_days": 2,
"max_days": 7,
"from_date": "2026-11-15",
"to_date": "2026-11-20"
},
"badges": [
"Zustellung: Um Nov 15 - 20",
"Kostenloser Versand",
"Keine Einfuhrkosten",
"2,4 GHz kabellos | Bluetooth | Gaming | Akku",
"Niedrigster Preis seit 30 Tagen: 73,45€",
"10,76€ sparen",
"Toller Preis im letzten Monat"
],
"sku_id": "12000059486359850",
"category_ids": [
"7",
"200001081",
"200001082",
"70805"
],
"listed_date": "2026-07-30",
"thumbnail": "https://ae-pic-a1.aliexpress-media.com/kf/Sc32e8e05b57f4a7cbc9d3bfad7c90cc2h.jpg",
"is_sponsored": false,
"is_choice": false,
"has_free_shipping_badge": true,
"is_new_shopper_price": false
},
"..."
]
}