OLX Listings Scraper

OLX Listings Scraper

Extract product listings from OLX marketplaces across Europe. The OLX Listings Scraper collects structured listing data including prices, seller info, photos, location, and category-specific attributes.

Supported countries: Poland (olx.pl), Bulgaria (olx.bg), Romania (olx.ro), Portugal (olx.pt), Ukraine (olx.ua).

✨ Features

• 🌍 Multi-country support: Scrape any of the 5 supported OLX regional markets
• 🔍 Keyword search: Find listings by search query across all categories
• 📂 Category browsing: Fetch listings from specific OLX category IDs
• 📄 Automatic pagination: Follows all result pages up to 1000 results per query
• 📍 Optional GPS coordinates: Enrich listings with latitude/longitude
• 💰 Price & sort filters: Filter by price range and sort by newest, cheapest, or most expensive
• ⚡ Fast: 1000 listings in ~30 seconds

🛠️ How It Works

1. Choose a country – Select one of the 5 supported OLX regional domains
2. Choose a mode – Search by keyword, browse by category ID, or provide URLs directly
3. Set limits – Configure maxItems, price filters, and sort order
4. Run the scraper – Listings are collected and paginated automatically
5. Optional GPS – Enable includeDetails to enrich each listing with GPS coordinates

📥 Input

Parameter	Type	Default	Description
country	string	pl	OLX regional domain: pl, bg, ro, pt, ua
mode	string	search	search (keyword), category (by ID), or urls (direct URLs)
searchQuery	string	—	Keyword to search for (used in search mode)
categoryIds	array	[]	OLX category IDs to scrape (used in category and search modes)
maxItems	integer	100	Maximum listings to return (up to 1000 per query)
includeDetails	boolean	false	Also retrieve GPS coordinates for each listing
sortBy	string	created_at:desc	Sort order: created_at:desc, price:asc, price:desc
priceFrom	integer	—	Minimum price filter in local currency
priceTo	integer	—	Maximum price filter in local currency
startUrls	array	[]	OLX listing URLs to scrape directly (used in urls mode)

📊 Sample Output

{
    "id": 1061972724,
    "url": "https://www.olx.pl/d/oferta/iphone-16-93-kondycja-baterii-CID99-ID19RWCk.html",
    "title": "Iphone 16! 93% kondycja baterii",
    "description": "Witam. Mam na sprzedaż telefon IPhone 16 w kolorze czarnym...",
    "price": 1950,
    "currency": "PLN",
    "negotiable": true,
    "previousPrice": null,
    "condition": "Używane",
    "city": "Katowice",
    "district": "Osiedle Tysiąclecia",
    "region": "Śląskie",
    "lat": 50.27778,
    "lon": 18.98144,
    "categoryId": 2298,
    "sellerId": 776288518,
    "sellerName": "Maciej Szczygieł",
    "sellerType": null,
    "sellerJoined": "2021-02-22",
    "isPromoted": true,
    "photos": [
        "https://ireland.apollo.olxcdn.com:443/v1/files/haxawzyemzul1-PL/image;s=800x600"
    ],
    "params": {
        "state": "Używane",
        "phonemodel": "iPhone 16",
        "builtinmemory_phones": "128GB",
        "coloriphone": "Czarny",
        "sim_options": "Dual SIM (SIM + eSIM)"
    },
    "createdAt": "2026-03-20T10:45:06+01:00",
    "refreshedAt": "2026-03-20T10:47:30+01:00",
    "country": "pl",
    "scrapedAt": "2026-03-25T12:32:37.195Z"
}

💡 Tips

• Category IDs are region-specific — a category ID valid on olx.pl may not exist on olx.bg. Browse the target OLX site and find the category ID in the URL (e.g. /elektronika/ → category ID 99 on olx.pl).
• 1000-result cap — OLX limits any single query to 1000 results. To collect more, use multiple categoryIds or combine a search query with price range filters to subdivide the result set.
• GPS coordinates — latitude and longitude require enabling includeDetails. This increases cost per listing.

💳 Pricing

This actor uses pay-per-event pricing — you are only charged for results delivered, not for compute time.

Event	When charged	Price
product-listing	Each listing scraped (without GPS)	$0.001
item-detail	Each listing scraped with GPS coordinates	$0.002

Examples:

• 1,000 listings without GPS → $1.00
• 1,000 listings with GPS coordinates → $2.00