# Olx (olx.pl) — 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 for classified listings across OLX Poland by keyword, price range, condition, location, and delivery options to find exactly what you're looking for from individual sellers or businesses. Filter results by seller type and other criteria to narrow down your choices and discover the best deals available.

**Category:** Marketplaces | **Website:** [www.olx.pl/elektronika/komputery/podzespoly-i-czesci/plyty-glowne/warszawa/q-MSI-p%C5%82yta-g%C5%82%C3%B3wna/?search%5Bdist%5D=5&search%5Bphotos%5D=1&search%5Bprivate_business%5D=private&search%5Border%5D=filter_float_price:asc&search%5Bfilter_float_price:from%5D=100&search%5Bfilter_float_price:to%5D=600&search%5Bfilter_enum_state%5D%5B0%5D=used&courier=1](https://www.olx.pl/elektronika/komputery/podzespoly-i-czesci/plyty-glowne/warszawa/q-MSI-p%C5%82yta-g%C5%82%C3%B3wna/?search%5Bdist%5D=5&search%5Bphotos%5D=1&search%5Bprivate_business%5D=private&search%5Border%5D=filter_float_price:asc&search%5Bfilter_float_price:from%5D=100&search%5Bfilter_float_price:to%5D=600&search%5Bfilter_enum_state%5D%5B0%5D=used&courier=1) | **Docs:** [parse.bot/marketplace/6a0a3a3c-61a1-49e1-b46c-e96cac52da9e/olx-pl-api](https://parse.bot/marketplace/6a0a3a3c-61a1-49e1-b46c-e96cac52da9e/olx-pl-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-pl/`
**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

### Search listings

Full-text search across OLX.pl classified ads. Supports filtering by category path, geographic location with radius, price range, item condition, seller type, delivery availability, and photo requirement. Results are paginated with ~40 listings per page and auto-iterated by the SDK. Promoted/featured listings appear at the top of results regardless of sort order.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category path slug (e.g. 'elektronika', 'elektronika/komputery', 'elektronika/komputery/podzespoly-i-czesci/plyty-glowne'). Omit to search all categories. |
| `condition` | string | No | Item condition filter. Comma-separated for multiple values (e.g. 'used,new'). |
| `courier` | boolean | No | When true, return only listings offering delivery from entirety of Poland (courier/shipping). |
| `distance` | string | No | Search radius in km from location (e.g. '5', '10', '25', '50', '75', '100'). Only effective when location is set. |
| `location` | string | No | Location slug — city (e.g. 'warszawa', 'krakow'), region (e.g. 'malopolskie'), or district. Omit to search all of Poland. |
| `page` | integer | No | Page number (1-based). |
| `photos_only` | boolean | No | When true, return only listings that have photos. |
| `price_max` | string | No | Maximum price in PLN (e.g. '600'). |
| `price_min` | string | No | Minimum price in PLN (e.g. '100'). |
| `private_business` | string | No | Filter by seller type. Omit for all sellers. |
| `query` | string | No | Search keywords (e.g. 'MSI płyta główna', 'laptop', 'rower'). |
| `sort` | string | No | Sort order for results. Omit for recommended/default ordering. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/olx-pl/search-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","condition":"<string>","courier":"<boolean>","distance":"<string>","location":"<string>","page":"<integer>","photos_only":"<boolean>","price_max":"<string>","price_min":"<string>","private_business":"<string>","query":"<string>","sort":"<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.