Changelog

Une recherche de biens peut renvoyer uniquement le nombre de résultats, sans aucun bien.

Added

• size: 0 sur POST /properties — la réponse ne contient aucun bien, seulement le nombre de biens correspondants dans meta.totalItems (format JSON:API) ; auparavant, size commençait à 1. Voir Pagination et la référence.

En JSON:API, chaque bien donne désormais le mandat, la référence et le contact de ses annonceurs, comme le JSON à plat.

Changed

• included peut contenir un quatrième type, PropertyPublisher : un client qui n'accepte que Listing, Publisher et Source doit l'accepter ou l'ignorer. Voir Types de ressources.

Added

• PropertyPublisher, référencée par relationships.propertyPublishers : mandate, reference et contact d'un annonceur sur ce bien. Voir Format de réponse.

Fixed

• Un Publisher sans aucun champ renseigné renvoie "attributes": {} au lieu de [], comme le prévoit le format.

La résolution d'adresse s'améliore : les correspondances sont plus fiables, et nous continuerons de les affiner pendant la bêta.

Added

• algorithmVersion — la version de la logique qui a produit la réponse. Une réponse peut changer d'une version à l'autre. Chaque nouvelle version est annoncée ici. Voir la référence.

Obtenez l'adresse postale d'un bien donné.

Added

• POST /properties/{id}/resolve-address — l'adresse du bien et son niveau de confiance, de EXACT à NONE. En bêta. Voir la référence.

Une règle qui contient encore l'ancien champ enabled n'est plus refusée. Vous avez jusqu'au 2026-10-20 pour le retirer.

Deprecated

• enabled sur une règle est toléré jusqu'au 2026-10-20 : false retire la règle, true est ignoré. Ensuite, le champ sera refusé en 400. Pour ne plus recevoir un événement, retirez sa règle. Voir Alert.

Une règle choisit sa granularité avec scope. Une règle PRICE_CHANGE accepte plusieurs intervalles de variation de prix. Les changements de prix et d'attributs déclenchent désormais des notifications.

Breaking

• ADDITIONAL_LISTING n'existe plus, ni dans les règles ni dans les webhooks. Une règle qui l'envoie reçoit un 400. Pour être prévenu de chaque nouveau listing sur une property déjà suivie, utilisez NEW_MATCH avec scope: LISTING. Voir Alert et Webhooks.
• variationPercent est maintenant une liste d'intervalles : [{ "gte": …, "lte": … }]. Un objet seul reçoit un 400. Voir l'intervalle de variation.
• Une seule règle par eventType. Un doublon reçoit un 422. Voir Alert.

Changed

• PRICE_CHANGE et OTHER_CHANGE déclenchent désormais des notifications. scope et variationPercent sont pris en compte. Voir Alert.

Retrouver une property à partir de l'URL d'une annonce ne dépend plus du slash final.

Fixed

• listings.url sur POST /properties — l'URL est reconnue avec ou sans slash final ; auparavant, la forme différente de celle publiée par le site ne renvoyait aucun résultat. Aucun changement à faire côté client, le champ url des réponses est inchangé. Voir la référence.

Les règles de notificationConfig adoptent un nouveau vocabulaire ; les anciens noms sont rejetés, sans période de cohabitation.

Breaking

• eventType : PRICE_CHANGED → PRICE_CHANGE, ANY_ATTRIBUTE_CHANGED → OTHER_CHANGE, LISTING_EXPIRED → EXPIRED, LISTING_REACTIVATED → REACTIVATED, dans les règles comme dans les webhooks reçus. Voir Alert et Webhooks.
• thresholdPercentage, thresholdMinPercentage, thresholdMaxPercentage, thresholdDirection et enabled disparaissent des règles : utilisez la liste d'intervalles signés variationPercent ([{ "lte": -5 }] pour une baisse d'au moins 5 %). Voir l'intervalle de variation.

Added

• scope sur chaque règle — PROPERTY (défaut) ou LISTING, la granularité de la notification. Voir Alert.

Le bloc unit.diagnostic d'une property gagne trois champs, dont la norme réglementaire du diagnostic, et cette norme devient filtrable.

Added

• unit.diagnostic.standard — FR_DPE_2006 ou FR_DPE_2021, absent quand la source ne l'indique pas ; liste préfixée par pays, appelée à s'étendre. Voir la référence.
• unit.diagnostic.methodVersion et unit.diagnostic.reference — révision du modèle de données et numéro du certificat au registre émetteur. Voir la référence.
• Filtre property.unit.diagnostic.standard sur POST /properties, avec in / nin / inOrMissing, utilisable dans le criteria d'une alerte. Voir Filtrage — norme du diagnostic énergétique.

Les filtres texte deviennent des phrases : ajouter un mot restreint le résultat au lieu de l'élargir, et une phrase peut désormais être exclue.

Breaking

• property.body.title et property.body.description n'acceptent plus une chaîne : envoyez { "in": [...], "nin": [...] }, chaque entrée étant une phrase — une chaîne nue renvoie un 400. Pour un résultat identique à l'ancien "a b", envoyez { "in": ["a", "b"] } ; aucune période de cohabitation, l'API étant en beta privée. Voir Filtrage — Recherche texte.

Added

• property.body.<champ>.in — au moins une des phrases, mots côte à côte et dans l'ordre, casse et accents ignorés ; jusqu'à 25 par liste. Voir la référence.
• property.body.<champ>.nin — aucune des phrases. Voir Filtrage — Recherche texte.

PUT /alerts/{uuid} ne modifie désormais que les champs nommés dans le corps, comme toute autre mise à jour de l'API.

Changed

• Un champ omis du corps de PUT /alerts/{uuid} conserve sa valeur enregistrée ; il était auparavant remis à sa valeur par défaut de création. Voir Alertes — mettre à jour une alerte.
• Pour effacer un champ, envoyez-le à null. En particulier, une alerte s'élargit à toutes les properties avec "criteria": null, et non plus en omettant criteria.

Les outils du serveur MCP déclarent désormais leur comportement selon la spécification MCP : un titre lisible et les indications readOnlyHint, destructiveHint, idempotentHint et openWorldHint, comme l'exige l'annuaire des connecteurs Claude.

Changed

• Les outils de lecture (search_properties, resolve_location, list_alerts) s'exécutent sans demande de confirmation dans un assistant qui respecte ces indications, Claude compris ; création, modification et suppression d'alerte continuent de demander confirmation. Voir Ce que l'assistant peut faire.

Added

• Chaque outil expose title et annotations dans la réponse tools/list. Voir le guide MCP.

Chaque annonce reçoit désormais un verdict de cohérence de prix, calculé en comparant son prix au m² à la médiane du marché local. Le verdict est conservateur : en cas de doute, le bien reste visible.

Changed

• Les properties dont toutes les annonces ont un prix incohérent sont masquées des résultats de POST /properties et des alertes par défaut — listings.priceCoherent vaut implicitement true, les biens au verdict indéterminé restent visibles. Voir Filtrage — masques par défaut.
• Les champs de prix filtrables d'une property (property.pricing.displayed, property.pricing.pricePerArea, variations de prix) sont calculés sans ses annonces au prix incohérent.

Added

• listings.priceCoherent — true reproduit le comportement par défaut, false renvoie uniquement les properties dont toutes les annonces sont incohérentes. Jugé au niveau de la property, contrairement aux autres filtres listings. Voir la référence.

Une destination webhook coupée par le circuit breaker n'a plus besoin d'une réactivation manuelle pour reprendre les livraisons.

Changed

• Une destination SUSPENDED est sondée automatiquement (toutes les 5 minutes, puis à intervalle croissant jusqu'à 6 h) et repasse en ACTIVE dès que votre endpoint répond, avec rejeu progressif des notifications suspendues ; la console reste disponible pour forcer la reprise. Voir Notifications — circuit breaker.
• Au plus 5 000 notifications sont conservées par destination suspendue ; au-delà, les événements restent visibles mais ne sont plus rejoués. Voir Notifications — circuit breaker.

Added

• Serveur MCP à https://api-v2.stream.estate/mcp (transport HTTP, authentification X-API-KEY). Permet à un assistant IA d'interroger l'API en langage naturel — voir le guide MCP.
• Ventilation byChannel dans GET /account/api-usage pour distinguer les appels DIRECT des appels passés via MCP.

Added

• Webhook signing via header X-Webhook-Signature: sha256=... et X-Webhook-Timestamp pour la protection replay. Détails complets dans le guide webhooks.
• Renouvellement de la clé depuis la console (console.stream.estate/webhooks) sans interrompre les livraisons en vol — voir le guide webhooks.
• Header User-Agent: StreamEstate-Webhook/1.0 sur toutes les requêtes sortantes.

Changed

• Les destinations webhook créées avant cette release obtiennent leur clé en la renouvelant une première fois depuis la console.