PolandRent Data API

Clean, structured Polish rental data — median rents, fair ranges, and sample sizes by city, district, and room count. Live now, keyless, free.

The API is in open beta: every endpoint below responds today, no API key, no card, no signup. All figures are CC-BY 4.0 — cite "PolandRent (polandrent.com)" and you're done. The data is the same published dataset the site renders, refreshed nightly from live listings.

curl https://polandrent.com/api/v1/median-rents/krakow

Endpoints

Base URL: https://polandrent.com/api/v1 · All responses are JSON, all rents in PLN, all figures dated (meta.updated_at).

Response examples below are illustrative — call the endpoints for live figures.

`GET /api/v1/cities`

Every covered city with its headline 2-room median and sample size.

curl https://polandrent.com/api/v1/cities

{
  "data": [
    {
      "slug": "warszawa",
      "name": "Warsaw",
      "name_pl": "Warszawa",
      "districts": 18,
      "median_rent_2room_pln": 4400,
      "sample_size": 2980
    }
  ],
  "meta": {
    "count": 49,
    "as_of": "Q3 2026",
    "updated_at": "2026-07-21",
    "currency": "PLN",
    "license": "CC-BY-4.0",
    "attribution": "PolandRent (https://polandrent.com), CC-BY 4.0"
  }
}

`GET /api/v1/districts`

Every district with published rent data, with its city and 2-room median.

curl https://polandrent.com/api/v1/districts

`GET /api/v1/median-rents/{city}`

The full published grid for one city: city-wide medians per room count (district: null) plus every district cell — each with median, p25–p75 fair range, and sample size.

curl https://polandrent.com/api/v1/median-rents/krakow

{
  "data": {
    "city": "krakow",
    "city_name": "Kraków",
    "rows": [
      { "district": null, "district_name": null, "rooms": 2, "median_pln": 3400, "p25_pln": 3000, "p75_pln": 3900, "sample_size": 1240 },
      { "district": "stare-miasto", "district_name": "Old Town", "rooms": 2, "median_pln": 3900, "p25_pln": 3400, "p75_pln": 4500, "sample_size": 210 }
    ]
  },
  "meta": { "count": 46, "as_of": "Q3 2026", "updated_at": "2026-07-21", "currency": "PLN", "license": "CC-BY-4.0" }
}

Terms of the open beta

Free and keyless. No authentication, no request quota enforced today. Be reasonable; heavy automated use should cache (responses carry Cache-Control).
Attribution required. The data is CC-BY 4.0 — credit "PolandRent (polandrent.com)" wherever figures appear.
Freshness. Aggregates refresh nightly; meta.updated_at is the snapshot date of every response.
Stability. v1 response shapes are stable; new fields may be added, existing ones won't be removed or renamed without a version bump.

Coming later — Pro & Scale (waitlist)

Higher-volume access with history (month-by-month medians back to mid-2026), CSV/Parquet exports, webhooks, and an SLA is planned but not available yet — we'd rather ship a small API that's real than a pricing page that isn't. Join the waitlist below and you'll hear when it opens.

Academics and journalists: the open beta already covers you — everything is free and citable. For bulk historical extracts, email hello@polandrent.com from your institutional or newsroom address.

Bulk & open data

The full aggregate dataset also ships as the PolandRent Index and the statistics hub, both citable pages.
A versioned open dataset (Hugging Face + DOI) is planned; until it's live, the API above is the canonical machine-readable access.

PolandRent Data API

Endpoints

GET /api/v1/cities

GET /api/v1/districts

GET /api/v1/median-rents/{city}