Location courte durée
Le marché de la location courte durée d'une commune et le revenu d'un logement. 2 opérations servies.
Marché de la courte durée d'une commune
Essayer en direct/api/v1/communes/{insee}/courte-dureeMarché de la location courte durée d'une commune : profil AirDNA (annonces actives, revenu, occupation, prix de nuit, revenu par nuit disponible, évolutions sur un an, score de marché et sous-scores), à la maille de la commune, de la ville pour un arrondissement, du département ajusté à la part de résidences secondaires ou de la France, avec sa confiance ; rentabilité de la courte durée, scores Pillr de courte durée, de longue durée et de tourisme, part de résidences secondaires, et statut réglementaire de la courte durée. Mêmes profils que le simulateur de pillr.fr. Données aspirées des pages publiques d'AirDNA.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- territoire
- Outil MCP
- courte_duree_commune
- Bac à sable
- Oui, sans débit, sur un jeu figé
- Cache serveur
- 24 h
- Délai maximal
- 5 s
Paramètres
inseetexteobligatoireCode INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).
Exemple d'appel
curl https://pillr.fr/api/v1/communes/76540/courte-duree \
-H "Authorization: Bearer $PILLR_CLE"Cette entrée est dans le bac à sable : une clé pk_test_ obtient la réponse, sans débit.
Réponse du bac à sable
{
"insee": "76540",
"commune": "Rouen",
"profil": {
"maille": "commune",
"marche": "Rouen",
"annonces_actives": 1716,
"revenu_annuel": 12892,
"occupation_pct": 62,
"prix_nuit": 61,
"revpar": 38,
"evolution_annonces_1an_pct": -41.4,
"evolution_revenu_1an_pct": 130.3,
"score_marche": 95,
"scores_airdna": {
"demande": 81,
"saisonnalite": 94,
"croissance": 59,
"reglementation": 63
},
"confiance": "mesure",
"millesime": "août 2026",
"qualite": {
"n": 1716,
"provenance": "mesure",
"incertitude": null,
"drapeaux": [],
"methode": "marché AirDNA de la commune",
"donnees_du": null,
"source": "AirDNA, pages publiques de marché aspirées et converties en euros (conditions d'utilisation d'AirDNA)"
}
},
"rentabilite_lcd_pct": {
"valeur": 24,
"qualite": {
"n": null,
"provenance": "estime",
"incertitude": null,
"drapeaux": [
"donnee_ancienne"
],
"methode": "colonne héritée du jeu de courte durée de 2025, non rafraîchie",
"donnees_du": "2026-10-19",
"source": "Pillr, market_data (scores 2026 de market_enrichments ; colonnes de courte durée héritées du jeu de 2025)"
}
},
"scores": {
"lcd": 76,
"lld": 57,
"tourisme": 75,
"qualite": {
"n": null,
"provenance": "estime",
"incertitude": null,
"drapeaux": [],
"methode": "scores Pillr de la commune, sur 100",
"donnees_du": "2026-10-19",
"source": "Pillr, market_data (scores 2026 de market_enrichments ; colonnes de courte durée héritées du jeu de 2025)"
}
},
"part_residences_secondaires_pct": {
"valeur": 3.2,
"qualite": {
"n": null,
"provenance": "mesure",
"incertitude": null,
"drapeaux": [],
"methode": "part des résidences secondaires dans les logements",
"donnees_du": "2026-10-19",
"source": "INSEE, recensement de la population, par market_data"
}
},
"reglementation": {
"niveau": "libre",
"recommandable": true,
"titre": "Déclaration en mairie",
"texte": "Déclaration préalable en mairie et numéro d'enregistrement (généralisé en 2026), règlement de copropriété à vérifier. Le plafond de 120 nuits ne vise que la résidence principale."
},
"limites": [
"Profils aspirés des pages publiques d'AirDNA, sans contrat : les conditions d'utilisation d'AirDNA s'appliquent.",
"Moyennes de l'annonce type du marché, toutes typologies confondues ; le revenu d'un logement précis se calcule avec estimer_courte_duree.",
"Le statut réglementaire est à confirmer en mairie : changement d'usage, quota, numéro d'enregistrement."
],
"source": "AirDNA, pages publiques de marché aspirées et converties en euros (conditions d'utilisation d'AirDNA)",
"credits": {
"debites": 0,
"restants": null
}
}Réponse réelle de l'API à cette entrée, obtenue avec le moteur du bac à sable, donnée du 19/10/2026.
Réponse
inseetextecommunetexte ou nullprofilobjet ou nullnull : aucun profil, même départemental ou national.
Afficher les 14 champsMasquer
mailletextecommune : marché AirDNA de la commune ; ville : marché de la ville d'un arrondissement ; departement : profil du département ajusté à la part de résidences secondaires ; france : profil national ; anciennes_donnees : colonnes du jeu de 2025.
Valeurs :
commune,ville,departement,france,anciennes_donneesmarchetexte ou nullNom du marché ou du profil source.
annonces_activesnombre ou nullAnnonces actives sur le marché, douze derniers mois.
revenu_annuelnombre ou nullRevenu annuel de l'annonce type du marché, en euros, avant charges.
occupation_pctnombrePart des nuits ouvertes réservées, en %.
prix_nuitnombrePrix de nuit moyen payé, en euros.
revparnombreRevenu par nuit disponible : prix de nuit multiplié par l'occupation, en euros.
evolution_annonces_1an_pctnombre ou nullevolution_revenu_1an_pctnombre ou nullscore_marchenombre ou nullScore de marché AirDNA, 40 à 100.
scores_airdnaobjetAfficher les 4 champsMasquer
demandenombre ou nullsaisonnalitenombre ou nullcroissancenombre ou nullreglementationnombre ou null
confiancetextemesure : marché AirDNA d'au moins 20 annonces ; estime : petit marché lissé avec son département, ou profil départemental ; faible : profil national ou anciennes données.
Valeurs :
mesure,estime,faiblemillesimetexte ou nullMillésime de l'aspiration des pages marché AirDNA.
qualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
rentabilite_lcd_pctobjetRentabilité brute de la courte durée publiée par market_data (colonne héritée du jeu de 2025).
Afficher les 2 champsMasquer
valeurnombre ou nullqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
scoresobjetScores Pillr de la commune sur 100 : courte durée, longue durée, tourisme.
Afficher les 4 champsMasquer
lcdnombre ou nulllldnombre ou nulltourismenombre ou nullqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
part_residences_secondaires_pctobjetAfficher les 2 champsMasquer
valeurnombre ou nullqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
reglementationobjetStatut de la courte durée pour un investisseur (hors résidence principale) dans la commune, sans DPE donné.
Afficher les 4 champsMasquer
niveautextelibre : déclaration en mairie ; declaration : zone tendue, déclaration et numéro d'enregistrement ; autorisation : changement d'usage à obtenir ; compensation : changement d'usage avec compensation ; dpe : DPE qui ferme le meublé de tourisme.
Valeurs :
libre,declaration,autorisation,compensation,dperecommandablebooléenFaux quand la courte durée ne peut pas être conseillée en l'état (compensation, DPE).
titretextetextetexte
limitesliste de textessourcetextecreditsobjetCrédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs
Revenu de courte durée d'un logement
Essayer en direct/api/v1/courte-duree/estimationsRevenu de location courte durée d'un logement décrit par sa commune, sa surface et ses chambres, avec le modèle du simulateur de pillr.fr : capacité d'accueil, prix de nuit et occupation ajustés à la capacité depuis le profil de marché AirDNA de la commune, nuits ouvertes et réservées, montée en charge de la première année ; coûts d'exploitation (plateforme, conciergerie, renouvellement, ménage, linge, énergie, internet, assurance, classement), revenu net, statut réglementaire de la commune et du DPE, hypothèses et avertissements. Sans profil de marché, le revenu est un multiple du loyer nu, et le dit.
- Coût
- 2 crédits par appel réussi
- Accès
- À l'usage ou avec l'abonnement Data
- Portée
- estimation
- Outil MCP
- estimer_courte_duree
- Bac à sable
- Oui, sans débit, sur un jeu figé
- Cache serveur
- 24 h
- Délai maximal
- 5 s
Paramètres
inseetexteobligatoireCode INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).
surfacenombreobligatoireSurface habitable, en m².
1 000 au plus ; plus de 0
chambresentierChambres ; sans elles, la capacité est déduite de la surface.
de 0 à 20
nuits_ouvertesentierNuits ouvertes à la location dans l'année.
de 1 à 365
occupation_pctnombreOccupation imposée, en % des nuits ouvertes ; sinon celle du marché, ajustée à la capacité.
de 0 à 100
gestiontexteGestion par l'investisseur seul, ou par une conciergerie (par défaut).
Valeurs :
seul,conciergerieclassebooléenMeublé de tourisme classé (oui par défaut).
dpetexteÉtiquette DPE : une nouvelle autorisation l'exige suffisante.
Valeurs :
A,B,C,D,E,F,Gloyer_nunombreLoyer mensuel en location nue, pour le repli et la comparaison ; sinon le loyer de marché de la commune.
100 000 au plus ; plus de 0
Exemple d'appel
curl -X POST https://pillr.fr/api/v1/courte-duree/estimations \
-H "Authorization: Bearer $PILLR_CLE" \
-H "Content-Type: application/json" \
-d '{"insee":"76540","surface":50}'Cette entrée est dans le bac à sable : une clé pk_test_ obtient la réponse, sans débit.
Réponse du bac à sable
{
"insee": "76540",
"commune": "Rouen",
"revenu": {
"capacite": 3,
"prix_nuit": 51,
"occupation_pct": 64.2,
"nuits_ouvertes": 350,
"nuits_reservees": 225,
"rotations": 56,
"revenu_brut": 11549,
"revenu_annee1": 9817,
"ratio_loyer_nu": 1.45,
"confiance": "mesure",
"source": "airdna_market",
"notes": [
"Prix de nuit 61 € et occupation 62 % de l'annonce type : marché AirDNA « Rouen » (1716 annonces actives, août 2026).",
"Capacité retenue 3 couchages contre 4 pour l'annonce type : prix de nuit ajusté à 51 €, occupation à 64 %.",
"Première année à 85 % du régime de croisière (montée en charge, absence d'avis)."
],
"avertissements": [
"Le nombre d'annonces actives a reculé de 41 % en un an : signal réglementaire ou de saturation."
],
"qualite": {
"n": 1716,
"provenance": "estime",
"incertitude": null,
"drapeaux": [],
"methode": "annonce type du marché ramenée à la capacité du logement, 350 nuits ouvertes (350 par défaut)",
"donnees_du": null,
"source": "AirDNA, pages publiques de marché aspirées et converties en euros (conditions d'utilisation d'AirDNA)"
}
},
"couts": {
"plateforme_pct": 15.5,
"conciergerie_pct": 20,
"renouvellement_pct": 3,
"plateforme": 1790,
"conciergerie": 2310,
"renouvellement": 346,
"menage": 4480,
"linge": 672,
"energie": 900,
"internet": 360,
"assurance": 250,
"classement": 40,
"total": 11148
},
"revenu_net": 401,
"loyer_nu_mensuel": 664,
"statut_reglementaire": {
"niveau": "libre",
"recommandable": true,
"titre": "Déclaration en mairie",
"texte": "Déclaration préalable en mairie et numéro d'enregistrement (généralisé en 2026), règlement de copropriété à vérifier. Le plafond de 120 nuits ne vise que la résidence principale."
},
"hypotheses": [
"Loyer nu de comparaison : loyer de marché au m² de la commune multiplié par la surface.",
"Gestion par une conciergerie (défaut du simulateur).",
"Meublé de tourisme classé (défaut du simulateur)."
],
"credits": {
"debites": 0,
"restants": null
}
}Réponse réelle de l'API à cette entrée, obtenue avec le moteur du bac à sable, donnée du 19/10/2026.
Réponse
inseetextecommunetexte ou nullrevenuobjetAfficher les 14 champsMasquer
capaciteentierCouchages retenus : deux par chambre plus un, ou déduits de la surface.
prix_nuitnombreoccupation_pctnombrenuits_ouvertesentiernuits_reserveesentierrotationsentierrevenu_brutnombreRevenu annuel en régime de croisière, en euros.
revenu_annee1nombreRevenu de la première année (montée en charge).
ratio_loyer_nunombre ou nullRevenu brut sur loyer nu annuel.
confiancetextemesure : marché AirDNA d'au moins 20 annonces ; estime : petit marché lissé avec son département, ou profil départemental ; faible : profil national ou anciennes données.
Valeurs :
mesure,estime,faiblesourcetexteValeurs :
airdna_market,airdna_departement,airdna_national,legacy_dump,loyer_nunotesliste de textesavertissementsliste de textesqualiteobjetCe qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
Afficher les 7 champsMasquer
nentier ou nullNombre d'observations derrière la valeur ; null si sans objet.
0 au moins
provenancetexte ou nullmesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
Valeurs :
mesure,estimeincertitudeobjet ou nullIncertitude de la valeur : fourchette et demi-largeur.
Afficher les 3 champsMasquer
demi_largeur_pctnombre ou nullDemi-largeur de la fourchette, en % de la valeur.
basnombre ou nullhautnombre ou null
drapeauxliste de textesCe qui doit faire lire la valeur avec prudence ; vide si rien.
Valeurs :
prix_atypique,surface_atypique,vente_en_bloc,doublon_probable,date_estimee,peu_d_observations,valeur_imputee,rattachement_incertain,donnee_anciennemethodetexte ou nullMéthode de calcul ou de rattachement, en clair.
donnees_dutexte ou nullDate de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
sourcetexteSource publique ou moteur Pillr, en clair.
coutsobjetAfficher les 13 champsMasquer
plateforme_pctnombreconciergerie_pctnombrerenouvellement_pctnombreplateformenombreconciergerienombrerenouvellementnombremenagenombrelingenombreenergienombreinternetnombreassurancenombreclassementnombretotalnombreCoûts d'exploitation annuels, en euros, sur le revenu brut.
revenu_netnombreRevenu brut moins coûts d'exploitation, avant charges de copropriété, taxe foncière, crédit et impôt.
loyer_nu_mensuelnombre ou nullLoyer nu de comparaison : celui donné, ou loyer de marché au m² de la commune multiplié par la surface.
statut_reglementaireobjetAfficher les 4 champsMasquer
niveautextelibre : déclaration en mairie ; declaration : zone tendue, déclaration et numéro d'enregistrement ; autorisation : changement d'usage à obtenir ; compensation : changement d'usage avec compensation ; dpe : DPE qui ferme le meublé de tourisme.
Valeurs :
libre,declaration,autorisation,compensation,dperecommandablebooléenFaux quand la courte durée ne peut pas être conseillée en l'état (compensation, DPE).
titretextetextetexte
hypothesesliste de textescreditsobjetCrédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
Afficher les 2 champsMasquer
debitesentier0 au moins
restantsentier ou null
Erreurs possibles
- 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
- 415type_contenuLe corps n'est pas envoyé en application/json
- 400corps_illisibleLe corps n'est pas un JSON lisible
- 413corps_trop_lourdLe corps dépasse la taille permise
- 403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
Afficher les 11 erreurs communes à toute l'APIMasquer les erreurs communes
- 401cle_absenteL'en-tête Authorization manque
- 401cle_invalideLa clé est inconnue, révoquée ou expirée
- 403organisation_suspendueL'organisation de la clé n'est pas active
- 403portee_insuffisanteLa clé ou l'accès de l'organisation n'ouvre pas cette opération
- 402credits_insuffisantsLes crédits ne suffisent plus pour cet appel
- 429plafond_cleLe plafond mensuel de crédits de la clé est atteint
- 429quota_minuteLe débit par minute de l'organisation est atteint
- 503charge_globaleL'API est momentanément surchargée, tous clients confondus ; rien n'est débité
- 504delai_depasseLe calcul dépasse le délai de l'opération ; rien n'est débité
- 503service_indisponibleL'API est momentanément indisponible
- 500erreur_interneUne erreur de notre côté ; rien n'est servi ni débité
Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs