Nos données dans vos outils

Une API en lecture seule, avec les chiffres du site : villes et quartiers, historique, estimation à une adresse, départements et communes, zones à l'étranger. Pour une conciergerie qui alimente ses tableaux de bord, un investisseur qui compare des marchés ou un outil métier.

Ce que renvoie l'API

Villes
  • Villes couvertesGET /marketsListe des villes analysées annonce par annonce, avec la date des données.
  • Ville d'une positionGET /markets/locateLa ville couverte la plus proche d'un point (latitude, longitude).
  • Chiffres d'une villeGET /markets/{slug}Prix par nuit, occupation et revenu annuel : médianes et quartiles, par type de logement et par nombre de chambres.
  • Quartiers d'une villeGET /markets/{slug}/neighbourhoodsLes mêmes chiffres pour chaque quartier, filtrables par type de logement et nombre de chambres.
  • Historique d'une villeGET /markets/{slug}/historyÉvolution des médianes, relevé après relevé.
Estimation
  • Estimer un logementGET /estimateRevenu, prix par nuit et occupation estimés à une adresse, d'après les annonces comparables autour.
France
  • DépartementsGET /france/departementsNuitées réservées sur les plateformes de location et prix au m² de chaque département.
  • Fiche d'un départementGET /france/departements/{code}Séries annuelles et mensuelles, prix, hébergements touristiques.
  • Rechercher une communeGET /france/communesPar nom ou par code postal / INSEE.
  • Fiche d'une communeGET /france/communes/{code}Prix au m², hébergements, taxe de séjour, points d'intérêt, revenus observés.
International
  • Zones d'un paysGET /intl/areasZones administratives d'un pays hors de France (Bali aujourd'hui).
  • Indicateurs d'une zoneGET /intl/areas/{area_id}Statistiques officielles, points d'intérêt et lieux visités d'une zone.

Un appel, une clé

Vous créez vos clés dans votre compte ; chacune n'est montrée qu'une fois. Elle part dans un en-tête, jamais dans l'adresse :

curl -H "Authorization: Bearer $NUITSTAT_API_KEY" \
  "https://nuitstat.fr/api/v1/markets/paris/neighbourhoods?room_type=Entire%20home%2Fapt"

Réponses en JSON, montants en euros, avec pour chaque indicateur son score de fiabilité et la mention des sources à reprendre si vous publiez une analyse. Documentation complète, consultable avant de souscrire.

Questions sur l'API

Les chiffres sont-ils les mêmes que sur le site ?
Oui : l'API appelle les mêmes calculs que les pages. Un chiffre sous 80 % de fiabilité est renvoyé vide, avec son score, exactement comme il est masqué sur le site.
Puis-je appeler l'API depuis une page web ou une application mobile ?
Non : la clé doit rester secrète, côté serveur (script, tableur connecté à un serveur, outil interne). Les navigateurs d'autres sites sont bloqués, et une clé publiée se révoque en un clic depuis votre compte.
Que se passe-t-il si mon abonnement s'arrête ?
Vos clés sont refusées avec un message clair, mais elles restent dans votre compte : elles refonctionnent dès que l'abonnement reprend. Vous recevez un rappel par e-mail au moins un mois avant chaque reconduction annuelle.
Puis-je revendre ou republier les données ?
Pas les données brutes : l'offre est faite pour un usage interne. Vous pouvez publier vos propres analyses, graphiques ou chiffres isolés en citant Nuitstat et les sources. Le détail est dans les conditions générales de vente.

Conditions : CGV, section « Offre API ». Une question avant de souscrire ? Écrivez-nous.