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