Saltar al contenido
REST API v1

REAL NOW es una plataforma de

Bearer-token authenticated REST API. Aggregated market intelligence + verified broker inventory + AI briefings. JSON responses, tier-based rate limits.

Notificaciones

All endpoints require a Bearer token in the Authorization header:

# Request
curl -H "Authorization: Bearer rn_live_xxxxxxxxxxxxxxxxxxxxxxxxx" \
     https://realnow.com/api/v1/health

How to get a key:

  • Enterprise users: self-service from Configuración.
  • PRO users: contact admin to issue a key on your behalf.
  • Free users: API access requires PRO+ tier.

Plaintext keys are shown ONCE at creation. Store them in a secrets manager — they cannot be recovered later. If lost, revoke and create a new one.

Rate limits

Per-key, per-hour. Counters reset at the top of each UTC hour.

PlanHourly limitDetalle
free—No API access
pro100~2,400
enterprise1,000~24,000
adminIlimitados—

Over-limit responses return HTTP 429 Esperar retry_after_seconds.

Error format

{
  "ok": false,
  "error": "rate_limit",
  "message": "Hourly rate limit reached (100 req/h for tier pro).",
  "limit": 100,
  "used": 100,
  "retry_after_seconds": 1842
}

Common error codes:

  • auth_required — 401, missing key
  • invalid_key — 401, key revoked or owner inactive
  • scope_denied — 403, key lacks the required scope
  • rate_limit — 429, hourly limit hit
  • not_found — 404, no such resource

Endpoints

GET /api/v1/health Comparar: read

Verify the key works + see your tier.

curl -H "Authorization: Bearer $RN_KEY" \
  https://realnow.com/api/v1/health
# {"ok":true,"service":"real-now-api","version":"v1","tier":"pro",...}
GET /api/v1/zones Comparar: read

Aggregate market stats per zone across all 7 LATAM countries (GT, SV, HN, CR, BZ, DO, PA). Use ?country=XX to filter.

ÁreaTipoDefault rotosDescripción
countrystringGTPaís
 
curl -H "Authorization: Bearer $RN_KEY" \
  https://realnow.com/api/v1/zones
# {"ok":true,"count":25,"zones":[
#   {"zone":"Zona 1","median_ppm2_usd":1340.5,"n_active":420,"median_dom":31,...},
#   ...
# ]}
GET /api/v1/zone/{slug} Comparar: read

Detailed snapshot for one zone: medians by property type + bedroom + operation, 30d delta, source mix.

curl -H "Authorization: Bearer $RN_KEY" \
  https://realnow.com/api/v1/zone/zona-10
GET /api/v1/listings Comparar: read

Verified broker inventory only (active broker_listings). Scraped data is NEVER exposed via API.

ÁreaTipoDescripción
zonestringZona N
countrystringGT (default)
operationstringVenta | Renta
property_typestringApartamento, Casa, Terreno, …
price_min / price_maxnumberUSD bounds
limit / offsetintPagination — limit 1-200
 
curl -H "Authorization: Bearer $RN_KEY" \
  "https://realnow.com/api/v1/listings?zone=Zona+10&operation=Venta&price_max=200000"
GET /api/v1/briefings/personas Comparar: read

List the 5 AI personas with their input schema + verdict vocabulary.

POST /api/v1/briefings/{persona} Comparar: write

Generate an AI briefing. Counts against the key owner's monthly quota (same as the web UI). 24h cache hits don't consume quota.

curl -X POST -H "Authorization: Bearer $RN_KEY" \
     -H "Content-Type: application/json" \
     -d '{"zone":"Zona 10","profile":"cash"}' \
     https://realnow.com/api/v1/briefings/inversor
# Returns: {"ok":true,"verdict":"Comprar","confidence":"Alta",
#           "headline":"Zona 10 ofrece yield bruto del 7.0%...",
#           "body_md":"## Veredicto\n**Comprar** · Confianza: Alta\n...",
#           "usage":{"used":3,"quota":20,"unlimited":false}}

Cambio

v1.0 · 2026-05-07 — Initial release. 6 endpoints. Bearer-token auth. Tier rate limits.