OLX Real Estate Scraper

Extracts published real-estate listing data from public OLX country pages. The active runner uses bounded browser-compatible HTTP plus JSON-LD and current listing-card parsing; it does not use login, private APIs, or CAPTCHA bypasses.

Input

• domain: supported OLX country root such as olx.pl, olx.pt, olx.ro, or olx.in.
• propertyType: for-sale, for-rent, land, commercial, or all.
• query and location: optional public search terms.
• priceMin, priceMax, maxListings: optional numeric filters and result limit.
• startUrls: optional HTTPS URLs on the selected OLX domain.
• timeoutMs, maxBytes: request safety limits.
• maxPages, requestDelayMs, maxRequestRetries: bounded pagination and retry controls.
• fixturePath: optional checked-in local QA fixture; it never silently replaces a live request.
• proxyConfiguration: optional standard Apify Proxy settings. Direct requests are the default; enabled runs reuse one valid session ID, and proxy credentials never enter datasets or summaries.

When startUrls is omitted, the actor builds a public search URL from the input terms. Output retains listing identity, title, published price/currency, physical property type, transaction type, numeric measures with their original text, location, photos, seller metadata where public, and stable access metadata. Publication and refresh labels are separated into publishedText/refreshedText and ISO timestamps when the source provides them; unknown negotiability is omitted rather than reported as false. A failed or challenged page produces an olx-diagnostic row instead of silently claiming success.

Local verification

npm ci --ignore-scripts --no-audit --no-fund
npm run check
apify run --purge --input-file .actor/input.json

The checked-in input performs a bounded live request against the current public OLX Poland apartment-sale category. validate-datasets.js validates every local dataset row and checks the OUTPUT summary counts.

Country-specific public routes are implemented for Poland, Ukraine, Portugal, and Romania, with locale-consistent request headers. The Ukraine QA input validates the apartment-sale mode against real OLX.ua records. Output omits redundant raw source payloads.

The result-card parser is merged with richer JSON-LD/embedded evidence by listing ID or URL. This preserves card identity and current price/location while filling structured description, seller, physical property type, dates, attributes, and images when the same public listing exposes them.

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel. Public listing rows retain property attributes and provenance, while access failures are emitted as minimal diagnostics.