---
title: "État des sources"
method: GET
path: "/sources"
---

# État des sources

`GET /sources`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/sources`
- Auth: HTTP bearer

L'état des données de Pillr, source par source, lu dans les journaux de chargement : sources publiques rafraîchies par le site (dernier succès, prochaine mise à jour, échecs consécutifs), miroirs des jeux publics au lac (dernier chargement réussi, tranches chargées, en échec et en cours, lignes, période couverte quand les tranches sont datées), balayages des portails sur 7 jours (dernier balayage fini, annonces vues et insérées), collectes des signaux communaux (lignes captées, total de la source et écart) et étages de la chaîne quotidienne ; plus les compteurs de la table des adresses. Chaque source dit ses anomalies constatées (échec, retard au-delà de 36 heures, tranche en échec, écart à la source au-delà de 5 %) ; aucun message d'erreur interne n'est servi. Coût : 0 crédit par appel réussi.

## Query parameters

- `source` string: Ne rendre que cette source (son nom, tel que la liste le donne).

## Response `200`

Réponse servie et débitée (sauf réponse identique déjà servie dans les 24 h).

- object
  - `sources` object[], required
    - `nom` string, required
    - `famille` 'source_publique' | 'miroir_public' | 'balayage_portail' | 'collecte_signaux' | 'chaine_quotidienne', required: source_publique : source rafraîchie par le site ; miroir_public : copie d'un jeu public au lac ; balayage_portail : balayage d'un portail d'annonces ; collecte_signaux : collecte d'un signal communal ; chaine_quotidienne : étage de la chaîne quotidienne.
    - `titre` string, nullable, required
    - `dernier_chargement` string, nullable, required: Dernier chargement réussi (ou dernier balayage fini).
    - `couverture` object, nullable, required: Période couverte, lue sur les tranches datées d'un miroir (années, mois) ; null sinon.
      - `debut` string, nullable, required
      - `fin` string, nullable, required
    - `volume` object, required: Volume du dernier état : lignes chargées, annonces vues, lignes captées.
      - `valeur` number, nullable, required
      - `qualite` object, required: Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
        - `n` integer, nullable, required: Nombre d'observations derrière la valeur ; null si sans objet.
        - `provenance` 'mesure' | 'estime', nullable, required: mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
        - `incertitude` object, nullable, required: Incertitude de la valeur : fourchette et demi-largeur.
          - `demi_largeur_pct` number, nullable, required: Demi-largeur de la fourchette, en % de la valeur.
          - `bas` number, nullable, required
          - `haut` number, nullable, required
        - `drapeaux` string[], required: Ce qui doit faire lire la valeur avec prudence ; vide si rien.
        - `methode` string, nullable, required: Méthode de calcul ou de rattachement, en clair.
        - `donnees_du` string, nullable, required: Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
        - `source` string, required: Source publique ou moteur Pillr, en clair.
    - `unite_volume` string, nullable, required
    - `prochaine_maj` string, nullable, required: Prochaine mise à jour prévue, quand la source la déclare.
    - `anomalies` string[], required: Anomalies constatées ; vide si rien.
    - `detail` object, required
      - `categorie` string, nullable, required
      - `millesime` string, nullable, required
      - `frequence` string, nullable, required
      - `echecs_consecutifs` integer, nullable, required
      - `tranches` integer, nullable, required
      - `tranches_en_echec` integer, nullable, required
      - `tranches_en_cours` integer, nullable, required
      - `balayages` integer, nullable, required: Balayages lancés sur 7 jours.
      - `balayages_finis` integer, nullable, required
      - `insertions` number, nullable, required: Annonces insérées sur 7 jours.
      - `total_source` number, nullable, required: Total annoncé par la source à la dernière collecte.
      - `ecart_source_pct` number, nullable, required
      - `verdict` string, nullable, required: Verdict du dernier passage d'un étage de la chaîne quotidienne.
    - `jeux` string[], required: Les jeux de lire_jeu que cette source alimente.
  - `adresses` object, nullable, required: Compteurs de la table des adresses, calculés à chaque build nocturne ; null s'ils ne se lisent pas.
    - `total` object, required: Adresses de la table des adresses.
      - `valeur` number, nullable, required
      - `qualite` object, required: Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
        - `n` integer, nullable, required: Nombre d'observations derrière la valeur ; null si sans objet.
        - `provenance` 'mesure' | 'estime', nullable, required: mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
        - `incertitude` object, nullable, required: Incertitude de la valeur : fourchette et demi-largeur.
          - `demi_largeur_pct` number, nullable, required: Demi-largeur de la fourchette, en % de la valeur.
          - `bas` number, nullable, required
          - `haut` number, nullable, required
        - `drapeaux` string[], required: Ce qui doit faire lire la valeur avec prudence ; vide si rien.
        - `methode` string, nullable, required: Méthode de calcul ou de rattachement, en clair.
        - `donnees_du` string, nullable, required: Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
        - `source` string, required: Source publique ou moteur Pillr, en clair.
    - `dpe_90j` object, required: Adresses dont le dernier DPE a moins de 90 jours, dans le périmètre du pré-marché.
      - `valeur` number, nullable, required
      - `qualite` object, required: Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
        - `n` integer, nullable, required: Nombre d'observations derrière la valeur ; null si sans objet.
        - `provenance` 'mesure' | 'estime', nullable, required: mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
        - `incertitude` object, nullable, required: Incertitude de la valeur : fourchette et demi-largeur.
          - `demi_largeur_pct` number, nullable, required: Demi-largeur de la fourchette, en % de la valeur.
          - `bas` number, nullable, required
          - `haut` number, nullable, required
        - `drapeaux` string[], required: Ce qui doit faire lire la valeur avec prudence ; vide si rien.
        - `methode` string, nullable, required: Méthode de calcul ou de rattachement, en clair.
        - `donnees_du` string, nullable, required: Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
        - `source` string, required: Source publique ou moteur Pillr, en clair.
    - `dpe_24m` object, required: Adresses dont le dernier DPE a moins de 24 mois.
      - `valeur` number, nullable, required
      - `qualite` object, required: Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
        - `n` integer, nullable, required: Nombre d'observations derrière la valeur ; null si sans objet.
        - `provenance` 'mesure' | 'estime', nullable, required: mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
        - `incertitude` object, nullable, required: Incertitude de la valeur : fourchette et demi-largeur.
          - `demi_largeur_pct` number, nullable, required: Demi-largeur de la fourchette, en % de la valeur.
          - `bas` number, nullable, required
          - `haut` number, nullable, required
        - `drapeaux` string[], required: Ce qui doit faire lire la valeur avec prudence ; vide si rien.
        - `methode` string, nullable, required: Méthode de calcul ou de rattachement, en clair.
        - `donnees_du` string, nullable, required: Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
        - `source` string, required: Source publique ou moteur Pillr, en clair.
    - `prospectables_90j` object, required: Adresses à DPE de moins de 90 jours, ni déjà en vente, ni vendues après le DPE.
      - `valeur` number, nullable, required
      - `qualite` object, required: Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
        - `n` integer, nullable, required: Nombre d'observations derrière la valeur ; null si sans objet.
        - `provenance` 'mesure' | 'estime', nullable, required: mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
        - `incertitude` object, nullable, required: Incertitude de la valeur : fourchette et demi-largeur.
          - `demi_largeur_pct` number, nullable, required: Demi-largeur de la fourchette, en % de la valeur.
          - `bas` number, nullable, required
          - `haut` number, nullable, required
        - `drapeaux` string[], required: Ce qui doit faire lire la valeur avec prudence ; vide si rien.
        - `methode` string, nullable, required: Méthode de calcul ou de rattachement, en clair.
        - `donnees_du` string, nullable, required: Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
        - `source` string, required: Source publique ou moteur Pillr, en clair.
  - `credits` object, required: 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).
    - `debites` integer, required
    - `restants` integer, nullable, required

## Other responses

- `304`: Non modifiée depuis l'ETag fourni : rien n'est débité.
- `400`: Paramètres invalides
- `401`: Clé d'API absente
- `402`: Crédits insuffisants ; Carte requise ; Plafond mensuel de dépense atteint
- `403`: Portée insuffisante
- `404`: Ressource absente : rien n'est débité
- `429`: Trop de requêtes par minute
- `500`: Erreur interne
- `503`: API indisponible ; Donnée momentanément indisponible

---

[API](https://skmtc.dev/pillr/apis/api-pillr.md) · [All operations](https://skmtc.dev/pillr/apis/api-pillr/llms.txt) · [OpenAPI document](https://skmtc.dev/pillr/apis/api-pillr/revisions/218b2866bd6c?raw)