Alibaba Supplier API Documentation Get the public storefront profile of an Alibaba supplier by the supplier_href or supplier.subdomain returned by search. A numeric company id alone is rejected with 422 because it does not resolve to a storefront. The response has the company name, country, verification and years, main product categories, an average star, a rating score and the on-time delivery rate. The public storefront does not expose priced product rows or review comments. This profile is marked complete=false and a limitations field says what is missing. The response never invents products or reviews. Priced product rows and reviews need a signed MTOP app key and stay a named follow-up. A supplier without public storefront data is not returned. 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
This endpoint has no required query parameters.
3 optional filters available.
string
Optional
Company id from search. A numeric id needs the subdomain or url from the same result.
1234567890
string
Optional
The supplier_href from a search result, e.g. https://shop.en.alibaba.com/.
https://example.com/product
string
Optional
The supplier.subdomain from a search result, e.g. shop.
example
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"url": "https://cnwhtrading.en.alibaba.com/",
"name": "Example Electronics Co.",
"rating": {
"max": 5,
"count": null,
"score": 4.3,
"stars": 120
},
"complete": false,
"feedback": [],
"company_id": "123456789",
"limitations": [
"The public storefront exposes company data, categories and an average rating.",
"It does not expose priced product rows or review comments.",
"Priced products and reviews need an authenticated data source."
],
"country_code": "CN",
"business_type": "Manufacturer",
"gold_supplier": true,
"main_categories": [
"Consumer Electronics"
],
"gold_supplier_years": 5
},
"meta": {
"billable": true,
"endpoint_family": "supplier"
},
"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": {
"id": [
"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
}Resource Not Found
No public supplier data is available for this storefront. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false
},
"error": {
"code": "NOT_FOUND",
"message": "No public supplier data is available for this storefront."
},
"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.