Gratka: Search
Search from Gratka as JSON. 1 credit per successful call.
GET /v1/gratka/search
Parameters
Send parameters in the query string.
| Parameter | Type | Required | Allowed values |
|---|---|---|---|
type | string | Optional | mieszkania, domy, pokoje, lokale-uzytkowe, garaze, dzialki-grunty |
transaction | string | Optional | sale, rent |
location | string | Optional | Any |
district | string | Optional | Any |
price_min | integer | Optional | Any |
price_max | integer | Optional | Any |
area_min | integer | Optional | Any |
area_max | integer | Optional | Any |
rooms | integer | Optional | 2, 3, 4 |
sort | string | Optional | newest, oldest, cheap, expensive, cheap-m2, expensive-m2, rooms-few, rooms-many, small, large |
page | integer | Optional | Any |
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.