← Retour aux tutoriels

AnchorLancer la démo Invest Immo en local

Ce tutoriel vous guide sur le projet open source immoteur/demo-invest-immo. Vous allez lancer l’app Next.js en local, la connecter à l’API Immoteur via un token personnel, puis parcourir des annonces d’appartements DPE F/G en quelques minutes.

Si vous voulez voir le résultat avant de lancer quoi que ce soit, ouvrez la démo live : https://demo-invest-immo.immoteur.com.

Astuce : le token n’est affiché qu’une seule fois après la création. Pensez à le stocker dans un gestionnaire de mots de passe.

AnchorCe que vous allez construire

  • Une démo Next.js locale qui garde le token Immoteur côté serveur.
  • Une interface simple avec sélection unique par département et cartes résultats.
  • Un flux configurable via .env.

AnchorPrérequis

  • Un compte Immoteur avec accès API.
  • Node.js 20+ et pnpm.
  • Git (et Docker si vous préférez lancer le conteneur).

AnchorLiens utiles

AnchorSchéma d’architecture

Rendering diagram...

AnchorGuide pas à pas

Anchor1) Créer un token API Immoteur

  1. Connectez-vous sur https://immoteur.com
  2. Ouvrez la page tokens : https://immoteur.com/dashboard/tokens
  3. Cliquez sur Créer un token, nommez-le (par exemple invest-immo-demo), puis copiez-le
Écran de création de token (placeholder)

Anchor2) Cloner le projet de démo

git clone https://github.com/immoteur/demo-invest-immo.git
cd demo-invest-immo
pnpm install
cp .env.example .env

Anchor3) Configurer .env

Ouvrez .env et ajoutez votre token API :

IMMOTEUR_API_KEY=immoteur_xxx
 
# Valeurs optionnelles
IMMOTEUR_TRANSACTION_TYPE=sale
IMMOTEUR_PROPERTY_TYPES=apartment
IMMOTEUR_DPE_LABELS=F,G
IMMOTEUR_MAX_RESULTS=15

Anchor4) Démarrer l’app

Anchor5) Explorer et ajuster le flux

Essayez le filtre par département, puis ajustez le flux via .env :

  • IMMOTEUR_DPE_LABELS pour élargir ou restreindre les étiquettes énergie
  • IMMOTEUR_PROPERTY_TYPES pour passer à d’autres types de biens
  • IMMOTEUR_MAX_RESULTS pour limiter le nombre de cartes

Redémarrez le serveur après toute modification de .env.

AnchorConclusion

La démo Invest Immo tourne maintenant en local avec votre token API Immoteur. Vous pouvez ensuite ajuster les filtres ou déployer l’app dans un environnement privé pour la partager.

Lancer la démo Invest Immo en local | Immoteur