Homesage.ai API Documentation

The Homesage.ai API exposes 30+ REST endpoints across 8 categories, covering 155M+ US properties. Authenticate with an Authorization: Token header, pass a US address or ZIP, and get structured JSON back. Start with Property Lookup to resolve an address, then call valuation, AI analysis, or skip tracing against it. Four endpoints are free, and failed calls (400, 401, 402, 404) cost 0 credits.

Property Search

3 operations in this category.

• Resolve a city / county / ZIP name into a search-area object (free) — GET /api/area/autocomplete/
  Up to 5 area suggestions (city, county, or ZIP) matching a partial place name — each a structured object you pass straight into the location filter of preview_property_search / run_property_search.
• Preview a property-database search — free match count + credit cost — GET /api/workspace/search/count/
  A free preview of a property-database search: count (how many properties match the filters) and cost (the credits the full search would charge).
• Search the property database by investment criteria (1 credit per result) — POST /api/workspace/search/
  The full set of properties matching your investment filters — each with valuation, investment metrics, condition, and location detail.

Property Lookup

4 operations in this category.

• Suggest US property addresses from a partial string — GET /api/properties/auto-complete/
  Up to 5 address suggestions matching a partial address string.
• Full property record for a US residential property — GET /api/properties/info/
  Full property record for a single US residential property — address, coordinates, listing status and price, AVM-estimated value, size, days on market, building/lot/parking/interior breakdown, listing-office details, recent property history, and nearby school ratings.
• Same as `info` but always force-fetches fresh data from the source — GET /api/properties/updated-info/
  Identical response shape to info — see that endpoint's docs for fields and FAQ.
• Paginated, filterable property search with ROI fields — GET /api/properties/bulk-info/
  Paginated search across all US residential properties matching geo + price + bed/bath/sqft/year-built/DOM/lot filters.

Property Valuation

10 operations in this category.

• 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.
• Composite investor-grade investment-potential score — GET /api/properties/investment_potential/
  An Investment Potential score plus the component sub-scores it's built from (price relative to comps, cash-flow potential, appreciation trajectory, neighborhood risk).
• Projected return after renovating a property — GET /api/properties/renovation_return/
  Projected return from performing a standard renovation: pre-renovation estimated value (AVM), projected post-renovation ARV (After Repair Value), the renovation cost estimate (see renovation-cost for the aggregate figure and renovation-cost-breakdown for room-level detail), the value increase, net return, ROI percent, and the maximum recommended renovation budget.
• 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.

AI-Powered Analysis

8 operations in this category.

• 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.
• Local market outlook (buyer's/balanced/seller's) for a ZIP — GET /api/properties/market-outlook/
  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).
• Solar potential + AI roof condition for a property — GET /api/solar/analysis/
  Two coupled analyses in one call:

Skip Tracing

3 operations in this category.

• Property owner name + contact info from an address — POST /api/properties/skip-tracing/property-owner-information/
  The legal owner of a US residential property given its address — name, mailing address (if different from the property), and contact methods (email and phone with connectivity/verification flags).
• People associated with a property address (residents, relatives) — POST /api/properties/skip-tracing/associated-people/
  A list of people associated with a property address — historical residents, current and former owners, related family members.
• Full skip-trace dossier for a known person_id — POST /api/properties/skip-tracing/person-details/
  Full skip-trace dossier for a single person — current and previous addresses, phone numbers (with type and connectivity status), email addresses (with verification status), relatives, and associates.

Risk & Diligence

1 operation in this category.

• Streaming location-risk analysis for a US address — POST /api/properties/red-flags/stream/
  A Server-Sent Events stream of location-risk findings for a US property — flood, crime, environmental hazards, school-district decline, and other neighborhood red flags.

Market Data

3 operations in this category.

• List residential properties sold in a ZIP in the last 365 days — GET /api/properties/sold/by-zip/
  Every residential property sold in a given US ZIP code within the last 365 days, with sale date, sale price, coordinates, and basic property characteristics (bed/bath, square footage, year built, lot size).
• Count of sold properties in a ZIP in the last 365 days — GET /api/properties/sold/count-by-zip/
  Just the count of residential properties sold in a ZIP within the last 365 days.
• Mortgage and lien data for a US property — GET /api/mortgage-lien/analysis/
  Mortgage and lien records for a US property — current and historical mortgages, lien summary, involuntary liens, pre-foreclosure status, and data quality metadata.

Account

1 operation in this category.

• Get the account's current API credit balance — GET /api/usage/credits/
  Your account's current API credit balance plus the plan and billing context that puts the number in context — credits_used, credits_remaining, total_credits, usage_percentage, current plan_name and subscription_status, and the renewal_date when the allowance resets.