PolandRent

PolandRent API

Clean, structured Polish rental data — median rents, percentiles, and distributions by city, district, and room count. One endpoint away from a real answer.

Built for developers who need rental price signals they can trust and cite: fintech, relocation, proptech, and research. Free to start, no card required.

curl https://api.polandrent.com/api/v1/median-rents/krakow \
  -H "Authorization: Bearer YOUR_API_KEY"

Pricing

| | Free | Pro | Scale | |---|---|---|---| | Price | $0 | $49/mo | $299/mo | | Requests / month | 1,000 | 100,000 | 2,000,000 | | Data freshness | 24h delayed | Real-time | Real-time | | Exports | JSON | JSON + CSV | JSON + CSV + Parquet | | History | Current | 24 months | 24 months | | Webhooks | — | — | Yes | | Resale rights | — | — | Yes | | Attribution | Required (CC-BY 4.0) | Optional | Optional | | Support | Community | Email | Priority + SLA |

Free is genuinely free and genuinely useful — 1,000 requests a month, no card, just an API key and a CC-BY 4.0 credit link. Perfect for a side project, a prototype, or a one-off analysis.

Pro drops the attribution requirement, removes the 24-hour delay, and opens CSV exports plus 24 months of history. For products and dashboards that need current data they can ship.

Scale adds Parquet bulk exports, webhooks for push updates, an SLA, and resale rights — for data platforms and teams redistributing rental signals to their own customers.

Academics and journalists: verified .edu and press accounts get Pro for free. Email us from your institutional or newsroom address to verify. We want the data cited in papers and articles — that's the point.

Get a free key → · No card. Upgrade when you outgrow it.

Quick start

1. Get an API key. Sign up free — you'll get a key instantly.

2. Authenticate. Pass your key as a bearer token on every request:

curl https://api.polandrent.com/api/v1/cities \
  -H "Authorization: Bearer YOUR_API_KEY"

3. Call an endpoint. All responses are JSON, all rents are in PLN, all timestamps are UTC.

Endpoints

Base URL: https://api.polandrent.com Current version: v1

GET /api/v1/cities

List every city we cover, with a coverage summary.

curl https://api.polandrent.com/api/v1/cities \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "slug": "krakow",
      "name": "Kraków",
      "districts": 18,
      "median_rent_pln": 3400,
      "sample_size": 1240,
      "updated_at": "2026-06-01T00:00:00Z"
    },
    {
      "slug": "warszawa",
      "name": "Warszawa",
      "districts": 23,
      "median_rent_pln": 4100,
      "sample_size": 2980,
      "updated_at": "2026-06-01T00:00:00Z"
    }
  ],
  "meta": { "count": 2 }
}

GET /api/v1/districts

List districts, optionally filtered to one city with ?city={slug}.

curl "https://api.polandrent.com/api/v1/districts?city=krakow" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "slug": "stare-miasto",
      "name": "Stare Miasto",
      "city": "krakow",
      "median_rent_pln": 4200,
      "sample_size": 210
    },
    {
      "slug": "podgorze",
      "name": "Podgórze",
      "city": "krakow",
      "median_rent_pln": 3300,
      "sample_size": 185
    }
  ],
  "meta": { "count": 2, "city": "krakow" }
}

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

The core endpoint: median rent, fair range, and the full distribution per room count for a city, broken down by district. This is the data that powers the Rent Check.

curl https://api.polandrent.com/api/v1/median-rents/krakow \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "city": "krakow",
    "name": "Kraków",
    "currency": "PLN",
    "districts": [
      {
        "slug": "stare-miasto",
        "name": "Stare Miasto",
        "rooms": {
          "2": {
            "median_rent_pln": 4200,
            "p25": 3600,
            "p75": 4900,
            "sigma": 0.28,
            "sample_size": 210
          }
        }
      }
    ]
  },
  "meta": {
    "updated_at": "2026-06-01T00:00:00Z",
    "license": "CC-BY-4.0"
  }
}

Every distribution response carries p25/p75 (the fair range), sigma (spread, log-scale), and sample_size (n) so you can judge confidence yourself. See the methodology for what each field means.

Conventions

  • Auth: Authorization: Bearer YOUR_API_KEY on every request. Free-tier keys are rate-limited; over-limit requests return 429 with a Retry-After header.
  • Format: JSON by default. Add ?format=csv (Pro+) or ?format=parquet (Scale) for bulk.
  • Currency: all rents in PLN, integers.
  • Timestamps: ISO 8601, UTC.
  • Confidence: every distribution carries sample_size (n) and updated_at, so you can weigh each figure and its freshness yourself. Read the methodology for what each field means.
  • Errors: standard HTTP codes. 401 (bad key), 429 (rate limit), 404 (unknown city/district), 5xx (our fault — retry).
  • Versioning: the path carries the major version (/v1). Breaking changes ship as /v2; v1 stays up.

Who buys this

  • Fintech — rental price signals for credit underwriting, affordability checks, and risk models. A real, current rent benchmark per district, on tap.
  • Relocation & mobility — accurate, English-language briefing data for clients moving to Poland. Stop quoting stale forum posts.
  • Proptech — market intelligence, comparables, and pricing context to build into your own product.
  • Academia & data journalism — a clean, openly-licensed, citable dataset for research and reporting. Free Pro for verified accounts — because a citation in your paper is worth more to us than $49.

If you're redistributing rental signals to your own customers, the Scale tier's resale rights and Parquet exports are built for you.

Open data & licensing

The PolandRent dataset is published under Creative Commons Attribution 4.0 (CC-BY 4.0).

  • Free tier: attribution required — credit PolandRent with a link back wherever the data appears.
  • Pro & Scale: attribution optional (still appreciated).
  • Resale: Scale tier only.

Open data is deliberate, not accidental: the more our numbers are used and cited, the stronger the source. We'd genuinely rather you used this than didn't.

Stable contract: the schema, endpoints, and field meanings are stable — build against them today and the contract holds. Every figure carries sample_size and updated_at, so provenance and freshness travel with the data. Full detail on the methodology page.

Questions, higher limits, or a custom contract? Reach out via the contact form. We read every message.