# Alibaba Search API Documentation

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

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

## 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 |
| --- | --- | --- | --- |
| `query` | string | Yes | Search keywords, e.g. wireless headphones. |
| `page` | integer | No | Page number from 1 to 100. Defaults to 1. |
| `category` | string | No | Category id or slug to restrict the search. |
| `min_price` | number | No | Lowest price in the result currency. |
| `max_price` | number | No | Highest price in the result currency. Works alone or with min_price. |
| `min_moq` | integer | No | Lowest minimum order quantity. |
| `max_moq` | integer | No | Highest minimum order quantity. Works alone or with min_moq. |
| `country` | string | No | Two-letter supplier country code, e.g. CN. |
| `verified` | boolean | No | true to keep verified gold suppliers only. |
| `review_score` | number | No | Minimum review score from 0 to 5. |
| `sort` | string | No | default, total_trade_desc, price_asc or price_desc. |

## Example response

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

| 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. |

## 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)
