Developer API

Connect your own AI agent to your Mappa IQ data. Your agent calls these endpoints with an API key — it can search comps, add records, run analysis, and ask Nila questions.

Quick start

Base URL: https://mappaiq.com/api/v1. Send your key on every request:

Authorization: Bearer mappa_live_xxxxxxxx

Search your comps

curl "https://mappaiq.com/api/v1/comps?keyword=industrial&maxPrice=5000000" \
  -H "Authorization: Bearer YOUR_KEY"

Ask Nila a question

curl -X POST "https://mappaiq.com/api/v1/ask" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question":"What are my land comps trading at per acre?"}'

All endpoints

GET /api/v1/layers — your layers + counts
GET /api/v1/comps — search/filter records
POST /api/v1/comps — add a record
GET /api/v1/comps/:id — one record
POST /api/v1/analyze — stats (avg, median, min/max)
POST /api/v1/ask — natural-language question (uses your daily AI allowance)

Tip: point a custom GPT Action, an MCP wrapper, or any function-calling agent at these endpoints — GET /api/v1 returns a machine-readable list of everything available.