--- title: "Gratka API: JSON data, 2 endpoints, 1 credit per call" description: "Gratka API for Polish property search, with flats, houses, rooms, commercial units, garages and plots, plus autocomplete as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/gratka --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Gratka 1 credit per call 2 endpoints 24 datapoints # Gratka API Gratka API for Polish property search, with flats, houses, rooms, commercial units, garages and plots, plus autocomplete as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Gratka GET /v1/gratka/search?type=mieszkania&transaction=rent&location=krakow&price\_max=3000&sort=cheap ``` { "success": true, "transaction": "rent", "type": "mieszkania", "applied_filters": { "location": "krakow", "price_max": "3000", "sort": "cheap" }, "total": 1456, "page": 1, "per_page": 35, "total_pages": 42, "has_more": true, "listings": [ { "id": "48943351", "url": "https://gratka.pl/nieruchomosci/mieszkanie-krakow-stare-miasto-aleja-juliusza-slowackiego/oi/48943351", "title": "mieszkanie na wynajem", "headline": "Stare Miasto-Słowackiego!125m2-lok. biurowy! 4pok! Lokalizacja! Klimatyzacja!", "price": { "amount": 64, "currency": "PLN" }, "price_formatted": "64 zł", "price_per_m2": { "amount": 0.51, "currency": "PLN" }, "price_per_m2_formatted": "1 zł/m²", "area_m2": 125, "rooms": 4, "rooms_label": "4 pokoje", "floor_label": "piętro 3/6", "address": { "voivodeship": "małopolskie", "city": "Kraków", "district": "Stare Miasto", "neighbourhood": "Piasek", "street": "Aleja Juliusza Słowackiego" }, "photos": [ { "url": "https://d-gr.cdngr.pl/kadry/k/r/gr-ogl/17/24/48943351_1580677349.jpg", "alt": "Mieszkanie na wynajem 125m2 Kraków Stare Miasto Piasek Aleja Juliusza Słowackiego - zdjęcie 1" }, { "url": "https://d-gr.cdngr.pl/kadry/k/r/gr-ogl/17/24/48943351_1580677747.jpg", "alt": "Mieszkanie na wynajem 125m2 Kraków Stare Miasto Piasek Aleja Juliusza Słowackiego - zdjęcie 2" }, { "url": "https://d-gr.cdngr.pl/kadry/k/r/gr-ogl/17/24/48943351_1580677883.jpg", "alt": "Mieszkanie na wynajem 125m2 Kraków Stare Miasto Piasek Aleja Juliusza Słowackiego - zdjęcie 3" } ], "photo_count": 21, "plans_count": 0, "has_3d_view": false, "has_video": false, "description": "Lokal biurowy z duszą o pow. 125m2 zlokalizowany na 3-cim piętrze w kamienicy z windą w dzielnicy Stare Miasto przy Al. Słowackiego 15a. Doskonała lokalizacja i komunikacja z każdym zakątkiem Krakowa. Składa się z: 4 oddzielnych i bardzo pr…", "added_at": "2026-09-12", "refreshed_at": "2026-09-13 18:56:44", "is_promoted": false, "is_development": false, "agent": { "company": {}, "person": { "name": "Tomasz", "type": "OWNER" } } }, { "id": "49095295", "url": "https://gratka.pl/nieruchomosci/mieszkanie-krakow-pradnik-czerwony-marcholta/ob/49095295", "title": "kawalerka na wynajem", "headline": "Marchołta - pokój do wynajęcia w mieszkaniu 3 pok.", "price": { "amount": 1000, "currency": "PLN" }, "price_formatted": "1 000 zł", "price_per_m2": { "amount": 54.05, "currency": "PLN" }, "price_per_m2_formatted": "54 zł/m²", "area_m2": 18, "rooms": 1, "rooms_label": "1 pokój", "floor_label": "piętro 5/6", "address": { "voivodeship": "małopolskie", "city": "Kraków", "district": "Prądnik Czerwony", "neighbourhood": "Os. Prądnik Czerwony", "street": "Marchołta" }, "photos": [ { "url": "https://d-gr.cdngr.pl/kadry/k/r/gr-ogl/a9/83/49095295_1624983201_mieszkanie-krakow-os-pradnik-czerwony-ul-marcholta.jpg", "alt": "Mieszkanie na wynajem 19m2 Kraków Prądnik Czerwony Os. Prądnik Czerwony Marchołta - zdjęcie 1" }, { "url": "https://d-gr.cdngr.pl/kadry/k/r/gr-ogl/a9/83/49095295_1624983345_mieszkanie-krakow-os-pradnik-czerwony-ul-marcholta.jpg", "alt": "Mieszkanie na wynajem 19m2 Kraków Prądnik Czerwony Os. Prądnik Czerwony Marchołta - zdjęcie 2" }, { "url": "https://d-gr.cdngr.pl/kadry/k/r/gr-ogl/a9/83/49095295_1624983355_mieszkanie-krakow-os-pradnik-czerwony-ul-marcholta.jpg", "alt": "Mieszkanie na wynajem 19m2 Kraków Prądnik Czerwony Os. Prądnik Czerwony Marchołta - zdjęcie 3" } ], "photo_count": 13, "plans_count": 0, "has_3d_view": false, "has_video": false, "description": "Do wynajęcia od 1 października 2026r. jeden pokój w mieszkaniu 3 pokojowym ! Dostępne po podpisaniu umowy najmu ! Mieszkanie 3 pokoje w osiedlu zamkniętym - monitorowanym - enklawa nowych bloków - szlaban do wjazdu samochodem. Pełna infrast…", "added_at": "2026-09-26", "refreshed_at": "2026-10-28 16:49:06", "is_promoted": false, "is_development": false, "agent": { "company": { "id": 69363, "name": "GALUS NIERUCHOMOŚCI - Jan Galus", "type": "AGENCY", "address": [ "Marchołta 55/63", "31-416 Kraków" ], "logo": "https://d-gr.cdngr.pl/kadry/k/r/gr-plogo/c1/3f/69363_1643424807.jpg" }, "person": { "name": "Jan Galus", "type": "AGENT", "photo": "https://img2.staticmorizon.com.pl/thumbnail/aHR0cDovL21lZGlhLmRvbXkucGwvaW1nL3V6eXRrb3duaWN5/200/200/2/thumbnail.jpg" } } }, { "id": "49357511", "url": "https://gratka.pl/nieruchomosci/mieszkanie-krakow-pradnik-bialy-skrajna/ob/49357511", "title": "kawalerka na wynajem", "headline": "Dużu pokój do wynajęcia ul. Skrajna - wspólna kuchnia i łazienka", "price": { "amount": 1100, "currency": "PLN" }, "price_formatted": "1 100 zł", "price_per_m2": { "amount": 30.56, "currency": "PLN" }, "price_per_m2_formatted": "31 zł/m²", "area_m2": 36, "rooms": 1, "rooms_label": "1 pokój", "floor_label": "piętro 2/2", "address": { "voivodeship": "małopolskie", "city": "Kraków", "district": "Prądnik Biały", "street": "Skrajna" }, "photos": [ { "url": "https://d-gr.cdngr.pl/kadry/k/r/gr-ogl/dd/e0/49357511_1634941913_mieszkanie-krakow-pradnik-bialy-ul-skrajna.jpg", "alt": "Mieszkanie na wynajem 36m2 Kraków Prądnik Biały Skrajna - zdjęcie 1" }, { "url": "https://d-gr.cdngr.pl/kadry/k/r/gr-ogl/dd/e0/49357511_1634941917_mieszkanie-krakow-pradnik-bialy-ul-skrajna.jpg", "alt": "Mieszkanie na wynajem 36m2 Kraków Prądnik Biały Skrajna - zdjęcie 2" }, { "url": "https://d-gr.cdngr.pl/kadry/k/r/gr-ogl/dd/e0/49357511_1634941921_mieszkanie-krakow-pradnik-bialy-ul-skrajna.jpg", "alt": "Mieszkanie na wynajem 36m2 Kraków Prądnik Biały Skrajna - zdjęcie 3" } ], "photo_count": 8, "plans_count": 0, "has_3d_view": false, "has_video": false, "description": "Do wynajęcia pokój połozony na poddaszu bloku przy ul. Skrajnej. Pokój ma własny oraz wspólny aneks kuchenny z 4 innymi mieszkankami i łazienkę dzieloną z 1 pokojem. Cena to 1100 zł + opłaty administracyjne 137 zł + media ok 400 zł przy 1 o…", "added_at": "2026-10-20", "is_promoted": false, "is_development": false, "agent": { "company": { "id": 46769, "name": "Max Nieruchomości", "type": "AGENCY", "address": [ " 58", "30-418 Kraków" ], "logo": "https://d-gr.cdngr.pl/kadry/k/r/gr-plogo/e3/8d/46769_1643074611.jpg" }, "person": { "name": "Maja Kurleto", "type": "AGENT", "photo": "https://img2.staticmorizon.com.pl/thumbnail/aHR0cDovL21lZGlhLmRvbXkucGwvaW1nL3V6eXRrb3duaWN5/200/200/2/thumbnail.jpg" } } } ], "meta": { "endpoint_family": "search", "attempts": 1, "filtered_out": 0, "request_id": "req_69945031c08a47568a1ad96f6b7c4aff", "credits_charged": 1, "credits_remaining": 1868 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id string | url url | title string | headline string | price object | price\_formatted string | price\_per\_m2 object | price\_per\_m2\_formatted string | area\_m2 integer | rooms integer | rooms\_label string | floor\_label string | address object | photos object\[\] | photo\_count integer | plans\_count integer | has\_3d\_view boolean | has\_video boolean | description string | added\_at string | refreshed\_at string | is\_promoted boolean | is\_development boolean | agent object | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 48943351 | https://gratka.pl/nieruchomosci/mieszkanie-krakow-stare-miasto-aleja-juliusza-slowackiego/oi/48943351 | mieszkanie na wynajem | Stare Miasto-Słowackiego!125m2-lok. biurowy! 4pok! Lokalizacja! Klimatyzacja! | {2 fields} | 64 zł | {2 fields} | 1 zł/m² | 125 | 4 | 4 pokoje | piętro 3/6 | {5 fields} | \[3 items\] | 21 | 0 | false | false | Lokal biurowy z duszą o pow. 125m2 zlokalizowany na 3-cim piętrze w kamienicy z windą w dzielnicy Stare Miasto przy Al. Słowackiego 15a. Doskonała lokalizacja i komunikacja z każdym zakątkiem Krakowa. Składa się z: 4 oddzielnych i bardzo pr… | 2026-09-12 | 2026-09-13 18:56:44 | false | false | {2 fields} | | 2 | 49095295 | https://gratka.pl/nieruchomosci/mieszkanie-krakow-pradnik-czerwony-marcholta/ob/49095295 | kawalerka na wynajem | Marchołta - pokój do wynajęcia w mieszkaniu 3 pok. | {2 fields} | 1 000 zł | {2 fields} | 54 zł/m² | 18 | 1 | 1 pokój | piętro 5/6 | {5 fields} | \[3 items\] | 13 | 0 | false | false | Do wynajęcia od 1 października 2026r. jeden pokój w mieszkaniu 3 pokojowym ! Dostępne po podpisaniu umowy najmu ! Mieszkanie 3 pokoje w osiedlu zamkniętym - monitorowanym - enklawa nowych bloków - szlaban do wjazdu samochodem. Pełna infrast… | 2026-09-26 | 2026-10-28 16:49:06 | false | false | {2 fields} | | 3 | 49357511 | https://gratka.pl/nieruchomosci/mieszkanie-krakow-pradnik-bialy-skrajna/ob/49357511 | kawalerka na wynajem | Dużu pokój do wynajęcia ul. Skrajna - wspólna kuchnia i łazienka | {2 fields} | 1 100 zł | {2 fields} | 31 zł/m² | 36 | 1 | 1 pokój | piętro 2/2 | {4 fields} | \[3 items\] | 8 | 0 | false | false | Do wynajęcia pokój połozony na poddaszu bloku przy ul. Skrajnej. Pokój ma własny oraz wspólny aneks kuchenny z 4 innymi mieszkankami i łazienkę dzieloną z 1 pokojem. Cena to 1100 zł + opłaty administracyjne 137 zł + media ok 400 zł przy 1 o… | 2026-10-20 | — | false | false | {2 fields} | Recorded from our API · 3 items shown · 24 datapoints per item GET /v1/gratka/search?type=mieszkania&transaction=rent&location=krakow&price\_max=3000&sort=cheap 24 datapoints ### Identity - id string - title string ### Contact - url url - agent object ### Location - area\_m2 integer - address object ### Reputation - photos object\[\] - photo\_count integer ### Price - price object - price\_formatted string - price\_per\_m2 object - price\_per\_m2\_formatted string ### Other - headline string - rooms integer - rooms\_label string - floor\_label string - plans\_count integer - has\_3d\_view boolean - has\_video boolean - description string - added\_at string - refreshed\_at string - is\_promoted boolean - is\_development boolean Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/gratka/search?type=mieszkania&transaction=rent&location=krakow&price_max=3000&sort=cheap" \ -H "X-API-Key: $API_KEY" ``` Gratka · 2 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/gratka/location-autocomplete`](https://perceptlayer.com/apis/gratka/location-autocomplete) | `query` | 1 credit | | [GET `/v1/gratka/search`](https://perceptlayer.com/apis/gratka/search) | none +11 optional | 1 credit | Overview ## About the Gratka API ## What you can get The Gratka API returns Polish property listings from Gratka as JSON through 2 endpoints. - **Search:** `search` takes a `type` (mieszkania, domy, pokoje, lokale-uzytkowe, garaze or dzialki-grunty) and a `transaction` (sale or rent), with `location`, `district`, `price_min`, `price_max`, `area_min`, `area_max`, `rooms` (2, 3 or 4), `sort` (newest, oldest, cheap, expensive, cheap-m2, expensive-m2, rooms-few, rooms-many, small or large) and `page`. - **Locations:** `location-autocomplete` takes a `query`. The recorded `search` for flats to rent in Kraków up to 3,000 PLN, cheapest first, returns `listings`, each with `id`, `url`, `title`, `headline`, `price`, `price_per_m2`, `area_m2`, `rooms`, `floor_label`, `address` (with `voivodeship`, `city`, `district`, `neighbourhood` and `street`), `photos`, `photo_count`, `description`, `added_at`, `refreshed_at`, `is_promoted`, `is_development` and `agent`. It also returns `total` (1,456), `per_page`, `total_pages`, `has_more` and `applied_filters`. ## How a call works Search a city: `GET /v1/gratka/search?type=mieszkania&transaction=rent&location=krakow&price_max=3000&sort=cheap` with your key in the `X-API-Key` header. `location-autocomplete` takes a partial name such as Krak to help you choose a `location`. Page with `page` while `has_more` is true. Every successful call costs 1 credit; failed calls cost nothing. Real estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) Use cases ### Track asking rents and sale prices for flats in Kraków, Warszawa and other Polish cities `Use the Gratka API to track asking rents and sale prices for flats in Kraków, Warszawa and other Polish cities` ### Compare \`price\_per\_m2\` across districts `` Use the Gratka API to compare `price_per_m2` across districts `` ### Watch new and refreshed listings with \`added\_at\` and \`refreshed\_at\` `` Use the Gratka API to watch new and refreshed listings with `added_at` and `refreshed_at` `` ### Size the market for garages, commercial units or plots with \`type\` `` Use the Gratka API to size the market for garages, commercial units or plots with `type` `` FAQ ## Questions **Do I need a Gratka account?** No. You call this Gratka API with your Perceptlayer key in the \`X-API-Key\` header, with no Gratka login. **How much does the Gratka API cost?** Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **What do the property types mean?** \`type\` uses Gratka's Polish categories: mieszkania (flats), domy (houses), pokoje (rooms), lokale-uzytkowe (commercial units), garaze (garages) and dzialki-grunty (plots and land). **Should I build a Gratka scraper instead?** You can, but a Gratka scraper is code you maintain: page changes break it, requests get blocked, and Gratka's terms govern how you collect data. The Gratka API gives you 2 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the Gratka API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)