Search for property addresses with typeahead autocomplete suggestions. Returns matching address suggestions for a partial address string — ideal for building address search UIs.
\nCredit Cost: Free (0 credits)
\nComprehensive property information including listing details, valuation, features, history, and school ratings. This is the primary property data endpoint.
\nCredit Cost: 2 credits per request
\nNote: Address format is flexible — commas, periods, and case variations all accepted.
\nSome fields may be null when source data is incomplete: listing_price is null unless the property is for sale; estimated_value is null when no AVM has been computed; numeric fields under property_features may be null per-property.
Always-fresh property information. Same schema as Property Info but fetches the latest valuation data. Recommended over Property Info for most use cases — cheaper (1 credit vs 2) and returns a fresher estimated value.
\nCredit Cost: 1 credit per request
\nTip: Calling this endpoint refreshes the cache that Property Info reads from. Call Updated Info first to ensure subsequent Property Info calls return fresh data.
\nSame response schema as Property Info. Some fields may be null when source data is incomplete.
\n "},{"id":27,"name":"Property Search (Bulk)","order":4,"identifier":"bulk_property_info","credits":10,"url":"https://developers.homesage.ai/api/properties/bulk-info/","method":"GET","description":"\nSearch for properties by location with optional filters. Returns a paginated list of properties matching your criteria. This is a location-based search endpoint, not a batch address lookup.
\nCredit Cost: 10 credits per search (regardless of result count)
\nNote: Use page_size to control results per page (default: 10, max: 100) and page for pagination.
All 36 per-property fields are always present. Several may be null when underlying data has not been computed: avm, avm_low, avm_high, avm_confidence, avm_disagreement (computed by the comps refresh job), and final_property_condition, is_tlc, neighborhood (depend on per-property data availability).
AI-powered square footage breakdown by floor. Uses a 7-stage analysis to determine per-floor square footage distribution.
\nCredit Cost: 1 credit per request
\nNote: Use a 45-second timeout for this endpoint.
\n "},{"id":1005,"name":"Current Property Estimate","order":6,"identifier":"current_estimate","credits":2,"url":"https://developers.homesage.ai/api/properties/current-estimate/","method":"GET","description":"\nCurrent property value estimate powered by our valuation engine.
\nCredit Cost: 2 credits per request
\n "},{"id":2,"name":"Investment Potential","order":7,"identifier":"investment_potential","credits":3,"url":"https://developers.homesage.ai/api/properties/investment_potential/","method":"GET","description":"\nInvestment potential score for a property.
\nCredit Cost: 3 credits per request
\n "},{"id":1,"name":"Price Flexibility Score (PFS)","order":8,"identifier":"pfs","credits":2,"url":"https://developers.homesage.ai/api/properties/pfs/","method":"GET","description":"\nPrice Flexibility Score (PFS) — a composite score indicating how flexible the listing price is. Lower scores suggest the seller may be more open to price negotiation.
\nCredit Cost: 2 credits per request
\n "},{"id":6,"name":"Home Value History","order":9,"identifier":"home_value_graph","credits":1,"url":"https://developers.homesage.ai/api/properties/home_value_graph/","method":"GET","description":"\nHistorical home value data points for charting. Returns monthly value estimates in reverse-chronological order (most recent first).
\nCredit Cost: 1 credit per request
\nNote: Data points are returned most-recent-first. Sort client-side if you need chronological order.
\n "},{"id":5,"name":"Flip Return Analysis","order":10,"identifier":"flip_return","credits":3,"url":"https://developers.homesage.ai/api/properties/flip_return/","method":"GET","description":"\nFlip/resale return analysis including total project cost, profit, ROI, and maximum recommended renovation budget.
\nCredit Cost: 3 credits per request
\nNote: Requires property size (sqft) and price data in the database. Returns 400 for properties missing this data.
\n "},{"id":4,"name":"Renovation Return","order":11,"identifier":"renovation_return","credits":3,"url":"https://developers.homesage.ai/api/properties/renovation_return/","method":"GET","description":"\nRental income projections including daily/monthly/annual gross and net income, IRR, cap rate, NOI, and cash-on-cash return.
\nCredit Cost: 3 credits per request
\nNote: Requires property size (sqft) data. Returns 400 for properties without sqft in the database.
\n "},{"id":12,"name":"Renovation Cost Estimate","order":12,"identifier":"renovation_cost","credits":5,"url":"https://developers.homesage.ai/api/properties/renovation/cost/","method":"GET","description":"\nQuick renovation cost estimate with value gap analysis. For detailed room-by-room breakdown, use the Renovation Cost Breakdown (POST) endpoint instead.
\nCredit Cost: 5 credits per request
\n "},{"id":9,"name":"Needs TLC Check","order":13,"identifier":"tlc","credits":1,"url":"https://developers.homesage.ai/api/properties/tlc/","method":"GET","description":"\nQuick check whether a property needs TLC (Tender Loving Care). Returns a simple boolean indicator.
\nCredit Cost: 1 credit per request
\n "},{"id":10,"name":"Long-Term Rental Analysis","order":14,"identifier":"rental_long_term","credits":5,"url":"https://developers.homesage.ai/api/properties/rental/long_term/","method":"GET","description":"\nLong-term rental income projections including daily/monthly/annual gross and net income, IRR, cap rate, NOI, and cash-on-cash return.
\nCredit Cost: 5 credits per request
\nNote: Requires property size (sqft) and price data.
\n "},{"id":11,"name":"Short-Term Rental Analysis","order":15,"identifier":"rental_short_term","credits":5,"url":"https://developers.homesage.ai/api/properties/rental/short_term/","method":"GET","description":"\nShort-term (Airbnb-style) rental income projections including daily/monthly/annual revenue, cap rate, NOI, and cash flow.
\nCredit Cost: 5 credits per request
\n "},{"id":14,"name":"Property Condition","order":16,"identifier":"property_condition","credits":2,"url":"https://developers.homesage.ai/api/properties/property-condition/","method":"GET","description":"\nAI-powered property condition assessment. Returns a condition label based on database analysis using ResNet50 and LLM models.
\nCredit Cost: 2 credits per request
\nCondition values: Excellent, Good, Outdated, Poor, Very Poor, Unpredictable
\n "},{"id":999,"name":"Property Condition with Custom Photos","order":17,"identifier":"property_condition_custom_photos","credits":3,"url":"https://developers.homesage.ai/api/properties/property-condition-custom-photos/","method":"POST","description":"\nAdvanced property condition analysis using custom photos. Combines database lookup with Gemini AI vision analysis of your property images for a more accurate assessment.
\nCredit Cost: 3 credits per request
\nSupports both GET and POST.
\nFind comparable recently sold properties for valuation analysis. Returns up to 5 comparable properties with adjusted prices and confidence scores.
\nCredit Cost: 5 credits per request
\nNote: ARV (After Repair Value) may be null in non-disclosure states where sale prices are not publicly recorded.
\n "},{"id":1025,"name":"Market Outlook","order":19,"identifier":"market_outlook","credits":2,"url":"https://developers.homesage.ai/api/properties/market-outlook/","method":"GET","description":"\nLocal market outlook and trends for a ZIP code area. Returns market health indicators including outlook score, forecast bars, market velocity metrics, and source breakdown.
\nCredit Cost: 2 credits per request
\nWhen upstream data sources are unavailable for a ZIP code, optional sections may be omitted from the response: outlook_score, forecast_bars, market_velocity, micro_stats, and source_breakdown.
The fields zip_code, metro_name, timestamp, weights_used, and credits_charged are always present.
Note: micro_stats.absorption_rate_pct and source_breakdown.internal.absorption_rate express the same metric under different field names — this is a known inconsistency in the upstream data structure.
Comprehensive solar potential and AI-powered roof condition analysis. Returns panel recommendations, energy projections, cost savings, federal incentives, and roof condition assessment.
\nCredit Cost: 4 credits per request
\nImportant: Use a 90-second client timeout. Cache responses — this is an expensive, slow endpoint.
\nThe response shape varies based on optional query parameters:
\n?detailed=true — adds the raw solar_potential.data blob and includes both roof_image_url and roof_image_base64 in roof_condition.imagery?agent=false — sets roof_condition.analysis to null (skips the AI roof analysis)If S3 image upload fails, roof_condition.imagery contains roof_image_base64 (raw base64 PNG) instead of roof_image_url. Individual entries in solar_layers may be missing if a particular Google data layer was unavailable for the address.
The most comprehensive property analysis endpoint. Aggregates data from 11 internal sources into a single response with 292 data fields. Costs 15 credits — 25% cheaper than calling individual endpoints separately (~20 credits).
\nCredit Cost: 15 credits per request
\nThis endpoint aggregates data from multiple internal sources. Sub-fields may be null, 0, or empty arrays when the underlying data is unavailable for the property — e.g., comps may be empty in rural areas, last_sold_price is 0 in non-disclosure states, and photos can be empty for unlisted properties.
AI-powered room-by-room renovation cost breakdown with confidence scores, red flags, and non-visible area estimates. The most detailed renovation analysis available — 158 data fields.
\nCredit Cost: 5 credits per request
\nThis endpoint is AI-powered, so a few fields vary by property:
\nrooms array length varies with property size (typically 3–8 entries)non_visible_areas is empty [] when all rooms are photographed; populated when the AI extrapolates from bedroom/bathroom countsmajor_red_flags is empty [] for properties in good condition; populated when issues are detectedCost values and text descriptions may vary slightly between calls for the same property. Structural keys and types remain consistent.
\n "},{"id":1011,"name":"Property Owner Information","order":23,"identifier":"skip_tracing_property_owner","credits":4,"url":"https://developers.homesage.ai/api/properties/skip-tracing/property-owner-information/","method":"POST","description":"\nRetrieve property owner contact information including name, phone numbers, email addresses, and ownership details from third-party data providers.
\nCredit Cost: 4 credits per request
\nEach per-person field is conditional — the proxy strips it from the response when the upstream service did not return it for that person. emails may be absent if no email addresses are associated; bankruptcy and involuntaryLien appear only when public records exist for the person.
When zero matches are found, the response shape changes to:
\n{\n \"count\": 0,\n \"persons\": [],\n \"credits_charged\": false,\n \"no_results\": true,\n \"message\": \"No owner information found for the provided address. No credits were charged.\",\n \"summary\": { \"requestCount\": 1, \"matchCount\": 0, \"noMatchCount\": 1, \"errorCount\": 0 }\n}Credits are not charged when no matches are found.
\n "},{"id":1012,"name":"Associated People","order":24,"identifier":"skip_tracing_associated_people","credits":1,"url":"https://developers.homesage.ai/api/properties/skip-tracing/associated-people/","method":"POST","description":"\nFind people associated with a property address — residents, relatives, and prior occupants.
\nCredit Cost: 1 credit per request
\n "},{"id":1009,"name":"Person Details","order":25,"identifier":"skip_tracing_person_details","credits":1,"url":"https://developers.homesage.ai/api/properties/skip-tracing/person-details/","method":"POST","description":"\nDetailed person information lookup by person ID. Requires a person_id obtained from internal systems.
Credit Cost: 1 credit per request
\nNote: This endpoint requires a person_id which is not currently available from other developer API endpoints. Contact support for access.
Retrieve all sold properties in a ZIP code area. Returns a full list of recently sold properties with details.
\nCredit Cost: ~51 credits per request (scales with result count, ~0.05 per property)
\nImportant: This is the most expensive endpoint. Use limit to cap results, or call Sold Properties Count first to estimate cost.
Get the count of sold properties in a ZIP code area. Use this before calling Sold Properties by ZIP to estimate credit cost.
\nCredit Cost: 1 credit per request
\n "},{"id":1018,"name":"Mortgage & Lien Analysis","order":28,"identifier":"mortgage_lien","credits":5,"url":"https://developers.homesage.ai/api/mortgage-lien/analysis/","method":"GET","description":"\nMortgage and lien data for a property including lien amounts, lender information, and equity estimates.
\nCredit Cost: 5 credits per fresh request (cached responses within 7 days are free)
\nCaching: Successful lookups are cached for 7 days. Repeat requests for the same address within that window do not consume credits.
\nNote: Coverage varies by market. Returns 404 with a clear message for addresses without data.
\n "},{"id":1031,"name":"Skip Tracing - Property Owner Information","order":29,"identifier":"skip_tracing_owner_name","credits":4,"url":"https://developers.homesage.ai/api/properties/skip-tracing/property-owner-information/","method":"POST","description":"Retrieve property owner names and contact information using skip tracing services.
Returns:
Supports batch requests: Up to 100 properties per request
Cost: 4 credits per request
"},{"id":1032,"name":"Updated Property Info","order":30,"identifier":"updated_property_info","credits":1,"url":"https://developers.homesage.ai/api/properties/updated-info/","method":"GET","description":"Get comprehensive property information with always-fresh data. This endpoint always fetches the latest property data from the source before returning a response, ensuring you receive the most current information available.
Key Features:
Retrieve your account's current API credit balance and plan/billing context.
\nThis endpoint is intended for usage monitoring — call it before a session to confirm\n you have credits available, or poll it to drive your own low-balance alerts.
\nAuthentication: API key only. Pass your key as a Bearer token in the\n Authorization header. The endpoint returns the balance for the account that\n owns the key; no email address or other identifier is needed.
Cost: This call is free — it does not consume any credits.
\n "},{"id":1034,"name":"Location Red Flags","order":32,"identifier":"location_red_flags","credits":5,"url":"https://developers.homesage.ai/api/properties/red-flags/stream/","method":"POST","description":"Analyze a property address for nearby location red flags (liquor stores, industrial sites, etc.) using Google Places and AI vision analysis. Returns a risk score and ranked list of nearby negative externalities.
Cost: 5 credits per request
"},{"id":1035,"name":"Skip Tracing - Associated People","order":33,"identifier":"skip_tracing_associated_persons","credits":1,"url":"https://developers.homesage.ai/api/properties/skip-tracing/associated-people/","method":"POST","description":"Retrieve people associated with a given property address.
Returns:
Cost: 1 credit per request
"},{"id":1036,"name":"Renovation Cost Breakdown","order":34,"identifier":"renovation_cost_breakdown","credits":5,"url":"https://developers.homesage.ai/api/properties/renovation-cost-breakdown/","method":"POST","description":"Get a detailed AI-powered renovation cost breakdown by analyzing property images using Google Gemini Vision API.
Returns:
Cost: 5 credits per request
"}]}