APIs / ParuVendu Immobilier / Search

ParuVendu Immobilier: Search

Search from ParuVendu Immobilier as JSON. 1 credit per successful call.

GET /v1/paruvendu/search

Parameters

Send parameters in the query string.

ParameterTypeRequiredAllowed values
listing_typestringOptionalsale, rent
property_typestringOptionalapartment, house, studio, land
placestringRequiredAny
roomsstringOptionalstudio, 2, 3, 4, 5, 6_plus
min_priceintegerOptionalAny
max_priceintegerOptionalAny
min_areaintegerOptionalAny
max_areaintegerOptionalAny
min_bedroomsintegerOptionalAny
min_bathroomsintegerOptionalAny
sellerstringOptionalprivate
with_photosbooleanOptionalAny
sortstringOptionalrelevance, newest, price_asc, price_desc, area_desc, area_asc, rooms_desc, rooms_asc
pageintegerOptionalAny

Example request

ParuVendu Immobilier
GET/v1/paruvendu/search?listing_type=sale&property_type=apartment&place=lyon&min_price=200000&max_price=400000
{
  "success": true,
  "data": {
    "search_parameters": {
      "listing_type": "sale",
      "property_type": "apartment",
      "place": "lyon",
      "min_price": "200000",
      "max_price": "400000",
      "sort": "newest",
      "page": 1
    },
    "search_metadata": {
      "total_results": 663,
      "low_price": 200000,
      "high_price": 400000,
      "page": 1,
      "per_page": 30,
      "reachable_results": 150,
      "has_next_page": true,
      "upstream_items": 30,
      "filtered_out": 0
    },
    "listings": [
      {
        "listing_id": "1297274803A1KIVHAP000",
        "listing_type": "sale",
        "property_type": "apartment",
        "title": "Appartement 100 m² Lyon 5",
        "url": "https://www.paruvendu.fr/immobilier/vente/appartement/1297274803A1KIVHAP000",
        "price": {
          "amount": 325000,
          "currency": "EUR",
          "text": "325 000 €",
          "per_sqm": 3250,
          "includes_charges": false
        },
        "area_m2": 100,
        "rooms": 5,
        "bedrooms": 3,
        "city": "Lyon 5",
        "features": [
          "Garage"
        ],
        "energy": {
          "class": "D"
        },
        "seller_type": "private",
        "updated_at": "2026-11-10",
        "description_snippet": "A Lyon, grand appartement familial de plus de 100 m², 5 pièces à rénover, au 3ème étage avec ascenseur. Vue sur la Saône, environnement calme. Proximité bus, gare de Perrache et stationnement sécurisé. Idéal pour un projet sur-mesure.",
        "photo_count": 1
      },
      {
        "listing_id": "1297269803A1KIVHAP000",
        "listing_type": "sale",
        "property_type": "apartment",
        "title": "Appartement 39 m² Lyon 4",
        "url": "https://www.paruvendu.fr/immobilier/vente/appartement/1297269803A1KIVHAP000",
        "price": {
          "amount": 210000,
          "currency": "EUR",
          "text": "210 000 €",
          "per_sqm": 5385,
          "includes_charges": false
        },
        "area_m2": 39,
        "rooms": 2,
        "bedrooms": 1,
        "city": "Lyon 4",
        "energy": {
          "class": "F"
        },
        "seller_type": "private",
        "updated_at": "2026-11-10",
        "description_snippet": "Lyon, T2 de 39 m2 au rez-de-chaussée. Entièrement rénové en 2020, séjour avec cuisine ouverte équipée, chambre, salle d'eau moderne. Vendu meublé, lumineux, au calme, idéal investisseur ou à habiter après avril 2027. Proche commerces et mét…",
        "photos": [
          "https://img.paruvendu.fr/media_ext/_https_/media.paruvendu.fr/f3/08/L21lZGlhLXBhL1dJMTcvOC8xL1dJMTc4MTY5MjgyXzEuanBlZz8yMDI2MTExMDEzMzk1MQ_rct?func=crop&w=1000&gravity=auto",
          "https://img.paruvendu.fr/media_ext/_https_/media.paruvendu.fr/30/69/L21lZGlhLXBhL1dJMTcvOC8xL1dJMTc4MTY5MjgyXzIuanBlZz8yMDI2MTExMDEzMzk1MQ_rct?func=crop&w=1000&gravity=auto",
          "https://img.paruvendu.fr/media_ext/_https_/media.paruvendu.fr/96/46/L21lZGlhLXBhL1dJMTcvOC8xL1dJMTc4MTY5MjgyXzMuanBlZz8yMDI2MTExMDEzMzk1MQ_rct?func=crop&w=1000&gravity=auto"
        ],
        "photo_count": 3
      },
      {
        "listing_id": "1297187162A1KIVHAP000",
        "listing_type": "sale",
        "property_type": "apartment",
        "title": "Appartement 54 m² Lyon 4",
        "url": "https://www.paruvendu.fr/immobilier/vente/appartement/1297187162A1KIVHAP000",
        "price": {
          "amount": 315000,
          "currency": "EUR",
          "text": "315 000 €",
          "per_sqm": 5833,
          "includes_charges": false
        },
        "area_m2": 54,
        "rooms": 2,
        "bedrooms": 1,
        "city": "Lyon 4",
        "features": [
          "Garage"
        ],
        "energy": {
          "class": "B"
        },
        "seller_type": "private",
        "updated_at": "2026-11-08",
        "description_snippet": "Lyon 4ème, appartement rénové de 54,28 m2 au 4ème étage. Prestations haut de gamme, terrasse et parking double. Pièce à vivre lumineuse, cuisine ouverte et salle de bains contemporaine. Immeuble de 2000, DPE B et GES A.",
        "photos": [
          "https://img.paruvendu.fr/media_ext/_https_/media.paruvendu.fr/97/19/L21lZGlhLXBhL1dJMTcvOC8xL1dJMTc4MTYxNjM1XzEuanBlZz8yMDI2MTEwODE2MzkyNw_rct?func=crop&w=1000&gravity=auto",
          "https://img.paruvendu.fr/media_ext/_https_/media.paruvendu.fr/77/f0/L21lZGlhLXBhL1dJMTcvOC8xL1dJMTc4MTYxNjM1XzIuanBlZz8yMDI2MTEwODE2MzkyNw_rct?func=crop&w=1000&gravity=auto",
          "https://img.paruvendu.fr/media_ext/_https_/media.paruvendu.fr/29/6b/L21lZGlhLXBhL1dJMTcvOC8xL1dJMTc4MTYxNjM1XzMuanBlZz8yMDI2MTEwODE2MzkyNw_rct?func=crop&w=1000&gravity=auto"
        ],
        "photo_count": 10
      }
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_a757529134ec4e1f83f5474ed11d6b7e",
    "credits_charged": 1,
    "credits_remaining": 1831
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.