# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-olx-pl-api-6a0a3a3c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-olx-pl-api-6a0a3a3c/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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>"}'
```