---
title: "Sreality API: Search | Perceptlayer"
description: "Search from Sreality as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/sreality/search
---

[APIs](https://perceptlayer.com/apis) / [Sreality](https://perceptlayer.com/apis/sreality) / Search

# Sreality: Search

Search from Sreality as JSON. 1 credit per successful call.

GET `/v1/sreality/search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `property_type` | integer | Optional | 1, 2, 3, 4, 5 |
| `deal_type` | integer | Optional | 1, 2, 3, 4 |
| `category_sub` | integer | Optional | Any |
| `country_id` | integer | Optional | Any |
| `region_id` | integer | Optional | Any |
| `entity_type` | string | Optional | region, district, ward, municipality, quarter |
| `entity_id` | integer | Optional | Any |
| `price_min` | integer | Optional | Any |
| `price_max` | integer | Optional | Any |
| `advert_age_days_max` | integer | Optional | Any |
| `agency_id` | integer | Optional | Any |
| `estate_area_min` | integer | Optional | Any |
| `estate_area_max` | integer | Optional | Any |
| `usable_area_min` | integer | Optional | Any |
| `usable_area_max` | integer | Optional | Any |
| `floor_min` | integer | Optional | Any |
| `floor_max` | integer | Optional | Any |
| `rooms` | integer | Optional | Any |
| `energy_rating` | integer | Optional | Any |
| `building_type` | integer | Optional | 1, 2, 3, 4, 5, 6, 7 |
| `building_condition` | integer | Optional | 1, 2, 3, 4, 5, 6 |
| `ownership` | integer | Optional | 1, 2, 3 |
| `furnished` | integer | Optional | 1, 2, 3 |
| `balcony` | boolean | Optional | Any |
| `terrace` | boolean | Optional | Any |
| `parking_lots` | boolean | Optional | Any |
| `elevator` | boolean | Optional | Any |
| `loggia` | boolean | Optional | Any |
| `cellar` | boolean | Optional | Any |
| `garage` | boolean | Optional | Any |
| `easy_access` | boolean | Optional | Any |
| `garden` | boolean | Optional | Any |
| `query` | string | Optional | Up to 200 characters |
| `description_search` | string | Optional | Up to 200 characters |
| `available_to` | string | Optional | Any |
| `has_video` | boolean | Optional | Any |
| `has_matterport` | boolean | Optional | Any |
| `has_floor_plan` | boolean | Optional | Any |
| `pois` | integer | Optional | Any |
| `lat_min` | number | Optional | Any |
| `lat_max` | number | Optional | Any |
| `lon_min` | number | Optional | Any |
| `lon_max` | number | Optional | Any |
| `sort` | string | Optional | price\_asc, price\_desc |
| `limit` | integer | Optional | Any |
| `offset` | integer | Optional | Any |

## Example request

cURL shell 

```
curl "https://api.perceptlayer.com/v1/sreality/search?property_type=1&deal_type=1&country_id=112&sort=price_asc&limit=20&offset=0" \
  -H "X-API-Key: $API_KEY"
```

[Run this endpoint in the playground](https://perceptlayer.com/apis/sreality?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.