> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ASOS API — Overview

> Search ASOS fashion products, retrieve rich product detail, monitor stock and prices, and browse navigation and search facets across storefronts.

Search ASOS fashion products, retrieve rich product detail, monitor stock and prices, and browse navigation and search facets across storefronts.

Authenticate with `X-API-Key`. Requests use `https://scrapebadger.com/v1/asos`.

## Endpoints

| Endpoint | Request | Credits |
| - | - | -: |
| [Search ASOS products](https://docs.scrapebadger.com/api-reference/endpoint/asos/search.md) | `GET /search` | 5 |
| [Get ASOS product detail](https://docs.scrapebadger.com/api-reference/endpoint/asos/products-product-id.md) | `GET /products/{product_id}` | 10 |
| [Get ASOS stock and price](https://docs.scrapebadger.com/api-reference/endpoint/asos/stock-price.md) | `GET /stock-price` | 10 |
| [Get category navigation](https://docs.scrapebadger.com/api-reference/endpoint/asos/categories.md) | `GET /categories` | 5 |
| [Autocomplete ASOS searches](https://docs.scrapebadger.com/api-reference/endpoint/asos/autocomplete.md) | `GET /autocomplete` | 3 |
| [Get search facets](https://docs.scrapebadger.com/api-reference/endpoint/asos/filters.md) | `GET /filters` | 5 |
| [List ASOS storefronts](https://docs.scrapebadger.com/api-reference/endpoint/asos/markets.md) | `GET /markets` | 0 |

Credits apply to successful requests. Failed requests and empty result sets are not charged.

## Markets

Supported market codes: `uk`, `us`, `au`, `de`, `fr`, `it`, `es`, `nl`, `se`, `dk`, `pl`.

Use the same market and location parameters across search, product and availability requests. Store availability and prices reflect the requested context at collection time.

## Pagination

Follow each endpoint’s pagination fields and retain product IDs to deduplicate results. Search counts and stock can change between calls.

## Get started

[Open the playground](https://scrapebadger.com/dashboard/asos-scraper) or use the [Python and Node.js SDKs](https://docs.scrapebadger.com/sdks.md).

## Search matching and price filters

ASOS uses semantic search and may return approximate or related matches even for terms with no exact matches. The response exposes `search_mode` and ASOS search metadata; do not interpret a nonzero count as an exact keyword match.

Minimum and maximum prices apply to the requested market currency. When you provide only a minimum, the API resolves the current price range before applying the bound. A zero maximum returns only genuinely zero-priced products.

Product currency, country, store and language overrides refresh live stock and prices for that context. Use a supported storefront combination from List Markets.

## Run this asynchronously

Calls on this API can run in the background, so you don't hold a connection open while they work. Add one of these to the call:

| Add | What you get |
| - | - |
| `async=true` | The normal response if the call finishes within 25 s. Otherwise `202` with a `request_id`, which you poll at `GET /v1/requests/{request_id}` for free. |
| `callback_url=https://…` | `202` at once. When the call completes, the result is POSTed to your URL, signed with your webhook secret. |
| `Idempotency-Key: <your id>` header | A resent submit returns the first call instead of running it again. |

```bash theme={null}
curl -s "https://scrapebadger.com/v1/...?your=params&async=true" \
  -H "X-API-Key: $SCRAPEBADGER_API_KEY"
# 202 {"request_id": "…", "status": "running", …}, then:
curl -s "https://scrapebadger.com/v1/requests/REQUEST_ID" \
  -H "X-API-Key: $SCRAPEBADGER_API_KEY"
```

An async call is billed once, when it completes. See [Async requests and webhooks](https://docs.scrapebadger.com/long-running-requests.md) for webhooks, signatures and the SDK helpers.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.