ParseForge Scrapers

OLX International Classifieds Scraper

parseforge/olx-scraper

E-commerceReal estate

Scrapes OLX classified listings from seven countries. Returns each ad as a flat row with title, price, description, location, and seller details.

Run this scraper See the API call
Total users
29
Monthly active
13
Total runs
282
Bookmarked
0
Rating
Not rated yet
Last modified
12 days ago

Overview

ParseForge

OLX International Classifieds Scraper

Scrape OLX classifieds from Poland, Ukraine, Romania, Portugal, Bulgaria, Kazakhstan, and Uzbekistan, up to a million listings per run. Every listing comes with its title, price, location, seller type, and full description. No login or API key. Export to CSV, JSON, Excel, or XML.

OLX is the dominant classifieds platform across Central and Eastern Europe, but its data is spread across seven separate country marketplaces with no unified API. Manually copying listings for market analysis, price monitoring, or lead generation is slow and error-prone. This Actor reads the public listing feeds directly, letting you pull structured data from any OLX country, category, or keyword search in one fixed schema.

Who uses it What they scrape OLX for
Market researchers Track supply, demand, and average prices for a product category across multiple countries.
E-commerce sellers Monitor competitor pricing and inventory levels on OLX to adjust their own listings.
Data analysts Build datasets of second-hand goods prices to feed into economic models or reports.
Lead generation specialists Find private sellers listing high-value items to offer consignment or direct purchase services.

What it does

This Actor collects OLX classified listings by country, category, keyword search, or direct URL, and returns each one as a flat row with its title, price, description, location, and seller details.

  • ๐ŸŒ Seven country marketplaces: scrape OLX in Poland (olx.pl), Ukraine (olx.ua), Romania (olx.ro), Portugal (olx.pt), Bulgaria (olx.bg), Kazakhstan (olx.kz), and Uzbekistan (olx.uz).
  • ๐Ÿ” Keyword and category search: target listings by free-text keyword, a specific OLX category from the full tree, or both together.
  • ๐Ÿ“ Geographic filtering: narrow results to a specific region or city within the chosen country.
  • ๐Ÿ’ฐ Price range filter: set minimum and maximum prices in the local currency to isolate listings within a budget.
  • ๐Ÿท๏ธ Condition and seller type: filter by item condition (new, used, damaged) and seller type (private or business).

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with OLX data

๐Ÿ“Š Monitor second-hand car prices.

A market analyst scrapes all used Audi listings in Poland and Romania weekly to track price depreciation trends and regional differences.

๐Ÿ  Find rental apartments in a specific city.

A relocation service scrapes apartment listings in Warsaw, filtering by the 'Wynajem' category and a max price, to build a curated list for clients.

๐Ÿ“ฑ Track competitor pricing for electronics.

An online electronics reseller scrapes iPhone listings across multiple OLX countries daily to benchmark their own prices against the second-hand market.

๐Ÿถ Identify popular dog breeds for sale.

A pet supply business scrapes the 'Psy' category in Poland to see which breeds are listed most often and at what price points, informing their inventory strategy.

Why choose this scraper

What you get
Consistent schema All listings from all seven countries are returned in one uniform, flat structure.
Full listing text Captures the complete title, description, and all structured attributes of each ad.
Flexible targeting Combine country, category, keyword, region, city, price range, condition, and seller type.
Scalable volume Collect up to a million listings in a single run for large-scale market analysis.

How it compares

No other Store actor targets OLX the same way, so the honest comparison is with the alternatives teams actually weigh.

OLX International Classifieds Scraper Build it in-house By hand
Setup Run it now, zero config Days of engineering None, but hours per pull
When OLX changes Maintained for you You fix it You re-learn the page
Proxies, retries, anti-bot Built in Your problem Browser only
Output Fixed JSON schema, CSV/Excel export Whatever you build Copy-paste
Cost Pay per result Engineering time Analyst hours

Configure the run

Drive the Actor from a country selection, a search URL, or a combination of keyword, category, region, and city, and filters run as each listing is read so only matches reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

{
  "maxItems": 10
}

A larger pull:

{
  "maxItems": 200
}

Pricing

Pay-per-result: $0.018 per result collected. You pay only for the results written to your dataset.

Results collected Approximate cost
100 results $1.80
1,000 results $18.00
10,000 results $180.00

New Apify accounts start with $5 in free credit.

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.

Run it

  1. Create a free Apify account with $5 in credit.
  2. Open the OLX International Classifieds Scraper.
  3. Set your inputs and any filters, then click Start.
  4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to OLX through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/olx-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting no results?

Check that your keyword and category combination is valid for the selected country. A keyword that returns results in Poland might not exist in Ukraine. Try broadening your search by removing the keyword or category filter.

The Actor is returning listings from the wrong country.

The 'Country' field is overridden if you select a 'Category' or 'Region' with a different country code prefix, or if you paste a 'startUrl' from another country. Ensure all your filters are set for the same target country.

Some listings are missing a price or description.

This is normal. Some sellers on OLX list items with a negotiable price or leave the description field blank. The Actor returns whatever data is publicly available on the listing page.

The run is taking a very long time.

A high 'Maximum listings' value combined with a broad search can take time. Reduce the maximum items, or narrow your search with a more specific keyword, category, or price range to speed up the run.

I get an error when using a city name.

The city name must be spelled correctly in the local language (e.g., 'Warszawa' not 'Warsaw'). If the city name is ambiguous, also select the 'Region' to help the Actor resolve the correct location.

FAQ

Question Answer
Which OLX countries does this scraper support? It supports Poland (olx.pl), Ukraine (olx.ua), Romania (olx.ro), Portugal (olx.pt), Bulgaria (olx.bg), Kazakhstan (olx.kz), and Uzbekistan (olx.uz).
Can I scrape a specific OLX category without a keyword? Yes. Leave the search term field empty and select a category from the dropdown. The Actor will return every listing in that category for the chosen country.
How do I scrape listings from a specific city? Use the 'City name' input field. The Actor resolves the city name to the correct OLX city ID automatically. You can combine it with the 'Region' filter for more precision.
What data fields are returned for each listing? Each row includes the title, price, currency, full description, listing URL, publication date, location, seller name, seller type, item condition, and any other attributes visible on the listing page.
Can I filter listings by price? Yes. Set the 'Min Price' and 'Max Price' fields in the input to return only listings within that range, using the local currency of the selected country.
Is it possible to scrape only listings from private sellers? Yes. Set the 'Seller Type' filter to 'Private seller' to exclude business and dealer listings from your results.
How many listings can I scrape in one run? You can set the 'Maximum listings' input to any number up to 1,000,000. The Actor will stop gracefully once it reaches that limit.
Do I need an OLX account or API key to use this? No. The Actor reads the publicly available listing pages, so no login, account, or API key is required.
Can I scrape listings from multiple countries at the same time? A single Actor run targets one country at a time. To scrape multiple countries, run the Actor multiple times with different 'Country' settings, or use multiple tasks.
What output formats are supported? You can export your scraped dataset in CSV, JSON, Excel, or XML format from the Apify platform.

Related actors

Browse the full ParseForge collection for more scrapers.

๐Ÿ†˜ Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.

โš ๏ธ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by OLX Group. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

Input

FieldTypeWhat it doesDefault
startUrl string Optional. Paste any OLX search or category URL (e.g. https://www.olx.pl/elektronika/telefony/q-iphone/). Country, keyword, category, region, city and price are parsed from the URL. The structured filters below override URL values when set. not set
country string (7 options) OLX regional marketplace to scrape. Each country has its own listings, currency and categories. Ignored when a Category, Region or search URL from another country is set. PL
maxItems integer How many listings to collect per run. 10
query string Free-text keyword (e.g. 'iphone', 'apartament', 'BMW e46'). Matches title and description in the chosen country's language. not set
category string (7791 options) Category to scrape, picked from the OLX tree of each market. The country code prefix (e.g. PL, UA) sets which marketplace is used and overrides the Country field above. Leave empty to span every category. not set
region string (170 options) Limit results to one OLX region/province. The country code prefix overrides the Country field. Leave empty for nationwide results. not set
cityName string City to scope the search (e.g. 'Warszawa', 'Kyiv', 'Bucuresti'). Resolved to an OLX city automatically - no IDs to look up. Combine with Region to disambiguate same-named towns. not set
priceMin integer Minimum price in the local currency (PLN, UAH, RON, EUR, BGN, KZT, UZS). not set
priceMax integer Maximum price in the local currency. not set
itemState string (4 options) Filter by listed item condition. any
sellerType string (3 options) Restrict to private individuals or business sellers (dealers, shops). any
sortBy string (4 options) Result ordering. Newest first matches the default OLX sort. created_at:desc

Pricing

from $13.50 per 1,000 results

Charged forWhat it isPrice each
Actor Start Charged once when the run starts. $0.005
Result Item Charged once per listing collected. $0.0135 to $0.018

Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.

API

One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.

POST ยท run and get results
curl -X POST "https://api.apify.com/v2/acts/parseforge~olx-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "helloWorld": 123
  }'

Examples

Input that runs as-is.

input.json
{
  "helloWorld": 123
}

Reviews

No reviews yet. Be the first.

Issues

We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.

Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.

Related scrapers

Run OLX International Classifieds Scraper on Apify All scrapers