Composite investor-grade investment-potential score

GET /api/properties/investment_potential/

3 credits

What it returns

An Investment Potential score plus the component sub-scores it's built from (price relative to comps, cash-flow potential, appreciation trajectory, neighborhood risk). Designed as a first-pass filter for investor screening.

When to use it

• Rank a watchlist of properties by overall investment quality.
• Power a 'top opportunities in your market' feed.

Pricing

3 credits.

FAQ

Is the score a percentage?

A 0–100 composite. Higher = better. Sub-scores are individually weighted; see the response's breakdown block.

Does it account for my financing assumptions?

No — it's a property-level score, not deal-specific. For deal-level returns, use flip-return or rental-long-term.

Parameters

• property_address (query, required)

Responses

• 200
• 400 — Bad request — a required parameter is missing or failed validation. Costs 0 credits.
• 401 — Authentication failed — missing or invalid API key. Costs 0 credits.
• 402 — Payment required — no active subscription or insufficient credit balance. Costs 0 credits.
• 404 — Not found — the address could not be confidently matched to a single property. The body includes a did_you_mean array of suggested addresses (each with an mpr_id) to show the user and retry with; an empty array means no close match. Costs 0 credits.

More in Property Valuation

• Price Flexibility Score — how much room a listing has to negotiate — GET /api/properties/pfs/
  A Price Flexibility Score (PFS) for an active or recently-sold property — an estimate of how much price-negotiation room a listing has, derived from days-on-market, price-change history, comparable activity, and seasonal demand.
• Projected return after renovating a property — GET /api/properties/renovation_return/
  Projected return analysis assuming a standard renovation is performed: pre-renovation AVM, projected post-renovation ARV (After Repair Value), renovation cost estimate (see renovation-cost for a breakdown), and net return + ROI percent.
• End-to-end fix-and-flip return projection — GET /api/properties/flip_return/
  A fix-and-flip return summary for the property — four numbers:
• Historical AVM trajectory for a property — GET /api/properties/home_value_graph/
  A time-series of monthly AVM estimates for a property over the last 5 years.
• Does this property need TLC (fixer-upper indicator)? — GET /api/properties/tlc/
  A boolean / confidence-scored flag indicating whether the property is likely a fixer-upper — i.
• Long-term (12-month-lease) rental projection — GET /api/properties/rental/long_term/
  Projected long-term rental income — monthly rent band, vacancy assumption, gross operating income, net operating income after standard expense ratios, and capitalization rate vs.
• Short-term (Airbnb-style) rental projection — GET /api/properties/rental/short_term/
  Projected short-term rental performance — nightly rate band, expected occupancy, monthly gross income, net of typical expense ratios.
• Total renovation cost estimate (top-level) — GET /api/properties/renovation/cost/
  An aggregate estimated renovation cost for a property, plus the sqft basis and the per-sqft cost-of-construction model used.
• Homesage.ai AVM (current estimated value) for a property — GET /api/properties/current-estimate/
  The current Homesage.