Mercados
Dónde tenemos cobertura, cómo se subdivide cada mercado y las estadísticas agregadas calculadas sobre él.
/v1/api/marketsmarkets:readListar mercados
Todos los mercados con cobertura, y hasta dónde llega esa cobertura.
Llama a esto antes de fijar un identificador de mercado en el código. La cobertura crece, y un mercado que aquí no aparece todavía no tiene oferta sistemática, no es que no haya inmuebles.
Respuesta
{
"data": [
{
"id": "berlin-de",
"name": "Berlin",
"country": "DE",
"property_count": 1284,
"district_count": 12,
"coverage": "systematic",
"currency": "EUR",
"area_unit": "sqm"
}
],
"meta": { "has_more": false, "limit": 50 }
}https://api.skautik.com/v1/api/markets
GET /v1/api/markets HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…/v1/api/markets/{city}markets:readObtener un mercado
Un mercado con su oferta y su distribución de precios.
Parámetros de ruta
| Nombre | Tipo | Descripción |
|---|---|---|
cityobligatorio | string | Identificador del mercado, por ejemplo berlin-de. ejemplo: berlin-de |
Parámetros de consulta
| Nombre | Tipo | Descripción |
|---|---|---|
period | string | Mes del que informar, como YYYY-MM. Por defecto, el más reciente calculado. ejemplo: 2026-07 |
property_type | enum | Restringir las cifras a una clase de inmueble. apartment | house | studio | villa | penthouse | loft | townhouse | other ejemplo: apartment |
Respuesta
{
"data": {
"id": "berlin-de",
"name": "Berlin",
"country": "DE",
"property_count": 1284,
"price_distribution": {
"currency": "EUR",
"p25": 31500000,
"median": 41500000,
"p75": 58000000,
"median_price_per_area": 560000
},
"computed_at": "2026-08-11T04:00:00Z"
}
}https://api.skautik.com/v1/api/markets/{city}
GET /v1/api/markets/berlin-de?period=2026-07&property_type=apartment HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…/v1/api/markets/{city}/districtsmarkets:readListar barrios
Subdivisiones de un mercado, para construir tus propios filtros.
Parámetros de ruta
| Nombre | Tipo | Descripción |
|---|---|---|
cityobligatorio | string | Identificador del mercado. ejemplo: berlin-de |
https://api.skautik.com/v1/api/markets/{city}/districts
GET /v1/api/markets/berlin-de/districts HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…/v1/api/markets/{city}/districts/{district}Growth and abovemarkets:readObtener un barrio
Oferta, distribución de precios y contexto de servicios a nivel de barrio.
Parámetros de ruta
| Nombre | Tipo | Descripción |
|---|---|---|
cityobligatorio | string | Identificador del mercado. ejemplo: berlin-de |
districtobligatorio | string | Identificador del barrio. ejemplo: kreuzberg |
Parámetros de consulta
| Nombre | Tipo | Descripción |
|---|---|---|
period | string | Mes del que informar, como YYYY-MM. Por defecto, el más reciente calculado. ejemplo: 2026-07 |
property_type | enum | Restringir las cifras a una clase de inmueble. apartment | house | studio | villa | penthouse | loft | townhouse | other ejemplo: apartment |
https://api.skautik.com/v1/api/markets/{city}/districts/{district}
GET /v1/api/markets/berlin-de/districts/kreuzberg?period=2026-07&property_type=apartment HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…/v1/api/markets/{city}/statisticsmarkets:readEstadísticas de mercado
Series de oferta y precio a lo largo del tiempo, por tipo de inmueble.
Se calculan a partir del catálogo que tenemos, lo que significa que describen el comportamiento de la oferta y no precios de operaciones cerradas. No son tasaciones y no deben usarse para decisiones de financiación.
Parámetros de ruta
| Nombre | Tipo | Descripción |
|---|---|---|
cityobligatorio | string | Identificador del mercado. ejemplo: berlin-de |
Parámetros de consulta
| Nombre | Tipo | Descripción |
|---|---|---|
property_type | enum | Acotar a un solo tipo de inmueble. apartment | house | studio | villa | penthouse | loft | townhouse | other ejemplo: apartment |
transaction_type | enum | sale o rent. sale | rent ejemplo: sale |
interval | enum | Granularidad de la serie devuelta. week | month | quarter ejemplo: month |
since | string | Cota inferior de la serie, en RFC 3339. ejemplo: 2026-08-01T00:00:00Z |
Respuesta
{
"data": {
"market_id": "berlin-de",
"interval": "month",
"series": [
{
"period": "2026-06",
"listing_count": 1211,
"median_price": 41000000,
"median_price_per_area": 554000,
"median_days_listed": 41
},
{
"period": "2026-07",
"listing_count": 1284,
"median_price": 41500000,
"median_price_per_area": 560000,
"median_days_listed": 38
}
]
},
"meta": { "computed_at": "2026-08-11T04:00:00Z" }
}https://api.skautik.com/v1/api/markets/{city}/statistics
GET /v1/api/markets/berlin-de/statistics?property_type=apartment&transaction_type=sale&interval=month HTTP/1.1
Host: api.skautik.com
Authorization: Bearer sk_live_…