OLX.pl Scraper

Scrape OLX.pl classifieds via internal API. Get full listing data: title, price, location (city/district/region), seller info, condition, photos, dates, delivery status, and coordinates. Supports keyword search, category/location/price filters.

Features

• Keyword search — search for any product or service by keyword
• Category filtering — scrape specific OLX categories (electronics, vehicles, real estate, etc.)
• Location filtering — narrow results to a specific city or region
• Price range filtering — set minimum and maximum price bounds
• Condition filter — filter by new or used items
• Seller type filter — filter by private sellers or businesses
• Sort order — sort by newest, price (ascending/descending), or relevance
• Pagination — automatically follows pagination to collect all results
• Deduplication — automatically skips duplicate listings
• Proxy support — works with Apify Proxy and custom proxy configurations

Input Parameters

Parameter	Type	Default	Description
startUrls	Array	[]	Direct OLX.pl URLs to scrape (search pages, category pages, or listing detail URLs)
keyword	String	-	Search keyword (e.g., "iPhone 15", "mieszkanie")
category	String	-	OLX category path (e.g., "elektronika", "motoryzacja/samochody")
location	String	-	City or region (e.g., "Warszawa", "Krakow")
priceMin	Integer	-	Minimum price in PLN
priceMax	Integer	-	Maximum price in PLN
condition	String	-	Item condition: "new" or "used"
sellerType	String	-	Seller type: "private" or "business"
sortBy	String	created_at:desc	Sort order: newest, oldest, cheapest, most expensive, relevance
maxItems	Integer	100	Maximum listings to scrape (0 = unlimited)
maxConcurrency	Integer	10	Maximum parallel requests
minConcurrency	Integer	1	Minimum parallel requests
maxRequestRetries	Integer	3	Max retries for failed requests
maxRequestsPerMinute	Integer	120	Rate limiting
proxyConfiguration	Object	-	Proxy settings

Input Examples

Search by keyword:

{
    "keyword": "iPhone 15",
    "maxItems": 50
}

Search with filters:

{
    "keyword": "laptop",
    "location": "Warszawa",
    "priceMin": 1000,
    "priceMax": 5000,
    "condition": "used",
    "sortBy": "price:asc",
    "maxItems": 100
}

Scrape a specific category:

{
    "category": "elektronika/telefony",
    "location": "Krakow",
    "sellerType": "private",
    "maxItems": 200
}

Use direct URLs:

{
    "startUrls": [
        "https://www.olx.pl/elektronika/laptopy/",
        "https://www.olx.pl/d/oferta/macbook-pro-16-m3-ID12345.html"
    ]
}

Output Data

Every listing includes full structured data from OLX's API:

Field	Type	Description
id	Number	OLX numeric listing ID
title	String	Listing title
price	Number	Numeric price value
currency	String	Currency code (PLN, EUR, USD)
negotiable	Boolean	Whether price is negotiable
free	Boolean	Whether the item is free
priceText	String	Original price text (e.g., "1 500 zl")
city	String	City name
district	String	District name
region	String	Region/voivodeship
categoryId	Number	OLX category ID
description	String	Full listing description
condition	String	Item condition (new/used/damaged)
sellerName	String	Seller display name
sellerType	String	Seller type (private/business)
sellerSince	String	When the seller joined OLX
images	Array	All image URLs (full resolution)
datePosted	String	ISO timestamp when listed
dateRefreshed	String	ISO timestamp when refreshed
validTo	String	ISO timestamp when listing expires
isPromoted	Boolean	Whether the listing is promoted
deliveryAvailable	Boolean	Whether OLX delivery is available
params	Object	Category-specific parameters (e.g., brand, model, platform)
coordinates	Object	GPS coordinates {lat, lon}
url	String	Direct URL to the listing
scrapedAt	String	ISO timestamp of when the data was scraped

Example Output

{
    "id": 1061281315,
    "title": "iPhone 15 Pro Max 256GB - jak nowy",
    "price": 4500,
    "currency": "PLN",
    "negotiable": true,
    "free": false,
    "priceText": "4 500 zl",
    "city": "Warszawa",
    "district": "Mokotow",
    "region": "Mazowieckie",
    "categoryId": 2272,
    "description": "Sprzedaje iPhone 15 Pro Max 256GB w idealnym stanie...",
    "condition": "used",
    "sellerName": "Jan Kowalski",
    "sellerType": "private",
    "sellerSince": "2019-05-10T12:00:00+02:00",
    "images": [
        "https://ireland.apollo.olxcdn.com/v1/files/abc123/image;s=1080x720",
        "https://ireland.apollo.olxcdn.com/v1/files/def456/image;s=1080x720"
    ],
    "datePosted": "2026-03-17T14:30:00+01:00",
    "dateRefreshed": null,
    "validTo": "2026-04-16T14:30:00+02:00",
    "isPromoted": false,
    "deliveryAvailable": true,
    "url": "https://www.olx.pl/d/oferta/iphone-15-pro-max-256gb-CID2272-IDABC123.html",
    "params": {
        "Stan": "Uzywane",
        "Platforma": "Apple"
    },
    "coordinates": {
        "lat": 52.2297,
        "lon": 21.0122
    },
    "scrapedAt": "2026-03-17T12:00:00.000Z"
}