Harta Preturilor — REST API v1 & v2
Base URL: https://hartapreturilor.ro
All responses are JSON with format: { "data": ..., "meta"?: ... }
Check API and database connectivity.
{ "status": "ok", "timestamp": "2026-04-11T...", "dbConnected": true }
List property listings with filters and pagination.
| Param | Type | Description |
|---|---|---|
| location_id | number | Filter by city ID |
| category_id | number | Filter by category (1=apartamente, 2=case, etc.) |
| min_price / max_price | number | Price range filter (EUR) |
| sort | string | Sort field: price, created_at |
| order | string | asc or desc |
| page / per_page | number | Pagination (max 100/page) |
Cache: 15 min
Aggregated price statistics by location, category, and period.
| Param | Type | Description |
|---|---|---|
| location_id | number | Filter by location |
| category_id | number | Filter by category |
| period | string | e.g. 2026-04, 2026-W14, 2026-Q1 |
| metric_type | string | price_sqm, price_total, count_listings |
Cache: 30 min
Compare statistics across 2+ locations.
| Param | Type | Description |
|---|---|---|
| location_ids | string | Comma-separated IDs (min 2) |
| category_id | number | Category filter |
| metric_type | string | Metric to compare |
List all property categories.
Cache: 24h
List locations. Filter by ?type=city (country|region|city|zone).
Cache: 1h
Export listings as CSV. Max 500 items. Rate limited: 3 req/min.
City data with population and stats. Optional ?slug=bucuresti.
Rental statistics. Optional ?city=bucuresti&rooms=2.
Official financial data (IRCC, EUR/RON, mortgage rates).
Create a price alert. Requires email verification. Rate limited: 5 req/min.
{ "email": "[email protected]", "city": "bucuresti", "maxPrice": 100000, "rooms": 2, "type": "sale" }
List alerts for an email address.
Verify and activate an alert via email token.
Deactivate (soft-delete) an alert.
Create account. Rate limited: 5 req/hour.
{ "email": "[email protected]", "password": "min8chars" }
Login. Returns session cookie. Rate limited: 10 req/min.
Logout. Clears session cookie.
Authenticate with Authorization: Bearer hp_xxx. Generate a key at /cont/api-keys.
Premium price estimate with extra fields (distribution, sample size).
| Param | Type | Description |
|---|---|---|
| city | string | City slug (e.g. bucuresti) |
| rooms | number | Number of rooms (1-10) |
| area | number | Area in sqm (15-1000) |
curl -H "Authorization: Bearer hp_YOUR_KEY" \ "https://hartapreturilor.ro/api/v2/premium/estimate?city=bucuresti&rooms=2&area=55"
| Tier | Calls / day | Price / month |
|---|---|---|
| Free | 100 | 0 EUR |
| Starter | 1.000 | 49 EUR |
| Pro | 10.000 | 149 EUR |
| Enterprise | Unlimited | Contact sales |
429 Too Many Requests when exceeded. Counter resets at midnight UTC.
| Status | Code | Meaning |
|---|---|---|
| 400 | BAD_REQUEST | Missing or invalid params |
| 401 | MISSING_API_KEY / INVALID_KEY / REVOKED_KEY / EXPIRED_KEY | Auth problem |
| 404 | NOT_FOUND | Resource (city) not found |
| 429 | RATE_LIMIT_EXCEEDED | Daily quota used up |
| 503 | DB_UNAVAILABLE | Service down |
List the authenticated user's API keys (prefix + usage metadata only).
Generate a new API key. Returns raw key ONCE.
{ "name": "Productie CRM", "tier": "pro" }
Revoke a key by id.
{ "id": 42 }
Register as a real-estate agent (free tier). Auto-links to session user if logged in.
{ "name": "...", "email": "...", "cities": ["bucuresti"], "specialization": ["residential-sale"] }
Load agent profile for the logged-in user.
Start a Stripe Checkout Session (placeholder until keys configured).
{ "tier": "starter" | "pro", "agent_id": 42 }
List leads assigned to the agent. Add ?format=csv for export.
Capture a lead from the evaluator or contact form. Auto-assigns to an eligible agent.
{ "email": "...", "phone": "...", "city": "bucuresti", "estimate_value": 95000, "source_page": "/evalueaza" }
Receives subscription lifecycle events. Node runtime required for raw body verification.
Admin dashboard data (counts, logs, health). Header: X-API-Key.
Ingest data batch. Rate limited: 10 req/min. Header: X-API-Key.
List authenticated user's alerts.
Create alert for authenticated user.
Harta Preturilor API v1.0 — Generated April 2026