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

> Browse and search products across Uzum.uz marketplace categories, view detailed product information with customer reviews, and discover seller profiles and their product listings. Get real-time access to marketplace data including category organization, product details, pricing, and seller ratings all in one place.

**Category:** Marketplaces | **Website:** [uzum.uz/](https://uzum.uz/) | **Docs:** [parse.bot/marketplace/b6da2db8-185b-4806-ae45-2f7554a08363/uzum-uz-api](https://parse.bot/marketplace/b6da2db8-185b-4806-ae45-2f7554a08363/uzum-uz-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/uzum/`
**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 categories

Retrieve the full category tree from the Uzum catalog. Returns all top-level categories with nested children arrays containing subcategories and product counts. Categories are hierarchical - each top-level category has children which may have their own children.

**Estimated cost:** Metered

_No parameters required._

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

### Get category products

Fetch paginated product listings for a specific category via GraphQL. Returns product catalog cards with product ID, title, pricing, rating, and feedback count. Use category IDs from get_categories results. Pagination is offset-based.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Category ID from get_categories results (e.g. '2894' for Mebel, '10020' for Elektronika) |
| `limit` | integer | No | Max results per page |
| `offset` | integer | No | Pagination offset (number of items to skip) |

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

### Get product details

Retrieve detailed product information by product ID via GraphQL. Returns full product data including title, HTML description, category, rating, feedback and order counts, pricing in UZS tiyin, seller info (id, title, rating), photo URLs, SKU list with availability and pricing, and product characteristics.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Product ID from search or category listings (e.g. '2692611') |

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

### Get product reviews

Fetch customer reviews for a product by ID with pagination via GraphQL. Returns feedback entries with rating (1-5), customer name, content text, pros, cons, and publication dates as Unix timestamps in milliseconds. Offset is converted to page internally (page = offset / limit).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of reviews per page |
| `offset` | integer | No | Pagination offset (converted to page internally: page = offset / limit) |
| `product_id` | string | Yes | Product ID |

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

### Get seller info

Fetch detailed seller/shop profile data by seller URL slug. Returns seller profile including numeric ID, title, banner/avatar images, description, rating, review count, order count, registration date (Unix timestamp in ms), and legal info. The seller ID from this response is needed to call get_seller_products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `seller_slug` | string | Yes | Seller URL slug (e.g. 'world', 'uzum-market') |

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

### Get seller products

Fetch paginated product listings for a specific seller by their numeric shop ID via GraphQL. Returns product catalog cards with product ID, title, and pricing. The seller_id is obtained from get_seller_info response field 'id'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results per page |
| `offset` | integer | No | Pagination offset (number of items to skip) |
| `seller_id` | string | Yes | Numeric shop/seller ID obtained from get_seller_info response field 'id' |

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

### Search products

Search for products by keyword via the Uzum GraphQL API. Returns product catalog cards with product ID, title, pricing (min sell and full price in UZS tiyin), rating, feedback count, and photo links. Pagination is offset-based; offset and limit control which slice of results to fetch.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max results per page |
| `offset` | integer | No | Pagination offset (number of items to skip) |
| `query` | string | Yes | Search keyword |

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