get_estaite_comparable_markets

Description

Finds submarkets whose median rent is within ±20% of a reference submarket’s median rent. Use this to surface “markets similar to X” for relocation, investment screening, or competitive analysis. Always returns a multi-segment view (apartments / single-family / condo-townhome × 1–4 BR).

Inputs

Name	Type	Required	Description
id	integer	yes	Reference submarket id from search_estaite_submarkets.
limit	integer 1–20	no	Max number of comparables to return. Default 5, hard cap 20.

Note

The implementation also has internal property_type and bedrooms arguments and a corresponding “slice mode” response shape, but these are not exposed through the MCP input schema. Every call returns the multi-segment summary, anchored on apt 2 BR for the rent-similarity comparison.

Response

{
  "attribution": "Data via Estaite Submarket Index",
  "powered_by": "Estaite.com",
  "source_domains": [],
  "reference_submarket": {
    "id": 1,
    "name": "Carmel Valley",
    "apartments": {
      "br1": { "median_rent": 2700, "rent_yoy": 3.5,  "rent_to_income": 22.2, "avg_dom": 21 },
      "br2": { "median_rent": 3659, "rent_yoy": -3.2, "rent_to_income": 23.4, "avg_dom": 24 },
      "br3": { "median_rent": 4200, "rent_yoy": 2.8,  "rent_to_income": 28.7, "avg_dom": 27 },
      "br4": { "median_rent": 5100, "rent_yoy": 1.6,  "rent_to_income": 34.9, "avg_dom": 31 }
    },
    "single_family":  { "br1": { "median_rent": null, "rent_yoy": null, "rent_to_income": null, "avg_dom": null }, "br2": {  }, "br3": {  }, "br4": {  } },
    "condo_townhome": { "br1": {  }, "br2": {  }, "br3": {  }, "br4": {  } }
  },
  "comparables": [
    {
      "id": 226,
      "name": "La Jolla",
      "cbsa": "San Diego-Chula Vista-Carlsbad, CA",
      "state": "CA",
      "as_of": 202603,
      "apartments": {
        "br1": { "median_rent": 2810, "rent_yoy": 3.1, "rent_to_income": 24.5, "avg_dom": 23 },
        "br2": { "median_rent": 3720, "rent_yoy": -1.4, "rent_to_income": 25.1, "avg_dom": 26 },
        "br3": { "median_rent": 4350, "rent_yoy": 1.9, "rent_to_income": 29.2, "avg_dom": 28 },
        "br4": { "median_rent": 5280, "rent_yoy": 0.8, "rent_to_income": 35.7, "avg_dom": 33 }
      },
      "single_family":  { "br1": {  }, "br2": {  }, "br3": {  }, "br4": {  } },
      "condo_townhome": { "br1": {  }, "br2": {  }, "br3": {  }, "br4": {  } }
    }
  ]
}

Fields

Top level

Field	Type	Description
attribution	string	Required attribution. Echo verbatim.
powered_by	string	Always "Estaite.com".
source_domains	string[]	Companies / domains attached to records in the result set.
reference_submarket	object	The input submarket’s metrics — the anchor row.
comparables	array	Up to limit similar submarkets, ordered ascending by absolute difference in median rent vs the reference.

reference_submarket and each comparables[] item

Path	Type	Description
id	number	Submarket id.
name	string	Submarket name.
cbsa	string	CBSA / metro name (on comparables[] only — the reference doesn’t echo cbsa).
state	string	2-letter state code (on comparables[] only).
as_of	number	Yearmonth of the underlying data, format YYYYMM (on comparables[] only).
apartments, single_family, condo_townhome	object	Each contains br1–br4 cells with the fields below.

Each br_key cell

Field	Type	Description
median_rent	number	Median monthly rent for the slice, USD. null when no data.
rent_yoy	number	Year-over-year rent change in whole-percent (e.g. 3.5 = +3.5%).
rent_to_income	number	Rent-to-income ratio in whole-percent.
avg_dom	number	Average days on market.

Errors

Code	HTTP	Meaning
MISSING_OR_INVALID_SUBMARKET_ID	400	id missing or non-numeric.
SUBMARKET_NOT_FOUND	404	No row for the requested id, or no apt-2BR median price available to anchor the similarity search.

Notes

• Similarity is rent-only. The tool returns submarkets within ±20% of the reference’s apt 2 BR median rent. It does not factor in growth, vacancy, demographics, or geography — a Carmel Valley match could come from anywhere in the country if rents line up.
• Sorted ascending by absolute rent difference. The closest match is first.
• All percent values are whole-percent. A rent_yoy of 3.1 means +3.1%, not 310%.
• The reference is excluded from comparables. You’ll never see the input submarket return as its own comparable.