Marchés
Où nous avons de la couverture, comment chaque marché se subdivise, et les statistiques agrégées calculées dessus.
/v1/api/marketsmarkets:readLister les marchés
Tous les marchés couverts, et jusqu'où va cette couverture.
Appelez ceci avant de figer un identifiant de marché dans votre code. La couverture s'étend, et un marché absent ici n'a pas encore d'inventaire systématique plutôt qu'aucun bien.
Réponse
{
"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:readRécupérer un marché
Un marché avec son offre et sa distribution de prix.
Paramètres de chemin
| Nom | Type | Description |
|---|---|---|
cityobligatoire | string | Identifiant du marché, par exemple berlin-de. exemple : berlin-de |
Paramètres de requête
| Nom | Type | Description |
|---|---|---|
period | string | Mois à rapporter, au format YYYY-MM. Par défaut, le plus récent calculé. exemple : 2026-07 |
property_type | enum | Restreindre les chiffres à un type de bien. apartment | house | studio | villa | penthouse | loft | townhouse | other exemple : apartment |
Réponse
{
"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:readLister les quartiers
Subdivisions d'un marché, pour construire vos propres filtres.
Paramètres de chemin
| Nom | Type | Description |
|---|---|---|
cityobligatoire | string | Identifiant du marché. exemple : 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:readRécupérer un quartier
Offre, distribution des prix et contexte des commodités à l'échelle du quartier.
Paramètres de chemin
| Nom | Type | Description |
|---|---|---|
cityobligatoire | string | Identifiant du marché. exemple : berlin-de |
districtobligatoire | string | Identifiant du quartier. exemple : kreuzberg |
Paramètres de requête
| Nom | Type | Description |
|---|---|---|
period | string | Mois à rapporter, au format YYYY-MM. Par défaut, le plus récent calculé. exemple : 2026-07 |
property_type | enum | Restreindre les chiffres à un type de bien. apartment | house | studio | villa | penthouse | loft | townhouse | other exemple : 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:readStatistiques de marché
Séries d'offre et de prix dans le temps, par type de bien.
Calculées sur le catalogue que nous détenons, ce qui signifie qu'elles décrivent les prix affichés plutôt que les prix de transaction. Ce ne sont pas des expertises et elles ne doivent pas servir à des décisions de crédit.
Paramètres de chemin
| Nom | Type | Description |
|---|---|---|
cityobligatoire | string | Identifiant du marché. exemple : berlin-de |
Paramètres de requête
| Nom | Type | Description |
|---|---|---|
property_type | enum | Restreindre à un seul type de bien. apartment | house | studio | villa | penthouse | loft | townhouse | other exemple : apartment |
transaction_type | enum | sale ou rent. sale | rent exemple : sale |
interval | enum | Granularité de la série renvoyée. week | month | quarter exemple : month |
since | string | Borne inférieure de la série, au format RFC 3339. exemple : 2026-08-01T00:00:00Z |
Réponse
{
"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_…