Guide d’intégration de la Housing Market API
Les tableaux de référence, les descriptions des points de terminaison, les codes d’erreur et les exemples sont générés à partir de la spécification de l’API et restent en anglais dans toutes les langues. Les noms, paramètres et codes sont identiques partout.
Présentation et formules
La Housing Market API donne à votre logiciel un accès en lecture seule aux annonces immobilières publiées sur les portails de Housing Market Group. Des statistiques de marché agrégées seront bientôt disponibles avec la formule Avancée.
Chaque requête est envoyée à https://api.housingmarketapi.com en HTTPS, et chaque réponse est au format JSON. Tous les points de terminaison sont en lecture seule : ce sont tous des requêtes GET.
Il existe deux formules. Toutes deux utilisent la même clé et les mêmes points de terminaison pour les annonces.
- Standard : les annonces publiées, avec tous les détails des biens décrits dans ce guide, pour les pays auxquels vous êtes abonné.
- Avancée : tout le contenu de Standard, plus les points de terminaison Insights (volume de recherches, volume de prospects, prix, nombre de biens, niveaux d’activité et données de marché de tiers), bientôt disponibles. Les clients de la formule Avancée obtiennent Insights sur la même clé dès son lancement.
Les données Insights sont des agrégats. Chaque valeur est un nombre ou une médiane pour un lieu et une période ; aucune ne décrit une personne, un prospect, un agent ou une annonce en particulier.
Vous choisissez les pays lors de votre abonnement : des pays individuels, une région ou le monde entier. Vous pouvez ajouter des pays ou passer à une formule supérieure par la suite, et la même clé les couvre alors.
Vous pouvez payer mensuellement ou annuellement. La console affiche exactement le montant qui vous sera facturé avant que vous ne confirmiez ; c’est pourquoi aucun prix n’est indiqué dans ce guide.
Les pays sont toujours indiqués sous forme de codes pays ISO, par exemple TH pour la Thaïlande. La console liste les pays couverts par votre clé.