PUBLIC COST DATA · READ ONLY

Use HomeCostGrid’s planning model in your own research.

The first public API release returns transparent state- and city-adjusted project ranges. It is free for light use, rate-limited, and always labeled as a planning estimate—not a quote.

01 · FAST START

Roof cost by city

Send a GET request with a state, optional supported city and measured project size.

GET /api/v1/roof-cost?state=TX&city=Dallas&size=2500
Open the live JSON example →
02 · ANY SUPPORTED PROJECT

Generic estimate endpoint

Choose a project slug and add planning inputs such as quality, complexity, condition, urgency or permit=false.

GET /api/v1/cost-estimate?project=hvac-replacement-cost&state=FL&city=Miami&size=1800
Open the live JSON example →
03 · RESPONSE CONTRACT

Numbers with context

Responses include the low, expected and high range, labor, materials, permit allowance, contingency, cost per unit, timeline, source date and confidence label.

{
  "estimate": {
    "currency": "USD",
    "low": 11800,
    "expected": 14500,
    "high": 17900
  },
  "model": {
    "confidenceLabel": "city-adjusted planning model",
    "disclaimer": "Planning estimate, not a quote."
  }
}
SUPPORTED PROJECTS

One stable slug per model.

All models use the same location and response contract. Valid size limits and units are returned in validation errors.

roof-replacement-costRoof replacement50012,000 sq ft
hvac-replacement-costHVAC replacement40010,000 sq ft
kitchen-remodel-costKitchen remodel50800 sq ft
foundation-repair-costFoundation repair506,000 sq ft
deck-building-costDeck construction802,500 sq ft
fence-installation-costFence installation253,000 linear ft
bathroom-remodel-costBathroom remodel20400 sq ft
flooring-installation-costFlooring installation10012,000 sq ft
window-replacement-costWindow replacement1100 windows
interior-painting-costInterior painting20015,000 sq ft
concrete-installation-costConcrete installation5012,000 sq ft

Fair-use guardrails

  • 120 requests per minute per network address in the current public release.
  • Cache responses and link back to the methodology when displaying estimates.
  • Do not present the output as a contractor quote, appraisal, permit decision or guaranteed market price.
  • For bulk access or a commercial data agreement, use the contact form.
Read the methodology →Review data sources →
BUILD A RANGETurn a project into a realistic budget.COMPARE CITIESLos Angeles vs Houston: home, transport and daily-life tradeoffs.WHICH CAR?Match the vehicle to your city, home and real annual cost.