Aller au contenu

Documentation

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
GET/api/v1/communes/{insee}/courte-duree

Marché 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

  • inseetexteobligatoire

    Code 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

  • inseetexte
  • communetexte ou null
  • profilobjet ou null

    null : aucun profil, même départemental ou national.

    Afficher les 14 champs
    • mailletexte

      commune : 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_donnees

    • marchetexte ou null

      Nom du marché ou du profil source.

    • annonces_activesnombre ou null

      Annonces actives sur le marché, douze derniers mois.

    • revenu_annuelnombre ou null

      Revenu annuel de l'annonce type du marché, en euros, avant charges.

    • occupation_pctnombre

      Part des nuits ouvertes réservées, en %.

    • prix_nuitnombre

      Prix de nuit moyen payé, en euros.

    • revparnombre

      Revenu par nuit disponible : prix de nuit multiplié par l'occupation, en euros.

    • evolution_annonces_1an_pctnombre ou null
    • evolution_revenu_1an_pctnombre ou null
    • score_marchenombre ou null

      Score de marché AirDNA, 40 à 100.

    • scores_airdnaobjet
      Afficher les 4 champs
      • demandenombre ou null
      • saisonnalitenombre ou null
      • croissancenombre ou null
      • reglementationnombre ou null
    • confiancetexte

      mesure : 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, faible

    • millesimetexte ou null

      Millésime de l'aspiration des pages marché AirDNA.

    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce 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_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • rentabilite_lcd_pctobjet

    Rentabilité brute de la courte durée publiée par market_data (colonne héritée du jeu de 2025).

    Afficher les 2 champs
    • valeurnombre ou null
    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce 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_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • scoresobjet

    Scores Pillr de la commune sur 100 : courte durée, longue durée, tourisme.

    Afficher les 4 champs
    • lcdnombre ou null
    • lldnombre ou null
    • tourismenombre ou null
    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce 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_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • part_residences_secondaires_pctobjet
    Afficher les 2 champs
    • valeurnombre ou null
    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce 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_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • reglementationobjet

    Statut de la courte durée pour un investisseur (hors résidence principale) dans la commune, sans DPE donné.

    Afficher les 4 champs
    • niveautexte

      libre : 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, dpe

    • recommandablebooléen

      Faux quand la courte durée ne peut pas être conseillée en l'état (compensation, DPE).

    • titretexte
    • textetexte
  • limitesliste de textes
  • sourcetexte
  • creditsobjet

    Cré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 champs
    • debitesentier

      0 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'API

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
POST/api/v1/courte-duree/estimations

Revenu 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

  • inseetexteobligatoire

    Code INSEE de la commune ou de l'arrondissement (5 caractères, 2A ou 2B pour la Corse).

  • surfacenombreobligatoire

    Surface habitable, en m².

    1 000 au plus ; plus de 0

  • chambresentier

    Chambres ; sans elles, la capacité est déduite de la surface.

    de 0 à 20

  • nuits_ouvertesentier

    Nuits ouvertes à la location dans l'année.

    de 1 à 365

  • occupation_pctnombre

    Occupation imposée, en % des nuits ouvertes ; sinon celle du marché, ajustée à la capacité.

    de 0 à 100

  • gestiontexte

    Gestion par l'investisseur seul, ou par une conciergerie (par défaut).

    Valeurs : seul, conciergerie

  • classebooléen

    Meublé de tourisme classé (oui par défaut).

  • dpetexte

    Étiquette DPE : une nouvelle autorisation l'exige suffisante.

    Valeurs : A, B, C, D, E, F, G

  • loyer_nunombre

    Loyer 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

  • inseetexte
  • communetexte ou null
  • revenuobjet
    Afficher les 14 champs
    • capaciteentier

      Couchages retenus : deux par chambre plus un, ou déduits de la surface.

    • prix_nuitnombre
    • occupation_pctnombre
    • nuits_ouvertesentier
    • nuits_reserveesentier
    • rotationsentier
    • revenu_brutnombre

      Revenu annuel en régime de croisière, en euros.

    • revenu_annee1nombre

      Revenu de la première année (montée en charge).

    • ratio_loyer_nunombre ou null

      Revenu brut sur loyer nu annuel.

    • confiancetexte

      mesure : 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, faible

    • sourcetexte

      Valeurs : airdna_market, airdna_departement, airdna_national, legacy_dump, loyer_nu

    • notesliste de textes
    • avertissementsliste de textes
    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce 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_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • coutsobjet
    Afficher les 13 champs
    • plateforme_pctnombre
    • conciergerie_pctnombre
    • renouvellement_pctnombre
    • plateformenombre
    • conciergerienombre
    • renouvellementnombre
    • menagenombre
    • lingenombre
    • energienombre
    • internetnombre
    • assurancenombre
    • classementnombre
    • totalnombre

      Coûts d'exploitation annuels, en euros, sur le revenu brut.

  • revenu_netnombre

    Revenu brut moins coûts d'exploitation, avant charges de copropriété, taxe foncière, crédit et impôt.

  • loyer_nu_mensuelnombre ou null

    Loyer nu de comparaison : celui donné, ou loyer de marché au m² de la commune multiplié par la surface.

  • statut_reglementaireobjet
    Afficher les 4 champs
    • niveautexte

      libre : 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, dpe

    • recommandablebooléen

      Faux quand la courte durée ne peut pas être conseillée en l'état (compensation, DPE).

    • titretexte
    • textetexte
  • hypothesesliste de textes
  • creditsobjet

    Cré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 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs