# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-asos-com-api-1ad9439c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-asos-com-api-1ad9439c/get_brands_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-asos-com-api-1ad9439c/get_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-asos-com-api-1ad9439c/get_men_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-asos-com-api-1ad9439c/get_new_arrivals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-asos-com-api-1ad9439c/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-asos-com-api-1ad9439c/get_product_similar \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-asos-com-api-1ad9439c/get_sale_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-asos-com-api-1ad9439c/get_trending_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-asos-com-api-1ad9439c/get_women_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-asos-com-api-1ad9439c/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","query":"<string>","sort":"<string>"}'
```