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.

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:

{
  "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 - Comprehensive overview of statistical features
• API Reference - 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?

Updated on: 22/07/2026