Skip to content
Scrappa Get API key
Alibaba API 1 credit / request

Alibaba Supplier API Documentation

GET https://scrappa.co/api/alibaba/supplier

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.

Alibaba Supplier API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/alibaba/supplier
Auth header
x-api-key
Cost
1 credit / request
Response preview
200 OK
{
    "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": [
...

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.

id string Optional

Company id from search. A numeric id needs the subdomain or url from the same result.

Example value 1234567890
url string Optional
Open example

The supplier_href from a search result, e.g. https://shop.en.alibaba.com/.

Example value https://example.com/product
subdomain string Optional

The supplier.subdomain from a search result, e.g. shop.

Example value example

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "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.

422

Validation Error

A parameter is missing or invalid. This response is not billable.

{
    "errors": {
        "id": [
            "This value is invalid."
        ]
    },
    "message": "The request validation failed"
}
503

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
}
404

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.