Démarrer
Démarrage rapide
Votre première recherche d’annonces en trois minutes : une clé, un appel, une page de résultats.
1. Obtenez une clé
Connectez-vous à votre espace développeur avec votre compte Regroupe Immo, puis créez une clé. Copiez-la tout de suite : elle ne s’affiche qu’une fois. Pendant la bêta, l’accès est ouvert sur demande.
Gardez la clé sur votre serveur (variable d’environnement, gestionnaire de secrets), jamais dans du code envoyé à un navigateur ni dans une adresse.
2. Faites un premier appel
Chaque requête porte la clé dans l’en-tête Authorization. Cherchez les annonces d’une commune par son code INSEE (ici Marseille, dont le code réunit les seize arrondissements) :
La réponse liste 20 annonces, les plus récemment mises en vente d’abord. Chaque annonce est un bien dédoublonné : s’il est diffusé sur plusieurs plateformes, il n’apparaît qu’une fois, avec toutes ses plateformes dans sources. La première page donne aussi le total.
3. Lisez la page suivante
Renvoyez next_cursor tel quel dans le paramètre cursor, avec les mêmes filtres et le même tri. Quand next_cursor vaut null, vous avez tout lu. Voir Pagination.
Et ensuite
- Rechercher des annonces : secteurs, filtres et tris.
- Lire l’audit de prix : prix de marché, libellés TBA…TMA et ventes comparables.
- Synchroniser un secteur : garder une copie à jour avec le flux des changements.