Cian.ru API
Newbuildings & Similar
/similar/byidCian.ru /similar/byid API
RealtyAPI's /similar/byid endpoint is your gateway to Cian.ru real estate data, designed with developers in mind from the ground up. You get clean JSON responses with predictable schemas, thorough parameter documentation with real-world examples, and a developer-friendly REST design that makes integration straightforward regardless of your tech stack. The endpoint supports both simple lookups and complex filtered queries, and every response includes metadata that helps you paginate results, handle edge cases, and debug issues quickly. Whether you work in Python, JavaScript, Go, PHP, or any other language that speaks HTTP, you can be up and running in under ten minutes.
import requests
url = "https://cian.realtyapi.io/similar/byid"
headers = {
"x-realtyapi-key": "YOUR_API_KEY"
}
params = {
"id": "330393692"
}
response = requests.get(url, headers=headers, params=params)
data = response.json()
print(data)What You Can Do With
the /similar/byid Endpoint.
Here's what this endpoint provides and how you can use the data it returns.
Endpoint Parameters
2 params| Parameter | Type | Required |
|---|---|---|
id | STRING | Required |
resultCount | NUMBER | Optional |
Required Parameters
This endpoint requires id to fetch data. Pass these as query parameters in your request.
JSON Response
Receive structured JSON containing /similar/byid data from Cian.ru. Parse it directly into your application models.
Real-Time Results
Every request fetches live Cian.ru data. No stale caches — you always get the most current information available.
Error Handling
Clear HTTP status codes and error messages help you handle edge cases gracefully. See our documentation for the full error reference.