# Real Estate API Docs — 30+ Endpoints | Homesage.ai > REST API documentation reference for Homesage.ai: 30+ endpoints across 8 categories returning valuation, AI condition, comps, skip tracing, and data on 155M+… Every page below is also available as Markdown by appending `.md` to the URL. ## Property Search API - [Property Search API — overview](https://app.homesage.ai/docs/property-search.md): Search the US property database on 155M+ US homes by investment criteria. 3 endpoints: resolve a search area, preview match count and cost, then run the full… - [Resolve a City, County, or ZIP — Property Search API](https://app.homesage.ai/docs/property-search/area-autocomplete.md): Resolve a partial city, county, or ZIP name into a structured search-area object you pass straight into the location filter. Returns up to 5 matches. Free. - [Preview Search Results and Cost — Property Search API](https://app.homesage.ai/docs/property-search/preview-property-search.md): Preview a property search before running it: returns how many properties match your filters and the exact credit cost of the full search. Free to call. - [Search Properties by Investment Criteria — Search API](https://app.homesage.ai/docs/property-search/run-property-search.md): Search 155M+ US property database by investment filters: price, condition, ROI, cap rate, and days on market. Returns valuation, metrics, and location data. ## Property Lookup API - [Property Lookup API — overview](https://app.homesage.ai/docs/property-lookup.md): Look up any US residential property by address. 4 endpoints covering address autocomplete, full property records, forced refresh, and bulk paginated search. - [Autocomplete a US Property Address — Lookup API](https://app.homesage.ai/docs/property-lookup/auto-complete.md): Return up to 5 US street-level address suggestions from a partial address string, drawn from a national address graph. Free to call. Use it to validate input. - [Bulk Property Search with ROI Fields — Lookup API](https://app.homesage.ai/docs/property-lookup/bulk-info.md): Paginated search across US residential properties, filtered by geo, price, beds, baths, sqft, year built, and days on market, with ROI fields returned. - [Get a Full Property Record — Property Lookup API](https://app.homesage.ai/docs/property-lookup/info.md): Retrieve the full record for one US residential property: address, coordinates, listing status and price, AVM value, size, beds, baths, and days on market. - [Force-Refresh a Property Record — Lookup API](https://app.homesage.ai/docs/property-lookup/updated-info.md): Re-fetch a property record from source, bypassing cached data. Returns the identical response shape as the info endpoint, with freshly pulled values. 1 credit. ## Property Valuation API - [Property Valuation API — overview](https://app.homesage.ai/docs/property-valuation.md): Value any US property and model returns. 10 endpoints spanning AVM estimates, value history, rental projections, renovation costs, and flip return analysis. - [Get a Current AVM Estimate — Valuation API](https://app.homesage.ai/docs/property-valuation/current-estimate.md): Return the current Homesage.ai AVM estimate for a US residential property as a single point value, with the valuation date and supporting confidence range. - [Project Fix-and-Flip Return — Valuation API](https://app.homesage.ai/docs/property-valuation/flip-return.md): Return an end-to-end fix-and-flip projection: total project cost across acquisition, renovation, holding, and financing, plus profit and ROI percentage. - [Get 5-Year Home Value History — Valuation API](https://app.homesage.ai/docs/property-valuation/home-value-history.md): Retrieve a monthly AVM time series for a US property covering the last 5 years, for charting appreciation trends and backtesting valuation models. 1 credit. - [Score Investment Potential — Valuation API](https://app.homesage.ai/docs/property-valuation/investment-potential.md): Return a composite investment-potential score plus its sub-scores: price against comps, cash-flow potential, appreciation trajectory, and neighborhood risk. - [Check If a Property Needs TLC — Valuation API](https://app.homesage.ai/docs/property-valuation/needs-tlc-check.md): Return a confidence-scored flag showing whether a property is likely a fixer-upper needing material renovation to reach full market potential. 1 credit. - [Get a Seller Motivation Score — Valuation API](https://app.homesage.ai/docs/property-valuation/price-flexibility-score.md): Score how motivated a seller is to negotiate with our Seller Motivation Score, from days on market, price-change history, comps, and seasonal demand. Returned… - [Estimate Total Renovation Cost — Valuation API](https://app.homesage.ai/docs/property-valuation/renovation-cost.md): Return an aggregate renovation cost estimate for a US property, plus the square-footage basis and the per-square-foot cost-of-construction model behind it. - [Project Renovation Return — Valuation API](https://app.homesage.ai/docs/property-valuation/renovation-return.md): Project the return on a standard renovation: pre-renovation AVM, projected post-renovation ARV, estimated renovation cost, and net return with ROI percentage. - [Project Long-Term Rental Income — Valuation API](https://app.homesage.ai/docs/property-valuation/rental-long-term.md): Project 12-month-lease rental performance: monthly rent band, vacancy assumption, gross operating income, and net operating income after expense ratios. - [Project Short-Term Rental Income — Valuation API](https://app.homesage.ai/docs/property-valuation/rental-short-term.md): Project Airbnb-style short-term rental performance: nightly rate band, expected occupancy, monthly gross income, and net income after typical expense ratios. ## AI-Powered Analysis API - [AI-Powered Analysis API — overview](https://app.homesage.ai/docs/ai-powered-analysis.md): Analyze properties with AI vision and LLMs. 8 endpoints covering condition scoring from photos, comps, renovation budgets, market outlook, and solar potential. - [Find Comparable Sold Properties — AI Analysis API](https://app.homesage.ai/docs/ai-powered-analysis/comps.md): Return recent comparable sold properties for a subject address, each with sale price, sale date, distance, and similarity scoring to justify a valuation. - [Get a Full Property Report — AI Analysis API](https://app.homesage.ai/docs/ai-powered-analysis/full-report.md): Aggregate 11 internal data sources into one response of 292 fields: valuation, condition, comps, renovation, rental, and risk. 15 credits per property. - [Get a ZIP-Level Market Outlook — AI Analysis API](https://app.homesage.ai/docs/ai-powered-analysis/market-outlook.md): 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. - [Score Property Condition from Photos — AI API](https://app.homesage.ai/docs/ai-powered-analysis/property-condition.md): Return an AI condition assessment from listing photos: an overall category of Excellent, Good, Fair, or Poor, a confidence score, and a per-room breakdown. - [Analyze Condition from Your Own Photos — AI API](https://app.homesage.ai/docs/ai-powered-analysis/property-condition-custom-photos.md): Submit your own property photos for AI vision analysis and receive an overall condition rating and confidence score, combined with a property database lookup. - [Get a Room-by-Room Renovation Budget — AI API](https://app.homesage.ai/docs/ai-powered-analysis/renovation-cost-breakdown.md): Return an LLM-generated line-item renovation budget broken down room by room from property photos. The standard call for fix-and-flip and BRRRR rehab numbers. - [Analyze Solar Potential and Roof — AI Analysis API](https://app.homesage.ai/docs/ai-powered-analysis/solar-analysis.md): Return solar generation potential for a US property alongside an AI roof-condition assessment covering usable roof area, orientation, and shading. 4 credits. - [Break Down Square Footage by Floor — AI API](https://app.homesage.ai/docs/ai-powered-analysis/sqft-per-floor.md): Return per-floor square-footage distribution for a US residential property, derived from multi-stage AI photo and room detection plus architectural style. ## Skip Tracing API - [Skip Tracing API — overview](https://app.homesage.ai/docs/skip-tracing.md): Trace property owners and their contact details. 3 endpoints: owner lookup from an address, associated people, and a full dossier for a known person_id. - [Find People Linked to an Address — Skip Tracing API](https://app.homesage.ai/docs/skip-tracing/associated-people.md): Return people associated with a US property address, covering relatives, co-owners, and past residents, each with a person_id for a deeper skip-trace lookup. - [Get a Full Skip-Trace Dossier — Skip Tracing API](https://app.homesage.ai/docs/skip-tracing/person-details.md): Return a complete skip-trace dossier for a known person_id: contact details, address history, and associated people, for outreach and lead qualification. - [Skip Trace a Property Owner — Skip Tracing API](https://app.homesage.ai/docs/skip-tracing/property-owner.md): Return the owner's name and contact details for a US property address, including phone numbers and emails where available, from an address input alone. ## Risk & Diligence API - [Risk & Diligence API — overview](https://app.homesage.ai/docs/risk-and-diligence.md): Assess location risk before committing to a US property. 1 streaming endpoint surfacing environmental, crime, flood, and nuisance red flags by address. - [Detect Location Risk Signals — Risk & Diligence API](https://app.homesage.ai/docs/risk-and-diligence/location-red-flags.md): Stream location-risk analysis for a US address, surfacing environmental, crime, flood, and nuisance red flags before you commit capital to a purchase. ## Market Data API - [Market Data API — overview](https://app.homesage.ai/docs/market-data.md): Measure US housing market activity by ZIP code. 3 endpoints covering sold listings, sale counts over 365 days, and mortgage and lien analysis by property. - [Analyze Mortgages and Liens — Market Data API](https://app.homesage.ai/docs/market-data/mortgage-lien-analysis.md): Return mortgage and lien data for a US property: outstanding loan balances, lien positions, lender names, and origination dates for equity and title analysis. - [List Properties Sold in a ZIP — Market Data API](https://app.homesage.ai/docs/market-data/sold-by-zip.md): List residential properties sold in a US ZIP code over the last 365 days, each with sale price, sale date, and characteristics. Costs 1 credit per 20 results. - [Count Sales in a ZIP Code — Market Data API](https://app.homesage.ai/docs/market-data/sold-count-by-zip.md): Return how many residential properties sold in a US ZIP code over the last 365 days, a fast, low-cost way to gauge market liquidity. Costs 1 credit per call. ## Account API - [Account API — overview](https://app.homesage.ai/docs/account.md): Monitor Homesage.ai API usage and spend. 1 free endpoint returning your credit balance, credits consumed this cycle, and credits remaining in the period. - [Check Your API Credit Balance — Account API](https://app.homesage.ai/docs/account/credit-balance.md): Return the current API credit balance for your Homesage.ai account, including credits consumed this billing cycle and credits remaining. Costs 0 credits. ## Developer Resources - [OpenAPI Specification](https://app.homesage.ai/openapi.json): Machine-readable OpenAPI 3.0 spec for every Homesage.ai real estate API endpoint — parameters, response schemas, and error codes. - [Sitemap](https://app.homesage.ai/sitemap.xml): All 42 documentation pages. - [Homesage.ai](https://homesage.ai/): Product site, pricing, and sign-up.