# Introducing Realie's Comparable Property Search API Endpoint

- **Canonical URL**: https://blog.realie.ai/blog/introducing-realie-comparable-property-search-api-endpoint
- **Markdown URL**: https://blog.realie.ai/blog/introducing-realie-comparable-property-search-api-endpoint.md
- **Published**: 2025-02-14
- **Modified**: 2025-02-14
- **Topic**: Platform
- **Author**: Alex Franzen (Co-founder & CTO)
- **Summary**: The new Realie Comparable Property Search API endpoint simplifies finding comparable properties

---

## Realie's Comparable Property Search API Endpoint

We're excited to announce the launch of our new [Comparable Property Search API Endpoint](https://docs.realie.ai/api-reference/premium/premium-comparables-search), designed to help you find comparable properties based on location and specific property characteristics. This powerful tool enables you to refine your search with various parameters, ensuring you get the most relevant results for your needs.

## Key Features

- **Location-Based Search:** Specify the latitude and longitude of the target property to find comparables within a defined radius.
- **Customizable Parameters:** Filter results by square footage, number of bedrooms and bathrooms, property type, and price range.
- **Time Frame**: Look back up to 18 months to find comparable sales.
- **Flexible Results**: Retrieve up to 50 comparable properties per request.

## How to Use the API

To use the [Comparable Property Search API Endpoint](https://docs.realie.ai/api-reference/premium/premium-comparables-search), provide your API key in the `Authorization` header. Here is an example of a `GET` request in Python:

```python
import requests

url = "https://app.realie.ai/api/public/property/comparables/"
params = {
    "latitude": 38.8951,
    "longitude": -77.0364,
    "radius": 1.0,
    "bedsMin": 3,
    "timeframe": 12,
    "maxResults": 25,
}
headers = {"Authorization": "YOUR_API_KEY"}

response = requests.get(url, params=params, headers=headers, timeout=10)
data = response.json()
print(f"Found {len(data.get('comparables', []))} comparable properties")
```

Replace `YOUR_API_KEY` with your actual API key to authenticate your request. The response includes an array of comparable properties that match your criteria, along with metadata about the search.

## Response Structure

The API returns a JSON object with the following structure:

- **comparables:** An array of comparable properties found, including sale date, sale price, square footage, beds/baths, distance, and parcel identifiers.
- **metadata:** An object containing additional information such as the count of comparables and the search parameters used.

## Get Started Today

Start using the [Comparable Property Search API Endpoint](https://docs.realie.ai/api-reference/premium/premium-comparables-search) to enhance your property search and valuation workflows. With its flexible parameters and detailed results, you'll have the insights you need to make informed decisions.

As always, if you have any questions about [Realie](https://www.realie.ai/) or any requests, please reach out to support@realie.ai!
