---
title: "Get a ZIP-Level Market Outlook — AI Analysis API"
description: "Classify a US ZIP code as a buyer's, balanced, or seller's market, with the inventory, days-on-market, and price-trend signals behind the call. 2 credits."
---

# 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.