# AliExpress Store Benefits API Documentation

<p><strong>AliExpress Store Benefits API Documentation</strong> Get the service badges of one store, such as items as described, communication and shipping speed, each with its score and a flag that shows whether it is above the category average. The response also lists store highlights such as followers and store age, and the seller country. Take seller_id and store_id from the seller block of the product response. An unknown store answers 404. Currency and language follow the market of the request, so they can differ between calls. Failed requests are never charged.</p>

- **Documentation:** [https://scrappa.co/docs/aliexpress-api/aliexpress_store_benefits](https://scrappa.co/docs/aliexpress-api/aliexpress_store_benefits)
- **API group:** AliExpress API
- **Endpoint:** `GET https://scrappa.co/api/aliexpress/store/benefits`

## 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 |
| --- | --- | --- | --- |
| `seller_id` | string | Yes | Seller number of 4 to 20 digits, e.g. 2678280160. Take it from seller.seller_id of the product response. |
| `store_id` | string | Yes | Store number of 4 to 20 digits, e.g. 1103573332. Take it from seller.store_id of the product response. |

## Example response

```json
{
    "data": {
        "badges": [
            {
                "title": "Items as description",
                "value": "5.0",
                "above_category_average": true
            },
            {
                "title": "Communication",
                "value": "4.8",
                "above_category_average": true
            }
        ],
        "store_id": "1103573332",
        "seller_id": "2678280160",
        "highlights": [
            "30.0K followers",
            "2-year old store"
        ],
        "seller_country": "CN"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "store_benefits"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 404 | Resource Not Found | The product or store does not exist. This response is not billable. |
| 503 | Service Unavailable | AliExpress 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)