# Myntra — 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 Myntra's fashion catalog to find products by category, price, brand, and color with detailed information including specifications, images, and customer reviews. Get sorted results across multiple pages and discover featured collections from the homepage and brand pages.

**Category:** E-commerce | **Website:** [myntra.com/](https://myntra.com/) | **Docs:** [parse.bot/marketplace/c7907340-1a8e-4914-8152-a0802fd7ecb1/myntra-com-api](https://parse.bot/marketplace/c7907340-1a8e-4914-8152-a0802fd7ecb1/myntra-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/myntra/`
**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

### Filter products by brand

Fetch product listings for a category filtered by brand name. Returns same structure as get_category_listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | Yes | Brand name to filter by (e.g. 'Nike', 'Puma', 'H&M'). |
| `category_slug` | string | Yes | Category URL slug (e.g. 'men-tshirts', 'women-dresses'). |

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

### Filter products by color

Fetch product listings for a category filtered by color. Returns same structure as get_category_listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Category URL slug (e.g. 'men-tshirts', 'women-dresses'). |
| `color` | string | Yes | Color name to filter by (e.g. 'Black', 'White', 'Navy Blue', 'Red', 'Blue'). |

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

### Filter products by price

Fetch product listings for a category filtered by price range. Combines category_slug with a price filter. Returns same structure as get_category_listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Category URL slug (e.g. 'men-tshirts', 'women-dresses'). |
| `max_price` | string | Yes | Maximum price value (e.g. '500'). |
| `min_price` | string | Yes | Minimum price value (e.g. '200'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/myntra/filter-products-by-price \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>","max_price":"<string>","min_price":"<string>"}'
```

### Get brand page

Fetch products from a specific brand by searching for the brand name. Returns all product categories for that brand (not limited to one article type).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | Yes | Brand name to search for (e.g. 'Nike', 'Puma', 'Adidas'). |

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

### Get category filters

Extract all available filter options from a category listing page including primary filters (size, color, brand), secondary filters, range filters (price, discount), and nested category filters.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Category URL slug (e.g. 'men-tshirts', 'women-dresses'). |

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

### Get category listings

Fetch product listings for a specific category slug on Myntra. Returns paginated results with filters and sort options. Category slugs correspond to URL paths on the site (e.g. 'men-tshirts' maps to myntra.com/men-tshirts).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Category URL slug (e.g. 'men-tshirts', 'women-dresses', 'men-casual-shoes'). |
| `filters` | string | No | Filter string in format 'key:value' (e.g. 'Color:Black', 'brand:Nike', 'price:200 TO 500'). |
| `page` | integer | No | Page number for pagination. |
| `sort` | string | No | Sort order. Accepted values: popularity, price_asc, price_desc, new, discount, Customer Rating. |

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

### Get homepage banners

Scrape Myntra homepage for layout data including banners, carousels, and promotional content. Returns the page layout tree with banner image URLs and links.

**Estimated cost:** Metered

_No parameters required._

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

### Get multi page listings

Scrape multiple pages of product listings for a category and accumulate all products into a single response. Stops early if hasNextPage is false.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Category URL slug (e.g. 'men-tshirts', 'women-dresses'). |
| `end_page` | integer | No | End page number (inclusive). |
| `start_page` | integer | No | Start page number. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/myntra/get-multi-page-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>","end_page":"<integer>","start_page":"<integer>"}'
```

### Get product details

Get full details for a specific product including pricing, sizes, media, reviews, seller information, and article attributes. Returns the complete PDP (product detail page) data object.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_url` | string | Yes | Product URL path (e.g. 'tshirts/nike/nike-men-tshirt/31418488/buy'). |

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

### Get product images

Extract all image URLs from a product page with resolved dimensions (720x540). Returns images from all albums (default, animatedImage, etc.).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_url` | string | Yes | Product URL path (e.g. 'tshirts/nike/nike-men-tshirt/31418488/buy'). |

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

### Get product reviews

Extract customer reviews and ratings summary from a product page including average rating, rating distribution, and top reviews. Some products may have no reviews.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_url` | string | Yes | Product URL path (e.g. 'tshirts/nike/nike-men-tshirt/31418488/buy'). |

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

### Get product specifications

Extract structured specifications (article attributes) from a product page including fit, fabric, pattern, and care instructions. A lightweight alternative to get_product_details when only specs are needed.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_url` | string | Yes | Product URL path (e.g. 'tshirts/nike/nike-men-tshirt/31418488/buy'). |

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

### Search products

Full-text search over Myntra's product catalog. Returns paginated product listings with available filters, sort options, and SEO metadata. Each page returns ~50 products. Supports combining filters and sort in one call.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `filters` | string | No | Filter string in format 'key:value' (e.g. 'Color:Black', 'brand:Nike', 'price:200 TO 500'). |
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword (e.g. 'tshirts', 'shoes', 'dresses'). |
| `sort` | string | No | Sort order. Accepted values: popularity, price_asc, price_desc, new, discount, Customer Rating. |

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

### Sort products

Fetch product listings for a category sorted by a specific order. Returns same structure as get_category_listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Category URL slug (e.g. 'men-tshirts', 'women-dresses'). |
| `sort` | string | Yes | Sort value. Accepted values: popularity, price_asc, price_desc, new, discount, Customer Rating. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/myntra/sort-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<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.