# Myntra — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-myntra-com-api-c7907340/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-myntra-com-api-c7907340/filter_products_by_brand \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-myntra-com-api-c7907340/filter_products_by_color \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-myntra-com-api-c7907340/filter_products_by_price \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-myntra-com-api-c7907340/get_brand_page \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-myntra-com-api-c7907340/get_category_filters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-myntra-com-api-c7907340/get_category_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-myntra-com-api-c7907340/get_homepage_banners \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-myntra-com-api-c7907340/get_multi_page_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-myntra-com-api-c7907340/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-myntra-com-api-c7907340/get_product_images \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-myntra-com-api-c7907340/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-myntra-com-api-c7907340/get_product_specifications \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-myntra-com-api-c7907340/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-myntra-com-api-c7907340/sort_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>","sort":"<string>"}'
```