Analytics

GET /analytics/listings interroge l'entrepôt de marché immuable : filtres classiques (type, transaction, ville, prix, surface, pièces, DPE, publisher, bounding box lat/lng), agrégation par group_by (jusqu'à 10 champs catégoriels), bucket temporel time_bucket sur event_at, et métriques agrégées via metrics (jusqu'à 20).

Format des metrics

Chaque entrée du paramètre metrics suit la grammaire count | <function>:<field> | percentile:<field>:<p> (0 < p <= 100).

• Fonctions disponibles : count, avg, median, min, max, percentile.
• Champs autorisés pour avg|median|min|max|percentile : price, price_displayed, price_per_sqm, area, area_displayed, rooms, bedrooms, days_between_events.
• Exemples : count, avg:price, median:price_per_sqm, percentile:price:95.

curl "https://api-v2.stream.estate/analytics/listings?\
property_type=FLAT&transaction_type=SELL&\
city_id=75056&group_by=property_type&time_bucket=month&\
metrics=count,avg:price,median:price" \
  -H "X-API-KEY: <votre_clé>"

Pour la liste exhaustive des paramètres (filtres, group_by autorisés, fonctions d'agrégation), voir /api-reference/analytics/listings.