OLX Poland Scraper — Any Keyword (olx.pl)

Unofficial. This Actor is not affiliated with, authorised by, endorsed by, or in any way officially connected to OLX, Grupa OLX sp. z o.o. or OLX Group. "OLX" is a trademark of its respective owner and is used here only to describe what this tool reads. It reads the same public pages a browser does.

Search OLX.pl, the Polish OLX classifieds site, by any keyword and get every matching listing as a clean row: price in PLN, condition, location, the seller's public profile fields, the ad's structured attributes and whether the placement is paid.

What does it do?

• Any category, any keyword. Laptops, phones, bikes, furniture: one search term per run entry, same output shape for all of them.
• Reads the site's own data, not the screen. Each search page carries the listings as structured data; the Actor parses that, so prices, dates and attributes are exact, never guessed from text.
• Condition and price filters are the site's own. condition sends OLX.pl's filter_enum_state value; minPrice/maxPrice send its price range.
• Keyword guard. OLX.pl search is fuzzy: a laptop page carries chargers, bags, RAM modules and a laptop table. requireKeywordMatch (on by default) drops rows whose title is missing a word of the query. Matching ignores accents except ł: type Łódź, not lodz.
• Promoted placements are labelled, not hidden. isFeatured marks paid placements; excludeFeatured drops them if you want organic results only.
• Zero-result searches return nothing. When nothing matches, olx.pl fills the page with unrelated "last resort" ads; the Actor recognises that page and returns no rows for it.

How to scrape OLX Poland (olx.pl)

1. Put one or more search terms in searchQueries.
2. Optionally narrow with condition, a price range in PLN, or sortBy.
3. Run it. Results land in the dataset.

Input

Field	Type	Meaning
searchQueries	array	One search per term. Required.
condition	string	any | new | used | damaged | refurbished (OLX.pl's Nowe, Używane, Uszkodzone, Odnowione / Poleasingowe). Default any.
minPrice / maxPrice	integer	Optional, in PLN. Left out of the request when empty, never defaulted to 0.
sortBy	string	relevance | priceAsc | priceDesc | newest. Default relevance. newest is by the ad's last refresh, not its creation date; paid promoted listings ignore the sort, so treat it as best-effort ordering.
excludeFeatured	boolean	Drops paid promoted placements. Off by default.
requireKeywordMatch	boolean	Drops items whose title is missing any word of the query. Default on.
maxItems	integer	Cap on rows across all terms. Default 1000.
maxPages	integer	Pages per term. Default 25, which is also OLX.pl's ceiling.
proxyConfiguration	object	Off by default. Turn on only if you see request failures.

{
    "searchQueries": ["macbook pro"],
    "condition": "used",
    "maxPrice": 3000,
    "maxItems": 200
}

Output

One row, verbatim from the laptop run of 2026-10-22 (only the description is shortened):

{
    "id": "978671624",
    "title": "BARDZO SZYBKI Laptop Apple Macbook Pro i5 16GB 512GB SSD",
    "description": "Sprzedam bardzo szybkiego laptopa: [...]",
    "url": "https://www.olx.pl/d/oferta/bardzo-szybki-laptop-apple-macbook-pro-i5-16gb-512gb-ssd-CID99-ID14epcc.html",
    "imageUrl": "https://ireland.apollo.olxcdn.com:443/v1/files/n970h8ym6vg43-PL/image;s=773x552",
    "price": 1299,
    "priceNegotiable": false,
    "currency": "PLN",
    "location": "Warszawa",
    "district": "Mokotów",
    "region": "Mazowieckie",
    "postedAt": "2025-02-01T12:04:49+01:00",
    "refreshedAt": "2026-10-20T23:17:50+02:00",
    "condition": "Używane",
    "attributes": {
        "state": "Używane",
        "screendiagonal_laptops": "13-13,9\"",
        "processorseries_laptops": "Intel Core i5",
        "ramsize_laptops": "16GB",
        "harddisktype_laptops": "SSD",
        "disksize_laptops": "513GB - 999GB"
    },
    "isFeatured": true,
    "isBusiness": false,
    "deliveryAvailable": false,
    "sellerName": "Radek",
    "sellerId": "66929504",
    "sellerCompanyName": null,
    "sellerMemberSince": "2017-05-13T11:09:45+02:00",
    "sellerPhoneAvailable": true,
    "latitude": 52.19282,
    "longitude": 21.03232,
    "locationRadiusKm": 7,
    "matchedKeyword": "laptop"
}

Notes and limits

• 25 pages of 52 ads per search, about 1,300 rows at most (fewer distinct, since promoted cards repeat across pages). That is OLX.pl's own ceiling. Narrow with condition or a price range to see more.
• Seller name, id, member-since date and company name are returned; the phone number is not. It is not part of the search data; the row carries sellerPhoneAvailable (whether the seller published one) and the ad url.
• latitude/longitude are approximate: the centre of the area OLX.pl shows on the ad map, within locationRadiusKm, never an exact address.
• price and condition are null, never 0 or empty, when the ad states neither.
• Shell pages are retried. OLX.pl sometimes answers with a page that carries no listings at all (its listing backend degraded). The Actor detects that shape, retries with a fresh connection, and logs how many it met. A page that still fails after four attempts is skipped and logged; the run continues with the next page.
• A run that returns zero rows fails instead of succeeding with an empty dataset, so a misconfigured search cannot look like an empty market.
• Reads the same public pages a browser does. See the disclaimer at the top.

How much does it cost to scrape OLX Poland (olx.pl)?

Pay-per-event: $0.001 per result saved to the dataset ($1.00 per 1,000 results), plus $0.00005 charged once when the run starts. No subscription. Rows your filters drop are not saved, so they are not charged.

FAQ

Is a proxy required? Off by default. Turn proxyConfiguration on only if you see request failures in the log.

How many listings can one search return? Up to 25 pages of 52 ads, about 1,300 rows, which is OLX.pl's own limit per search.

Does it cover other OLX countries? This Actor is OLX.pl only. OLX Romania and OLX Portugal have their own Actors, below.

More second-hand marketplace scrapers

Actor	What it scrapes
OLX Romania Scraper	OLX Romania (olx.ro) — any category
OLX Portugal Scraper	OLX Portugal (olx.pt) — any category
OLX Brazil Scraper	OLX Brazil (olx.com.br) — any category, structured attributes from the site's own detail chips
Kleinanzeigen Scraper	Kleinanzeigen, Germany — classifieds by keyword
Vinted Spain Scraper	Vinted Spain (vinted.es) — any keyword or category, no proxy required

Privacy & Compliance

This Actor reads only publicly accessible pages and returns the public data they show. It sends no login.