# Asos — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse ASOS's fashion catalog to discover products across women's and men's categories, view real-time pricing and stock information, and find trending or sale items. Get detailed product information, explore similar items, and discover new arrivals and brands all in one place.

**Category:** E-commerce | **Website:** [asos.com/](https://asos.com/) | **Docs:** [parse.bot/marketplace/1ad9439c-87a5-440e-9e9e-3bc5418e0c5d/asos-com-api](https://parse.bot/marketplace/1ad9439c-87a5-440e-9e9e-3bc5418e0c5d/asos-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/asos/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get brands list

Retrieve the full list of brands available on ASOS extracted from search facets. Returns brand names with product counts, useful for filtering or discovering the available brand catalog.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/asos/get-brands-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get category products

Browse products in a specific ASOS category by its numeric category ID. Returns paginated product listings with facets. Category IDs are found in the navigation tree (get_women_categories / get_men_categories) or from ASOS URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | ASOS category ID (e.g. '4209' for shoes, '7046' for women's sale). |
| `limit` | integer | No | Max results per page (1-200). |
| `offset` | integer | No | Pagination offset (number of items to skip). |
| `refine` | string | No | Refinement filters as a pipe-separated string of facet selections (e.g. 'brand:53\|base_colour:4'). |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/asos/get-category-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","limit":"<integer>","offset":"<integer>","refine":"<string>","sort":"<string>"}'
```

### Get men categories

Get the full category navigation tree for Men's fashion. Returns a hierarchical structure of categories with links, titles, images, and nested children. Useful for discovering category IDs to pass to get_category_products.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/asos/get-men-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get new arrivals

Retrieve newest clothing items added to ASOS. Delegates to category browsing with new-arrivals category IDs (2623 for women, 27110 for men by default). Returns paginated product listings sorted by freshness.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | No | Override category ID for new arrivals (defaults to 2623 for women, 27110 for men). |
| `gender` | string | No | Gender filter. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/asos/get-new-arrivals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","gender":"<string>"}'
```

### Get product details

Get full details for a specific ASOS product including JSON-LD structured data (name, brand, description, offers, sku), real-time stock/price per variant, and search metadata. Provide either product_id or product_url; at least one is required.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | No | ASOS numeric product ID (e.g. '207206543'). |
| `product_url` | string | No | ASOS product URL, either absolute (https://www.asos.com/<brand>/<name>/prd/<id>) or relative path. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/asos/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>","product_url":"<string>"}'
```

### Get product similar

Get similar or related products (You Might Also Like) for a given product ID. Returns product recommendations based on the source product's attributes and purchase patterns.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max number of recommendations (1-30). |
| `product_id` | string | Yes | ASOS numeric product ID to find similar products for. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/asos/get-product-similar \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","product_id":"<string>"}'
```

### Get sale products

Get products currently on sale or discounted. Uses sale category IDs (7046 for women, 8409 for men). Returns products with marked-down prices showing current and previous pricing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | No | Override category ID for sale section. |
| `gender` | string | No | Gender filter. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/asos/get-sale-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","gender":"<string>"}'
```

### Get trending products

Retrieve trending and selling-fast products. Uses category ID 51137 (Selling Fast) by default. Returns products currently popular on ASOS.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | No | Category ID for trending items (defaults to '51137'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/asos/get-trending-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>"}'
```

### Get women categories

Get the full category navigation tree for Women's fashion. Returns a hierarchical structure of categories with links, titles, images, and nested children. Useful for discovering category IDs to pass to get_category_products.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/asos/get-women-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search products

Full-text search over the ASOS catalog by keyword. Returns paginated product listings with facets for filtering (brand, price range, gender). Paginates via offset; each product includes id, name, price, brandName, colour, imageUrl. Facets describe the available refinement axes for the current query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results per page (1-200). |
| `offset` | integer | No | Pagination offset (number of items to skip). |
| `query` | string | Yes | Search keyword (e.g. 'sneakers', 'black dress'). |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/asos/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","query":"<string>","sort":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.