> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.repliers.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to Calculate Annual Growth Rate for a Location

## Overview

This guide explains how to calculate the annual growth rate for a specific location using the Repliers API. You'll learn how to retrieve monthly statistics and apply growth calculations to measure year-over-year changes in property values.

| **Looking for more statistical features?** Check out our [Real-Time Market Statistics Implementation Guide](https://help.repliers.com/en/article/real-time-market-statistics-implementation-guide-l3b1uy/) for a comprehensive overview.

## Example Scenario

In this example, we'll calculate the annual growth in median sold price for resale residential properties in Los Angeles that have at least 4 bedrooms, using data as of June 2025.

## Step-by-Step Process

### Step 1: Define the Time Range

To measure year-over-year growth, you'll need to include data from the previous 12 months.

Set the following parameters:

* `minSoldDate=2024-05-01`
* `maxSoldDate=2025-05-31`

This ensures the results cover sales from May 2024 to May 2025.

### Step 2: Make the API Request

Use the following request to retrieve monthly median sold price statistics for matching listings:

```
GET /listings?listings=false&minSoldDate=2024-05-01&city=Los+Angeles&status=U&type=sale&statistics=med-soldPrice,grp-mth&class=residential&minBeds=4&maxSoldDate=2025-05-31
```

**Key parameters explained:**

* `listings=false` - Returns only statistics (faster response)
* `statistics=med-soldPrice,grp-mth` - Requests median sold price grouped by month
* `city=Los+Angeles` - Filters to Los Angeles
* `status=U&type=sale` - Recently sold properties
* `class=residential&minBeds=4` - Residential properties with 4+ bedrooms

### Step 3: Review the Response

The API will return grouped monthly statistics in the following structure:

```json
{
  "apiVersion": 2,
  "page": 1,
  "numPages": 27,
  "pageSize": 100,
  "count": 2644,
  "statistics": {
    "soldPrice": {
      "med": 1780082,
      "mth": {
        "2024-05": {
          "med": 1897499,
          "count": 208
        },
        "2024-06": {
          "med": 2000000,
          "count": 193
        },
        "2024-07": {
          "med": 1810000,
          "count": 211
        },
        "2024-08": {
          "med": 1560000,
          "count": 189
        },
        "2024-09": {
          "med": 1558250,
          "count": 198
        },
        "2024-10": {
          "med": 1750000,
          "count": 239
        },
        "2024-11": {
          "med": 1750000,
          "count": 191
        },
        "2024-12": {
          "med": 1600000,
          "count": 219
        },
        "2025-01": {
          "med": 1640000,
          "count": 181
        },
        "2025-02": {
          "med": 1850000,
          "count": 239
        },
        "2025-03": {
          "med": 1984900,
          "count": 333
        },
        "2025-04": {
          "med": 1955000,
          "count": 206
        },
        "2025-05": {
          "med": 2170000,
          "count": 37
        }
      }
    }
  },
  "listings": []
}
```

### Step 4: Calculate Annual Growth

To compute the annual growth rate:

1. Extract the median sold prices for the same month from consecutive years:
* May 2024: `statistics.soldPrice.mth["2024-05"].med`
* May 2025: `statistics.soldPrice.mth["2025-05"].med`
2. **Apply the percentage growth formula:**
Growth (%) = ((Current Year Value - Previous Year Value) / Previous Year Value) × 100
3. **Using the sample values:**
Growth (%) = ((2,170,000 - 1,897,499) / 1,897,499) × 100 = 14.36%


## Additional Growth Calculations

The same dataset can be used to calculate other growth metrics:

* **Month-over-month growth** (e.g., April to May 2025)
* **Quarter-over-quarter growth**
* **Year-to-date growth**

Simply compare the corresponding monthly values from `statistics.soldPrice.mth` to perform these calculations.

## Key Considerations

* Ensure you have sufficient data points for accurate calculations (check the `count` field in each month)
* Consider seasonal variations when interpreting growth rates
* Use the same time periods for consistent year-over-year comparisons

## Related Resources

* [Real-Time Market Statistics Implementation Guide](https://help.repliers.com/en/article/real-time-market-statistics-implementation-guide-l3b1uy/) - Comprehensive overview of statistical features
* [API Reference](https://docs.repliers.io/reference/getting-started-with-your-api) - Complete API documentation

# What questions does this article answer?

* How do I calculate annual growth in median sold price using Repliers data?  
* Which query parameters should I use to get monthly medians over a 12-month range?  
* How do I use `statistics=med-soldPrice,grp-mth` for growth calculations?  
* How do I interpret the grouped monthly statistics in the API response?  
* How can I derive year-over-year growth for a specific city, property class, and bedroom count?  
* How can I reuse this approach for other growth or trend calculations?