By the end of this tutorial you will have a short Python script that searches OLX.pl, the Polish classifieds site, for a product and prints one line per listing: price in PLN, title, town and seller name.
OLX Poland Scraper (reventadata/olx-pl-scraper) is the Apify Actor I built for this. You give it one or more search terms and it returns one row per listing. The run on 2026-11-16, with the input shown below, saved 25 rows. The sample rows in this post are the first 10 of them, copied without changes.
Everything here runs from Python with the Apify API client. You write no scraping code yourself.
Prerequisites
You need three things:
- Python 3.11 or newer, because the Apify client for Python requires it.
- A free Apify account. You can sign up with an email address or a GitHub login.
- Your Apify API token.
Install the client and export the token in the terminal you will run the script from:
pip install -U "apify-client~=3.0"
export APIFY_API_TOKEN="your_apify_token_here"
Nothing else is needed on your side. The Actor does the reading of the site.
What you'll achieve
You will search OLX.pl for used iPhone 13 listings priced between 800 and 2000 PLN, read the rows in Python and print one line per listing.
In the sample, all 10 rows match the search term iphone 13. Their prices run from 800 PLN to 1599 PLN, and every ad is marked used. Three of the 10 are promoted placements, which the row labels with isFeatured.
Along the way you will also see which fields are always filled in a sample and which can be empty, so you know what to check before you build on the data.
The same script works for a buyer comparing asking prices across towns, or for someone following one model across regions. Only the input changes.
Step 1: Open OLX Poland Scraper
Open the OLX Poland Scraper page on Apify Store. This tutorial calls the Actor from Python, so the only name you need is reventadata/olx-pl-scraper.
Step 2: Choose the search
The search is described by a few input fields:
-
searchQueries: a list of search terms, one search per term. Required, with no default. -
condition:any,new,used,damagedorrefurbished. These map to OLX.pl's own condition filter, labelled Nowe, Używane, Uszkodzone and Odnowione / Poleasingowe. Any other value is refused before the run starts. -
minPriceandmaxPrice: whole PLN. When left out, no price filter is sent. -
maxItems: the cap on rows across all search terms. Default 1000. -
maxPages: pages per search term, up to 25. OLX.pl serves at most 25 pages for one search. -
sortBy,excludeFeaturedandrequireKeywordMatch: covered under Pro tips.
This is the input the sample run used. The caps are small so that the test stays small:
{
"searchQueries": ["iphone 13"],
"condition": "used",
"minPrice": 800,
"maxPrice": 2000,
"maxItems": 25,
"maxPages": 2
}
Step 3: Run it from Python
This script starts the Actor, waits for it to finish, reads the run's dataset and prints one line per listing:
import os
from apify_client import ApifyClient
# 1. Initialise the client with your token from the environment
client = ApifyClient(os.environ["APIFY_API_TOKEN"])
# 2. Describe the search: used iPhone 13 listings from 800 to 2000 PLN
run_input = {
"searchQueries": ["iphone 13"],
"condition": "used",
"minPrice": 800,
"maxPrice": 2000,
"maxItems": 25,
"maxPages": 2,
}
# 3. Start the Actor and wait for it to finish
run = client.actor("reventadata/olx-pl-scraper").call(run_input=run_input)
if run is None or run.status != "SUCCEEDED":
status = run.status if run else "unknown"
raise SystemExit(f"Run did not succeed (status: {status}).")
# 4. Read the rows from the run's default dataset
items = client.dataset(run.default_dataset_id).list_items().items
print(f"Retrieved {len(items)} listings.\n")
# 5. Print one line per listing: price, title, town and seller
for item in items:
print(f"{item.get('price')} PLN | {item.get('title')} | {item.get('location')} | {item.get('sellerName')}")
The script stops with a message when the run does not end as SUCCEEDED.
Step 4: Read the output
Each row is one listing. This is one row from the sample, unchanged. It is the cheapest listing in the sample, at 800 PLN:
{
"id": "1111857802",
"title": "Niebieski Iphone 13 128gb 100% baterii",
"description": "Niebieski iPhone 13 z pamięcią 128 GB.\n\nKondycja baterii wynosi 100%, zostala wymieniona\n\nWyswietlacz w idealnym stanie, delikatne ryski na bokach ekranu\n\nTelefon w pelni sprawny, wylogowany z icloud, gotowy do konfiguracji dla nowego właściciela.\n\nDorzucam kabel i etui, nie mam pudelka",
"url": "https://www.olx.pl/d/oferta/niebieski-iphone-13-128gb-100-baterii-CID99-ID1dff0m.html",
"imageUrl": "https://ireland.apollo.olxcdn.com:443/v1/files/enng0gyphwmt3-PL/image;s=750x1000",
"price": 800,
"priceNegotiable": true,
"currency": "PLN",
"location": "Lublin",
"district": null,
"region": "Lubelskie",
"postedAt": "2026-11-13T11:09:21+01:00",
"refreshedAt": "2026-11-13T11:09:24+01:00",
"condition": "Używane",
"attributes": {
"state": "Używane",
"phonemodel": "iPhone 13",
"builtinmemory_phones": "128GB",
"coloriphone": "Niebieski",
"phonecharger": "Tak"
},
"isFeatured": false,
"isBusiness": false,
"deliveryAvailable": false,
"sellerName": "Karol",
"sellerId": "282134223",
"sellerCompanyName": null,
"sellerMemberSince": "2018-08-25T14:24:42+02:00",
"sellerPhoneAvailable": false,
"latitude": 51.23955,
"longitude": 22.55257,
"locationRadiusKm": 6,
"matchedKeyword": "iphone 13"
}
Every row has the same keys. Some values are empty for some ads, and the next section says which.
Understanding your results
-
priceis the asking price in PLN. It isnullwhen the ad states no price, never 0. Every row in this sample has a price. -
priceNegotiableistruewhen the ad marks its price as negotiable. Four of the 10 rows are. -
conditionis the site's own value. It isUżywaneon all 10 rows.attributesholds the ad's structured fields, such asphonemodelandbuiltinmemory_phones, which are present on all 10 rows. -
location,districtandregioncome from the ad. In this sampledistrictis empty on 4 of the 10 rows. -
latitude,longitudeandlocationRadiusKmdescribe the site's approximate position for the ad. They are not an exact address. -
isFeaturedmarks a paid promoted placement.isBusinessmarks a business account.deliveryAvailablemarks an ad that offers OLX delivery. -
sellerName,sellerId,sellerCompanyNameandsellerMemberSinceare the seller's public profile fields.sellerCompanyNameis empty on 9 of the 10 rows. -
sellerPhoneAvailablesays whether the seller published a phone number. The number itself is not in the row. Seven of the 10 rows saytrue.
Pro tips
-
Keep the test small. A
maxPagesof 1 and a smallmaxItemsshow the output shape quickly. The sample run took 6.6 seconds. -
Narrow with the filters. OLX.pl serves at most 25 pages per search. For a broad term,
condition,minPriceandmaxPricehelp you see a different slice of the listings. -
Keep the keyword guard on.
requireKeywordMatchis on by default. It drops a listing whose title is missing any word of the search term, because OLX.pl's own search is loose: a search forlaptopalso returns chargers and bags. -
Use
excludeFeaturedfor organic results only. It drops the listings the site marks as promoted. By default they are kept and labelled withisFeatured. -
Do not treat
sortByas exact. Promoted placements are interspersed regardless of sort order, sopriceAsc,priceDescandnewestare best-effort. - A listing appears once per run. When two search terms return the same ad, the row is pushed once.
Troubleshooting
-
A value is refused before the run starts.
conditionaccepts only the five values above. Any other value stops the run before it starts. -
The run ends
SUCCEEDEDwith no rows. OLX.pl answered and nothing matched. The run's status message says so. Check the spelling of the search term. -
The run ends
FAILED. The run saves no rows and a page could not be read. Run it again later.proxyConfigurationis off by default, and the input description says to turn it on only when you see request failures. -
Where to look. The run's log and status message, and the
statusvalue your script prints.
Next steps
Save the rows to a file and run the same script again later to compare prices from one day to the next.
For current pricing and details, see the Store page.
What are you planning to search for on OLX.pl? Drop a comment! 💬
About the author: reventadata builds and publishes data extraction Actors on the Apify Store.
Top comments (0)