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

Alibaba Search API Documentation

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

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.

Alibaba Search API Documentation 1 credit / request

Endpoint

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

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.

query string Required

Search keywords, e.g. wireless headphones.

Example value coffee shops
page integer Optional

Page number from 1 to 100. Defaults to 1.

Example value 1
category string Optional

Category id or slug to restrict the search.

Example value example
min_price number Optional

Lowest price in the result currency.

Example value 10
max_price number Optional

Highest price in the result currency. Works alone or with min_price.

Example value 10
min_moq integer Optional

Lowest minimum order quantity.

Example value 10
max_moq integer Optional

Highest minimum order quantity. Works alone or with min_moq.

Example value 10
country string Optional

Two-letter supplier country code, e.g. CN.

Example value US
verified boolean Optional

true to keep verified gold suppliers only.

Example value true
review_score number Optional

Minimum review score from 0 to 5.

Example value 10
sort string Optional

default, total_trade_desc, price_asc or price_desc.

Example value relevance

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": {
        "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.

422

Validation Error

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

{
    "errors": {
        "query": [
            "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
}

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.