Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

Sreality.cz Czech Reality API

Real-time access to 50,000+ property listings from Sreality.cz — the largest real estate portal in the Czech Republic.

Search flats, houses, and land for sale or rent. Get structured listing details including price, GPS coordinates, images, seller/agency info, nearby points of interest (doctors, schools, shops, transport), infrastructure data, and more.

Subscribe on RapidAPI | API Documentation


Features

  • 50,000+ active listings — flats, houses, land, commercial properties
  • GPS coordinates for every listing — ready for mapping
  • Points of interest — nearby doctors, schools, grocery stores, restaurants, public transport with exact walking distances
  • Agency details — name, address, website, rating, reviews, company ID (ICO)
  • Infrastructure data — water, gas, electricity, telecom, transport connections
  • Property details — size, rooms, floor, year built, energy rating, ownership type, parking, terrace/cellar area
  • Similar listings — find comparable properties in the same area
  • Powerful filters — property type, transaction, region, price range, size range
  • No scraping needed — clean, structured JSON

Quick Start

1. Get your API key

Sign up at RapidAPI and subscribe to a plan (free tier available — 50 requests/month).

2. Make your first request

Python:

import requests

headers = {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "sreality-cz-czech-reality-api1.p.rapidapi.com"
}

# Search for flats for sale in Prague
response = requests.get(
    "https://sreality-cz-czech-reality-api1.p.rapidapi.com/search",
    headers=headers,
    params={
        "category_main": "flat",
        "category_type": "sale",
        "locality_region_id": 10,
        "per_page": 5
    }
)

data = response.json()
print(f"Found {data['total_count']} flats in Prague")
for listing in data["results"]:
    print(f"  {listing['name']} | {listing['price']:,} CZK | {listing['locality']}")

JavaScript:

const response = await fetch(
  'https://sreality-cz-czech-reality-api1.p.rapidapi.com/search?category_main=flat&category_type=sale&locality_region_id=10&per_page=5',
  {
    headers: {
      'X-RapidAPI-Key': 'YOUR_API_KEY',
      'X-RapidAPI-Host': 'sreality-cz-czech-reality-api1.p.rapidapi.com'
    }
  }
);
const data = await response.json();
console.log(`Found ${data.total_count} flats in Prague`);
data.results.forEach(r => {
  console.log(`  ${r.name} | ${r.price?.toLocaleString()} CZK | ${r.locality}`);
});

cURL:

curl "https://sreality-cz-czech-reality-api1.p.rapidapi.com/search?category_main=flat&category_type=sale&locality_region_id=10&per_page=5" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: sreality-cz-czech-reality-api1.p.rapidapi.com"

Endpoints

Method Endpoint Description
GET /search Search listings with filters
GET /listing/{id} Full listing detail (price, GPS, POI, agency, infrastructure...)
GET /listing/{id}/similar Find similar properties in the same area
GET /health Health check

Search Parameters

Parameter Type Description Example
category_main string Property type flat, house, land, commercial
category_type string Transaction type sale, rent, auction
locality_region_id integer Region ID (see table below) 10 (Prague)
locality_district_id integer District ID
price_min integer Min price (CZK) 3000000
price_max integer Max price (CZK) 8000000
size_min integer Min size (m2) 50
size_max integer Max size (m2) 120
page integer Page number 1
per_page integer Results per page (max 60) 20

Listing Detail Response

The /listing/{id} endpoint returns comprehensive property data:

Section Fields
Basic type, transaction, rooms, flat type, price, meta description
Dimensions usable area (m2), land area, built-up area, terrace area, cellar area
Building floor, total floors, year built, energy rating, ownership, building type, condition, parking spots
Infrastructure water, gas, waste, electricity, telecom, transport, road type
Seller broker name, phone, email, photo, agency (name, address, website, rating, reviews, ICO)
POI nearby doctors, schools, grocery, restaurants, transport, leisure — with exact distances
Media images, floor plan, panorama, video, Matterport 3D tour
Similar related listings via /listing/{id}/similar

Region IDs

ID Region
10 Praha
11 Stredocesky kraj
12 Jihocesky kraj
13 Plzensky kraj
14 Karlovarsky kraj
15 Ustecky kraj
16 Liberecky kraj
17 Kralovehradecky kraj
18 Pardubicky kraj
19 Vysocina
20 Jihomoravsky kraj
21 Olomoucky kraj
22 Zlinsky kraj
23 Moravskoslezsky kraj

Room Layout Types (Czech system)

Code Meaning
1+kk 1 room + kitchenette (studio)
1+1 1 room + separate kitchen
2+kk 2 rooms + kitchenette
2+1 2 rooms + separate kitchen
3+kk 3 rooms + kitchenette
3+1 3 rooms + separate kitchen
4+kk 4 rooms + kitchenette
4+1 4 rooms + separate kitchen
5+kk / 5+1 5 rooms
6+ 6 or more rooms

Examples

Check out the examples/ directory for complete, runnable scripts:

File Description
search_properties.py Search with filters, display results
listing_detail.py Full listing detail with POI, agency, infrastructure
price_comparison.py Compare prices across Czech regions
find_similar.py Find similar properties in the same area
rental_yield.py Analyze rental yields by comparing sale vs rent prices
search_properties.js JavaScript/Node.js example

Pricing

Plan Price Requests/month
Free $0 50
Basic $9.99 1,000
Pro $29.99 10,000
Ultra $99.99 100,000

Subscribe on RapidAPI


Notes

  • Prices are in Czech Koruna (CZK). 1 EUR ~ 25 CZK, 1 USD ~ 23 CZK.
  • Descriptions and features are in Czech language as provided by Sreality.cz.
  • POI data includes up to 5 nearest places per category with straight-line and walking distances.
  • Agency ICO is the Czech company registration number — cross-reference with the Czech Business Register.
  • Images are served from Sreality's CDN — URLs are stable and can be used directly.

Related

License

MIT

About

Real-time Czech real estate API. 50K+ listings from Sreality.cz. Search flats, houses, land. Get price, GPS, POI, agency info, infrastructure.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors