Homesage.ai Real Estate APIs

Property data, valuations and investment analysis for 160M+ US properties and 200B+ data points. Call 30+ REST endpoints from your own code, or connect the MCP to Claude, ChatGPT, Gemini or Cursor.

Look up a property: property record, estimated value, value history and condition score.
Run the numbers: comps, ARV, renovation cost, and flip and rental returns.
Search an area: filter a city, county or ZIP by price, condition, ROI and rent.
Check the risk: market outlook, location red flags, and mortgage and lien data.
Reach the owner: owner contacts and associated people for a property address.

Quickstart

Create an account and choose a plan on the pricing page.
Create an API key on the Keys page.
Send the key in the Authorization: Bearer header:

curl 'https://api.homesage.ai/api/properties/info/?property_address=4411%20E%20Hidden%20Oak%20St%20Springfield%20MO%2065802' \
  -H 'Authorization: Bearer YOUR_API_KEY'

The base URL is https://api.homesage.ai. Every endpoint returns JSON.

Code examples

The examples folder has two flows in Python and JavaScript:

Flow	Python	JavaScript
Look up one property	`property_lookup.py`	`property_lookup.mjs`
Preview, then run an area search	`search_properties.py`	`search_properties.mjs`

MCP

The MCP puts the same data inside your AI assistant. Add this URL to the assistant, sign in once, and ask in plain words. You need no API key.

https://api.homesage.ai/mcp

Claude (web or desktop)

Open Customize → Connectors.
Click the "+", then "Add custom connector".
Paste the URL, click Add, then Connect, and sign in.

On Team or Enterprise plans, an admin adds the connector once in organization settings first.

ChatGPT

Open Settings → Apps → Advanced and turn on Developer mode.
Go to Settings → Connectors → Create.
Paste the URL, name it, create it, and sign in when prompted.

Gemini CLI

gemini mcp add --transport http homesage https://api.homesage.ai/mcp

Run it, then approve the browser sign-in.

Cursor and most other clients

In Cursor, open Settings → Tools & Integrations → New MCP Server. Add the server to mcp.json:

{
  "mcpServers": {
    "homesage": {
      "url": "https://api.homesage.ai/mcp"
    }
  }
}

VS Code (Copilot)

VS Code uses the same shape with a servers root key and a type:

{
  "servers": {
    "homesage": {
      "type": "http",
      "url": "https://api.homesage.ai/mcp"
    }
  }
}

Endpoints

The endpoints sit in 8 categories. The endpoint index lists each one with its credit price and a link to its live docs page.

Category	What it covers
Property Search	Area lookup, search preview and filtered search
Property Lookup	Address suggestions and property records
Property Valuation	Estimated value, scores, renovation, flip and rental returns
AI-Powered Analysis	Full report, condition, comps, renovation breakdown and solar
Skip Tracing	Property owners and associated people
Risk & Diligence	Location red flags
Market Data	Sold properties by ZIP, mortgage and lien data
Account	Credit balance

Credits and errors

One credit balance covers the web app, Sage (our AI assistant), the APIs and the MCP. Each endpoint page shows its credit price.

Status	Meaning	Credits charged
401	The API key is missing or invalid.	0
402	The account has no active plan or not enough credits.	0
404	The address has no confident match. The response lists close matches in `did_you_mean`.	0

Docs for agents

Every docs page has a Markdown version: add .md to its URL. The OpenAPI spec and llms.txt are public too.

Contact

Questions? Email [email protected].

Homesage.ai-Real-Estate-APIs