APIs / Marketplaces / ASOS

1 credit per call4 endpoints16 datapoints

ASOS API

ASOS API for product search by brand, colour, size and price, sale items, product details, reviews and autocomplete as JSON. 1 credit per successful call.

ASOS
GET/v1/asos/search?query=dress&sort=price_asc&sale_only=true
{
  "success": true,
  "data": {
    "query": "dress",
    "store": "COM",
    "total_results": 11994,
    "pagination": {
      "page": 1,
      "per_page": 72,
      "total_pages": 167,
      "returned": 72
    },
    "items": [
      {
        "id": 208461145,
        "name": "COLLUSION 90s mini long sleeve dress in black",
        "brand": "Collusion",
        "colour": "BLACK",
        "product_code": "145573369",
        "product_type": "Product",
        "price": {
          "current": 3.99,
          "previous": 15.99,
          "currency": "GBP",
          "is_on_sale": true,
          "discount_percent": 75,
          "lowest_price_30d": 3.99
        },
        "url": "https://www.asos.com/collusion/collusion-90s-mini-long-sleeve-dress-in-black/prd/208461145",
        "images": [
          "https://images.asos-media.com/products/collusion-90s-mini-long-sleeve-dress-in-black/208461145-1-black",
          "https://images.asos-media.com/products/collusion-90s-mini-long-sleeve-dress-in-black/208461145-2",
          "https://images.asos-media.com/products/collusion-90s-mini-long-sleeve-dress-in-black/208461145-3"
        ],
        "video_url": "https://www.asos-video.com/video/upload/q_auto/t_legacy_product_video/208461145-catwalk",
        "is_selling_fast": false,
        "is_restocking_soon": false,
        "is_new": false,
        "is_sponsored": false,
        "has_variant_colours": false,
        "has_multiple_prices": false
      },
      {
        "id": 200450391,
        "name": "Brave Soul Plus stories button thru knitted dress",
        "brand": "Brave Soul Plus",
        "colour": "BLACK",
        "product_code": "104064721",
        "product_type": "Product",
        "price": {
          "current": 4,
          "previous": 20,
          "rrp": 42,
          "currency": "GBP",
          "is_on_sale": true,
          "discount_percent": 80,
          "lowest_price_30d": 4
        },
        "url": "https://www.asos.com/brave-soul-plus/brave-soul-plus-stories-button-thru-knitted-dress/prd/200450391",
        "images": [
          "https://images.asos-media.com/products/brave-soul-plus-stories-button-thru-knitted-dress/200450391-1-black",
          "https://images.asos-media.com/products/brave-soul-plus-stories-button-thru-knitted-dress/200450391-2",
          "https://images.asos-media.com/products/brave-soul-plus-stories-button-thru-knitted-dress/200450391-3"
        ],
        "is_selling_fast": false,
        "is_restocking_soon": false,
        "is_new": false,
        "is_sponsored": false,
        "has_variant_colours": false,
        "has_multiple_prices": false
      },
      {
        "id": 205855017,
        "name": "ASOS DESIGN one shoulder ruched side mini dress in black",
        "brand": "ASOS DESIGN",
        "colour": "BLACK",
        "product_code": "133832701",
        "product_type": "Product",
        "price": {
          "current": 4,
          "previous": 18,
          "currency": "GBP",
          "is_on_sale": true,
          "discount_percent": 78,
          "lowest_price_30d": 4
        },
        "url": "https://www.asos.com/asos-design/asos-design-one-shoulder-ruched-side-mini-dress-in-black/prd/205855017",
        "images": [
          "https://images.asos-media.com/products/asos-design-one-shoulder-ruched-side-mini-dress-in-black/205855017-1-black",
          "https://images.asos-media.com/products/asos-design-one-shoulder-ruched-side-mini-dress-in-black/205855017-2",
          "https://images.asos-media.com/products/asos-design-one-shoulder-ruched-side-mini-dress-in-black/205855017-3"
        ],
        "video_url": "https://www.asos-video.com/video/upload/q_auto/t_legacy_product_video/205855017-catwalk",
        "is_selling_fast": false,
        "is_restocking_soon": false,
        "is_new": false,
        "is_sponsored": false,
        "has_variant_colours": false,
        "has_multiple_prices": false
      }
    ],
    "facets": [
      {
        "id": "range",
        "name": "Sale/New Season",
        "values": [
          {
            "id": "new_season",
            "name": "New Season",
            "count": 8484,
            "selected": false
          },
          {
            "id": "sale",
            "name": "Sale",
            "count": 11994,
            "selected": true
          }
        ]
      },
      {
        "id": "freshness_band",
        "name": "New in date",
        "values": [
          {
            "id": "3",
            "name": "Last 7 Days",
            "count": 4,
            "selected": false
          },
          {
            "id": "4",
            "name": "Last 14 Days",
            "count": 10,
            "selected": false
          },
          {
            "id": "5",
            "name": "Last 28 Days",
            "count": 33,
            "selected": false
          }
        ]
      },
      {
        "id": "floor",
        "name": "Gender",
        "values": [
          {
            "id": "1001",
            "name": "Men",
            "count": 6,
            "selected": false
          },
          {
            "id": "1000",
            "name": "Women",
            "count": 11990,
            "selected": false
          },
          {
            "id": "2001",
            "name": "Unisex",
            "count": 2,
            "selected": false
          }
        ]
      }
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_d2396bf39f4143d69837b5d3d44ef8e8",
    "credits_charged": 1,
    "credits_remaining": 1987
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#idintegernamestringbrandstringcolourstringproduct_codestringproduct_typestringpriceobjecturlurlimagesstring[]video_urlurlis_selling_fastbooleanis_restocking_soonbooleanis_newbooleanis_sponsoredbooleanhas_variant_coloursbooleanhas_multiple_pricesboolean
1208461145COLLUSION 90s mini long sleeve dress in blackCollusionBLACK145573369Product{6 fields}https://www.asos.com/collusion/collusion-90s-mini-long-sleeve-dress-in-black/prd/208461145[3 items]https://www.asos-video.com/video/upload/q_auto/t_legacy_product_video/208461145-catwalkfalsefalsefalsefalsefalsefalse
2200450391Brave Soul Plus stories button thru knitted dressBrave Soul PlusBLACK104064721Product{7 fields}https://www.asos.com/brave-soul-plus/brave-soul-plus-stories-button-thru-knitted-dress/prd/200450391[3 items]—falsefalsefalsefalsefalsefalse
3205855017ASOS DESIGN one shoulder ruched side mini dress in blackASOS DESIGNBLACK133832701Product{6 fields}https://www.asos.com/asos-design/asos-design-one-shoulder-ruched-side-mini-dress-in-black/prd/205855017[3 items]https://www.asos-video.com/video/upload/q_auto/t_legacy_product_video/205855017-catwalkfalsefalsefalsefalsefalsefalse

Recorded from our API · 3 items shown · 16 datapoints per itemGET /v1/asos/search?query=dress&sort=price_asc&sale_only=true

16 datapoints

Identity

  • idinteger
  • namestring
  • brandstring
  • product_typestring

Contact

  • urlurl
  • video_urlurl

Reputation

  • imagesstring[]

Price

  • priceobject
  • has_multiple_pricesboolean

Other

  • colourstring
  • product_codestring
  • is_selling_fastboolean
  • is_restocking_soonboolean
  • is_newboolean
  • is_sponsoredboolean
  • has_variant_coloursboolean

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/asos/search?query=dress&sort=price_asc&sale_only=true" \
  -H "X-API-Key: $API_KEY"

ASOS · 4 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/asos/autocomplete
query+1 optional
1 credit
GET/v1/asos/product
none+3 optional
1 credit
GET/v1/asos/reviews
product_id+2 optional
1 credit
GET/v1/asos/search
none+11 optional
1 credit

Overview

About the ASOS API

What you can get

The ASOS API returns ASOS shop data as JSON through 4 endpoints. Each takes a store (COM, US, DE, FR or AU).

  • Search: search takes a query or a category_id, with page, sort (relevance, price_asc, price_desc or newest), brand, colour, size, min_price, max_price and sale_only. autocomplete takes a partial query.
  • Products: product takes a product_id or a product url.
  • Reviews: reviews takes a product_id, with page.

The recorded search for "dress", sorted by price_asc with sale_only=true, returns items, each with id, name, brand, colour, product_code, price (current, previous, currency, is_on_sale, discount_percent and lowest_price_30d), url, images, is_selling_fast, is_restocking_soon, is_new and is_sponsored. It also returns total_results (11994 in that recording), pagination with total_pages, and facets.

How a call works

Search, then look up: GET /v1/asos/search?query=dress&sort=price_asc&sale_only=true with your key in the X-API-Key header. Each result carries an id; product and reviews take it as product_id. Every successful call costs 1 credit; failed calls cost nothing.

MarketplacesJSONRESTMCP

More marketplaces APIs

Use cases

Track prices and markdowns for a product list on ASOS

Use the ASOS API to track prices and markdowns for a product list on ASOS

Compare a product's lowest price in the last 30 days with its current price

Use the ASOS API to compare a product's lowest price in the last 30 days with its current price

Monitor sale items for a brand or category

Use the ASOS API to monitor sale items for a brand or category

Compare prices across the COM, US, DE, FR and AU stores

Use the ASOS API to compare prices across the COM, US, DE, FR and AU stores

FAQ

Questions

How much does the ASOS API cost?

Each successful call costs one credit, and each search page is one call. New accounts get free credits to start, and credit packs bring the price down as you scale.

Can I search only sale items?

Yes. Pass `sale_only=true` to `search`. Each result's `price` includes `is_on_sale`, `previous` and `discount_percent`.

Do I need an ASOS account?

No. You call this ASOS API with your Perceptlayer key in the `X-API-Key` header, with no ASOS login.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Should I build an ASOS scraper instead?

You can, but an ASOS scraper is code you maintain: page changes break it, requests get blocked, and ASOS's terms govern how you collect data. The ASOS API gives you 4 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the ASOS API with 100 free credits

No credit card. Failed calls are never billed.