After Repair Value, ZIP-level market intelligence, and AI renovation analytics — the same investor-grade methodology that powers icomps.io, served over a clean REST API.
Every endpoint returns iComps-derived analysis or open-government data — the high-value signal, computed with our methodology. Authenticate with a single API key.
/v1/analyze
The flagship. One call, one credit — a complete property analysis: ARV with confidence and estimated range, the comparable sales used (similarity, weights, and adjustments), the full transparency breakdown, and a branded PDF report. Returns the sections in your implementation config.
iComps-derived · flagship · metered/v1/arv
Lightweight After Repair Value — value, confidence, comp tier, and comp count from the 5-tier comparable-sales engine, when you need just the number and not the full analysis bundle.
iComps-derived/v1/zips/{zip}
ZIP market intelligence — income, population, owner/renter mix, fair-market rents, crime, and MSA unemployment.
Census · HUD · FBI · FRED/v1/zips/{zip}/renovation-profile
AI renovation analytics — the distribution of finish levels and average renovation score across analyzed homes in a ZIP.
iComps AI/v1/coverage
Which ZIP codes have active iComps data coverage, with property counts.
iComps-derived/v1/account · /v1/usage
Confirm your key and plan, and track your request usage over time for your dashboards.
Account & meteringx-api-keyEvery /v1 request carries your key in the header. No OAuth dance.POST /v1/analyze returns the analysis object directly; errors are application/problem+json (RFC 7807) with a stable type and a request id. The data endpoints use the { success, data, error, meta } envelope.# A full property analysis — one credit
curl -X POST https://icomps-data-gw-1t4cvml7.uc.gateway.dev/v1/analyze \
-H "x-api-key: $ICOMPS_KEY" \
-H "content-type: application/json" \
-d '{"address":"123 Main St SW","zip":"30311","lat":33.72,"lon":-84.44,"beds":3,"baths":2,"sqft":1450}'from icomps_data import IcompsData
client = IcompsData(api_key="YOUR_KEY")
result = client.analyze(address="123 Main St SW", zip="30311",
lat=33.72, lon=-84.44, beds=3, baths=2, sqft=1450)
result["arv"]["value"], result["pdf"]["url"] # insufficient_comps -> not chargedimport { IcompsData } from "@icomps/data";
const client = new IcompsData({ apiKey: "YOUR_KEY" });
const result = await client.analyze({ address: "123 Main St SW", zip: "30311",
lat: 33.72, lon: -84.44, beds: 3, baths: 2, sqft: 1450 });Your API key unlocks every product below. Higher tiers raise your rate limits; analysis usage is metered — you pay per successful analysis, billed at graduated rates.
| You can… | Endpoint | Starter | Pro | Enterprise |
|---|---|---|---|---|
| Run a full property analysis (ARV + comps + breakdown + PDF) | POST /v1/analyze |
✓ | ✓ | ✓ |
| Re-fetch & list your prior analyses | GET /v1/analyses |
✓ | ✓ | ✓ |
| Estimate After Repair Value for any address | POST /v1/arv |
✓ | ✓ | ✓ |
| Pull ZIP market intelligence (income, rents, crime, jobs) | GET /v1/zips/{zip} |
✓ | ✓ | ✓ |
| Read AI renovation profiles by ZIP | GET /v1/zips/{zip}/renovation-profile |
✓ | ✓ | ✓ |
| List active data coverage | GET /v1/coverage |
✓ | ✓ | ✓ |
| Track your own usage & plan | GET /v1/usage · /v1/account |
✓ | ✓ | ✓ |
| Rate limit (requests / min) | — | 300 | 1,200 | 6,000 |
| Analyze / ARV requests / min | — | 30 | 120 | 600 |
| Property analyses | — | Metered | Metered | Volume terms |
| Support | — | Community | Dedicated + SLA |
One credit = one successful /v1/analyze call. Graduated rates apply
automatically as your monthly volume grows — no plans to pick, no overage cliffs.
You are only charged for successful analyses — if we cannot produce
an ARV for a property (insufficient_comps), that analysis is free,
automatically, and idempotent retries are never double-charged. Graduated rates bill each
analysis at its bracket's rate within the month. Live usage, plan state, and your
fee-waiver progress are on your developer console.