# Olx (Uzbekistan) — 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 product listings on OLX.uz across all categories, with full details including specifications, location, and pricing. Compare prices and product information to identify the best available deals.

**Category:** Marketplaces | **Website:** [olx.uz/](https://olx.uz/) | **Docs:** [parse.bot/marketplace/3146a97f-95e1-4c92-94e5-9ff1bd4dcfab/olx-uz-api](https://parse.bot/marketplace/3146a97f-95e1-4c92-94e5-9ff1bd4dcfab/olx-uz-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/olx-uzbekistan/`
**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

Get a flat list of all enabled category IDs on OLX.uz. Returns numeric IDs without names. Use category_id 80 for laptops.

**Estimated cost:** Metered

_No parameters required._

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

### Get listing details

Get full details for a specific listing by its ID. Returns comprehensive information including description, photos, seller info, location coordinates, and all parameters. When the seller has enabled phone visibility, the real phone number is fetched via the friction challenge flow and returned as a top-level field. Listing IDs have limited validity; expired listings return a stale_input error with kind input_not_found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listing_id` | string | Yes | Numeric listing ID obtained from search_listings results (e.g. '65599811'). Listings expire over time. |

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

### Search listings

Search for listings on OLX.uz. Returns paginated results with price, location, specifications, and deal indicators. Some listings are priced in UYE (conventional units ~USD) and some in UZS (Uzbekistani som). The price filter operates in UZS. Paginates via offset; use limit and offset together for manual page control.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | integer | No | Category ID to search within. Use get_categories endpoint to discover valid IDs. 80 is laptops. |
| `limit` | integer | No | Max results to return per page. |
| `offset` | integer | No | Pagination offset (number of items to skip). |
| `price_max` | integer | No | Maximum price filter in UZS (Uzbekistani som). Typical laptop prices range from 1,000,000 to 15,000,000 UZS. |
| `price_min` | integer | No | Minimum price filter in UZS (Uzbekistani som). |
| `query` | string | No | Search keyword (e.g. 'laptop', 'MacBook', 'Core i5'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/olx-uzbekistan/search-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<integer>","limit":"<integer>","offset":"<integer>","price_max":"<integer>","price_min":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.