# Sokmarket — 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 Şok Market's product catalog, including real-time pricing, categories, weekly deals, and current campaigns. Get detailed product information, explore items across all categories, and view checkout promotions all in one place.

**Category:** Food & Dining | **Website:** [sokmarket.com.tr/](https://sokmarket.com.tr/) | **Docs:** [parse.bot/marketplace/3b94c30c-d4cf-4787-a588-de2d12da038e/sokmarket-com-tr-api](https://parse.bot/marketplace/3b94c30c-d4cf-4787-a588-de2d12da038e/sokmarket-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-sokmarket-com-tr-api-3b94c30c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_campaigns

List all active promotional campaigns and discount banners. Each campaign includes a title, description, images, and associated SKU IDs. Results are paginated server-side (page info returned in response).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sokmarket-com-tr-api-3b94c30c/get_campaigns \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_category_products

List products within a given category. Category slugs are discovered via get_subcategories. Supports pagination via the page parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `slug` | string | Yes | Category slug from get_subcategories content[*].url (without leading slash). Example slugs: 'icecek-c-20505', 'kahvaltilik-c-890'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sokmarket-com-tr-api-3b94c30c/get_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","slug":"<string>"}'
```

### get_checkout_products

Fetch products from the checkout/impulse buy discounts section (Kasa Arkası Ürünler). Discovers the checkout deals category dynamically and returns the discounted products available.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sokmarket-com-tr-api-3b94c30c/get_checkout_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_product_details

Fetch full details of a specific product including nutritional information, ingredients, dimensions, storage instructions, and HTML description. The slug is the product's URL path from search or category listings (e.g. 'mis-uht-sut-yarim-yagli-1-l-p-5834').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Product slug/path from search_products results[*].path or get_category_products results[*].path (e.g. 'mis-uht-sut-yarim-yagli-1-l-p-5834') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sokmarket-com-tr-api-3b94c30c/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_subcategories

Get the full category listing including promotional categories and their slugs. Use the url field (without leading slash) from results as the slug parameter for get_category_products.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sokmarket-com-tr-api-3b94c30c/get_subcategories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_weekly_deals

Get this week's discounted/featured deals (Haftanın Fırsatları). Discovers the weekly deals page from menu banners and returns the current promotional products.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sokmarket-com-tr-api-3b94c30c/get_weekly_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_products

Full-text search over Şok Market products by keyword. Returns matching products with prices, brand, stock status, and images. Paginates as a single page of results per query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'süt' for milk, 'ekmek' for bread) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sokmarket-com-tr-api-3b94c30c/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```