Mercati

Dove abbiamo copertura, come si suddivide ciascun mercato e le statistiche aggregate calcolate su di esso.

GET/v1/api/marketsmarkets:read

Elencare i mercati

Tutti i mercati coperti, e quanto in profondità arriva quella copertura.

Chiama questo endpoint prima di fissare un identificatore di mercato nel codice. La copertura si amplia, e un mercato qui assente non ha ancora un patrimonio sistematico, non significa che lì non ci siano immobili.

Risposta

{
  "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_…

GET/v1/api/markets/{city}markets:read

Recuperare un mercato

Un mercato con la sua offerta e la distribuzione dei prezzi.

Parametri di percorso

Parametri di percorso
Nome	Tipo	Descrizione
`city`obbligatorio	string	Identificatore del mercato, ad esempio berlin-de. esempio: berlin-de

Parametri di query

Parametri di query
Nome	Tipo	Descrizione
`period`	string	Mese da riportare, nel formato YYYY-MM. Per impostazione predefinita, il più recente calcolato. esempio: 2026-07
`property_type`	enum	Restringere i dati a un genere di immobile. apartment \| house \| studio \| villa \| penthouse \| loft \| townhouse \| other esempio: apartment

Risposta

{
  "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_…

GET/v1/api/markets/{city}/districtsmarkets:read

Elencare i quartieri

Suddivisioni di un mercato, per costruire i tuoi filtri.

Parametri di percorso

Parametri di percorso
Nome	Tipo	Descrizione
`city`obbligatorio	string	Identificatore del mercato. esempio: 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_…

GET/v1/api/markets/{city}/districts/{district}Growth and abovemarkets:read

Recuperare un quartiere

Offerta, distribuzione dei prezzi e contesto dei servizi a livello di quartiere.

Parametri di percorso

Parametri di percorso
Nome	Tipo	Descrizione
`city`obbligatorio	string	Identificatore del mercato. esempio: berlin-de
`district`obbligatorio	string	Identificatore del quartiere. esempio: kreuzberg

Parametri di query

Parametri di query
Nome	Tipo	Descrizione
`period`	string	Mese da riportare, nel formato YYYY-MM. Per impostazione predefinita, il più recente calcolato. esempio: 2026-07
`property_type`	enum	Restringere i dati a un genere di immobile. apartment \| house \| studio \| villa \| penthouse \| loft \| townhouse \| other esempio: 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_…

GET/v1/api/markets/{city}/statisticsmarkets:read

Statistiche di mercato

Serie di offerta e prezzo nel tempo, per tipo di immobile.

Calcolate dal catalogo che deteniamo, il che significa che descrivono i prezzi richiesti e non quelli delle compravendite. Non sono perizie e non vanno usate per decisioni di credito.

Parametri di percorso

Parametri di percorso
Nome	Tipo	Descrizione
`city`obbligatorio	string	Identificatore del mercato. esempio: berlin-de

Parametri di query

Parametri di query
Nome	Tipo	Descrizione
`property_type`	enum	Restringere a un solo tipo di immobile. apartment \| house \| studio \| villa \| penthouse \| loft \| townhouse \| other esempio: apartment
`transaction_type`	enum	sale oppure rent. sale \| rent esempio: sale
`interval`	enum	Granularità della serie restituita. week \| month \| quarter esempio: month
`since`	string	Limite inferiore della serie, in formato RFC 3339. esempio: 2026-08-01T00:00:00Z

Risposta

{
  "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_…

Mercati

Dove abbiamo copertura, come si suddivide ciascun mercato e le statistiche aggregate calcolate su di esso.

GET/v1/api/marketsmarkets:read

Elencare i mercati

Tutti i mercati coperti, e quanto in profondità arriva quella copertura.

Risposta

{
  "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_…

GET/v1/api/markets/{city}markets:read

Recuperare un mercato

Un mercato con la sua offerta e la distribuzione dei prezzi.

Parametri di percorso

Parametri di percorso
Nome	Tipo	Descrizione
`city`obbligatorio	string	Identificatore del mercato, ad esempio berlin-de. esempio: berlin-de

Parametri di query

Parametri di query
Nome	Tipo	Descrizione
`period`	string	Mese da riportare, nel formato YYYY-MM. Per impostazione predefinita, il più recente calcolato. esempio: 2026-07
`property_type`	enum	Restringere i dati a un genere di immobile. apartment \| house \| studio \| villa \| penthouse \| loft \| townhouse \| other esempio: apartment

Risposta

{
  "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_…

GET/v1/api/markets/{city}/districtsmarkets:read

Elencare i quartieri

Suddivisioni di un mercato, per costruire i tuoi filtri.

Parametri di percorso

Parametri di percorso
Nome	Tipo	Descrizione
`city`obbligatorio	string	Identificatore del mercato. esempio: 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_…

GET/v1/api/markets/{city}/districts/{district}Growth and abovemarkets:read

Recuperare un quartiere

Offerta, distribuzione dei prezzi e contesto dei servizi a livello di quartiere.

Parametri di percorso

Parametri di percorso
Nome	Tipo	Descrizione
`city`obbligatorio	string	Identificatore del mercato. esempio: berlin-de
`district`obbligatorio	string	Identificatore del quartiere. esempio: kreuzberg

Parametri di query

Parametri di query
Nome	Tipo	Descrizione
`period`	string	Mese da riportare, nel formato YYYY-MM. Per impostazione predefinita, il più recente calcolato. esempio: 2026-07
`property_type`	enum	Restringere i dati a un genere di immobile. apartment \| house \| studio \| villa \| penthouse \| loft \| townhouse \| other esempio: 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_…

GET/v1/api/markets/{city}/statisticsmarkets:read

Statistiche di mercato

Serie di offerta e prezzo nel tempo, per tipo di immobile.

Calcolate dal catalogo che deteniamo, il che significa che descrivono i prezzi richiesti e non quelli delle compravendite. Non sono perizie e non vanno usate per decisioni di credito.

Parametri di percorso

Parametri di percorso
Nome	Tipo	Descrizione
`city`obbligatorio	string	Identificatore del mercato. esempio: berlin-de

Parametri di query

Parametri di query
Nome	Tipo	Descrizione
`property_type`	enum	Restringere a un solo tipo di immobile. apartment \| house \| studio \| villa \| penthouse \| loft \| townhouse \| other esempio: apartment
`transaction_type`	enum	sale oppure rent. sale \| rent esempio: sale
`interval`	enum	Granularità della serie restituita. week \| month \| quarter esempio: month
`since`	string	Limite inferiore della serie, in formato RFC 3339. esempio: 2026-08-01T00:00:00Z

Risposta

{
  "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_…