# A101 — 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.

> Browse and search products from A101's grocery delivery service (Kapıda) and marketplace (Ekstra), including category exploration and detailed product information. Find what you need across both platforms with search functionality and organized category browsing.

**Category:** E-commerce | **Website:** [a101.com.tr/](https://a101.com.tr/) | **Docs:** [parse.bot/marketplace/66397d30-5b86-4b47-a4d4-ddf2a0ac79ef/a101-com-tr-api](https://parse.bot/marketplace/66397d30-5b86-4b47-a4d4-ddf2a0ac79ef/a101-com-tr-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-a101-com-tr-api-66397d30/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_kapida_categories

Retrieves the full category tree for both A101 Kapıda (grocery delivery) and A101 Ekstra (electronics). Each category includes its ID, display name, subcategories (nested in items), and metadata. Category IDs from this tree are used with get_kapida_category_products to list products.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-a101-com-tr-api-66397d30/get_kapida_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_kapida_category_products

Lists all products in a specific A101 Kapıda grocery category, grouped by subcategory. Each subcategory contains its products with full details including price, stock level, images, and attributes. Use top-level category IDs from get_kapida_categories (e.g. C05 for dairy, C06 for snacks).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Top-level category ID from get_kapida_categories (e.g. 'C05', 'C06', 'C07') |
| `store_id` | string | No | Store location ID determining price and stock availability |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-a101-com-tr-api-66397d30/get_kapida_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","store_id":"<string>"}'
```

### get_kapida_product_detail

Retrieves current price and stock information for a specific A101 Kapıda grocery product by its SKU. Returns the normal and discounted prices (as integers in kuruş and formatted strings) plus stock level and available quantity. Use product IDs obtained from search_kapida_products or get_kapida_category_products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sku` | string | Yes | Product SKU/ID from search or category results (e.g. '12000001', '12000244') |
| `store_id` | string | No | Store location ID determining price and stock availability |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-a101-com-tr-api-66397d30/get_kapida_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sku":"<string>","store_id":"<string>"}'
```

### search_ekstra_products

Full-text search over A101 Ekstra marketplace products (electronics, appliances, clothing, home goods). Returns paginated results with detailed product information including pricing, brand, category hierarchy, images, stock status, and available variants. Query expansion is applied automatically (e.g. 'laptop' expands to include 'dizüstü bilgisayar notebook').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page (accepted values include 10, 20, 60) |
| `page` | integer | No | Page number for pagination |
| `query` | string | Yes | Search term (e.g. 'telefon', 'televizyon', 'laptop') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-a101-com-tr-api-66397d30/search_ekstra_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```

### search_kapida_products

Full-text search over A101 Kapıda grocery products available for home delivery. Returns paginated results with product details including price, availability, images, and promotions. The query is matched against product titles. Results are scoped to a specific store location for accurate pricing and stock.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page (accepted values include 10, 20, 60) |
| `page` | integer | No | Page number for pagination |
| `query` | string | Yes | Search term in Turkish (e.g. 'süt', 'ekmek', 'peynir') |
| `store_id` | string | No | Store location ID determining price and stock availability |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-a101-com-tr-api-66397d30/search_kapida_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>","store_id":"<string>"}'
```