API ParuVendu : les petites annonces de paruvendu.fr en JSON, rubrique par rubrique

ParuVendu.fr range ses petites annonces en rubriques qui n'ont pas les mêmes critères : voitures d'occasion, immobilier à vendre ou à louer, objets de seconde main (« Mon débarras »), animaux, services entre particuliers. L'API reprend ce découpage : `section` choisit la rubrique, chaque rubrique accepte ses propres filtres, et toutes se restreignent à un département (`33` pour la Gironde, `69` pour le Rhône, `2A` pour la Corse-du-Sud). En immobilier, chaque ligne porte le prix, la surface, le nombre de pièces et, quand l'annonce l'indique, la classe énergie : de quoi calculer un prix au m² commune par commune. Rien n'est déposé ni modifié par ce biais, et une agence qui diffuse ses biens sur ParuVendu n'y trouvera pas d'outil de gestion : on lit, côté acheteur, ce qui est en ligne.

Exemple qui fonctionne

Appartements à vendre en Gironde jusqu'à 250 000 €, le 28 octobre 2026 : 2 156 annonces, 30 par page. Sur la première page, le prix au m² calculé à partir de `price_eur` et `surface_m2` allait de 2 044 €/m² à Libourne à 5 250 €/m² à La Teste-de-Buch, et tombait à 800 €/m² pour un « appartement » de 10 m² à Bordeaux affiché 8 000 € : d'après son texte, une cave de stockage classée par l'annonceur dans les appartements. Avant de calculer une moyenne, écartez ce genre de ligne : ParuVendu publie catégories et surfaces telles que l'annonceur les a saisies. La classe énergie (`energy_class`) était renseignée sur 13 lignes sur 30.

curl -X POST https://api.reefapi.com/paruvendu/v1/search \
  -H "x-api-key: VOTRE_CLE" \
  -H "content-type: application/json" \
  -d '{"section": "real_estate", "property_type": "apartment", "transaction": "sale", "department": "33", "max_price": 250000}'

{
  "ok": true,
  "data": {
    "section": "real_estate",
    "total": 2156,
    "page": 1,
    "page_size": 30,
    "last_page": 72,
    "has_more": true,
    "page_beyond_end": false,
    "sort": "relevance",
    "listings": [
      {
        "id": "1296781480A1KIVHAP000",
        "url": "https://www.paruvendu.fr/immobilier/vente/appartement/1296781480A1KIVHAP000",
        "title": "Appartement 40 m2 La Teste-de-Buch (33)",
        "price_eur": 210000,
        "price_text": "210 000 €",
        "city": "La Teste-de-Buch",
        "postal_code": null,
        "department": "33",
        "seller_type": "Professionnel",
        "published_on": "2026-10-28",
        "property_kind": "Appartement",
        "surface_m2": 40,
        "rooms": 2,
        "bedrooms": 1,
        "energy_class": null
      },
      ...
      {
        "id": "1292692820A1KIVHAP000",
        "title": "Appartement 10 m2 Bordeaux (33)",
        "price_eur": 8000,
        "price_text": "8 000 €",
        "city": "Bordeaux",
        "description_snippet": "Bien situé à Bordeaux, cette cave de stockage d'environ 10m2 est idéale pour mobilier, vélos ou archives. ...",
        "surface_m2": 10,
        "rooms": 1,
        "energy_class": null
      },
      {
        "id": "1294986914A1KIVHAP000",
        "title": "Appartement 68 m2 Libourne (33)",
        "price_eur": 139000,
        "price_text": "139 000 €",
        "city": "Libourne",
        "published_on": "2026-10-26",
        "surface_m2": 68,
        "rooms": 2,
        "bedrooms": 1,
        "energy_class": "D"
      },
      ...
    ],
    "filters_applied": { "section": "real_estate", "sort": "relevance", "department": "33", "transaction": "sale", "property_type": "apartment", "max_price": 250000, "page": 1 }
  },
  "meta": { "record_count": 30, "upstream_requests": 1, "cache_hit": false, "mode": "live" }
}

Limites et remarques honnêtes

• Ce service est indépendant de ParuVendu : le site ne le propose pas, ne l'a pas validé, et aucun partenariat ne nous lie à lui.
• Prix et catégories sont ceux de l'annonceur, sans contrôle : en voitures, le tri par prix croissant commençait à 1 € lors de nos mesures, et l'exemple montre une cave classée en appartement. « Faire offre », « NC » et 0 € donnent `price_eur` à null, la mention restant dans `price_text` (2 canapés sur 30 dans notre recherche du Rhône).
• Les cartes immobilières ne donnent pas de code postal, seulement le département, et la commune est tirée du titre de la carte. Sur l'appartement bordelais de 35 m² à 159 840 € ouvert avec `listing`, `department` était null et seule la région était renseignée (« Aquitaine »).
• La classe énergie de la liste ne se retrouve pas toujours dans l'annonce : pour ce même T2, `energy_class` valait D dans `search`, et aucun attribut de `listing` ne la mentionnait.
• Pas de filtre sur le nombre de pièces : sur le site, il ne faisait presque pas varier le total (212 383 annonces sans lui, 211 764 avec). Filtrez sur `rooms` de votre côté.
• Ni coordonnées GPS, ni note du vendeur, ni nombre de vues. Les rubriques emploi et locations de vacances restent hors du périmètre.
• `listing` renvoie le bloc vendeur tel que la page le publie, téléphone du professionnel compris quand il est affiché. Ces champs ne figurent pas dans l'exemple.
• Prix par appel : `search` 3 crédits, `listing` 2, `car_facets` et `categories` 1 chacun.