# LLMS.TXT

Project: Minside  
Website: https://minside.ro  
API Base URL: https://minside.ro/api  
Category: Real Estate Market Intelligence  
Geography: Romania  
Primary Market: Romanian residential real estate  

---

## Overview

Minside is a data-driven platform that analyzes the Romanian residential real estate market using official public sources. It aggregates, standardizes, and processes real-time data from:

- BNR (National Bank of Romania)
- INS (National Institute of Statistics)
- ANCPI (National Agency for Cadastre and Real Estate Publicity)
- Other verified public data sources

The platform provides objective insight into whether the market is growing, stagnating, or declining.

---

## Mission

To eliminate speculation in real estate decisions by providing transparent, verifiable, and data-backed analysis of the Romanian residential market.

---

## Core Value Proposition

Minside identifies market direction by analyzing:

- Transaction volumes
- Price evolution
- Macroeconomic indicators
- Legislative changes
- Supply and demand dynamics

Users gain early visibility into trend shifts, structural changes, and market shocks.

---

## Key Features

- Real-time aggregation of official public data
- Standardized processing across institutions
- Historical vs current data comparison
- Detection of market shocks and trend reversals
- Correlation between legislative events and market behavior
- Centralized analytics dashboard
- Email notifications for new data releases
- REST API access for programmatic data extraction

---

## Target Audience

### Real Estate Developers
Evaluate whether market conditions are favorable for new launches.  
Anticipate demand cycles and sales waves.

### Private Investors
Identify entry and exit windows.  
Assess whether demand supports current price levels.

### Real Estate Agents
Adjust strategy based on macro market direction.  
Understand broader buyer sentiment.

### Individuals
Make informed buying or selling decisions.  
Understand if the market is expanding, stagnating, or correcting.

---

## Pricing

### FREE Plan — €0/month
- Access to raw data
- Email notifications for new data releases

### PRO Plan — Custom pricing
- Full access to market trends and analytics
- Strategic decision support
- REST API access

---

## Data Integrity

- All indicators are linked to official public sources
- Each metric can be independently verified
- No manipulation of primary source data
- Transparent methodology

---

## Update Frequency

Data is updated in real time, synchronized with official publication from public institutions.

---

## Key Questions Addressed

- Is this a good time to launch a new real estate project?
- Is the market overbuilding or underbuilding?
- Is a price correction likely?
- How does fiscal policy impact the housing market?
- When are sales volumes accelerating or slowing?

---

# API Documentation

## Introduction

Minside REST API allows programmatic access to the data available in the platform.

Base URL:
https://minside.ro/api

All endpoints require authentication.

---

## Authentication

All API endpoints require an API key.

The API key:
- Has prefix `minside_`
- Is available in the Minside dashboard under Organization Settings
- Must be sent in the `x-api-key` header

Example header:

x-api-key: minside_your_api_key_here

To request API access:
- Email: hello@minside.ro
- Or schedule a call via the website

---

## Endpoint: Get Data Points

Returns a list of monthly data points for a specific metric and region.

### HTTP Method

GET /data-points

### Example cURL

curl --request GET \
  --url "https://minside.ro/api/data-points" \
  --header "x-api-key:{api_key}" \
  --data-urlencode "region={region}" \
  --data-urlencode "metric={metric}" \
  --data-urlencode "date_start={date_start}" \
  --data-urlencode "date_end={date_end}"

---

### Headers

x-api-key  
Required. Must contain the organization API key.

---

### Query Parameters

region  
Required. Slug of the region.  
Example: sibiu

metric  
Required. Slug of the metric.  
Example: price_sqm_residential_new

date_start  
Required. Start date in format YYYY-MM  
Example: 2025-01

date_end  
Required. End date in format YYYY-MM  
Example: 2025-12

---

### Successful Response

Status: 200 OK

[
  {
    "value": 1234.56,
    "date": "2025-01"
  }
]

value is numeric.  
date is formatted as YYYY-MM.

---

## API Purpose

The API enables:

- Custom dashboards
- Internal BI integration
- Automated reporting
- Quantitative investment models
- Data science and forecasting workflows

All data served via API reflects official public sources aggregated and standardized by Minside.