Alibaba Search API
The Alibaba Search API returns Alibaba.com products for a search, 48 per page by default and up to 100.
Each product carries its price range with any promotion and discount, the unit price for each order quantity, its minimum order, category, images and certifications, and whether it is an ad,
along with its supplier's country, years on Alibaba, Gold, Verified and Verified PRO badges, rating, response rate and audits.
Filter by supplier country, Verified or Verified PRO suppliers, Trade Assurance, ready to ship, free samples, minimum order, price or the category_id of a product,
get titles and prices in 19 languages and 39 currencies, and page through up to 100 pages.
API Parameters
Search Query
-
- Name
-
q - Required
- Required
- Description
-
Parameter defines the search terms, such as
bluetooth speakeroroffice chair, up to 200 characters.
Localization
-
- Name
-
language - Required
- Optional
- Description
-
Parameter defines the language of product titles and order units. It can be set to
ar,de,en,es,fr,he,hi,id,it,ja,ko,nl,pl,pt,ru,th,tr,viorzh, and defaults toen. Supplier ratings are only returned in English.
-
- Name
-
currency - Required
- Optional
- Description
-
Parameter defines the currency of the prices and price tiers, as a three-letter currency code such as
USD,EUR,GBPorJPY. It can be set toAED,ARS,AUD,BRL,CAD,CHF,CLP,CNY,COP,DKK,EGP,EUR,GBP,HKD,IDR,ILS,INR,JPY,KRW,KZT,MXN,MYR,NGN,NOK,NZD,PHP,PKR,PLN,RUB,SAR,SEK,SGD,THB,TRY,TWD,UAH,USD,VNDorZAR, and defaults toUSD.
Filters
-
- Name
-
category_id - Required
- Optional
- Description
-
Parameter keeps the search within an Alibaba category, given as the
category_idof a product, such as518.
-
- Name
-
supplier_country - Required
- Optional
- Description
-
Parameter keeps only the products of suppliers based in a country, as an ISO 3166-1 alpha-2 country code such as
CN,VNorGB. Each product'ssupplier.country_codeuses the same codes.
-
- Name
-
is_verified_supplier - Required
- Optional
- Description
-
Parameter keeps only the products of Verified suppliers when set to
true.
-
- Name
-
is_verified_pro_supplier - Required
- Optional
- Description
-
Parameter keeps only the products of Verified PRO suppliers when set to
true.
-
- Name
-
has_trade_assurance - Required
- Optional
- Description
-
Parameter keeps only the products covered by Trade Assurance when set to
true.
-
- Name
-
is_ready_to_ship - Required
- Optional
- Description
-
Parameter keeps only the products that are ready to ship when set to
true.
-
- Name
-
has_free_sample - Required
- Optional
- Description
-
Parameter keeps only the products with free samples when set to
true.
-
- Name
-
price_min - Required
- Optional
- Description
-
Parameter defines the lowest starting unit price, in USD whatever the
currency.
-
- Name
-
price_max - Required
- Optional
- Description
-
Parameter defines the highest starting unit price, in USD whatever the
currency. It must be at leastprice_min.
-
- Name
-
moq_min - Required
- Optional
- Description
-
Parameter defines the lowest minimum order quantity.
-
- Name
-
moq_max - Required
- Optional
- Description
-
Parameter defines the highest minimum order quantity, such as
10for products you can order in small amounts. It must be at leastmoq_min.
Engine
-
- Name
-
engine - Required
- Required
- Description
-
Parameter defines an engine that will be used to retrieve real-time data. It must be set to
alibaba_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=alibaba_search&q=bluetooth+speaker
- 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": "alibaba_search",
"q": "bluetooth speaker"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_vjcgEaZzRxLjOvcUZaw1YGGw",
"status": "Success",
"created_at": "2026-11-19T14:57:08Z",
"request_time_taken": 3.43,
"parsing_time_taken": 0.13,
"total_time_taken": 3.55,
"request_url": "https://www.alibaba.com/trade/search?SearchText=bluetooth+speaker",
"html_url": "https://www.searchapi.io/api/v1/searches/search_vjcgEaZzRxLjOvcUZaw1YGGw.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_vjcgEaZzRxLjOvcUZaw1YGGw"
},
"search_parameters": {
"engine": "alibaba_search",
"q": "bluetooth speaker"
},
"organic_results": [
{
"position": 1,
"product_id": "1601764704205",
"title": "Modern Desk Smart Artificial Plant With Flower Pot Usb Use Has Bluetooth, Speakers, White Noise, Lighting",
"link": "https://www.alibaba.com/product-detail/Modern-Desk-Smart-Artificial-Plant-With_1601764704205.html",
"price": "$9.99",
"extracted_price_min": 9.99,
"extracted_price_max": 9.99,
"minimum_order": "1 square centimeter",
"extracted_minimum_order": 1,
"unit": "square centimeter",
"category": "Artificial Plant",
"category_id": "100008969",
"thumbnail": "https://s.alicdn.com/@sc04/kf/H09c779856ce24eeab4ee6977a2b1125fu.png_300x300.png",
"images": [
"https://s.alicdn.com/@sc04/kf/H09c779856ce24eeab4ee6977a2b1125fu.png_300x300.png",
"..."
],
"has_video": true,
"is_sponsored": true,
"supplier": {
"name": "Dongguan Weixuan Household Products Co., Ltd.",
"id": "233949033",
"link": "https://dgwx.en.alibaba.com/company_profile.html",
"country": "China",
"country_code": "CN",
"years_on_platform": 3,
"is_gold_supplier": true,
"is_verified": false,
"is_verified_pro": false,
"has_trade_assurance": true,
"response_rate": "100.0%",
"response_time": "≤1h",
"rating": 4.8,
"reviews": 10,
"ratings": {
"product": 4.9,
"service": 4.8,
"shipping": 4.9
}
}
},
"..."
],
"pagination": {
"current": 1,
"next": 2
}
}
Verified Suppliers Only
https://www.searchapi.io/api/v1/search?engine=alibaba_search&is_verified_supplier=true&q=office+chair
- 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": "alibaba_search",
"q": "office chair",
"is_verified_supplier": "true"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_7UF2R3vTFK356TRdDWir8qFz",
"status": "Success",
"created_at": "2026-11-19T14:57:12Z",
"request_time_taken": 8.86,
"parsing_time_taken": 0.02,
"total_time_taken": 8.88,
"request_url": "https://www.alibaba.com/trade/search?SearchText=office+chair&assessmentCompany=true",
"html_url": "https://www.searchapi.io/api/v1/searches/search_7UF2R3vTFK356TRdDWir8qFz.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_7UF2R3vTFK356TRdDWir8qFz"
},
"search_parameters": {
"engine": "alibaba_search",
"q": "office chair",
"is_verified_supplier": true
},
"organic_results": [
{
"position": 1,
"product_id": "1600460041390",
"title": "Kabel New Design Nylon Base Swivel Executive Mesh Ergonomic Office Chair",
"link": "https://www.alibaba.com/product-detail/Kabel-New-Design-Nylon-Base-Swivel_1600460041390.html?s=p",
"price": "$24.20-26.70",
"extracted_price_min": 24.2,
"extracted_price_max": 26.7,
"price_tiers": [
{
"min_quantity": 40,
"max_quantity": 689,
"price": "$26.70",
"extracted_price": 26.7
},
"..."
],
"minimum_order": "40 pieces",
"extracted_minimum_order": 40,
"unit": "piece",
"category": "Office Chairs",
"category_id": "201715704",
"thumbnail": "https://s.alicdn.com/@sc04/kf/H5c2d9fb496474adb98b16a87ff577e0cd.jpg_300x300.jpg",
"images": [
"https://s.alicdn.com/@sc04/kf/H5c2d9fb496474adb98b16a87ff577e0cd.jpg_300x300.jpg",
"..."
],
"has_video": true,
"is_sponsored": true,
"supplier": {
"name": "Anji Ka Bei Long Furniture Co., Ltd.",
"id": "50059973",
"link": "https://zjenjoy.en.alibaba.com/company_profile.html",
"country": "China",
"country_code": "CN",
"years_on_platform": 21,
"is_gold_supplier": true,
"is_verified": true,
"is_verified_pro": false,
"has_trade_assurance": true,
"response_rate": "100.0%",
"response_time": "≤1h",
"rating": 5.0,
"reviews": 2,
"ratings": {
"product": 5.0,
"service": 5.0,
"shipping": 5.0
}
}
},
"..."
],
"pagination": {
"current": 1,
"next": 2
}
}
Ready to Ship, Order 10 or Fewer
https://www.searchapi.io/api/v1/search?engine=alibaba_search&is_ready_to_ship=true&moq_max=10&q=led+strip+lights
- 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": "alibaba_search",
"q": "led strip lights",
"is_ready_to_ship": "true",
"moq_max": "10"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_s9mpqKyfcgiWsGZG0fAXQfCf",
"status": "Success",
"created_at": "2026-11-19T14:57:21Z",
"request_time_taken": 9.47,
"parsing_time_taken": 0.01,
"total_time_taken": 9.49,
"request_url": "https://www.alibaba.com/trade/search?SearchText=led+strip+lights&moqt=10&productTag=1200000228",
"html_url": "https://www.searchapi.io/api/v1/searches/search_s9mpqKyfcgiWsGZG0fAXQfCf.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_s9mpqKyfcgiWsGZG0fAXQfCf"
},
"search_parameters": {
"engine": "alibaba_search",
"q": "led strip lights",
"moq_max": 10,
"is_ready_to_ship": true
},
"organic_results": [
{
"position": 1,
"product_id": "1601360558725",
"title": "SNOWMAN ARGB Cable Light up LED Strip for PSU Extensions 5V 3 Pin ARGB Sync Compatible with 8-Pin 16-Pin GPU 24pin Motherboard",
"link": "https://www.alibaba.com/product-detail/SNOWMAN-ARGB-Cable-Light-up-LED_1601360558725.html",
"price": "$5.74-6.62",
"extracted_price_min": 5.74,
"extracted_price_max": 6.62,
"price_tiers": [
{
"min_quantity": 1,
"max_quantity": 99,
"price": "$6.62",
"extracted_price": 6.62
},
"..."
],
"minimum_order": "1 piece",
"extracted_minimum_order": 1,
"unit": "piece",
"category": "Other Computer Accessories",
"category_id": "70899",
"thumbnail": "https://s.alicdn.com/@sc04/kf/H45926757b8384450a5e57e63130445acB.jpg_300x300.jpg",
"images": [
"https://s.alicdn.com/@sc04/kf/H45926757b8384450a5e57e63130445acB.jpg_300x300.jpg",
"..."
],
"has_video": true,
"certifications": [
"ROHS",
"CE",
"FCC"
],
"is_sponsored": true,
"supplier": {
"name": "Dongguan Bingman Electronic Technology Co., Ltd.",
"id": "244758013",
"link": "https://bingman.en.alibaba.com/company_profile.html",
"country": "China",
"country_code": "CN",
"years_on_platform": 5,
"is_gold_supplier": true,
"is_verified": true,
"is_verified_pro": false,
"has_trade_assurance": true,
"response_rate": "99.9%",
"rating": 4.7,
"reviews": 180,
"ratings": {
"product": 4.9,
"service": 4.6,
"shipping": 4.6
},
"audits": [
"ISO"
]
}
},
"..."
],
"pagination": {
"current": 1,
"next": 2
}
}
In German and Euros
https://www.searchapi.io/api/v1/search?currency=EUR&engine=alibaba_search&language=de&q=yoga+mat
- 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": "alibaba_search",
"q": "yoga mat",
"language": "de",
"currency": "EUR"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_WYZWFHOgNcbC1mhNz2PXXpMq",
"status": "Success",
"created_at": "2026-11-19T14:57:30Z",
"request_time_taken": 2.86,
"parsing_time_taken": 0.03,
"total_time_taken": 2.89,
"request_url": "https://www.alibaba.com/trade/search?SearchText=yoga+mat",
"html_url": "https://www.searchapi.io/api/v1/searches/search_WYZWFHOgNcbC1mhNz2PXXpMq.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_WYZWFHOgNcbC1mhNz2PXXpMq"
},
"search_parameters": {
"engine": "alibaba_search",
"q": "yoga mat",
"language": "de",
"currency": "EUR"
},
"organic_results": [
{
"position": 1,
"product_id": "1601617846699",
"title": "SHENGDE Großhandel Hochwertige umwelt freundliche faltbare Kinder rutsch feste doppelseitige Reise Fitness Workouts Trendy TPE Yoga Mat",
"link": "https://www.alibaba.com/product-detail/SHENGDE-Wholesale-High-Quality-Eco-Friendly_1601617846699.html",
"price": "2,44-2,68 €",
"extracted_price_min": 2.44,
"extracted_price_max": 2.68,
"price_tiers": [
{
"min_quantity": 300,
"max_quantity": 499,
"price": "2,68 €",
"extracted_price": 2.68
},
"..."
],
"minimum_order": "300 Stück",
"extracted_minimum_order": 300,
"unit": "Stück",
"category": "Yogamatten",
"category_id": "201273273",
"thumbnail": "https://s.alicdn.com/@sc04/kf/H9783cf64e5af453f8bc3c3925cfb28f3I.jpg_300x300.jpg",
"images": [
"https://s.alicdn.com/@sc04/kf/H9783cf64e5af453f8bc3c3925cfb28f3I.jpg_300x300.jpg",
"..."
],
"has_video": true,
"is_sponsored": true,
"supplier": {
"name": "Fuqing Shengde Ruibo Technology Co., Ltd.",
"id": "282993354",
"link": "https://shengdeproduct.en.alibaba.com/de_DE/company_profile.html",
"country": "China",
"country_code": "CN",
"years_on_platform": 3,
"is_gold_supplier": true,
"is_verified": true,
"is_verified_pro": false,
"has_trade_assurance": true,
"response_rate": "95.6%"
}
},
"..."
],
"pagination": {
"current": 1,
"next": 2
}
}