Local market outlook (buyer's/balanced/seller's) for a ZIP

GET /api/properties/market-outlook/

2 credits

What it returns

A composite Market Outlook score (0-100) classifying a ZIP code as a buyer's market (<40), balanced (40-60), or seller's market (>60). Built from a hybrid weighted model — 40% macro market indicators (market-heat index and forecasts), 40% Homesage.ai absorption-rate analytics, and 20% live market signals when available. Includes 1/3/6-month forecasts, days-on-market velocity, active/sold/pending counts, and a per-signal breakdown.

When to use it

• Render a market-context widget on a property report.
• Power a 'best markets to buy' / 'best markets to sell' ranking.
• Inform pricing-strategy recommendations.

Pricing

2 credits.

FAQ

What if live market data is unavailable?

The live-signal weight rebalances to the macro and Homesage.ai components (50% / 50%). The response's weights_used field reflects the actual weights applied.

Why ZIP-level instead of city or county?

ZIP is the smallest unit that all three sources support consistently. For city/county roll-ups, query multiple ZIPs and aggregate.

Parameters

• days (query) — Lookback window. Default 90 days.
• zip (query, required) — 5-digit US ZIP code.

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.
• 503 — Upstream data provider is temporarily unavailable — retry with backoff.

More in AI-Powered Analysis

• Composite full property report — everything aggregated — GET /api/properties/full-report/
  The most comprehensive property analysis endpoint — aggregates 11 internal sources into a single response with 292 data fields.
• AI-derived property condition score from listing photos — GET /api/properties/property-condition/
  An AI condition assessment for a US residential property — overall condition category (Excellent/Good/Fair/Poor), confidence score, per-room breakdown when photos are available, and any flags (water damage, deferred maintenance signals).
• Property condition analysis with your own photos — POST /api/properties/property-condition-custom-photos/
  An overall property-condition rating and confidence score, combining a database lookup with AI vision analysis of property photos you supply.
• AI-powered square-footage breakdown by floor — GET /api/properties/sqft-per-floor/
  Per-floor square-footage distribution for a US residential property, derived from a multi-stage AI analysis (photo/room detection, architectural-style inference, and multi-method validation).
• Comparable sold properties (comps) for a subject property — GET /api/properties/comps/
  A ranked list of comparable sold properties within a search radius of the subject — each comp scored on similarity (size, beds/baths, year built, distance, condition delta) with the sale price and date.
• LLM-powered room-by-room renovation cost breakdown — POST /api/properties/renovation-cost-breakdown/
  An itemized room-by-room renovation cost breakdown powered by a multimodal LLM analyzing the property's images plus its size/feature metadata.
• Solar potential + AI roof condition for a property — GET /api/solar/analysis/
  Two coupled analyses in one call: