# N11 — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

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

## 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.paywithlocus.com/api/wrapped/parse-n11-com-api-8ac5f448/get_best_sellers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-n11-com-api-8ac5f448/get_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-n11-com-api-8ac5f448/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-n11-com-api-8ac5f448/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-n11-com-api-8ac5f448/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-n11-com-api-8ac5f448/search_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```