Search Polish real-estate listings (Gratka.pl)
gratka_searchSearch property listings on Gratka.pl, a major Polish real-estate portal: flats, houses, plots, commercial premises, offices, garages and rooms, for sale or for rent, filtered by location (any Polish city, district, town, village, county or voivodeship), price, area, rooms, private sellers only and primary/secondary market, sorted like the site. Returns one results page (up to 35 listings) with each listing's price, price per m², area, rooms, floor, location, seller and link; pass a listing id to gratka_offer for the full details. Gratka.pl shows the same listings as Morizon.pl (one platform, different ids and links): search one portal, not both, and use gratka_offer only with Gratka.pl ids. Fetched live from Gratka.pl's own API (typically under 1 s). Result shape: { source, fetchedAt, query, search_url, heading, resolved_location, total_count, page, total_pages, count, listings: [...], note? } — the list key is listings; total_count counts matches across all pages (use page for more); resolved_location is the place location was matched to. Each listing: { source, id, url, title, category, kind, development, price, price_per_m2, currency, area_m2, rooms, floor, location, street, district, city, region, seller_type, seller_name, date_posted, refreshed_at, image, photo_count, description }. Prices are numbers in PLN (for rent, price is the monthly rent) and area is in m²; fields are null when the listing omits them. kind is 'new_development' for a developer's unit in a new project (named in development), else 'listing'; seller_type is agency | private | developer. An empty match answers count: 0 with a note saying why and what to change — that is a successful result, not an error.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Results page, 1-based (35 listings per page). Default 1. | |
| sort | No | Order: 'newest' (recently added), 'price_asc' / 'price_desc', 'price_per_m2_asc' / 'price_per_m2_desc', 'area_asc' / 'area_desc'. Default: the site's own order (recently refreshed). | |
| type | Yes | Property type: 'flat' = mieszkanie, 'house' = dom, 'plot' = działka/grunt (land), 'commercial' = lokal użytkowy (any commercial premises), 'office' = biuro, 'garage' = garaż, 'room' = pokój (a room to rent — rent only). | |
| market | No | 'primary' = new build from a developer (rynek pierwotny), 'secondary' = resale (rynek wtórny). | |
| area_max | No | Maximum area in m² (the plot's area for type 'plot'). | |
| area_min | No | Minimum area in m² (the plot's area for type 'plot'). | |
| location | No | Where, as a Polish place name, matched by the site's own location search: a city ('Kraków'), a district ('Warszawa Mokotów', 'Gdańsk Wrzeszcz'), a town or village, a county ('krakowski') or a whole voivodeship ('mazowieckie'). Diacritics are optional; English names other than Warsaw/Cracow are not recognised. Omit to search all of Poland. | |
| no_cache | No | Force a fresh fetch and bypass this server's result cache (5 min). Default false. | |
| price_max | No | Maximum total price in PLN (monthly rent when transaction is 'rent'). | |
| price_min | No | Minimum total price in PLN (monthly rent when transaction is 'rent'). | |
| rooms_max | No | Maximum number of rooms — not for types 'plot' and 'garage' (use min = max for exactly N). | |
| rooms_min | No | Minimum number of rooms — not for types 'plot' and 'garage'. | |
| transaction | Yes | 'sale' = na sprzedaż (buying), 'rent' = na wynajem (renting; prices are monthly). | |
| private_only | No | Only listings posted by private owners — no agencies or developers. Default false. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| page | Yes | ||
| count | Yes | ||
| query | Yes | ||
| source | Yes | ||
| heading | No | ||
| listings | Yes | ||
| fetchedAt | Yes | ||
| search_url | Yes | ||
| total_count | No | ||
| total_pages | No | ||
| resolved_location | No |