# AliExpress Store Products API Documentation

<p><strong>AliExpress Store Products API Documentation</strong> Get a window of products of one store: for each product the id, title, web url, image, price, original price, discount percent, rating and sold text or count. The window holds about 20 to 40 products, so complete is false and count shows how many products came back. There is no pagination. Use the search endpoint to find more products. 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_products](https://scrappa.co/docs/aliexpress-api/aliexpress_store_products)
- **API group:** AliExpress API
- **Endpoint:** `GET https://scrappa.co/api/aliexpress/store/products`

## 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": {
        "count": 46,
        "complete": false,
        "products": [
            {
                "url": "https://www.aliexpress.com/item/1005013158592106.html",
                "price": {
                    "amount": 3.59,
                    "currency": "USD",
                    "formatted": "$3.59"
                },
                "title": "Mini USB Galaxy Star Projector Light 360\u00b0 Adjustable Night Light Atmosphere Lights For Bedroom Romantic Night Birthday Party Use",
                "rating": 4.9,
                "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S40cf6406470242b7962cbac63aaa01aeO.png",
                "sold_text": "5,000+ sold",
                "product_id": "1005013158592106",
                "sold_count": 5378,
                "original_price": {
                    "amount": 7.19,
                    "currency": "USD",
                    "formatted": "$7.19"
                },
                "discount_percent": 50
            },
            {
                "url": "https://www.aliexpress.com/item/1005012986748239.html",
                "price": {
                    "amount": 2.95,
                    "currency": "USD",
                    "formatted": "$2.95"
                },
                "title": "Makeup Brush Set Soft Fluffy Professiona Cosmetic Foundation Powder Eyeshadow Kabuki Blending Make Up Brush Beauty Tool Makeup",
                "rating": 4.9,
                "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/S322337184d9c45a1b510bbe7d2a57f2cd.jpg",
                "sold_text": "50,000+ sold",
                "product_id": "1005012986748239",
                "original_price": {
                    "amount": 5.91,
                    "currency": "USD",
                    "formatted": "$5.91"
                },
                "discount_percent": 50
            }
        ],
        "store_id": "1103573332",
        "seller_id": "2678280160"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "store_products"
    },
    "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)