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

ASOS Product API Documentation

GET https://scrappa.co/api/asos/product

ASOS Product API returns one product by product_id 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, materials, care instructions, size and fit, country of manufacture, full size images, video and the rating with its distribution and the share of buyers who recommend it.

Variants: every size is one variant with size, brand size, SKU, colour and its own stock flags: in_stock, low_stock, restocking_soon and the time of the last stock update. Stock is a flag, not a quantity: 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.

Price and stock are read at the time of the request. If you send a URL without store, the store is taken from the URL path (/us/, /de/, /fr/, /au/, 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.

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

Credits: 1 credit per successful request. Failed requests are not billed. A valid empty result is successful and billable.

ASOS Product API Documentation 1 credit/request

Endpoint

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

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

This endpoint has no required query parameters.

3 optional filters available.

product_id integer Optional

Numeric ASOS product id from a search answer, for example 209773375. Send product_id or url.

Example value 1234567890
url string Optional
Open example

ASOS product page URL that contains /prd/ and the id. Send url or product_id.

Example value https://example.com/product
store string Optional

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 value example

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

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": {
        "store": [
            "The store must be one of: COM, US, DE, FR, AU."
        ]
    },
    "message": "The request validation failed"
}
404

Not Found

The product is not sold in this store or does not exist. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": false,
        "endpoint_family": "x"
    },
    "error": {
        "code": "NOT_FOUND",
        "message": "The requested resource was not found."
    },
    "success": false
}
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.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "product"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "ASOS could not be reached. Please retry shortly."
    },
    "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.