# Otodom Scraper: Otomoto, OLX, Imovirtual and Storia Listings (`themineworks/otodom-scraper`) Actor

Scrape Otodom, Otomoto, OLX (PL, PT, RO, BG, UA), Imovirtual, Standvirtual, Storia and Autovit: one row per listing with price, area or mileage, rooms, year, location, seller type and agency or dealer. Paste search links or pick a place. No login.

- **URL**: https://apify.com/themineworks/otodom-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Real estate, E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.08 / 1,000 listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Otodom Scraper: Otomoto, OLX, Imovirtual and Storia Listings

[![50 Otodom listings with price, area, price per m2 and agency in 3 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/otodom-scraper-hero.png)](https://console.apify.com/actors/OCBsgr7IxTPPh8QDY/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

Returns property, car and classified listings from 11 OLX Group sites in Poland, Portugal, Romania, Bulgaria and Ukraine: Otodom, Otomoto, OLX, Imovirtual, Standvirtual, Storia and Autovit. One row per listing with price, area or mileage, rooms or year, location, seller type and the agency or dealer. No login, no cookies, no API key. You pay $1.80 per 1,000 listings on the Free plan and $1.08 per 1,000 on the Gold plan, plus a $0.001 start fee per run.

From **The Mine Works**, with over 335,000 runs across 330+ public actors.

Updated 12 Nov 2026: first release. Eleven sites in one actor, place names or pasted search links, property, car and OLX filters, and optional listing details (GPS, description, build year, heating, condition) on the property sites. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **Eleven sites, one schema.** Otodom, Imovirtual and Storia property; Otomoto, Standvirtual and Autovit vehicles; OLX in Poland, Portugal, Romania, Bulgaria and Ukraine. `price`, `currency`, `area_m2`, `mileage_km`, `year`, `city`, `seller_type` and `agency_name` or `dealer_name` sit in the same columns whatever the site, so one sheet or one pipeline covers six countries.
- **Agency and dealer in every row they apply to.** Agency name, id and page on the property sites, dealer name and dealer page on the car sites, company name of business sellers on OLX. In our tests 238 of 300 Otodom rentals in Kraków and 34 of 40 Otomoto BMW listings carried a named agency or dealer.
- **Price per m2 and monthly charges.** Otodom rows carry `price_per_m2` and the monthly service charge (`monthly_charges`, the czynsz) straight from the search page; new developments come back with unit count, area range and expected handover.
- **Details when you need them, at the same price.** `includeDetails` adds GPS, the full description, market, build year, building type and material, floors, condition, ownership, heating, windows, amenities and the date the place is free. In our test 150 of 150 Gdansk houses came back with GPS.
- **Pay per listing, nothing for errors.** Links from other sites, places a site does not know, duplicates found by two searches and the summary row are never charged.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/OCBsgr7IxTPPh8QDY/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Part of The Mine Works Real estate family:** [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [99acres Scraper](https://apify.com/themineworks/99acres-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [MagicBricks Scraper](https://apify.com/themineworks/magicbricks-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns the first 50 flats for sale in Warsaw on Otodom. It took 3 seconds in our test run on Apify:

```json
{
  "site": "otodom.pl",
  "locations": ["Warszawa"],
  "maxItems": 50
}
```

Put several places on separate lines to run several searches at once, or paste search links from any of the 11 sites into `startUrls`, with every filter you set on the site. A listing that two of your searches find is delivered once.

Apify's free plan includes $5 of credit every month, which covers about 2,700 listings at this actor's price.

#### Copy to your AI assistant

```text
themineworks/otodom-scraper on Apify. Reads listings from Otodom, Otomoto, OLX (pl, pt, ro, bg, ua), Imovirtual, Standvirtual, Storia and Autovit and returns one flat row per listing, no login. Call ApifyClient("TOKEN").actor("themineworks/otodom-scraper").call(run_input={"site": "otodom.pl", "locations": ["Warszawa"], "maxItems": 100}), then client.dataset(run["defaultDatasetId"]).list_items().items. Either give startUrls (search result links from any of the 11 sites, each link names its own site) or site (otodom.pl, otomoto.pl, olx.pl, imovirtual.com, standvirtual.com, olx.pt, storia.ro, autovit.ro, olx.ro, olx.bg, olx.ua) plus locations (place names, each one search; empty = whole country). Optional: maxItems (default 100, 1 to 10000, per search; OLX serves 1000 per search), sort (default, newest, price_low, price_high). Property sites: transaction (sale, rent), propertyType (flat, house, plot, commercial, room, garage, warehouse, investment), areaMin, areaMax, rooms (list of numbers), ownerType (all, private, agency), market (all, primary, secondary), daysSinceCreated, includeDetails (default false). Car sites: vehicleType (cars, motorcycles, vans), make, model, yearFrom, yearTo, mileageMax, radiusKm. OLX: keyword. All: priceMin, priceMax in the site currency. Listing rows have no _type field and carry site, listing_type, listing_id, url, title, description, short_description, transaction, property_type, category_id, price, currency, price_text, price_hidden, price_negotiable, previous_price, price_is_gross, price_evaluation, price_drop_percent, price_per_m2, price_from_per_m2, units_count, units_area_from_m2, units_area_to_m2, units_rooms_from, units_rooms_to, construction_state, delivery_date, monthly_charges, area_m2, plot_area_m2, rooms, rooms_text, floor, floor_text, make, model, version, year, mileage_km, fuel_type, gearbox, engine_capacity_cm3, engine_power, engine_power_text, country_of_origin, offer_type, attributes, street, city, district, neighbourhood, region, location_text, latitude, longitude, location_is_approximate, seller_type, agency_name, agency_id, agency_url, agency_address, dealer_name, dealer_id, dealer_url, seller_id, seller_since, development_name, development_url, is_promoted, is_exclusive, badges, features, amenities, market, build_year, building_type, building_material, building_floors, condition, ownership, heating, windows, available_from, deposit, reference_id, details_scraped, image_urls, image_count, created_at, updated_at, bumped_at, valid_until, search, page, position, scraped_at. Each run also writes one row with _type "summary", one with _type "info" when listings were delivered, and a row with _type "error" for each input that could not be read; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~otodom-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme.
```

### Key features

- **Place names or links.** Type a city the way the site spells it (Warszawa, Kraków, Lisboa, Porto, Cluj-Napoca, Sofiya or София, Kiev). The actor finds the site's own location for it. Or paste any search link from the 11 sites, with all its filters.
- **Property filters.** Sale or rent, flat, house, plot, commercial, room, garage, warehouse or new development, area, rooms, price, private owners or agencies, primary or secondary market, listed in the last N days.
- **Vehicle filters.** Cars, motorcycles or vans, make, model, year range, mileage, price, and a distance around a place.
- **OLX keyword search.** Any words, in any category, limited to a place if you want. Every OLX parameter (brand, condition, size, floor and so on) comes back in `attributes`.
- **Four sort orders.** The site's own order, newest first, cheapest first or dearest first.
- **Page after page.** 72 listings a page on the property sites, 32 on the car sites, 50 on OLX, until your `maxItems` or the end of the results.
- **Stops cleanly.** A refused request is retried on another route; six failed requests in a row end the run; the run stops before its time limit and keeps every row. The summary row says why it stopped.

### How to use it

#### Flats for rent in Kraków, newest first, with details

```json
{
  "site": "otodom.pl",
  "locations": ["Kraków"],
  "transaction": "rent",
  "sort": "newest",
  "maxItems": 300,
  "includeDetails": true
}
```

#### Used cars for valuation

```json
{
  "site": "otomoto.pl",
  "make": "Toyota",
  "model": "Corolla",
  "yearFrom": 2018,
  "priceMax": 80000,
  "maxItems": 500
}
```

#### Every site at once from your own search links

```json
{
  "startUrls": [
    "https://www.otodom.pl/pl/wyniki/wynajem/mieszkanie/malopolskie/krakow/krakow/krakow?priceMax=4000",
    "https://www.standvirtual.com/carros/bmw/lisboa",
    "https://www.storia.ro/ro/rezultate/vanzare/apartament/bucuresti",
    "https://www.olx.pl/nieruchomosci/mieszkania/wynajem/gdansk/"
  ],
  "maxItems": 200
}
```

#### Agency leads: who lists houses for sale in Porto

```json
{
  "site": "imovirtual.com",
  "locations": ["Porto"],
  "propertyType": "house",
  "ownerType": "agency",
  "maxItems": 1000
}
```

#### Resale prices on OLX Romania

```json
{
  "site": "olx.ro",
  "locations": ["Cluj-Napoca"],
  "keyword": "iphone 15",
  "maxItems": 200
}
```

### Input parameters

| Field | Type | Default | What it does |
|---|---|---|---|
| `site` | choice | otodom.pl | Which site the fields below search. Not used for links. |
| `locations` | list of text | | Places, one search each. Empty = the whole country. |
| `startUrls` | list of text | | Search links from any of the 11 sites. When given, `site`, `locations` and the filters are not used. |
| `maxItems` | number | 100 | Most listings per place or link, 1 to 10,000. |
| `sort` | choice | default | default, newest, price_low, price_high. |
| `transaction` | choice | sale | Property sites: sale or rent. |
| `propertyType` | choice | flat | flat, house, plot, commercial, room, garage, warehouse, investment. |
| `areaMin` / `areaMax` | number | | Floor area in m2. |
| `rooms` | list of numbers | | Room counts, for example 2 and 3. |
| `ownerType` | choice | all | all, private, agency. |
| `market` | choice | all | all, primary, secondary. |
| `daysSinceCreated` | number | | Listed in the last 1, 3, 7, 14 or 30 days. |
| `includeDetails` | true/false | false | Property sites: adds GPS, description, build year and more (one small extra request per listing). |
| `vehicleType` | choice | cars | Car sites: cars, motorcycles, vans (Otomoto). |
| `make` / `model` | text | | Car sites, for example Toyota and Corolla. |
| `yearFrom` / `yearTo` | number | | Car sites: production years. |
| `mileageMax` | number | | Car sites: most kilometres. |
| `radiusKm` | number | | Car sites: distance around the place. |
| `keyword` | text | | OLX: words to search for. |
| `priceMin` / `priceMax` | number | | In the site's currency. |
| `proxyConfiguration` | proxy | auto | Leave as is; the route is picked for you and included in the price. |

### What data do you get?

| Field | Example | Notes |
|---|---|---|
| `site` / `listing_type` | otodom.pl / property | property, vehicle, or the OLX category type |
| `listing_id` / `url` / `title` | 68398383 / link / 3 pokoje na Mokotowie | |
| `price` / `currency` | 699000 / PLN | |
| `price_per_m2` / `monthly_charges` | 14562.5 / 1099 | property sites |
| `area_m2` / `rooms` / `floor` | 48 / 3 / 2 | property sites, and `area_m2` on OLX real estate |
| `make` / `model` / `year` / `mileage_km` | BMW / Seria 3 / 2020 / 31500 | car sites, and `year` and `mileage_km` on OLX cars |
| `fuel_type` / `gearbox` / `engine_power` | Benzyna / Automatyczna / 252 | car sites |
| `price_evaluation` / `price_drop_percent` | below / 3.62 | the car site's own price rating |
| `city` / `district` / `region` / `street` | Warszawa / Mokotów / mazowieckie / Bełdan | |
| `seller_type` | agency | private, agency, developer, dealer, business |
| `agency_name` / `agency_url` | NieruchomosciSzybko.pl / link | property sites; business name on OLX |
| `dealer_name` / `dealer_url` | Pan America / panamerica.otomoto.pl | car sites |
| `units_count` / `delivery_date` | 130 / 2029 Q1 | new developments |
| `latitude` / `longitude` | 52.24 / 20.94 | OLX rows, and property rows with details |
| `description` / `build_year` / `heating` / `condition` | | OLX rows; property rows with details |
| `attributes` | {"rooms": "3 pokoje", "rent": "900 zł"} | every OLX parameter |
| `image_urls` / `image_count` | | |
| `created_at` / `bumped_at` | 2026-09-09T07:31:02+00:00 | |

#### Output example

```json
{
  "site": "otodom.pl",
  "listing_type": "property",
  "listing_id": "68398383",
  "url": "https://www.otodom.pl/pl/oferta/3-pokoje-na-mokotowie-48-m-swietna-lokalizacj-ID4CZxJ",
  "title": "3 pokoje na Mokotowie | 48 m² | Świetna lokalizacj",
  "transaction": "sale",
  "property_type": "flat",
  "price": 699000,
  "currency": "PLN",
  "price_per_m2": 14562.5,
  "monthly_charges": 1099,
  "area_m2": 48,
  "rooms": 3,
  "floor": 2,
  "street": "Bełdan",
  "city": "Warszawa",
  "district": "Mokotów",
  "neighbourhood": "Służew",
  "region": "mazowieckie",
  "seller_type": "agency",
  "agency_name": "NieruchomosciSzybko.pl",
  "agency_id": "7046548",
  "agency_url": "https://www.otodom.pl/pl/firmy/biura-nieruchomosci/nieruchomosciszybko-pl-ID7046548",
  "is_promoted": false,
  "features": ["secure_building"],
  "image_count": 17,
  "created_at": "2026-09-09T07:31:02+00:00",
  "bumped_at": "2026-11-11T21:22:49+01:00",
  "page": 1,
  "position": 1,
  "scraped_at": "2026-11-11T20:25:25.289Z"
}
```

### Pricing

Pay per event: you pay for the listings you receive, plus a flat $0.001 per run, whatever memory you choose. Listing details cost nothing extra.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `listing` | Once per listing row stored in your dataset | $1.80 per 1,000 | $1.50 per 1,000 | $1.30 per 1,000 | $1.08 per 1,000 |
| `run-start` | Once per run, after the first page returned listings | $0.001 | $0.001 | $0.001 | $0.001 |

Never charged:

- links that are not search links from one of the 11 sites, and places a site does not know (each gets an error row);
- a listing that a second search of the same run finds again;
- listings past your `maxItems`;
- the summary, info and error rows;
- a run with no valid input, or one whose searches return no listings: the start fee is charged only once listings came back;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit.

### How it compares

| Actor | Price per 1,000 on the Free plan | Start fee | Sites | Details (GPS, description) |
|---|---|---|---|---|
| **This actor** | $1.80 | $0.001 per run | 11: Otodom, Otomoto, OLX (5 countries), Imovirtual, Standvirtual, Storia, Autovit | Yes, same price |
| [OLX Listings Scraper by piotrv1001](https://apify.com/piotrv1001/olx-listings-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $1.00 | $0.00005 per GB of memory | OLX in 7 countries | GPS in every row; $2.00 per 1,000 for listing links |
| [Otodom Scraper by trev0n](https://apify.com/trev0n/otodom-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $2.00 | none | Otodom | Yes, same price |
| [Otodom Scraper by fatihtahta](https://apify.com/fatihtahta/otodom-pl-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $1.99 | none | Otodom | not stated |

Checked 12 Nov 2026 from the public Store listings.

### Run it on a schedule

1. Open the actor in Apify Console, set your input and click **Save as a new task**.
2. In the task, open **Schedules**, click **Add schedule** and pick how often (every day, every Monday at 08:00 and so on).
3. Use `sort: newest` and compare runs on `site` and `listing_id` to see new listings and price changes.
4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

### FAQ

#### What does this actor read?

The same public listing data the sites load in your browser when you search, as anyone sees it without logging in. It does not log in, contact sellers or read anything behind an account. It does not collect phone numbers, and it leaves out the names of private sellers.

#### Do I need an account, cookies or an API key?

No account, no cookies and no API key. Nothing to set up; the route is included.

#### How many listings can I get?

Up to 10,000 per place or link and 100 searches per run. OLX serves the first 1,000 results of any one search; split a big OLX search by place or price for more.

#### Why is a place not found?

Each site has its own spelling. Use the local name (Kraków, Lisboa, Bucuresti), or on OLX Bulgaria and Ukraine the Cyrillic name or OLX's own Latin one (Sofiya, Kiev). Or open the search on the site and paste the link into `startUrls`.

#### Why do some property rows have no price or area?

New developments list a price per m2 from and a range of unit sizes instead (`price_from_per_m2`, `units_area_from_m2`, `units_area_to_m2`, `units_count`). A few advertisers hide the price (`price_hidden: true`).

#### How long does a run take?

In our tests on Apify (12 Nov 2026): 3 seconds for the "Try it" input (50 listings), 27 seconds for 320 Otomoto listings, 33 seconds for 440 listings from all 11 sites, and 41 seconds for 150 Otodom houses with details.

#### Which formats can I download?

JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API. In CSV and Excel, lists such as `image_urls` and the `attributes` object are flattened into columns.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/otodom-scraper

- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code: `claude mcp add -t http otodom-scraper "https://mcp.apify.com/?tools=themineworks/otodom-scraper"`

#### Is it legal to scrape Otodom?

The actor reads only public listings that anyone can see without logging in, and it leaves out phone numbers and the names of private sellers. You are responsible for how you use the data, including the sites' terms and laws such as the GDPR that apply to you. This is general information, not legal advice.

### Integrations

- **Google Sheets**: send each run's listings to a sheet with Apify's Google Sheets integration; one row per listing fits a sheet as is.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "new Kraków rentals under 4,000 PLN every morning to Slack".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

If this actor saved you time, a short rating on the Store helps other buyers find it.

### More from The Mine Works

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [99acres Scraper](https://apify.com/themineworks/99acres-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [MagicBricks Scraper](https://apify.com/themineworks/magicbricks-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Property Scraper](https://apify.com/themineworks/zillow-property-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Photos Scraper](https://apify.com/themineworks/zillow-photos?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Real Estate MCP](https://apify.com/themineworks/real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Airbnb Scraper](https://apify.com/themineworks/airbnb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Domain.com.au Property Scraper](https://apify.com/themineworks/domain-property-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [realestate.com.au Scraper](https://apify.com/themineworks/realestate-com-au-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Support

Found a search that returns fewer listings than the site, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new site, email dmineworks@gmail.com.

*Search Otodom, Otomoto, OLX, Imovirtual, Standvirtual, Storia and Autovit and get every listing back as one row, with price, area or mileage, location and the agency or dealer, no login.*

# Actor input Schema

## `site` (type: `string`):

The site to search with the fields below. Ignored for links in startUrls (each link names its own site).

## `locations` (type: `array`):

City or region names, one per line, as the site spells them (Warszawa, Kraków, Lisboa, Porto, Bucuresti, Sofia). Each place is one search. Leave empty to search the whole country. On Otodom, Imovirtual and Storia you can also give the site's own location path, for example mazowieckie/warszawa/warszawa/warszawa.

## `startUrls` (type: `array`):

Search results links copied from your browser on any of the 11 sites, with every filter you set there. Example: https://www.otodom.pl/pl/wyniki/wynajem/mieszkanie/malopolskie/krakow/krakow/krakow?priceMax=4000 or https://www.otomoto.pl/osobowe/toyota/corolla or https://www.olx.pl/nieruchomosci/mieszkania/warszawa/. When links are given, the site, places and filter fields are not used.

## `maxItems` (type: `integer`):

The most listings to return for each place or link, 1 to 10,000. OLX serves the first 1,000 results of any one search.

## `sort` (type: `string`):

Order of the results. Default keeps the site's own order.

## `transaction` (type: `string`):

For Otodom, Imovirtual and Storia.

## `propertyType` (type: `string`):

Flat, house, plot, commercial, room, garage, warehouse or new development. Not every site has every type: Imovirtual has no commercial or warehouse search, Storia no warehouse or development search (paste a link instead).

## `areaMin` (type: `integer`):

Smallest floor area in square metres.

## `areaMax` (type: `integer`):

Largest floor area in square metres.

## `rooms` (type: `array`):

Room counts to include, for example 2 and 3. 10 means 10 or more.

## `ownerType` (type: `string`):

Private owners only, agencies only, or both.

## `market` (type: `string`):

Primary (new from developers) or secondary market.

## `daysSinceCreated` (type: `integer`):

Only listings added in the last 1, 3, 7, 14 or 30 days.

## `includeDetails` (type: `boolean`):

On: every property listing also gets its ad data: GPS coordinates, full description, market, build year, building type and material, floors, condition, ownership, heating, windows, amenities and the date it is free from. One extra small request per listing; same price per listing.

## `vehicleType` (type: `string`):

For Otomoto, Standvirtual and Autovit. Vans are on Otomoto only; for other categories paste a link.

## `make` (type: `string`):

For example Toyota, BMW, Dacia.

## `model` (type: `string`):

For example Corolla. Needs a make.

## `yearFrom` (type: `integer`):

Oldest production year.

## `yearTo` (type: `integer`):

Newest production year.

## `mileageMax` (type: `integer`):

Highest mileage in kilometres.

## `radiusKm` (type: `integer`):

With a place: also include listings within this many kilometres of it.

## `keyword` (type: `string`):

Words to search for on OLX, for example iphone 13 or rower. With a place, the search is limited to it.

## `priceMin` (type: `integer`):

Lowest price in the site's currency (PLN in Poland, EUR in Portugal and on Storia and Autovit, RON or EUR on OLX Romania, BGN in Bulgaria, UAH in Ukraine).

## `priceMax` (type: `integer`):

Highest price in the site's currency.

## `proxyConfiguration` (type: `object`):

Leave empty: the actor goes direct first, then over Apify datacenter IPs, then a residential IP in the site's country, only when a site refuses a request. Set your own proxy only if you need to.

## Actor input object example

```json
{
  "site": "otodom.pl",
  "locations": [
    "Warszawa"
  ],
  "maxItems": 50,
  "sort": "default",
  "transaction": "sale",
  "propertyType": "flat",
  "ownerType": "all",
  "market": "all",
  "includeDetails": false,
  "vehicleType": "cars"
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "site": "otodom.pl",
    "locations": [
        "Warszawa"
    ],
    "maxItems": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/otodom-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "site": "otodom.pl",
    "locations": ["Warszawa"],
    "maxItems": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/otodom-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "site": "otodom.pl",
  "locations": [
    "Warszawa"
  ],
  "maxItems": 50
}' |
apify call themineworks/otodom-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/otodom-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/OCBsgr7IxTPPh8QDY/builds/PxM3Sz3tF5T76zJON/openapi.json
