---
title: "Annonces recommandées pour le compte"
method: GET
path: "/compte/recommandations"
---

# Annonces recommandées pour le compte

`GET /compte/recommandations`

## Request

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

Des annonces actives et analysées choisies pour l'utilisateur de la clé, avec les règles de la page du site : d'après les motifs de ses favoris (ville, type, budget et surface autour de leur moyenne), sinon d'après la stratégie de son profil investisseur, sinon les meilleurs scores du catalogue. Les motifs retenus sont rendus avec les annonces. Exige une clé rattachée à un compte Pillr. Coût : 1 crédit par élément rendu.

## Query parameters

- `nombre` integer: Annonces rendues au plus.

## Response `200`

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

- object
  - `donnees` object[], required
    - `id` string, required: Identifiant de l'annonce : lbc:<n>, bienici:<id> ou seloger:<id>.
    - `type` string, required
    - `commune` string, nullable, required
    - `code_postal` string, nullable, required
    - `prix` number, nullable, required
    - `surface` number, nullable, required
    - `pieces` number, nullable, required
    - `prix_m2` number, nullable, required
    - `dpe` 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G', nullable, required
    - `score` number, nullable, required
    - `loyer_estime` number, nullable, required
    - `rendement_brut` number, nullable, required
    - `rendement_net` number, nullable, required
    - `travaux_max` number, nullable, required
    - `type_vendeur` 'pro' | 'particulier' | 'inconnu', required
    - `lien` string, nullable, required: Lien d'origine, servi quand la clé porte la portée lien_origine.
    - `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.
  - `base` 'favoris' | 'profil' | 'catalogue', required: Ce sur quoi la sélection s'appuie.
  - `raison` string, required
  - `motifs` object, required
    - `type` 'appartement' | 'maison', nullable, required
    - `budget` object, nullable, required
      - `min` number, nullable, required
      - `max` number, nullable, required
    - `surface` object, nullable, required
      - `min` number, nullable, required
      - `max` number, nullable, required
    - `dpe` string[], required
    - `villes` string[], required
    - `strategie` string, nullable, required
  - `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 ; Clé sans compte rattaché
- `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)