Sreality

Search public Czech property listings

get/sreality/search

Request

  • Base URL: https://scrappa.co/api
  • URL: https://scrappa.co/api/sreality/search
  • Auth: API key in header X-API-KEY

Query parameters

property_typeinteger nullable

Property category: 1 flats, 2 houses, 3 land, 4 commercial, or 5 other.

deal_typeinteger nullable

Transaction category: 1 sale, 2 rent, 3 auction, or 4 share deal.

category_subinteger nullable

Positive property subcategory identifier.

country_idinteger nullable

Positive country identifier; 112 is Czechia. Zero and negative sentinel values are not accepted.

region_idinteger nullable

Positive region identifier; 10 is Praha. Zero and negative sentinel values are not accepted.

entity_type'region' | 'district' | 'ward' | 'municipality' | 'quarter' | 'null' nullable

Locality level: region, district, ward, municipality, or quarter. Supply together with entity_id.

entity_idinteger nullable

Positive locality identifier. Supply together with entity_type; Brno is 5740.

price_mininteger nullable

Minimum advertised price in CZK.

price_maxinteger nullable

Maximum advertised price in CZK; cannot be lower than price_min.

advert_age_days_maxinteger nullable

Maximum age of the advertisement in days.

agency_idinteger nullable

Positive agency identifier to limit results to that agency.

estate_area_mininteger nullable

Minimum estate area in square metres.

estate_area_maxinteger nullable

Maximum estate area in square metres.

usable_area_mininteger nullable

Minimum usable area in square metres.

usable_area_maxinteger nullable

Maximum usable area in square metres.

floor_mininteger nullable

Minimum floor number.

floor_maxinteger nullable

Maximum floor number.

roomsinteger nullable

Room-count identifier.

energy_ratinginteger nullable

Energy-efficiency rating identifier.

building_typeinteger nullable

Building type identifier from 1 to 7.

building_conditioninteger nullable

Building condition identifier from 1 to 6.

ownershipinteger nullable

Ownership identifier from 1 to 3.

furnishedinteger nullable

Furnishing identifier from 1 to 3.

balconyboolean nullable

Filter for listings with a balcony.

terraceboolean nullable

Filter for listings with a terrace.

parking_lotsboolean nullable

Filter for listings with parking spaces.

elevatorboolean nullable

Filter for listings with an elevator.

loggiaboolean nullable

Filter for listings with a loggia.

cellarboolean nullable

Filter for listings with a cellar.

garageboolean nullable

Filter for listings with a garage.

easy_accessboolean nullable

Filter for listings with easy access.

gardenboolean nullable

Filter for listings with a garden.

querystring nullable

Free-text search in listing descriptions; description_search is an equivalent alias.

description_searchstring nullable

Equivalent alias for query; searches listing descriptions.

available_tostring date-time nullable

Latest ready date in YYYY-MM-DD format.

has_videoboolean nullable

Filter for listings with a video.

has_matterportboolean nullable

Filter for listings with a Matterport tour.

has_floor_planboolean nullable

Filter for listings with a floor plan.

poisinteger nullable

Proximity category identifier from 1 to 13.

lat_minnumber nullable

Southern latitude bound. Supply all four bounding-box coordinates together.

lat_maxnumber nullable

Northern latitude bound. Supply all four bounding-box coordinates together.

lon_minnumber nullable

Western longitude bound. Supply all four bounding-box coordinates together.

lon_maxnumber nullable

Eastern longitude bound. Supply all four bounding-box coordinates together.

sort'price_asc' | 'price_desc' | 'null' nullable

Only price_asc and price_desc are supported.

limitinteger nullable

Results per page, from 1 to 2000; defaults to 20.

offsetinteger nullable

Number of results to skip. Keep offset + limit at or below 10000.

Response

string required

Changes

No recorded changes to this operation across all 4 revisions of this API.