APIs / Gratka / Search

Gratka: Search

Search from Gratka as JSON. 1 credit per successful call.

GET /v1/gratka/search

Parameters

Send parameters in the query string.

ParameterTypeRequiredAllowed values
typestringOptionalmieszkania, domy, pokoje, lokale-uzytkowe, garaze, dzialki-grunty
transactionstringOptionalsale, rent
locationstringOptionalAny
districtstringOptionalAny
price_minintegerOptionalAny
price_maxintegerOptionalAny
area_minintegerOptionalAny
area_maxintegerOptionalAny
roomsintegerOptional2, 3, 4
sortstringOptionalnewest, oldest, cheap, expensive, cheap-m2, expensive-m2, rooms-few, rooms-many, small, large
pageintegerOptionalAny

Example request

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.

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.