# Alibaba Supplier API Documentation

<p><strong>Alibaba Supplier API Documentation</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/alibaba-api/alibaba_supplier](https://scrappa.co/docs/alibaba-api/alibaba_supplier)
- **API group:** Alibaba API
- **Endpoint:** `GET https://scrappa.co/api/alibaba/supplier`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | No | Company id from search. A numeric id needs the subdomain or url from the same result. |
| `url` | string | No | The supplier_href from a search result, e.g. https://shop.en.alibaba.com/. |
| `subdomain` | string | No | The supplier.subdomain from a search result, e.g. shop. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 503 | Service Unavailable | Alibaba could not be reached. Retry after a short pause. This response is not billable. |
| 404 | Resource Not Found | No public supplier data is available for this storefront. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
