Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Gratka

1 credit per call2 endpoints24 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 keyRun 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 OKJSONX-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.

#idstringurlurltitlestringheadlinestringpriceobjectprice_formattedstringprice_per_m2objectprice_per_m2_formattedstringarea_m2integerroomsintegerrooms_labelstringfloor_labelstringaddressobjectphotosobject[]photo_countintegerplans_countintegerhas_3d_viewbooleanhas_videobooleandescriptionstringadded_atstringrefreshed_atstringis_promotedbooleanis_developmentbooleanagentobject
148943351https://gratka.pl/nieruchomosci/mieszkanie-krakow-stare-miasto-aleja-juliusza-slowackiego/oi/48943351mieszkanie na wynajemStare Miasto-Słowackiego!125m2-lok. biurowy! 4pok! Lokalizacja! Klimatyzacja!{2 fields}64 zł{2 fields}1 zł/m²12544 pokojepiętro 3/6{5 fields}[3 items]210falsefalseLokal 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-122026-09-13 18:56:44falsefalse{2 fields}
249095295https://gratka.pl/nieruchomosci/mieszkanie-krakow-pradnik-czerwony-marcholta/ob/49095295kawalerka na wynajemMarchołta - pokój do wynajęcia w mieszkaniu 3 pok.{2 fields}1 000 zł{2 fields}54 zł/m²1811 pokójpiętro 5/6{5 fields}[3 items]130falsefalseDo 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-262026-10-28 16:49:06falsefalse{2 fields}
349357511https://gratka.pl/nieruchomosci/mieszkanie-krakow-pradnik-bialy-skrajna/ob/49357511kawalerka na wynajemDużu pokój do wynajęcia ul. Skrajna - wspólna kuchnia i łazienka{2 fields}1 100 zł{2 fields}31 zł/m²3611 pokójpiętro 2/2{4 fields}[3 items]80falsefalseDo 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—falsefalse{2 fields}

Recorded from our API · 3 items shown · 24 datapoints per itemGET /v1/gratka/search?type=mieszkania&transaction=rent&location=krakow&price_max=3000&sort=cheap

24 datapoints

Identity

  • idstring
  • titlestring

Contact

  • urlurl
  • agentobject

Location

  • area_m2integer
  • addressobject

Reputation

  • photosobject[]
  • photo_countinteger

Price

  • priceobject
  • price_formattedstring
  • price_per_m2object
  • price_per_m2_formattedstring

Other

  • headlinestring
  • roomsinteger
  • rooms_labelstring
  • floor_labelstring
  • plans_countinteger
  • has_3d_viewboolean
  • has_videoboolean
  • descriptionstring
  • added_atstring
  • refreshed_atstring
  • is_promotedboolean
  • is_developmentboolean

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/gratka/location-autocomplete
query
1 credit
GET/v1/gratka/search
none+11 optional
1 credit

Overview

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 estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

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 keyRead the docs