# N11 — 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 products on n11.com with access to detailed information including specifications, pricing, stock status, and reviews across all categories. Retrieve best-seller listings, autocomplete suggestions, and full product details including installment plans and seller information.

**Category:** Marketplaces | **Website:** [n11.com/](https://n11.com/) | **Docs:** [parse.bot/marketplace/8ac5f448-c4fb-4bc5-9455-016e55bc0847/n11-com-api](https://parse.bot/marketplace/8ac5f448-c4fb-4bc5-9455-016e55bc0847/n11-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/n11/`
**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 best sellers

Retrieve the current best-selling products across the platform. Returns 10 products per page with detailed product info including pricing, seller data, stock, and category. Note: the input page is 1-indexed but the response currentPage is 0-indexed (input page=1 maps to response currentPage=0).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-indexed). |

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

### Get category products

Browse products by deep category slug (2+ path segments). Shallow/top-level category slugs (e.g., 'elektronik') are not supported. Use multi-segment slugs such as 'telefon-ve-aksesuarlari/cep-telefonu'. Returns paginated product listings with the same structure as search.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Deep category URL slug with 2+ path segments (e.g., 'telefon-ve-aksesuarlari/cep-telefonu', 'bilgisayar/dizustu-bilgisayar'). Single-segment top-level slugs are not supported. |
| `page` | integer | No | Page number for pagination (1-indexed). |
| `sort` | string | No | Sorting option for results. |

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

### Get product detail

Retrieve comprehensive product details by product ID. Aggregates data from multiple internal endpoints: product description/specs (HTML), real-time pricing and stock status, installment payment plans, and product recommendations. The category_id parameter can refine pricing accuracy.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | No | Optional numeric category ID as a string for more accurate pricing and stock data (e.g., '1000476'). |
| `product_id` | string | Yes | Numeric product ID as a string (from search or category results, e.g., '732056631'). |

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

### Get product reviews

Retrieve paginated product reviews, star ratings breakdown, and review statistics for a given product. Each review includes content text, star rating, date, masked buyer name, and seller nickname.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-indexed). |
| `page_size` | integer | No | Number of reviews per page (max 100). |
| `product_id` | string | Yes | Numeric product ID as a string to fetch reviews for (e.g., '732056631'). |

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

### Search products

Full-text search across n11.com product listings. Returns paginated results with product items, filter attributes, and pagination metadata. Each item includes id, title, brand, pricing, seller info, stock, and review count. Supports sorting by relevance, price, date, or reviews.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-indexed). |
| `query` | string | Yes | Search keyword (e.g., 'iphone', 'laptop', 'samsung'). |
| `sort` | string | No | Sorting option for results. |

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

### Search suggestions

Get search autocomplete suggestions as the user types. Returns keyword suggestions, category suggestions, and a combined complete list with type indicators (KEYWORD, CATEGORY, BRAND, SELLER, CAMPAIGN).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Partial search query (e.g., 'iph', 'sam', 'laptop'). |

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