# Amazon (India) — 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 for products on Amazon India and retrieve detailed information including search suggestions, product details, and bestseller listings. Get instant autocomplete recommendations and access comprehensive product data to compare prices and features across the Indian marketplace.

**Category:** E-commerce | **Website:** [amazon.in/](https://amazon.in/) | **Docs:** [parse.bot/marketplace/bfc89291-39a6-46f5-bc2b-628cfd065151/amazon-in-api](https://parse.bot/marketplace/bfc89291-39a6-46f5-bc2b-628cfd065151/amazon-in-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/amazon-india/`
**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

### Get bestsellers

Retrieve Amazon Bestsellers list for a category. Returns ranked products with title, price, rating, and image. When no category is specified, returns overall bestsellers spanning multiple sub-categories.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category path slug (e.g. 'electronics', 'books'). Empty string for overall bestsellers. |

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

### Get product details

Extract detailed product information from an Amazon.in product page including title, brand, price, features, images, availability, and customer reviews when available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Amazon Standard Identification Number (ASIN) of the product. |

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

### Get product reviews

Extract customer reviews for an Amazon.in product. Returns up to 13 reviews visible on the public product page, optionally sorted by most recent date. Each review includes rating, title, body, author, date, and verified purchase status. The dedicated reviews page requires authentication, so this endpoint extracts all reviews embedded in the public product page (typically 8-13 reviews depending on the product).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Amazon Standard Identification Number (ASIN) of the product. |
| `sort_by` | string | No | Sort order for reviews. Accepts 'recent' (sorted by date, newest first) or 'top' (default Amazon relevance order). |
| `star_filter` | string | No | Filter reviews by star rating. Accepts '1', '2', '3', '4', or '5'. Empty string or omitted returns all ratings. |

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

### Get search suggestions

Get search autocomplete suggestions for a given query prefix on Amazon.in. Returns keyword and widget-type suggestions with metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query prefix to get suggestions for. |

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

### Search products

Search for products by keyword on Amazon.in. Returns paginated results with product summaries including title, price, rating, and image.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword. |

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