# ASOS Product API Documentation

<p><strong>ASOS Product API</strong> returns one product by <code>product_id</code> or by product page URL. The answer holds the name, brand, product code, gender, product type, category path, price (current, previous, RRP, currency, sale flag, discount percent, lowest price of the last 30 days), the description, <strong>materials</strong>, <strong>care instructions</strong>, size and fit, country of manufacture, full size images, video and the rating with its distribution and the share of buyers who recommend it.</p><p><strong>Variants:</strong> every size is one variant with size, brand size, SKU, colour and its own stock flags: <code>in_stock</code>, <code>low_stock</code>, <code>restocking_soon</code> and the time of the last stock update. <strong>Stock is a flag, not a quantity</strong>: ASOS shows in stock, low stock or out of stock. A size that ASOS does not list for the store counts as out of stock.</p><p>Price and stock are read at the time of the request. If you send a URL without <code>store</code>, the store is taken from the URL path (<code>/us/</code>, <code>/de/</code>, <code>/fr/</code>, <code>/au/</code>, no prefix for COM). A URL that belongs to another store than the one you chose returns 422. A product that is not sold in the store returns 404.</p><p><strong>Stores:</strong> COM (UK), US, DE, FR and AU. Prices are numbers in the currency of the store. Product ids are the same across stores, but a product can be sold in one store and not in another.</p><p><strong>Credits:</strong> 1 credit per successful request. Failed requests are not billed. A valid empty result is successful and billable.</p>

- **Documentation:** [https://scrappa.co/docs/asos-api/asos_product](https://scrappa.co/docs/asos-api/asos_product)
- **API group:** ASOS API
- **Endpoint:** `GET https://scrappa.co/api/asos/product`

## 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 |
| --- | --- | --- | --- |
| `product_id` | integer | No | Numeric ASOS product id from a search answer, for example 209773375. Send product_id or url. |
| `url` | string | No | ASOS product page URL that contains /prd/ and the id. Send url or product_id. |
| `store` | string | No | Store: COM (ASOS UK, GBP, default), US (USD), DE (EUR), FR (EUR) or AU (AUD). Product ids, prices and stock are per store. Taken from the url when omitted. |

## Example response

```json
{
    "data": {
        "id": 209773375,
        "url": "https://www.asos.com/prd/209773375",
        "name": "ASOS DESIGN high neck mini dress with gathered hardware trim detail in black",
        "brand": {
            "id": 53,
            "name": "ASOS DESIGN"
        },
        "price": {
            "rrp": null,
            "current": 8.49,
            "currency": "GBP",
            "previous": 34,
            "is_on_sale": true,
            "discount_percent": 75,
            "lowest_price_30d": 8.49
        },
        "store": "COM",
        "gender": "Women",
        "images": [
            {
                "url": "https://images.asos-media.com/products/asos-design-high-neck-mini-dress-with-gathered-hardware-trim-detail-in-black/209773375-1-black",
                "colour": "BLACK",
                "is_primary": true
            },
            {
                "url": "https://images.asos-media.com/products/asos-design-high-neck-mini-dress-with-gathered-hardware-trim-detail-in-black/209773375-2",
                "colour": null,
                "is_primary": false
            }
        ],
        "rating": {
            "count": 23,
            "average": 3.3,
            "distribution": {
                "1": 8,
                "2": 1,
                "3": 1,
                "4": 2,
                "5": 11
            },
            "star_average": 3.5,
            "percent_recommended": 50
        },
        "fit_type": "Regular",
        "in_stock": true,
        "variants": [
            {
                "sku": "152933004",
                "size": "XS - UK 4-6",
                "colour": "BLACK",
                "in_stock": false,
                "low_stock": false,
                "brand_size": "XS",
                "variant_id": 209773399,
                "restocking_soon": false,
                "stock_updated_at": "2026-11-04T13:09:01.172Z"
            },
            {
                "sku": "152933006",
                "size": "S - UK 8-10",
                "colour": "BLACK",
                "in_stock": true,
                "low_stock": true,
                "brand_size": "S",
                "variant_id": 209773387,
                "restocking_soon": false,
                "stock_updated_at": "2026-11-04T13:11:26.337Z"
            },
            {
                "sku": "152933008",
                "size": "M - UK 12-14",
                "colour": "BLACK",
                "in_stock": false,
                "low_stock": false,
                "brand_size": "M",
                "variant_id": 209773395,
                "restocking_soon": false,
                "stock_updated_at": "2026-11-04T12:45:16.685Z"
            },
            {
                "sku": "152933010",
                "size": "L - UK 16-18",
                "colour": "BLACK",
                "in_stock": false,
                "low_stock": false,
                "brand_size": "L",
                "variant_id": 209773391,
                "restocking_soon": false,
                "stock_updated_at": "2026-11-04T13:13:01.099Z"
            }
        ],
        "materials": "Jersey: soft and stretchy knitted fabric\nMain: 94% Viscose, 6% Elastane.",
        "video_url": "https://www.asos-video.com/video/upload/f_auto:video/q_auto/t_medium_product_video/c_fill,w_576/209773375-catwalk?_a=DATAiZiwZAA0",
        "description": "Dresses by ASOS DESIGN\nHigh neck\nFlared sleeves\nSide split\nGold-tone hardware detail\nRegular fit",
        "product_code": "152933001",
        "product_type": "Dresses",
        "size_and_fit": "Model's height: 176cm / 5' 9.5\nModel is wearing: S - UK 8-10",
        "category_path": [
            {
                "id": 1000,
                "url": "https://www.asos.com/women/",
                "name": "Women"
            },
            {
                "id": 8799,
                "url": "https://www.asos.com/women/dresses/cat/?cid=8799",
                "name": "Dresses"
            }
        ],
        "is_selling_fast": true,
        "brand_description": "This is ASOS DESIGN \u2013 your go-to for all the latest trends, no matter who you are, where you\u2019re from and what you\u2019re up to. Exclusive to ASOS, our universal brand is here for you, and comes in all our fit ranges: ASOS Curve, Tall, Petite and Maternity. Created by us, styled by you.",
        "care_instructions": "Machine wash according to instructions on care label",
        "country_of_manufacture": "TR"
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "product"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | The product is not sold in this store or does not exist. This response is not billable. |
| 503 | Upstream Unavailable | ASOS could not be reached or returned data that does not match the request. This response is not billable and is retryable. |

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