Alibaba Search API Documentation Search Alibaba.com products by keyword. Each result has the product id, title, web url, price as a number plus currency, minimum order quantity, sold count, supplier with verification, years and the storefront subdomain for the supplier endpoint, rating and review count, full-size images, badges and certifications. Narrow results with category, price range, MOQ, supplier country, verification, rating and sort. Price, MOQ, country, verification and review score are checked on every returned row, so no result breaks them. Review score keeps rows with an unknown score out. Category is an upstream filter. A valid search with no hits returns a successful empty page. Failed requests are never charged.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
10 optional filters available.
string
Required
Search keywords, e.g. wireless headphones.
coffee shops
integer
Optional
Page number from 1 to 100. Defaults to 1.
1
string
Optional
Category id or slug to restrict the search.
example
number
Optional
Lowest price in the result currency.
10
number
Optional
Highest price in the result currency. Works alone or with min_price.
10
integer
Optional
Lowest minimum order quantity.
10
integer
Optional
Highest minimum order quantity. Works alone or with min_moq.
10
string
Optional
Two-letter supplier country code, e.g. CN.
US
boolean
Optional
true to keep verified gold suppliers only.
true
number
Optional
Minimum review score from 0 to 5.
10
string
Optional
default, total_trade_desc, price_asc or price_desc.
relevance
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"page": 1,
"query": "wireless headphones",
"filters": [],
"results": [
{
"moq": 5,
"url": "https://www.alibaba.com/product-detail/x_1000000000001.html",
"price": {
"max": 6.2,
"min": 5.5,
"amount": 5.5,
"currency": "USD",
"formatted": "US $5.50-6.20"
},
"title": "Wireless Bluetooth Headphones",
"badges": [],
"rating": {
"count": 120,
"score": 4.8,
"product": 4.8,
"shipping": 4.7,
"supplier_service": 4.9
},
"moq_unit": "pieces",
"supplier": {
"company_id": "123456789",
"company_name": "Example Electronics Co.",
"country_code": "CN",
"gold_supplier": true,
"gold_supplier_years": 5
},
"product_id": "1000000000001",
"sold_count": 539,
"certifications": []
}
],
"has_more": true,
"page_size": 60,
"total_pages": 100
},
"meta": {
"billable": true,
"endpoint_family": "search"
},
"success": true
}
Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or invalid. This response is not billable.
{
"errors": {
"query": [
"This value is invalid."
]
},
"message": "The request validation failed"
}Service Unavailable
Alibaba could not be reached. Retry after a short pause. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Alibaba is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.