OLX Classifieds Scraper

Search OLX classifieds by keyword and collect offers — title, price, location, seller, photos, and timestamps. Covers Poland, Portugal, Romania, Bulgaria, Ukraine, Kazakhstan, and Uzbekistan. No account or login required.

Why use this actor

• No login needed — public classifieds data.
• Keyword search in any supported country — one or many search terms per run.
• Rich offer data — title, description, price + currency, city/region, seller (private/business), photos, and created/refresh timestamps.
• Optional category/region narrowing — to dig past the per-search limit.
• Stable JSON output — ready for price tracking, lead lists, or market research.

How it works

1. Pick a country and enter one or more search terms.
2. (Optional) add a category ID / region ID to narrow the search.
3. The actor pages through the results and writes one row per offer — JSON, CSV, or Excel.

Use cases

• Price monitoring — track asking prices for a product across a country.
• Lead generation — collect business sellers and their offers.
• Market research — supply, pricing, and locations by category.

Input

{
  "country": "pl",
  "queries": ["iphone"],
  "categoryId": null,
  "regionId": null,
  "maxItemsPerQuery": 0,
  "maxItems": 200,
  "proxyConfiguration": { "useApifyProxy": true }
}

Field	Type	Description
country	string	OLX site: pl, pt, ro, bg, ua, kz, uz.
queries	array	Search terms. Empty = everything (narrow with category/region).
categoryId / regionId	integer	Optional numeric filters to narrow (and go deeper than the per-search cap).
maxItemsPerQuery	integer	Cap per term. 0 = all (OLX paginates the first ~1000 per search).
maxItems	integer	Overall cap. 0 = no limit. Default 200.
proxyConfiguration	object	Proxy recommended for large pulls.

Output

One record per offer:

{
  "_input": "pl:iphone",
  "_scrapedAt": "2026-06-17T18:30:00Z",
  "recordType": "OFFER",
  "id": 1080452670,
  "url": "https://www.olx.pl/d/oferta/iphone-15-black-128gb-...",
  "title": "Iphone 15 black 128gb",
  "description": "...",
  "price": 1999, "currency": "PLN", "negotiable": false,
  "cityName": "Komorniki", "regionName": "Wielkopolskie",
  "createdTime": "2026-06-15T10:00:00+02:00",
  "lastRefreshTime": "2026-06-17T08:00:00+02:00",
  "validToTime": "2026-07-15T10:00:00+02:00",
  "isBusiness": false,
  "contactName": "Jan",
  "offerType": "sell",
  "categoryId": 99,
  "photos": ["https://ireland.apollo.olxcdn.com/.../image;s=800x600"],
  "params": { "state": "used" }
}

Field	Type	Description
id / url	mixed	Offer ID and link.
title / description	string	Listing text.
price / currency / negotiable	mixed	Price details.
cityName / regionName	string	Location.
createdTime / lastRefreshTime / validToTime	string	Timestamps.
isBusiness	boolean	Business vs private seller.
contactName	string	Seller name (when shown).
photos	array	Photo URLs.
params	object	Extra attributes (condition, etc.).

Queries that fail return an _error record, so nothing fails silently.

Notes

• OLX paginates the first ~1000 results per search — use categoryId / regionId (and specific terms) to cover more.
• All supported countries use the same data source.