Gratka.pl Property Scraper: Extract Real Estate Data Efficiently

---

What Is Gratka.pl?

Gratka.pl is one of Poland's largest online real estate marketplaces, hosting thousands of residential and commercial property listings. The platform covers apartments, houses, and land across major Polish cities including Warsaw, Krakow, Wroclaw, and Kielce. With daily updates and comprehensive property details, Gratka.pl is a valuable source for market intelligence — but manually collecting data from individual listings is inefficient. The Gratka.pl Property Scraper automates this process, extracting structured data from property detail pages at scale.

---

Overview

The Gratka Property Details Scraper extracts complete property information from Gratka.pl listing pages, transforming unstructured web content into clean, machine-readable records. It is designed for:

• Real estate analysts studying market trends and pricing patterns
• Property aggregators building centralized listing databases
• Market researchers analyzing housing supply and demand
• Investment firms conducting portfolio and competitor analysis
• Data scientists building property valuation models

Key strengths include support for up to 200 items per URL, fault tolerance with ignore_url_failures, and comprehensive extraction of 40+ data fields covering pricing, location, photos, and property specifications.

---

Input Format

The scraper accepts a JSON configuration object:

{
  "urls": [
    "https://gratka.pl/nieruchomosci/mieszkanie-kielce-piaski-wincentego-witosa/ob/48345669",
    "https://gratka.pl/nieruchomosci/mieszkanie-warszawa-praga-poludnie-londynska/ob/48356881"
  ],
  "max_items_per_url": 200,
  "ignore_url_failures": true
}

Field	Description
urls	Array of direct links to Gratka.pl property detail pages. Each URL points to a specific property listing.
max_items_per_url	Maximum number of records extracted per URL. Default: 200. Adjust based on your needs.
ignore_url_failures	Boolean flag. If true, the scraper continues if certain URLs fail to load; if false, the run stops on any error. Recommended: true for bulk operations.

Best Practice: Use direct property detail URLs (e.g., https://gratka.pl/nieruchomosci/mieszkanie-...) rather than search result pages. Each URL should represent a single property listing.

---

Output Format

Sample output

{
  "advertisement_text": "Komfortowe 2-pokojowe mieszkanie z dużą loggią | Garaż podziemny | Winda",
  "area": "35,55",
  "building_detailed_information": [
    {
      "label": "Typ budynku",
      "value": "Apartamentowiec",
      "url": "/nieruchomosci/mieszkania/w-apartamentowcu/kielce/piaski"
    },
    {
      "label": "Rok budowy",
      "value": "2017",
      "url": null
    },
    {
      "label": "Stan budynku",
      "value": "Bardzo dobry",
      "url": null
    }
  ],
  "contact": {
    "company": {
      "address": [
        "Lecha 5",
        "25-622 Kielce"
      ],
      "faxes": [],
      "id": 464821,
      "logo": {
        "id": "aHR0cHM6Ly9kLWdyLmNkbmdyLnBsL2thZHJ5L2svci9nci1wbG9nby9iOS8zNi80NjQ4MjFfMTUzMjgxODM2My5qcGc=",
        "name": "urbanski-nieruchomosci-dominik-urbanski",
        "alt": "URBAŃSKI NIERUCHOMOŚCI DOMINIK URBAŃSKI"
      },
      "name": "URBAŃSKI NIERUCHOMOŚCI DOMINIK URBAŃSKI",
      "phones": [
        "660 872 147"
      ],
      "type": "AGENCY"
    },
    "contact_comment": [],
    "person": {
      "faxes": [],
      "name": "Dominik Urbański",
      "phones": [
        "660872147"
      ],
      "photo": {
        "id": "aHR0cHM6Ly9pbWczLnN0YXRpY21vcml6b24uY29tLnBsL3RodW1ibmFpbC9hSFIwY0RvdkwyMWxaR2xoTG1SdmJYa3VjR3d2TDJsdFp5OTFlbmwwYTI5M2JtbGplUzgxTlRZeE1HSXpZMk5qWXpReFltTXpaakE0TXpFeU5EUmtZekUxT0RGbE5DNXdibWM9LzIwMC8yMDAvMi90aHVtYm5haWwuanBn",
        "name": "dominik-urbanski",
        "alt": "Dominik Urbański"
      },
      "type": "ASSISTANT"
    }
  },
  "description": "<p>Biuro Urbański Nieruchomości prezentuje:</p><p>Na sprzedaż funkcjonalne i starannie wykończone mieszkanie o powierzchni 35,55 m², usytuowane na 2. piętrze w nowoczesnym, 3-piętrowym budynku z 2017 roku, wyposażonym w windę.</p><p>Lokal został zaprojektowany z myślą o wygodzie codziennego użytkowania i jest gotowy do zamieszkania.</p><p>Powierzchnia 35,55 m² obejmuje:</p><p>- przestronny salon z aneksem kuchennym,</p><p>- ustawną sypialnię,</p><p>- łazienkę z prysznicem i umywalką,</p><p>- przedpokój.</p><p>Atuty nieruchomości:</p><p>- duża loggia o powierzchni 8 m², stanowiąca idealne miejsce do wypoczynku,</p><p>- korzystna ekspozycja okien zapewniająca naturalne doświetlenie wnętrz od godzin południowych aż do wieczora,</p><p>- komórka lokatorska o powierzchni 3,05 m² w cenie mieszkania,</p><p>- nowoczesny budynek z windą,</p><p>- kameralna zabudowa oraz wysoki standard części wspólnych.</p><p>Do mieszkania przynależy miejsce postojowe w garażu podziemnym (jednostanowiskowe, szerokość ok. 4 m), płatne dodatkowo 70 000 zł.</p><p>Nieruchomość doskonale sprawdzi się zarówno jako komfortowe mieszkanie dla singla lub pary, jak i atrakcyjna inwestycja pod wynajem.</p><p>Nasze biuro zajmuje się kompleksową obsługą sprzedaży i zakupu nieruchomości oraz bezpłatnie pomaga w uzyskaniu najlepszej oferty kredytowej na rynku.</p><p>Zapraszamy do kontaktu w celu uzyskania dodatkowych informacji oraz umówienia terminu prezentacji. To mieszkanie warto zobaczyć na żywo.</p><p>Cena: 470 000 zł </p><p>Opiekun oferty:</p><p>Dominik Urbański</p><p><span class=\"replacePhone\">660 872 147</span></p>",
  "detailed_information": [
    {
      "label": "Pow. całkowita",
      "value": "35,55 m²",
      "url": null
    },
    {
      "label": "Piętro",
      "value": "2/3",
      "url": null
    },
    {
      "label": "Liczba pięter",
      "value": "3",
      "url": null
    },
    {
      "label": "Typ kuchni",
      "value": "Aneks",
      "url": null
    },
    {
      "label": "Liczba łazienek",
      "value": "1",
      "url": null
    },
    {
      "label": "łazienka razem z WC",
      "value": "Tak",
      "url": null
    },
    {
      "label": "Loggia",
      "value": "Tak",
      "url": null
    },
    {
      "label": "Pow. loggii",
      "value": "3,05 m²",
      "url": null
    },
    {
      "label": "Ogród",
      "value": "Nie",
      "url": null
    },
    {
      "label": "Rynek",
      "value": "Wtórny",
      "url": null
    },
    {
      "label": "Dostępne od",
      "value": "28.07.2026",
      "url": null
    },
    {
      "label": "Forma własności",
      "value": "Własność",
      "url": null
    },
    {
      "label": "Na biuro",
      "value": "Tak",
      "url": null
    },
    {
      "label": "Liczba pokoi",
      "value": "2",
      "url": "/nieruchomosci/mieszkania/2-pokojowe/kielce/piaski"
    }
  ],
  "environment": {
    "air_quality": null,
    "noise_level": null,
    "urban_greenery": null,
    "public_transport": [
      {
        "type": "BUS",
        "type_name": "Autobus",
        "name": "Witosa / Piwowarska",
        "distance": 215,
        "formatted_distance": "215 m"
      },
      {
        "type": "BUS",
        "type_name": "Autobus",
        "name": "Witosa / Zagnańska",
        "distance": 237,
        "formatted_distance": "237 m"
      },
      {
        "type": "BUS",
        "type_name": "Autobus",
        "name": "Peryferyjna",
        "distance": 321,
        "formatted_distance": "321 m"
      },
      {
        "type": "BUS",
        "type_name": "Autobus",
        "name": "Zagnańska / Witosa",
        "distance": 332,
        "formatted_distance": "332 m"
      },
      {
        "type": "BUS",
        "type_name": "Autobus",
        "name": "Morawieckiego / Zagnańska",
        "distance": 396,
        "formatted_distance": "396 m"
      },
      {
        "type": "BUS",
        "type_name": "Autobus",
        "name": "Zagnańska szkoła",
        "distance": 440,
        "formatted_distance": "440 m"
      }
    ],
    "service_points": [
      {
        "type": "CONVENIENCE",
        "type_name": "Sklep osiedlowy",
        "name": "Żabka",
        "distance": 129,
        "formatted_distance": "129 m"
      }
    ]
  },
  "equipments": [
    {
      "icon": "furniture",
      "label": "Meble"
    },
    {
      "icon": "kitchen_is_furnished",
      "label": "Umeblowana kuchnia"
    }
  ],
  "etag": "e32351c25d847aec",
  "facilities": [
    {
      "icon": "closed_complex",
      "label": "Obiekt zamknięty"
    },
    {
      "icon": "elevator",
      "label": "Winda (1)"
    },
    {
      "icon": "intercom",
      "label": "Domofon"
    },
    {
      "icon": "parking_places",
      "label": "Miejsce postojowe (garaż)"
    }
  ],
  "floor_formatted": "piętro 2/3",
  "highlighted_parameters": [
    {
      "type": "ROOMS",
      "label": "Pokoje",
      "value": "2"
    },
    {
      "type": "AREA",
      "label": "Powierzchnia",
      "value": "35,55 m²"
    },
    {
      "type": "FLOOR",
      "label": "Piętro",
      "value": "2 / 3 z windą"
    },
    {
      "type": "PARKING",
      "label": "Parking",
      "value": "dostępny"
    }
  ],
  "header_title": "Mieszkanie na sprzedaż",
  "id": 1542762214,
  "id_on_frontend": "48345669",
  "is_highlighted": false,
  "is_top_promoted": false,
  "ing_mortgage_calculator": {
    "url": "https://clk.tradedoubler.com/click?p=122963&a=3143100&g=25160290&url=https%3A%2F%2Fwww.ing.pl%2Flp%2Fkredyt-hipoteczny-widget%3Futm_campaign%3Dkihipoteka-perfo-20170501%26utm_source%3Dwww.gratka.pl%26utm_medium%3Ddisplay%26utm_content%3Dkredyt-widget%26utm_term%3Dwidget-kalkulator%26PARTNER%3DtradedoublerGr%26tPeriod%3D30%26tProduct%3DbWllc3prYW5pZSUyMG5hJTIwc3ByemVkYSVDNSVCQyUyMCVDNSU5QndpJUM0JTk5dG9rcnp5c2tpZSUyQyUyMEtpZWxjZSUyQyUyMFBpYXNraSUyMFdpbmNlbnRlZ28lMjBXaXRvc2E=%26tImg%3DaHR0cHM6Ly9pbWcxLnN0YXRpY21vcml6b24uY29tLnBsL3RodW1iL2FIUjBjSE02THk5a0xXZHlMbU5rYm1keUxuQnNMMnRoWkhKNUwyc3ZjaTluY2kxdloyd3ZOMkV2Wm1Rdk5EZ3pORFUyTmpsZk1UVXpNamM0TXpNeU4xOXRhV1Z6ZW10aGJtbGxMV3RwWld4alpTMXdhV0Z6YTJrdGRXd3RkMmx1WTJWdWRHVm5ieTEzYVhSdmMyRXRNVEF6WVM1cWNHYz0vM3gyX2w6ZmlsbF9hbmRfY3JvcC9taWVzemthbmllLW5hLXNwcnplZGF6LTM1LW0uanBn%26tAmount%3D470000",
    "rrso": "RRSO 6,17%\n",
    "disclaimer": "        <div class=\"creditCalc__costContainer\" data-expand-box>\n          <div class=\"creditCalc__rolled ql-container\" data-expand-box-rolled>\n            <p class=\"creditCalc__costText\">\n              <b></b>\n            </p>\n            <p class=\"creditCalc__costText\">\n              <b>Rzeczywista Roczna Stopa Oprocentowania (RRSO) 6,17%</b>, dla kredytu hipotecznego w ofercie Lato u siebie - łatwy start z oprocentowaniem zmiennym, przy założeniach: okres kredytowania 16 lat i 11 miesięcy, całkowita kwota kredytu zabezpieczonego hipoteką (bez kredytowanych kosztów) wypłacona jednorazowo 230,000 zł, całkowita kwota do zapłaty 364,194.47 zł, oprocentowanie zmienne 5,63% w tym: wskaźnik referencyjny WIBOR 1M  3,78%  oraz marża 1.85%, całkowity koszt kredytu 134,194.47 zł w tym: prowizja 0 zł, odsetki 126,377.22 zł, podatek PCC 19 zł, ubezpieczenie nieruchomości zawarte za pośrednictwem banku 4,504.32 zł (dla jednej nieruchomości, na cały okres kredytowania), opłaty za: wycenę nieruchomości zlecaną przez bank 560 zł (mieszkanie), Konto w Planie ING Go w wysokości 0 zł udostępnianego wraz z rachunkiem osobistym którego koszt wynosi 0 zł, Moje ING 0 zł, ubezpieczenie spłaty kredytu Twoja Ochrona Życia z Nationale-Nederlanden (za okres 3 lat) 2,733.93 zł , 203 miesięcznych uśrednionych rat kapitałowo-odsetkowych po 1,755.55 zł. Kredyt wymaga zabezpieczenia w wysokości min. 345,000 zł. Kalkulacja wykonana 2026-07-20 na reprezentatywnym przykładzie. Zmienne oprocentowanie niesie ze sobą ryzyko wzrostu wysokości raty kredytu, a tym samym całkowitej kwoty do zapłaty. Informacja nie stanowi oferty w rozumieniu przepisów prawa, udzielenie kredytu i jego warunki zależą od wyniku oceny zdolności kredytowej i proponowanego zabezpieczenia.  ING Bank Śląski S.A.\n            </p>\n          </div>\n        </div>\n"
  },
  "last_modified": "Fri, 24 Jul 2026 02:28:32 GMT",
  "refreshed_at": "2026-07-24 02:27:52",
  "lendi_mortgage_calculation_url": "https://www.lendi.pl/formularz/kredyty-hipoteczne?utm_data_grabber=form_before_installment_comparer&utm_form=heading_check_installment&utm_fp_partner_id=551&utm_fp_source_id=91&utm_interest=installment_calculation&utm_loan_category=Mortgage&utm_keyword=sprawdz_rate&utm_medium=offer_website&utm_source=morizon.pl&hypothecValue=470000&loanPurpose.what=Apartment&loanPurpose.market=SecondaryMarket&meeting_voivoidship=%C5%9Bwi%C4%99tokrzyskie&meeting_city=Kielce",
  "lendi_mortgage_form_calculation_url": "https://www.lendi.pl/formularz/kredyty-hipoteczne?utm_data_grabber=form_before_installment_comparer&utm_fp_partner_id=551&utm_fp_source_id=91&utm_form=installment_widget&utm_interest=installment_calculation&utm_keyword=oblicz_rate&utm_loan_category=Mortgage&utm_medium=offer_website&utm_source=morizon.pl&hypothecValue=%7B%7BhypothecValue%7D%7D&loanPeriod=%7B%7BloanPeriod%7D%7D&loanPurpose.what=Apartment&loanPurpose.market=SecondaryMarket&meeting_voivoidship=%C5%9Bwi%C4%99tokrzyskie&meeting_city=Kielce&meeting_community=",
  "location": {
    "country_code": "PL",
    "location": [
      "świętokrzyskie",
      "Kielce",
      "Piaski"
    ],
    "map": {
      "center": {
        "latitude": 50.8994,
        "longitude": 20.6384
      },
      "zoom": 13
    },
    "number": "103a",
    "street": "Wincentego Witosa",
    "county": null,
    "commune": null
  },
  "market_type": "Rynek wtórny",
  "number_of_rooms": "2 pokoje",
  "offer_detailed_information": [
    {
      "label": "Data dodania",
      "value": "23.07.2026"
    },
    {
      "label": "Aktualizacja",
      "value": "24.07.2026"
    },
    {
      "label": "Numer ogłoszenia",
      "value": "gratka-18"
    },
    {
      "label": "Liczba odsłon",
      "value": "33"
    },
    {
      "label": "Liczba Punktów Podbić",
      "value": "0"
    }
  ],
  "photos": [
    {
      "id": "aHR0cHM6Ly9kLWdyLmNkbmdyLnBsL2thZHJ5L2svci9nci1vZ2wvN2EvZmQvNDgzNDU2NjlfMTUzMjc4MzMyN19taWVzemthbmllLWtpZWxjZS1waWFza2ktdWwtd2luY2VudGVnby13aXRvc2EtMTAzYS5qcGc=",
      "name": "mieszkanie-na-sprzedaz-35-m",
      "alt": "Mieszkanie na sprzedaż 36m2 Kielce Piaski Wincentego Witosa - zdjęcie 1"
    },
    {
      "id": "aHR0cHM6Ly9kLWdyLmNkbmdyLnBsL2thZHJ5L2svci9nci1vZ2wvN2EvZmQvNDgzNDU2NjlfMTUzMjc4MzMzOV9taWVzemthbmllLWtpZWxjZS1waWFza2ktdWwtd2luY2VudGVnby13aXRvc2EtMTAzYS5qcGc=",
      "name": "mieszkanie-na-sprzedaz-35-m",
      "alt": "Mieszkanie na sprzedaż 36m2 Kielce Piaski Wincentego Witosa - zdjęcie 2"
    },
    {
      "id": "aHR0cHM6Ly9kLWdyLmNkbmdyLnBsL2thZHJ5L2svci9nci1vZ2wvN2EvZmQvNDgzNDU2NjlfMTUzMjc4MzQxOV9taWVzemthbmllLWtpZWxjZS1waWFza2ktdWwtd2luY2VudGVnby13aXRvc2EtMTAzYS5qcGc=",
      "name": "mieszkanie-na-sprzedaz-35-m",
      "alt": "Mieszkanie na sprzedaż 36m2 Kielce Piaski Wincentego Witosa - zdjęcie 3"
    },
    {
      "id": "aHR0cHM6Ly9kLWdyLmNkbmdyLnBsL2thZHJ5L2svci9nci1vZ2wvN2EvZmQvNDgzNDU2NjlfMTUzMjc4MzQzM19taWVzemthbmllLWtpZWxjZS1waWFza2ktdWwtd2luY2VudGVnby13aXRvc2EtMTAzYS5qcGc=",
      "name": "mieszkanie-na-sprzedaz-35-m",
      "alt": "Mieszkanie na sprzedaż 36m2 Kielce Piaski Wincentego Witosa - zdjęcie 4"
    },
    {
      "id": "aHR0cHM6Ly9kLWdyLmNkbmdyLnBsL2thZHJ5L2svci9nci1vZ2wvN2EvZmQvNDgzNDU2NjlfMTUzMjc4MzQzOV9taWVzemthbmllLWtpZWxjZS1waWFza2ktdWwtd2luY2VudGVnby13aXRvc2EtMTAzYS5qcGc=",
      "name": "mieszkanie-na-sprzedaz-35-m",
      "alt": "Mieszkanie na sprzedaż 36m2 Kielce Piaski Wincentego Witosa - zdjęcie 5"
    },
    {
      "id": "aHR0cHM6Ly9kLWdyLmNkbmdyLnBsL2thZHJ5L2svci9nci1vZ2wvN2EvZmQvNDgzNDU2NjlfMTUzMjc4MzUwM19taWVzemthbmllLWtpZWxjZS1waWFza2ktdWwtd2luY2VudGVnby13aXRvc2EtMTAzYS5qcGc=",
      "name": "mieszkanie-na-sprzedaz-35-m",
      "alt": "Mieszkanie na sprzedaż 36m2 Kielce Piaski Wincentego Witosa - zdjęcie 6"
    },
    {
      "id": "aHR0cHM6Ly9kLWdyLmNkbmdyLnBsL2thZHJ5L2svci9nci1vZ2wvN2EvZmQvNDgzNDU2NjlfMTUzMjc4MzUwN19taWVzemthbmllLWtpZWxjZS1waWFza2ktdWwtd2luY2VudGVnby13aXRvc2EtMTAzYS5qcGc=",
      "name": "mieszkanie-na-sprzedaz-35-m",
      "alt": "Mieszkanie na sprzedaż 36m2 Kielce Piaski Wincentego Witosa - zdjęcie 7"
    },
    {
      "id": "aHR0cHM6Ly9kLWdyLmNkbmdyLnBsL2thZHJ5L2svci9nci1vZ2wvN2EvZmQvNDgzNDU2NjlfMTUzMjc4MzUxNV9taWVzemthbmllLWtpZWxjZS1waWFza2ktdWwtd2luY2VudGVnby13aXRvc2EtMTAzYS5qcGc=",
      "name": "mieszkanie-na-sprzedaz-35-m",
      "alt": "Mieszkanie na sprzedaż 36m2 Kielce Piaski Wincentego Witosa - zdjęcie 8"
    },
    {
      "id": "aHR0cHM6Ly9kLWdyLmNkbmdyLnBsL2thZHJ5L2svci9nci1vZ2wvN2EvZmQvNDgzNDU2NjlfMTUzMjc4MzU4N19taWVzemthbmllLWtpZWxjZS1waWFza2ktdWwtd2luY2VudGVnby13aXRvc2EtMTAzYS5qcGc=",
      "name": "mieszkanie-na-sprzedaz-35-m",
      "alt": "Mieszkanie na sprzedaż 36m2 Kielce Piaski Wincentego Witosa - zdjęcie 9"
    },
    {
      "id": "aHR0cHM6Ly9kLWdyLmNkbmdyLnBsL2thZHJ5L2svci9nci1vZ2wvN2EvZmQvNDgzNDU2NjlfMTUzMjc4MzYwM19taWVzemthbmllLWtpZWxjZS1waWFza2ktdWwtd2luY2VudGVnby13aXRvc2EtMTAzYS5qcGc=",
      "name": "mieszkanie-na-sprzedaz-35-m",
      "alt": "Mieszkanie na sprzedaż 36m2 Kielce Piaski Wincentego Witosa - zdjęcie 10"
    },
    {
      "id": "aHR0cHM6Ly9kLWdyLmNkbmdyLnBsL2thZHJ5L2svci9nci1vZ2wvN2EvZmQvNDgzNDU2NjlfMTUzMjc4MzYxNV9taWVzemthbmllLWtpZWxjZS1waWFza2ktdWwtd2luY2VudGVnby13aXRvc2EtMTAzYS5qcGc=",
      "name": "mieszkanie-na-sprzedaz-35-m",
      "alt": "Mieszkanie na sprzedaż 36m2 Kielce Piaski Wincentego Witosa - zdjęcie 11"
    },
    {
      "id": "aHR0cHM6Ly9kLWdyLmNkbmdyLnBsL2thZHJ5L2svci9nci1vZ2wvN2EvZmQvNDgzNDU2NjlfMTUzMjc4MzY2MV9taWVzemthbmllLWtpZWxjZS1waWFza2ktdWwtd2luY2VudGVnby13aXRvc2EtMTAzYS5qcGc=",
      "name": "mieszkanie-na-sprzedaz-35-m",
      "alt": "Mieszkanie na sprzedaż 36m2 Kielce Piaski Wincentego Witosa - zdjęcie 12"
    }
  ],
  "plans": [],
  "presentation_type": "ACTIVE",
  "price": {
    "amount": "470000.00",
    "currency": "PLN"
  },
  "price_m2": {
    "amount": "13220.82",
    "currency": "PLN"
  },
  "price_formatted": "470 000 zł",
  "price_m2_formatted": "13 221 zł/m²",
  "promotion_points": 0,
  "reference": "18",
  "sales_manago_data": {
    "property_market_type": "wtórny",
    "property_transaction_type": "sprzedaż",
    "property_type": "mieszkanie"
  },
  "similar_listing_url": "/nieruchomosci/mieszkania/kielce/piaski?cena-calkowita:max=540000&cena-calkowita:min=390000&powierzchnia-w-m2:max=40&powierzchnia-w-m2:min=30",
  "status": 200,
  "archive_category_redirect_url": null,
  "supported_languages": [],
  "tags": null,
  "ai_tags": [],
  "title": "Komfortowe 2-pokojowe mieszkanie z dużą loggią | Garaż podziemny | Winda",
  "transaction": "SALE",
  "types": {
    "primary_type": "FLAT",
    "primary_type_root": "FLAT",
    "main_type": "FLAT",
    "main_type_root": "FLAT"
  },
  "url": "/nieruchomosci/mieszkanie-kielce-piaski-wincentego-witosa/ob/48345669",
  "utilities": [],
  "view_3d": null,
  "videos": [
    "https://www.youtube.com/embed/wkyjonkuU7E"
  ],
  "service_promocena_is_active": false,
  "omnibus_previous_sale_price": null,
  "omnibus_previous_lowest_price": null,
  "questions_about_missing_details": [
    {
      "key": "MONTHLY_COST",
      "question": "Jaki jest całkowity koszt miesięczny (czynsz + wszystkie opłaty)?"
    },
    {
      "key": "HEATING",
      "question": "Jakie jest ogrzewanie?"
    }
  ],
  "realization_status": null
}

Each scraped property returns a rich record with 40+ fields organized by category:

Basic Identification

Field	Meaning
ID	Unique internal Gratka identifier for the property
ID On Frontend	Public-facing property ID displayed to users
Reference	Additional reference number for the listing
URL	Direct link to the property detail page
Title	Property headline as listed (e.g., "3-room apartment in Warsaw")
Header Title	Formatted title displayed in search results
ETag	Version identifier for cache validation

Pricing Information

Field	Meaning
Price	Listed price in Polish Zloty (PLN)
Price Formatted	Price with currency formatting (e.g., "450,000 PLN")
Price M2	Price per square meter (PLN/m²)
Price M2 Formatted	Formatted price per square meter
Omnibus Previous Sale Price	Historical price from previous listing (if available)
Omnibus Previous Lowest Price	Lowest price history for the property

Property Specifications

Field	Meaning
Area	Total usable area in square meters
Number Of Rooms	Count of rooms (bedrooms and living areas)
Floor Formatted	Floor level display (e.g., "3rd floor", "ground floor")
Building Detailed Information	Construction year, building type, material, condition
Description	Full property description text
Advertisement Text	Custom marketing text added by the seller
Detailed Information	Structured property attributes and specifications

Amenities & Features

Field	Meaning
Equipments	Built-in appliances and fixtures (kitchen, heating, etc.)
Facilities	Building amenities (elevator, parking, security, etc.)
Environment	Surrounding area features (green space, proximity to transport)
Utilities	Available utilities (water, gas, electricity status)
Highlighted Parameters	Key selling features emphasized by the seller
Tags	Categorical tags assigned to the property
AI Tags	Automatically generated tags from AI analysis

Location & Market Data

Field	Meaning
Location	Structured location data (district, street, coordinates)
Market Type	Property category (residential, commercial, land)
Types	Specific property type (apartment, house, studio, etc.)
Transaction	Deal type (sale, rent, exchange)
Status	Listing status (active, sold, archived)

Media & Visuals

Field	Meaning
Photos	Array of property photo URLs in high resolution
Videos	URLs to video tours or property walkthroughs
Plans	URLs to floor plans or architectural drawings
View 3D	Link to 3D virtual tour (if available)

Promotion & Visibility

Field	Meaning
Is Highlighted	Boolean indicating if the listing is highlighted/featured
Is Top Promoted	Whether the listing has premium top placement
Promotion Points	Points accumulated for featured placement
Service Promocena Is Active	Status of Promocena (premium visibility service)
Archive Category Redirect URL	URL for archived listings

Financial Tools & Integrations

Field	Meaning
ING Mortgage Calculator	Integration link to ING's mortgage calculator
Lendi Mortgage Calculation URL	Lendi mortgage pre-calculation link
Lendi Mortgage Form Calculation URL	Direct link to Lendi mortgage form

Administrative & Metadata

Field	Meaning
Contact	Seller/agent contact information
Last Modified	Timestamp of the last listing update
Refreshed At	When the scraper last refreshed this record
Presentation Type	How the listing is presented (standard, premium, etc.)
Similar Listing URL	Link to other comparable properties
Supported Languages	Languages in which the listing is available
Sales Manago Data	CRM integration data (if applicable)
Questions About Missing Details	User-submitted questions about the property
Realization Status	Development stage (for new constructions)

---

How to Use

1. Gather property URLs — Navigate to Gratka.pl and open individual property detail pages. Copy the full URL from your browser.
2. Prepare your input — Create a JSON file with the urls array populated with property links. Set max_items_per_url (typically 200 for detailed data).
3. Enable fault tolerance — Set ignore_url_failures: true to handle temporary network issues or unavailable listings gracefully.
4. Launch the scraper — Start the scraper actor and monitor the run log for progress.
5. Export and analyze — Download results in JSON, CSV, or Excel format for downstream analysis in spreadsheets, databases, or BI tools.

Tips:

• Start with a small batch of URLs to test the configuration.
• Ensure URLs point to individual property detail pages, not search results.
• Property details update frequently; refresh data periodically for current market intelligence.

---

Use Cases & Business Value

• Market analysis: Track price trends, supply levels, and demand patterns across Polish cities
• Investment research: Identify undervalued properties, emerging neighborhoods, and market opportunities
• Aggregator platforms: Consolidate Gratka listings with other portals into a unified database
• Valuation modeling: Build datasets for machine learning models that predict property prices
• Competitive intelligence: Monitor competitor listings, pricing strategies, and market positioning
• Academic research: Analyze housing affordability, urbanization patterns, and real estate dynamics

The Gratka.pl Property Scraper transforms hours of manual data collection into minutes of automated extraction, enabling faster insights and better-informed decisions in the real estate market.

---

Conclusion

The Gratka.pl Property Details Scraper is a powerful tool for anyone needing structured real estate data from Poland's largest property marketplace. With 40+ fields covering pricing, specifications, media, and market positioning, it provides the comprehensive dataset needed for analysis, valuation, and market intelligence. Automate your data collection today and unlock insights that drive real estate strategy.