{
  "data": {
    "id": "lkL2CVJVgcZji40bh",
    "actId": "OtAwo8vgrqKT6Fm6n",
    "userId": "NL4ThgItAwaoBlffQ",
    "startedAt": "2026-11-20T07:47:31.060Z",
    "finishedAt": "2026-11-20T07:47:36.277Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 5139,
      "runTimeSecs": 5.139,
      "computeUnits": 0.00571,
      "imageSizeBytes": 309500416
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "6GwdnIcc2aWR7LzCS",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Nieruchomosci-online.pl Scraper Input\",\n  \"description\": \"Search real estate listings on nieruchomosci-online.pl by city, property type and transaction type, or fetch full details for specific listing URLs.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"What to fetch.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"search\",\n        \"byUrl\",\n        \"investments\",\n        \"agencies\",\n        \"developers\"\n      ],\n      \"enumTitles\": [\n        \"Search listings (city + property type + transaction type)\",\n        \"Lookup by listing URL(s)\",\n        \"Browse new-build developer projects (nationwide)\",\n        \"Browse real estate agencies directory\",\n        \"Browse developer companies directory\"\n      ],\n      \"default\": \"search\",\n      \"prefill\": \"search\"\n    },\n    \"city\": {\n      \"title\": \"City\",\n      \"type\": \"string\",\n      \"description\": \"Polish city or town name, e.g. `Warszawa`, `Krakow`, `Wroclaw`, `Gdansk`, `Poznan`. Required scope for mode=search. For mode=investments/agencies/developers it's an optional narrowing filter — clear it for nationwide results.\",\n      \"editor\": \"textfield\",\n      \"default\": \"Warszawa\",\n      \"prefill\": \"Warszawa\"\n    },\n    \"propertyType\": {\n      \"title\": \"Property type\",\n      \"type\": \"string\",\n      \"description\": \"Type of property to search (mode=search).\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"mieszkanie\",\n        \"pokoj\",\n        \"dom\",\n        \"dzialka\",\n        \"lokal-uzytkowy\",\n        \"budynek-uzytkowy\"\n      ],\n      \"enumTitles\": [\n        \"Apartment (Mieszkanie)\",\n        \"Room (Pokój)\",\n        \"House (Dom)\",\n        \"Plot / Land (Działka)\",\n        \"Commercial premises (Lokal użytkowy)\",\n        \"Commercial building (Budynek użytkowy)\"\n      ],\n      \"default\": \"mieszkanie\",\n      \"prefill\": \"mieszkanie\"\n    },\n    \"transactionType\": {\n      \"title\": \"Transaction type\",\n      \"type\": \"string\",\n      \"description\": \"Sale or rent (mode=search).\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"sprzedaz\",\n        \"wynajem\"\n      ],\n      \"enumTitles\": [\n        \"For sale (Sprzedaż)\",\n        \"For rent (Wynajem)\"\n      ],\n      \"default\": \"sprzedaz\",\n      \"prefill\": \"sprzedaz\"\n    },\n    \"sortBy\": {\n      \"title\": \"Sort order\",\n      \"type\": \"string\",\n      \"description\": \"Result ordering (mode=search).\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"newest\",\n        \"price_desc\",\n        \"price_asc\",\n        \"pricePerM2_desc\",\n        \"pricePerM2_asc\",\n        \"area_desc\",\n        \"area_asc\"\n      ],\n      \"enumTitles\": [\n        \"Newest first (default)\",\n        \"Price: highest first\",\n        \"Price: lowest first\",\n        \"Price per m²: highest first\",\n        \"Price per m²: lowest first\",\n        \"Area: largest first\",\n        \"Area: smallest first\"\n      ],\n      \"default\": \"newest\",\n      \"prefill\": \"newest\"\n    },\n    \"sellerType\": {\n      \"title\": \"Seller type\",\n      \"type\": \"string\",\n      \"description\": \"Keep only offers published by a given seller type (mode=search; in mode=investments every project is a developer). `any` keeps all sellers. Private means the ad is placed directly by the owner.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"any\",\n        \"agency\",\n        \"private\",\n        \"developer\",\n        \"company\"\n      ],\n      \"enumTitles\": [\n        \"Any seller\",\n        \"Real estate agency\",\n        \"Private owner\",\n        \"Developer\",\n        \"Company\"\n      ],\n      \"default\": \"any\",\n      \"prefill\": \"any\"\n    },\n    \"minPrice\": {\n      \"title\": \"Min price (PLN)\",\n      \"type\": \"integer\",\n      \"description\": \"Drop listings priced below this (PLN). Applied client-side against each record's price (mode=search or mode=investments; for investments this is the project's starting price).\",\n      \"minimum\": 0,\n      \"maximum\": 100000000\n    },\n    \"maxPrice\": {\n      \"title\": \"Max price (PLN)\",\n      \"type\": \"integer\",\n      \"description\": \"Drop listings priced above this (PLN). Applied client-side against each record's price (mode=search or mode=investments; for investments this is the project's starting price).\",\n      \"minimum\": 0,\n      \"maximum\": 100000000\n    },\n    \"minRooms\": {\n      \"title\": \"Min rooms\",\n      \"type\": \"integer\",\n      \"description\": \"Drop listings with fewer rooms than this. Only meaningful for apartments/houses/rooms; plots and buildings without a room count always pass through (mode=search).\",\n      \"minimum\": 1,\n      \"maximum\": 20\n    },\n    \"maxRooms\": {\n      \"title\": \"Max rooms\",\n      \"type\": \"integer\",\n      \"description\": \"Drop listings with more rooms than this (mode=search).\",\n      \"minimum\": 1,\n      \"maximum\": 20\n    },\n    \"minSize\": {\n      \"title\": \"Min size (m²)\",\n      \"type\": \"integer\",\n      \"description\": \"Drop listings smaller than this (m²) (mode=search).\",\n      \"minimum\": 1,\n      \"maximum\": 1000000\n    },\n    \"maxSize\": {\n      \"title\": \"Max size (m²)\",\n      \"type\": \"integer\",\n      \"description\": \"Drop listings larger than this (m²) (mode=search).\",\n      \"minimum\": 1,\n      \"maximum\": 1000000\n    },\n    \"listingUrls\": {\n      \"title\": \"Listing URLs (mode=byUrl)\",\n      \"type\": \"array\",\n      \"description\": \"Full nieruchomosci-online.pl listing URLs, e.g. `https://warszawa.nieruchomosci-online.pl/mieszkanie,na-sprzedaz/26869247.html`.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Hard cap on emitted records.\",\n      \"minimum\": 1,\n      \"maximum\": 2000,\n      \"default\": 20,\n      \"prefill\": 3\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# Nieruchomosci-online Property & Agency Directory Scraper\n\nNieruchomosci-online.pl is one of Poland's largest independent real estate portals, pairing property listings with its own directories of agencies and developer companies. This actor searches apartments, houses, plots, rooms and commercial property for sale or rent in any Polish city, browses nationwide new-build developer projects, browses the agency and developer-company directories, or fetches full details (amenities, floor plan facts, agent contact, GPS coordinates) for a specific listing or project URL. No account is required.\n\n## What this actor does\n\n- **Five modes:** `search` (by city + property type + transaction type), `investments` (nationwide new-build developer projects, optionally narrowed by city/price), `agencies` (real estate agency directory, nationwide or one city), `developers` (developer company directory, nationwide or one city), and `byUrl` (direct listing or project lookup)\n- **6 property types × 2 transaction types:** apartments, rooms, houses, plots/land, commercial premises, commercial buildings — for sale or for rent\n- **Client-side filters:** city scope, price range (PLN), room count range, size range (m²) — applied against every listing so results always respect your bounds even when the source's own search/filter widgets don't\n- **7 sort orders:** newest, price (asc/desc), price per m² (asc/desc), area (asc/desc)\n- **Rich detail mode:** amenities, building facts (year built, floors, building type), GPS coordinates, agent contact, and more when you supply listing or project URLs directly\n- **Business directories:** agency/developer name, profile URL, phone, address, city, short description and listing/project counts — useful for lead-gen or partner research\n- **Empty fields are omitted**\n\n## Output per listing (mode = `search`)\n\n- `title`, `description`\n- `price` (PLN), `pricePerM2` (PLN), `currency`\n- `rooms`, `size` (m²), `floorLevel`, `yearBuilt`\n- `address`, `city`, `district`, `region`, `country`\n- `latitude`, `longitude`\n- `imageUrl`\n- `sellerType` (`agency` / `private` / `developer` / `company`), `agencyName`, `agentName`, `agentPhone`, `agentUrl`, `isProAgent`, `noCommission`\n- `marketType` (`primary` / `secondary`), `dateModified`\n- `details` — extra card facts such as `totalFloors`, `conditionType`, `parkingType`, `garageType`, `completionDate`\n- `virtualTourUrl`, `videoUrl` when the listing publishes them\n- `propertyType`, `transactionType`\n- `url`\n- `recordType: \"listing\"`, `scrapedAt`\n\n## Output per project (mode = `investments`)\n\nDeveloper new-build projects from the site's `/inwestycje/` hub — each record is a whole multi-unit development, so `price`/`pricePerM2` are the project's *starting* price (the source's own \"od &lt;price&gt; zł\" framing), not one flat's exact price. Fetch the project's own `url` via `mode=byUrl` for full per-project facts (unit count, amenities, year built).\n\n- `title` (the source's own price-teaser headline, e.g. \"Mieszkania od 629 000 zł do 849 000 zł\")\n- `price` (PLN, starting price), `pricePerM2` (PLN), `currency`\n- `address`, `city`, `district`, `region`, `country`, `latitude`, `longitude`\n- `imageUrl`\n- `developerName`, `developerUrl`, `salesOfficeName`, `salesOfficeAddress`, `salesOfficeCity`, `salesOfficePostalCode`, `agentPhone`\n- `availableUnits` — currently advertised unit count\n- `sellerType` (`developer`), `marketType` (`primary`), `dateModified`\n- `category` (`\"Inwestycje\"`)\n- `virtualTourUrl`, `videoUrl` when published\n- `url`\n- `recordType: \"investment\"`, `scrapedAt`\n\n## Output per listing (mode = `byUrl`)\n\n- `title`, `description`\n- `price` (PLN), `pricePerM2` (PLN), `currency`\n- `rooms`, `bedrooms`, `bathrooms`, `size` (m²), `floorLevel`, `yearBuilt`\n- `address`, `city`, `district` where available, `region`, `country`, `latitude`, `longitude`\n- `amenities[]` — e.g. Parking, Elevator, Balcony, Garage, WiFi\n- `details` — extra structured facts that vary by property type (e.g. `totalFloors`, `buildingType`, `landArea`, `landType` for plots; `numberOfUnits`, `unitMix`, `yearBuilt` for developer projects)\n- `availableUnits` — currently-available unit count (developer-project pages only)\n- `images[]`\n- `agentName`, `agentAddress`, `agentPhone`\n- `sellerType`, `marketType`\n- `virtualTourUrl`, `videoUrl` when published\n- `datePosted`\n- `category`, `transactionLabel` — Polish labels from the site's own breadcrumb (e.g. `category: \"Inwestycje\"` for a developer-project URL instead of a property-type label)\n- `url`\n- `recordType: \"listingDetail\"`, `scrapedAt`\n\n`listingUrls` accepts both ordinary listing URLs (`.../mieszkanie,na-sprzedaz/26869247.html`) and developer-project URLs (`.../smetna-garden.html`) — both are the same JSON-LD detail-page shape the site publishes.\n\n## Output per entry (mode = `agencies` or `developers`)\n\nFrom the site's `/biura-nieruchomosci/` (agencies) and `/deweloperzy/` (developer companies) directories — nationwide by default, or scoped to one city's own directory subdomain when `city` is set.\n\n- `name` — company/office name\n- `phone`\n- `address`, `city`\n- `description` — the source's own short bio text (sometimes truncated with `(...)`, as shown on the site)\n- `listingCount` (mode=agencies) — current number of active listings\n- `projectCount` (mode=developers) — current number of active developer projects\n- `isProAgent` — present (`true`) only when the source shows its \"Profesjonalny Agent\" quality badge; omitted otherwise\n- `category` (`\"Biuro nieruchomości\"` or `\"Deweloper\"`)\n- `url` — the company's own profile subdomain\n- `recordType: \"agency\"` / `\"developer\"`, `scrapedAt`\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search` / `investments` / `agencies` / `developers` / `byUrl` |\n| `city` | string | `Warszawa` | Polish city or town name. Required scope for `search`; optional narrowing filter for `investments`/`agencies`/`developers` (clear it for nationwide) |\n| `propertyType` | string | `mieszkanie` | Apartment / room / house / plot / commercial premises / commercial building (mode=search) |\n| `transactionType` | string | `sprzedaz` | For sale / for rent (mode=search) |\n| `sortBy` | string | `newest` | Newest / price asc-desc / price-per-m² asc-desc / area asc-desc (mode=search) |\n| `sellerType` | string | `any` | `any` / `agency` / `private` / `developer` / `company` — keeps only offers from that seller type (mode=search; every investment project is a developer) |\n| `minPrice` / `maxPrice` | int | – | Price range in PLN (mode=search or mode=investments) |\n| `minRooms` / `maxRooms` | int | – | Room count range (mode=search) |\n| `minSize` / `maxSize` | int | – | Size range in m² (mode=search) |\n| `listingUrls` | array | – | Listing or developer-project URLs to fetch (mode=byUrl) |\n| `maxItems` | int | `20` | Hard cap (1–2000) |\n\n### Example: apartments for sale in Warsaw, 2–3 rooms under 800 000 PLN\n\n```json\n{\n  \"mode\": \"search\",\n  \"city\": \"Warszawa\",\n  \"propertyType\": \"mieszkanie\",\n  \"transactionType\": \"sprzedaz\",\n  \"minRooms\": 2,\n  \"maxRooms\": 3,\n  \"maxPrice\": 800000,\n  \"sortBy\": \"price_asc\",\n  \"maxItems\": 30\n}\n```\n\n### Example: full details for specific listings or developer projects\n\n```json\n{\n  \"mode\": \"byUrl\",\n  \"listingUrls\": [\n    \"https://warszawa.nieruchomosci-online.pl/mieszkanie,na-sprzedaz/26869247.html\",\n    \"https://krakow.nieruchomosci-online.pl/smetna-garden.html\"\n  ]\n}\n```\n\n### Example: nationwide new-build developer projects under 700 000 PLN\n\n```json\n{\n  \"mode\": \"investments\",\n  \"city\": \"\",\n  \"maxPrice\": 700000,\n  \"maxItems\": 30\n}\n```\n\n### Example: real estate agencies in Warsaw\n\n```json\n{\n  \"mode\": \"agencies\",\n  \"city\": \"Warszawa\",\n  \"maxItems\": 30\n}\n```\n\n### Example: developer companies nationwide\n\n```json\n{\n  \"mode\": \"developers\",\n  \"city\": \"\",\n  \"maxItems\": 30\n}\n```\n\n## Use cases\n\n- **PropTech & market analytics** — track asking-price trends by city, property type and room count\n- **Investment & new-build research** — scan plots, commercial buildings and nationwide developer projects for development opportunities, and monitor starting prices and unit availability\n- **Relocation services** — build curated listing digests for clients moving to a Polish city\n- **Rental market monitoring** — compare rent levels across cities and neighborhoods\n- **Lead generation for agents** — discover fresh private-seller listings by transaction type\n- **Partner/vendor research** — build a contact list of active real estate agencies or developer companies in a target city\n\n## FAQ\n\n**What's the data source?** The public search, `/inwestycje/` (developer projects hub), `/biura-nieruchomosci/` and `/deweloperzy/` (business directories), and listing/project detail pages of [nieruchomosci-online.pl](https://www.nieruchomosci-online.pl). Listing/investment/detail data is parsed from the structured data (JSON-LD) each page publishes for search engines; the agency/developer directories don't publish JSON-LD, so those two modes parse the same directory-card HTML the site renders server-side.\n\n**How does city-scoping work for `mode=agencies`/`mode=developers`?** The actor first requests the city's own directory subdomain (e.g. `warszawa.nieruchomosci-online.pl/biura-nieruchomosci/`) to narrow the scan server-side, then — same as `search`/`investments` — applies a strict client-side match against each entry's own `city` field before emitting it. This second step is necessary: verified via testing that a city-scoped `/deweloperzy/` subdomain page can also list developers based in a nearby town or a different city in the same voivodeship, so relying on the subdomain alone would leak out-of-scope results. If a city has no matching entries (or the name doesn't resolve to a real directory subdomain), the actor emits 0 records with a clear status message rather than guessing or fabricating a match — try clearing `city` for the nationwide directory instead.\n\n**Why does `developers` sometimes omit `projectCount`?** A minority of developer-directory cards don't render a project counter on the source page at all (typically a company with 0 currently-listed projects) — the field is simply omitted rather than showing a fabricated `0`.\n\n**Is this affiliated with Nieruchomosci-online.pl?** No — this is an independent third-party actor that reads publicly available pages.\n\n**Why are `city`/`minPrice`/`maxPrice`/`minRooms`/`maxRooms`/`minSize`/`maxSize` applied \"client-side\"?** The site's own search broadens results to nearby towns/villages in the same voivodeship (e.g. searching `Warszawa` can also return listings in `Otwock`), and its price/room/size filter widgets — including the market-type (primary/secondary), building-type, construction-year and room-capacity dropdowns — require JavaScript and are silently ignored by a plain URL request (verified: passing their query parameters directly returns the identical unfiltered page). So the actor fetches the (city + property type + transaction type) result pages and applies your `city` and numeric bounds itself, page by page, until `maxItems` is reached or the search is exhausted. This guarantees every returned record genuinely matches your filters, including `city`.\n\n**Why do some listings have no `price`?** New-development marketing cards (mode=`search`/`investments`) sometimes leave `price`/`size` blank on the search-result card itself — the actor detects this and automatically fetches that listing's own detail page to backfill the real figures (same data `mode=byUrl` returns), so this happens transparently in the vast majority of cases. Only the rare listing that has genuinely never published a price anywhere on the site (even its own detail page) ends up with the field omitted rather than a fabricated placeholder.\n\n**Can I search a district/neighborhood within a city?** Not as an input filter — the site's district filter needs JavaScript and is not applied server-side. `district` (e.g. `Ochota`, `Nowa Huta`) is extracted and returned on every listing where the source publishes it, so you can filter the dataset by district after the run. `address` and `city` are also returned as separate fields.\n\n**What does `sellerType` mean?** The source labels every card with a publisher type. The actor normalizes it to `agency`, `private` (ad placed directly by the owner), `developer` (new-build project) or `company`, and exposes it as `sellerType`. Set `sellerType: \"private\"` to keep only owner-placed offers, or `agency` to exclude private sellers.\n\n**Do I get the full photo gallery?** Search and investment cards publish only the cover photo (`imageUrl`); the full `images[]` array is returned in `mode=byUrl` from each listing's detail page. Use `byUrl` when you need every photo, the floor plan facts, or the full description.\n\n**What is `mode=investments`?** It browses the site's dedicated `/inwestycje/` hub — brand-new multi-unit developments from developers, listed nationwide. Each record represents a whole project (not one flat), so `price`/`pricePerM2` are the project's advertised *starting* price. The hub doesn't support server-side city scoping, so — same as `search` — `city` is applied client-side as an optional narrowing filter over the nationwide feed; clear the `city` field for unfiltered nationwide results. `minRooms`/`maxRooms`/`minSize`/`maxSize`/`sortBy` aren't offered for this mode since a project spans many unit sizes/layouts rather than one, and the hub doesn't support sorting.\n\n**How fresh is the data?** Listings and projects are scraped live on every run — pricing, availability and descriptions reflect what's currently published on the site.\n\n**Is a proxy or login required?** No — the actor works entirely over plain HTTP with no authentication or paid proxy.\n\n## Limitations\n\n- **District filter:** returned per listing but not accepted as an input filter (the site's own district widget is JavaScript-only). Filter the dataset downstream by `district`.\n- **Rows per run:** `maxItems` is capped at 2,000. The actor scans up to 60 result pages and deduplicates by URL, so a broad search returns the first 2,000 unique matches; split by city/property type to reach more.\n- **Search-card depth:** `mode=search` and `mode=investments` return the card payload (plus one automatic detail fetch when price/size are blank). Full galleries, amenities and free-text building facts require `mode=byUrl`.\n- **Single portal:** this actor covers Nieruchomosci-online.pl only; it does not aggregate Otodom, OLX, Morizon or other portals.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "nieruchomosci-online-property-and-agency-directory",
      "title": "Nieruchomosci-online Property & Agency Directory Scraper",
      "description": "Search Nieruchomosci-online.pl properties for sale or rent in any Polish city, browse nationwide new-build developer projects or the agency/developer directories, or fetch full listing details by URL.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "../Dockerfile",
      "readme": "# Nieruchomosci-online Property & Agency Directory Scraper\n\nNieruchomosci-online.pl is one of Poland's largest independent real estate portals, pairing property listings with its own directories of agencies and developer companies. This actor searches apartments, houses, plots, rooms and commercial property for sale or rent in any Polish city, browses nationwide new-build developer projects, browses the agency and developer-company directories, or fetches full details (amenities, floor plan facts, agent contact, GPS coordinates) for a specific listing or project URL. No account is required.\n\n## What this actor does\n\n- **Five modes:** `search` (by city + property type + transaction type), `investments` (nationwide new-build developer projects, optionally narrowed by city/price), `agencies` (real estate agency directory, nationwide or one city), `developers` (developer company directory, nationwide or one city), and `byUrl` (direct listing or project lookup)\n- **6 property types × 2 transaction types:** apartments, rooms, houses, plots/land, commercial premises, commercial buildings — for sale or for rent\n- **Client-side filters:** city scope, price range (PLN), room count range, size range (m²) — applied against every listing so results always respect your bounds even when the source's own search/filter widgets don't\n- **7 sort orders:** newest, price (asc/desc), price per m² (asc/desc), area (asc/desc)\n- **Rich detail mode:** amenities, building facts (year built, floors, building type), GPS coordinates, agent contact, and more when you supply listing or project URLs directly\n- **Business directories:** agency/developer name, profile URL, phone, address, city, short description and listing/project counts — useful for lead-gen or partner research\n- **Empty fields are omitted**\n\n## Output per listing (mode = `search`)\n\n- `title`, `description`\n- `price` (PLN), `pricePerM2` (PLN), `currency`\n- `rooms`, `size` (m²), `floorLevel`, `yearBuilt`\n- `address`, `city`, `district`, `region`, `country`\n- `latitude`, `longitude`\n- `imageUrl`\n- `sellerType` (`agency` / `private` / `developer` / `company`), `agencyName`, `agentName`, `agentPhone`, `agentUrl`, `isProAgent`, `noCommission`\n- `marketType` (`primary` / `secondary`), `dateModified`\n- `details` — extra card facts such as `totalFloors`, `conditionType`, `parkingType`, `garageType`, `completionDate`\n- `virtualTourUrl`, `videoUrl` when the listing publishes them\n- `propertyType`, `transactionType`\n- `url`\n- `recordType: \"listing\"`, `scrapedAt`\n\n## Output per project (mode = `investments`)\n\nDeveloper new-build projects from the site's `/inwestycje/` hub — each record is a whole multi-unit development, so `price`/`pricePerM2` are the project's *starting* price (the source's own \"od &lt;price&gt; zł\" framing), not one flat's exact price. Fetch the project's own `url` via `mode=byUrl` for full per-project facts (unit count, amenities, year built).\n\n- `title` (the source's own price-teaser headline, e.g. \"Mieszkania od 629 000 zł do 849 000 zł\")\n- `price` (PLN, starting price), `pricePerM2` (PLN), `currency`\n- `address`, `city`, `district`, `region`, `country`, `latitude`, `longitude`\n- `imageUrl`\n- `developerName`, `developerUrl`, `salesOfficeName`, `salesOfficeAddress`, `salesOfficeCity`, `salesOfficePostalCode`, `agentPhone`\n- `availableUnits` — currently advertised unit count\n- `sellerType` (`developer`), `marketType` (`primary`), `dateModified`\n- `category` (`\"Inwestycje\"`)\n- `virtualTourUrl`, `videoUrl` when published\n- `url`\n- `recordType: \"investment\"`, `scrapedAt`\n\n## Output per listing (mode = `byUrl`)\n\n- `title`, `description`\n- `price` (PLN), `pricePerM2` (PLN), `currency`\n- `rooms`, `bedrooms`, `bathrooms`, `size` (m²), `floorLevel`, `yearBuilt`\n- `address`, `city`, `district` where available, `region`, `country`, `latitude`, `longitude`\n- `amenities[]` — e.g. Parking, Elevator, Balcony, Garage, WiFi\n- `details` — extra structured facts that vary by property type (e.g. `totalFloors`, `buildingType`, `landArea`, `landType` for plots; `numberOfUnits`, `unitMix`, `yearBuilt` for developer projects)\n- `availableUnits` — currently-available unit count (developer-project pages only)\n- `images[]`\n- `agentName`, `agentAddress`, `agentPhone`\n- `sellerType`, `marketType`\n- `virtualTourUrl`, `videoUrl` when published\n- `datePosted`\n- `category`, `transactionLabel` — Polish labels from the site's own breadcrumb (e.g. `category: \"Inwestycje\"` for a developer-project URL instead of a property-type label)\n- `url`\n- `recordType: \"listingDetail\"`, `scrapedAt`\n\n`listingUrls` accepts both ordinary listing URLs (`.../mieszkanie,na-sprzedaz/26869247.html`) and developer-project URLs (`.../smetna-garden.html`) — both are the same JSON-LD detail-page shape the site publishes.\n\n## Output per entry (mode = `agencies` or `developers`)\n\nFrom the site's `/biura-nieruchomosci/` (agencies) and `/deweloperzy/` (developer companies) directories — nationwide by default, or scoped to one city's own directory subdomain when `city` is set.\n\n- `name` — company/office name\n- `phone`\n- `address`, `city`\n- `description` — the source's own short bio text (sometimes truncated with `(...)`, as shown on the site)\n- `listingCount` (mode=agencies) — current number of active listings\n- `projectCount` (mode=developers) — current number of active developer projects\n- `isProAgent` — present (`true`) only when the source shows its \"Profesjonalny Agent\" quality badge; omitted otherwise\n- `category` (`\"Biuro nieruchomości\"` or `\"Deweloper\"`)\n- `url` — the company's own profile subdomain\n- `recordType: \"agency\"` / `\"developer\"`, `scrapedAt`\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search` / `investments` / `agencies` / `developers` / `byUrl` |\n| `city` | string | `Warszawa` | Polish city or town name. Required scope for `search`; optional narrowing filter for `investments`/`agencies`/`developers` (clear it for nationwide) |\n| `propertyType` | string | `mieszkanie` | Apartment / room / house / plot / commercial premises / commercial building (mode=search) |\n| `transactionType` | string | `sprzedaz` | For sale / for rent (mode=search) |\n| `sortBy` | string | `newest` | Newest / price asc-desc / price-per-m² asc-desc / area asc-desc (mode=search) |\n| `sellerType` | string | `any` | `any` / `agency` / `private` / `developer` / `company` — keeps only offers from that seller type (mode=search; every investment project is a developer) |\n| `minPrice` / `maxPrice` | int | – | Price range in PLN (mode=search or mode=investments) |\n| `minRooms` / `maxRooms` | int | – | Room count range (mode=search) |\n| `minSize` / `maxSize` | int | – | Size range in m² (mode=search) |\n| `listingUrls` | array | – | Listing or developer-project URLs to fetch (mode=byUrl) |\n| `maxItems` | int | `20` | Hard cap (1–2000) |\n\n### Example: apartments for sale in Warsaw, 2–3 rooms under 800 000 PLN\n\n```json\n{\n  \"mode\": \"search\",\n  \"city\": \"Warszawa\",\n  \"propertyType\": \"mieszkanie\",\n  \"transactionType\": \"sprzedaz\",\n  \"minRooms\": 2,\n  \"maxRooms\": 3,\n  \"maxPrice\": 800000,\n  \"sortBy\": \"price_asc\",\n  \"maxItems\": 30\n}\n```\n\n### Example: full details for specific listings or developer projects\n\n```json\n{\n  \"mode\": \"byUrl\",\n  \"listingUrls\": [\n    \"https://warszawa.nieruchomosci-online.pl/mieszkanie,na-sprzedaz/26869247.html\",\n    \"https://krakow.nieruchomosci-online.pl/smetna-garden.html\"\n  ]\n}\n```\n\n### Example: nationwide new-build developer projects under 700 000 PLN\n\n```json\n{\n  \"mode\": \"investments\",\n  \"city\": \"\",\n  \"maxPrice\": 700000,\n  \"maxItems\": 30\n}\n```\n\n### Example: real estate agencies in Warsaw\n\n```json\n{\n  \"mode\": \"agencies\",\n  \"city\": \"Warszawa\",\n  \"maxItems\": 30\n}\n```\n\n### Example: developer companies nationwide\n\n```json\n{\n  \"mode\": \"developers\",\n  \"city\": \"\",\n  \"maxItems\": 30\n}\n```\n\n## Use cases\n\n- **PropTech & market analytics** — track asking-price trends by city, property type and room count\n- **Investment & new-build research** — scan plots, commercial buildings and nationwide developer projects for development opportunities, and monitor starting prices and unit availability\n- **Relocation services** — build curated listing digests for clients moving to a Polish city\n- **Rental market monitoring** — compare rent levels across cities and neighborhoods\n- **Lead generation for agents** — discover fresh private-seller listings by transaction type\n- **Partner/vendor research** — build a contact list of active real estate agencies or developer companies in a target city\n\n## FAQ\n\n**What's the data source?** The public search, `/inwestycje/` (developer projects hub), `/biura-nieruchomosci/` and `/deweloperzy/` (business directories), and listing/project detail pages of [nieruchomosci-online.pl](https://www.nieruchomosci-online.pl). Listing/investment/detail data is parsed from the structured data (JSON-LD) each page publishes for search engines; the agency/developer directories don't publish JSON-LD, so those two modes parse the same directory-card HTML the site renders server-side.\n\n**How does city-scoping work for `mode=agencies`/`mode=developers`?** The actor first requests the city's own directory subdomain (e.g. `warszawa.nieruchomosci-online.pl/biura-nieruchomosci/`) to narrow the scan server-side, then — same as `search`/`investments` — applies a strict client-side match against each entry's own `city` field before emitting it. This second step is necessary: verified via testing that a city-scoped `/deweloperzy/` subdomain page can also list developers based in a nearby town or a different city in the same voivodeship, so relying on the subdomain alone would leak out-of-scope results. If a city has no matching entries (or the name doesn't resolve to a real directory subdomain), the actor emits 0 records with a clear status message rather than guessing or fabricating a match — try clearing `city` for the nationwide directory instead.\n\n**Why does `developers` sometimes omit `projectCount`?** A minority of developer-directory cards don't render a project counter on the source page at all (typically a company with 0 currently-listed projects) — the field is simply omitted rather than showing a fabricated `0`.\n\n**Is this affiliated with Nieruchomosci-online.pl?** No — this is an independent third-party actor that reads publicly available pages.\n\n**Why are `city`/`minPrice`/`maxPrice`/`minRooms`/`maxRooms`/`minSize`/`maxSize` applied \"client-side\"?** The site's own search broadens results to nearby towns/villages in the same voivodeship (e.g. searching `Warszawa` can also return listings in `Otwock`), and its price/room/size filter widgets — including the market-type (primary/secondary), building-type, construction-year and room-capacity dropdowns — require JavaScript and are silently ignored by a plain URL request (verified: passing their query parameters directly returns the identical unfiltered page). So the actor fetches the (city + property type + transaction type) result pages and applies your `city` and numeric bounds itself, page by page, until `maxItems` is reached or the search is exhausted. This guarantees every returned record genuinely matches your filters, including `city`.\n\n**Why do some listings have no `price`?** New-development marketing cards (mode=`search`/`investments`) sometimes leave `price`/`size` blank on the search-result card itself — the actor detects this and automatically fetches that listing's own detail page to backfill the real figures (same data `mode=byUrl` returns), so this happens transparently in the vast majority of cases. Only the rare listing that has genuinely never published a price anywhere on the site (even its own detail page) ends up with the field omitted rather than a fabricated placeholder.\n\n**Can I search a district/neighborhood within a city?** Not as an input filter — the site's district filter needs JavaScript and is not applied server-side. `district` (e.g. `Ochota`, `Nowa Huta`) is extracted and returned on every listing where the source publishes it, so you can filter the dataset by district after the run. `address` and `city` are also returned as separate fields.\n\n**What does `sellerType` mean?** The source labels every card with a publisher type. The actor normalizes it to `agency`, `private` (ad placed directly by the owner), `developer` (new-build project) or `company`, and exposes it as `sellerType`. Set `sellerType: \"private\"` to keep only owner-placed offers, or `agency` to exclude private sellers.\n\n**Do I get the full photo gallery?** Search and investment cards publish only the cover photo (`imageUrl`); the full `images[]` array is returned in `mode=byUrl` from each listing's detail page. Use `byUrl` when you need every photo, the floor plan facts, or the full description.\n\n**What is `mode=investments`?** It browses the site's dedicated `/inwestycje/` hub — brand-new multi-unit developments from developers, listed nationwide. Each record represents a whole project (not one flat), so `price`/`pricePerM2` are the project's advertised *starting* price. The hub doesn't support server-side city scoping, so — same as `search` — `city` is applied client-side as an optional narrowing filter over the nationwide feed; clear the `city` field for unfiltered nationwide results. `minRooms`/`maxRooms`/`minSize`/`maxSize`/`sortBy` aren't offered for this mode since a project spans many unit sizes/layouts rather than one, and the hub doesn't support sorting.\n\n**How fresh is the data?** Listings and projects are scraped live on every run — pricing, availability and descriptions reflect what's currently published on the site.\n\n**Is a proxy or login required?** No — the actor works entirely over plain HTTP with no authentication or paid proxy.\n\n## Limitations\n\n- **District filter:** returned per listing but not accepted as an input filter (the site's own district widget is JavaScript-only). Filter the dataset downstream by `district`.\n- **Rows per run:** `maxItems` is capped at 2,000. The actor scans up to 60 result pages and deduplicates by URL, so a broad search returns the first 2,000 unique matches; split by city/property type to reach more.\n- **Search-card depth:** `mode=search` and `mode=investments` return the card payload (plus one automatic detail fetch when price/size are blank). Full galleries, amenities and free-text building facts require `mode=byUrl`.\n- **Single portal:** this actor covers Nieruchomosci-online.pl only; it does not aggregate Otodom, OLX, Morizon or other portals.\n",
      "input": {
        "title": "Nieruchomosci-online.pl Scraper Input",
        "description": "Search real estate listings on nieruchomosci-online.pl by city, property type and transaction type, or fetch full details for specific listing URLs.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "What to fetch.",
            "editor": "select",
            "enum": [
              "search",
              "byUrl",
              "investments",
              "agencies",
              "developers"
            ],
            "enumTitles": [
              "Search listings (city + property type + transaction type)",
              "Lookup by listing URL(s)",
              "Browse new-build developer projects (nationwide)",
              "Browse real estate agencies directory",
              "Browse developer companies directory"
            ],
            "default": "search",
            "prefill": "search"
          },
          "city": {
            "title": "City",
            "type": "string",
            "description": "Polish city or town name, e.g. `Warszawa`, `Krakow`, `Wroclaw`, `Gdansk`, `Poznan`. Required scope for mode=search. For mode=investments/agencies/developers it's an optional narrowing filter — clear it for nationwide results.",
            "editor": "textfield",
            "default": "Warszawa",
            "prefill": "Warszawa"
          },
          "propertyType": {
            "title": "Property type",
            "type": "string",
            "description": "Type of property to search (mode=search).",
            "editor": "select",
            "enum": [
              "mieszkanie",
              "pokoj",
              "dom",
              "dzialka",
              "lokal-uzytkowy",
              "budynek-uzytkowy"
            ],
            "enumTitles": [
              "Apartment (Mieszkanie)",
              "Room (Pokój)",
              "House (Dom)",
              "Plot / Land (Działka)",
              "Commercial premises (Lokal użytkowy)",
              "Commercial building (Budynek użytkowy)"
            ],
            "default": "mieszkanie",
            "prefill": "mieszkanie"
          },
          "transactionType": {
            "title": "Transaction type",
            "type": "string",
            "description": "Sale or rent (mode=search).",
            "editor": "select",
            "enum": [
              "sprzedaz",
              "wynajem"
            ],
            "enumTitles": [
              "For sale (Sprzedaż)",
              "For rent (Wynajem)"
            ],
            "default": "sprzedaz",
            "prefill": "sprzedaz"
          },
          "sortBy": {
            "title": "Sort order",
            "type": "string",
            "description": "Result ordering (mode=search).",
            "editor": "select",
            "enum": [
              "newest",
              "price_desc",
              "price_asc",
              "pricePerM2_desc",
              "pricePerM2_asc",
              "area_desc",
              "area_asc"
            ],
            "enumTitles": [
              "Newest first (default)",
              "Price: highest first",
              "Price: lowest first",
              "Price per m²: highest first",
              "Price per m²: lowest first",
              "Area: largest first",
              "Area: smallest first"
            ],
            "default": "newest",
            "prefill": "newest"
          },
          "sellerType": {
            "title": "Seller type",
            "type": "string",
            "description": "Keep only offers published by a given seller type (mode=search; in mode=investments every project is a developer). `any` keeps all sellers. Private means the ad is placed directly by the owner.",
            "editor": "select",
            "enum": [
              "any",
              "agency",
              "private",
              "developer",
              "company"
            ],
            "enumTitles": [
              "Any seller",
              "Real estate agency",
              "Private owner",
              "Developer",
              "Company"
            ],
            "default": "any",
            "prefill": "any"
          },
          "minPrice": {
            "title": "Min price (PLN)",
            "type": "integer",
            "description": "Drop listings priced below this (PLN). Applied client-side against each record's price (mode=search or mode=investments; for investments this is the project's starting price).",
            "minimum": 0,
            "maximum": 100000000
          },
          "maxPrice": {
            "title": "Max price (PLN)",
            "type": "integer",
            "description": "Drop listings priced above this (PLN). Applied client-side against each record's price (mode=search or mode=investments; for investments this is the project's starting price).",
            "minimum": 0,
            "maximum": 100000000
          },
          "minRooms": {
            "title": "Min rooms",
            "type": "integer",
            "description": "Drop listings with fewer rooms than this. Only meaningful for apartments/houses/rooms; plots and buildings without a room count always pass through (mode=search).",
            "minimum": 1,
            "maximum": 20
          },
          "maxRooms": {
            "title": "Max rooms",
            "type": "integer",
            "description": "Drop listings with more rooms than this (mode=search).",
            "minimum": 1,
            "maximum": 20
          },
          "minSize": {
            "title": "Min size (m²)",
            "type": "integer",
            "description": "Drop listings smaller than this (m²) (mode=search).",
            "minimum": 1,
            "maximum": 1000000
          },
          "maxSize": {
            "title": "Max size (m²)",
            "type": "integer",
            "description": "Drop listings larger than this (m²) (mode=search).",
            "minimum": 1,
            "maximum": 1000000
          },
          "listingUrls": {
            "title": "Listing URLs (mode=byUrl)",
            "type": "array",
            "description": "Full nieruchomosci-online.pl listing URLs, e.g. `https://warszawa.nieruchomosci-online.pl/mieszkanie,na-sprzedaz/26869247.html`.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Hard cap on emitted records.",
            "minimum": 1,
            "maximum": 2000,
            "default": 20,
            "prefill": 3
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Nieruchomosci-online Property & Agency Directory Scraper Output",
        "description": "Nieruchomosci-online.pl property listings, developer projects, and agency/developer directory entries with price, size, rooms, address, district, GPS coordinates, seller type and agent contact details where the source publishes them.",
        "properties": {
          "listings": {
            "type": "string",
            "title": "Nieruchomosci-online.pl listings",
            "description": "Dataset containing all scraped listings.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Listings",
              "transformation": {
                "fields": [
                  "title",
                  "price",
                  "currency",
                  "rooms",
                  "size",
                  "city",
                  "district",
                  "sellerType",
                  "propertyType",
                  "transactionType",
                  "url"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.2",
    "imageDigest": "df1ea4be678aa0ccdcf415a15484f3b3598a1871498ef4bafb25342b081de8dc",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.00571
    }
  }
}