# Ajio — 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 products on Ajio.com to find exactly what you're looking for across categories, brands, new arrivals, and sales, with instant access to pricing, availability, and customer ratings. Discover detailed product information to compare options and make informed shopping decisions.

**Category:** E-commerce | **Website:** [ajio.com/](https://ajio.com/) | **Docs:** [parse.bot/marketplace/92d4fdce-ed63-4ac2-ac8e-1f3ea9bf9a67/ajio-com-api](https://parse.bot/marketplace/92d4fdce-ed63-4ac2-ac8e-1f3ea9bf9a67/ajio-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-ajio-com-api-92d4fdce/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_brand_products

Get products from a specific brand on Ajio.com. Returns paginated brand product listings with facets and sorting. Brand name is case-insensitive and uses the brand slug format.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand_name` | string | Yes | Brand name as used on Ajio (e.g. 'puma', 'nike', 'adidas'). Case-insensitive. |
| `page` | integer | No | Zero-based page number for pagination. |
| `size` | integer | No | Number of results per page (e.g. 5, 10, 45). |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ajio-com-api-92d4fdce/get_brand_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand_name":"<string>","page":"<integer>","size":"<integer>","sort":"<string>"}'
```

### get_category_products

List products in a specific Ajio category by brick code. Returns paginated product listings with facets and sorting. The category_id is passed as a search query to the API.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Ajio category brick code (e.g. '830216013' for Men's Shirts, '830207010' for Men's Sneakers). |
| `page` | integer | No | Zero-based page number for pagination. |
| `size` | integer | No | Number of results per page (e.g. 5, 10, 45). |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ajio-com-api-92d4fdce/get_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","page":"<integer>","size":"<integer>","sort":"<string>"}'
```

### get_new_arrivals

Get newly arrived products on Ajio.com sorted by newest first. Returns paginated product listings filtered by an optional keyword.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Zero-based page number for pagination. |
| `query` | string | No | Search keyword to filter new arrivals (e.g. 'shoes', 'shirts'). Use 'all' for all categories. |
| `size` | integer | No | Number of results per page (e.g. 5, 10, 45). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ajio-com-api-92d4fdce/get_new_arrivals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","size":"<integer>"}'
```

### get_product_detail

Get detailed product information for a specific product on Ajio.com by its option code. Returns full product details including pricing, images, size variants, ratings, promotional offers, and return policy. The option code is obtainable from search_products results[*].url path suffix.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Product option code (e.g. '469544798_black'). Obtainable from search_products results[*].url path after '/p/'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ajio-com-api-92d4fdce/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### get_sale_products

Get products sorted by highest discount on Ajio.com. Returns paginated product listings ordered by discount percentage descending, filtered by an optional keyword.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Zero-based page number for pagination. |
| `query` | string | No | Search keyword to filter sale products (e.g. 'shoes', 'dresses'). Use 'all' for all categories. |
| `size` | integer | No | Number of results per page (e.g. 5, 10, 45). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ajio-com-api-92d4fdce/get_sale_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","size":"<integer>"}'
```

### search_products

Full-text search over all Ajio.com products. Returns paginated product listings with facets and sorting options. Each product includes pricing, images, brand, and discount information. Paginates via zero-based page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Zero-based page number for pagination. |
| `query` | string | Yes | Search keyword (e.g. 'shoes', 'puma', 'running shoes'). |
| `size` | integer | No | Number of results per page (e.g. 5, 10, 45). |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ajio-com-api-92d4fdce/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","size":"<integer>","sort":"<string>"}'
```