Search OLX.pl classifieds
olx_search
Search offers on OLX.pl, Poland's largest classifieds site, across every category: flats and houses for rent or sale, cars and parts, phones and electronics, furniture, clothes, jobs, services, free items. Filter by words, category, place (city or district, with a radius) or voivodeship, price range, new/used, private vs business seller, and any category-specific attribute via `filters`. Common category_id values: Nieruchomości 3 (flats for rent 15, flats for sale 14, houses for rent 20, houses for sale 18, rooms 11, plots 709), Motoryzacja 5 (passenger cars 84, motorcycles 81, car parts 82), Elektronika 99 (smartphones 1839, laptops 1199, TVs 1849, game consoles 1604), Dom i Ogród 628 (furniture 565), Moda 87, Dla Dzieci 88, Sport i Hobby 767 (bicycles 461), Zwierzęta 103, Praca 4 (jobs), Usługi 4371, Oddam za darmo 1151 (free items). olx_categories lists the full tree and shows which categories a query's offers fall in. Pass an offer's `id` to olx_offer for the full description, all photos and map location. Fetched live from OLX.pl's public API (typically well under 1 s; a few seconds when it falls back to an unblocker). Result shape: { source, fetchedAt, query, resolved_location, total_count, offset, limit, next_offset, count, offers: [...], note? } — the list key is `offers`; `total_count` counts all matches, but OLX pages through only the first 1000 (pass `next_offset` as `offset` for more). Each offer: { id, url, title, price: { value, currency, negotiable, type, label, per?, previous_value? } | null, salary?, area_m2?, rooms?, params, city, district, region, category_id, category, seller_type, promoted, created_time, refreshed_time, photo, photos_count, description, external_url? }. `price.value` is a number in `currency` (PLN) or null when there is no amount. `price.type`: 'price' = the asking price (`negotiable` when the seller accepts offers; for flat/house rentals the monthly rent), 'arranged' (to be agreed) with value null, 'budget' = the advertiser's budget rather than an asking price, 'free' = giveaway with value 0, 'exchange' = swap with value null — so never read a missing amount as 0 PLN. `per` ('hour' | 'day' | 'night' | 'week' | 'month') marks a rate, e.g. equipment rented at 150 PLN per day — the value is then not a total. `previous_value` appears after a price drop. Jobs carry `salary` { from, to, currency, period, gross } instead of a price. `params` maps each attribute's key to its Polish display label (e.g. { state: 'Używane', m: '44,60 m²', rooms: '2 pokoje' }) — the keys are what `filters` use. `description` is a short excerpt; contact details are never included. An empty match answers count: 0 with a `note` saying why and what to change — a successful result, not an error.
Schema valid · SHA-256 2e5df0f2827a…
View input schema
{
"type": "object",
"properties": {
"query": {
"description": "Search words, matched loosely against titles and descriptions. Polish terms work best ('rower górski', 'kawalerka', 'iphone 13 pro'). Omit to browse a category/place.",
"type": "string",
"minLength": 1
},
"category_id": {
"description": "OLX category id (see the list above or olx_categories), e.g. 15 = flats for rent.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"location": {
"description": "Polish name of a city, town or village, optionally followed by a district: 'Kraków', 'Warszawa Mokotów', 'Gdańsk Wrzeszcz'. English names ('Warsaw') are not recognised; a partial name returns suggestions. Same-name villages: add region to choose.",
"type": "string",
"minLength": 1
},
"region": {
"description": "Voivodeship. Alone: search the whole voivodeship. With location: picks among same-name places.",
"type": "string",
"enum": [
"dolnoslaskie",
"kujawsko-pomorskie",
"lubelskie",
"lubuskie",
"lodzkie",
"malopolskie",
"mazowieckie",
"opolskie",
"podkarpackie",
"podlaskie",
"pomorskie",
"slaskie",
"swietokrzyskie",
"warminsko-mazurskie",
"wielkopolskie",
"zachodniopomorskie"
]
},
"distance_km": {
"description": "Also include offers within this radius of location, in km (OLX offers 2, 5, 10, 15, 30, 50, 75, 100).",
"type": "integer",
"minimum": 0,
"maximum": 200
},
"price_from": {
"description": "Minimum price in PLN (monthly rent for rentals).",
"type": "number",
"minimum": 0
},
"price_to": {
"description": "Maximum price in PLN (monthly rent for rentals).",
"type": "number",
"minimum": 0
},
"condition": {
"description": "Item condition (Stan) — goods categories only (electronics, fashion, home…).",
"type": "string",
"enum": [
"new",
"used"
]
},
"owner_type": {
"description": "'private' = private individuals only; 'business' = companies/agencies only.",
"type": "string",
"enum": [
"private",
"business"
]
},
"sort_by": {
"description": "'relevance', 'newest' (most recently posted or refreshed first), 'price_asc' (cheapest first) or 'price_desc'. Default: OLX's own ordering.",
"type": "string",
"enum": [
"relevance",
"newest",
"price_asc",
"price_desc"
]
},
"filters": {
"description": "Category-specific OLX filters (requires category_id). Keys come from an offer's `params` keys: 'filter_float_<key>:from' / ':to' for numbers, 'filter_enum_<key>' for choices (value or list of option keys). Examples — flats: { 'filter_float_m:from': 40, 'filter_float_m:to': 60, 'filter_enum_rooms': ['two', 'three'], 'filter_enum_furniture': 'yes' }; cars (84): { 'filter_float_year:from': 2018, 'filter_float_milage:to': 100000, 'filter_enum_petrol': 'diesel' }. OLX rejects a key the category does not have.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
]
}
},
"include_promoted": {
"description": "Also return OLX's paid top-ad slots (flagged promoted: true). They repeat across pages and ignore sort_by, so they are left out by default.",
"type": "boolean"
},
"offset": {
"description": "Skip this many results (0–1000; OLX pages through the first 1000 only). Default 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per call, 1–50. Default 20.",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"no_cache": {
"description": "Force a fresh fetch and bypass this server's result cache (5 min). Default false.",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}