# Amzn (India) — 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.

> Access data from amzn.in.

**Category:** E-commerce | **Website:** [amzn.in/](https://amzn.in/) | **Docs:** [parse.bot/marketplace/d739bba5-2244-4b9d-87ce-fa669a9e5a62/amzn-in-api](https://parse.bot/marketplace/d739bba5-2244-4b9d-87ce-fa669a9e5a62/amzn-in-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-amzn-in-api-d739bba5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_bestsellers

Retrieve the current best-selling products in a specific Amazon India category. Returns ranked products with title, price, rating, and ASIN. Category is specified as the URL path segment used in Amazon's bestsellers page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category path as used in the bestsellers URL (e.g. 'electronics', 'books', 'kitchen'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-amzn-in-api-d739bba5/get_category_bestsellers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### get_product_details

Retrieve full product details for one ASIN: title, brand, pricing, rating, review count, availability, feature bullet points, and high-resolution image URLs. A separate fetch from search — use an ASIN obtained from search_products or get_category_bestsellers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Amazon Standard Identification Number (e.g. 'B0BS1QCFHX'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-amzn-in-api-d739bba5/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asin":"<string>"}'
```

### get_product_specifications

Extract technical specifications for a product by ASIN. Collects key-value pairs from the product overview table, technical details table, and detail bullets section. Returns an open map of specification names to values.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Amazon Standard Identification Number (e.g. 'B0FBRGKXHG'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-amzn-in-api-d739bba5/get_product_specifications \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asin":"<string>"}'
```

### search_products

Full-text search over Amazon India's product catalog. Returns a paginated list of products matching the query keyword, each with basic info (title, price, rating, ASIN). Pages beyond 1 may be unreliable due to upstream limitations. Each result carries an ASIN usable for detail/spec lookups.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for results. Pages beyond 1 may return errors due to upstream limitations. |
| `query` | string | Yes | Search keyword (e.g. 'headphones', 'laptop under 50000'). |

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