# ParuVendu Scraper 🇫🇷 Immobilier Particulier + Agence (`tagadanar/french-real-estate-paruvendu`) Actor

Toutes les annonces ParuVendu.fr, particuliers et agences, vente et location : prix, €/m², surface, pièces, ville, photos et DPE. Collez une URL de recherche, l'actor suit toutes les pages ; un filtre isole les particuliers pour la pige immobilière (API et MCP).

- **URL**: https://apify.com/tagadanar/french-real-estate-paruvendu.md
- **Developed by:** [Tagada Data](https://apify.com/tagadanar) (community)
- **Categories:** Real estate, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.05 / 1,000 listing founds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## ParuVendu Scraper 🇫🇷 Immobilier Particulier + Agence

**Turn any ParuVendu search into clean, structured property data.** Paste a `paruvendu.fr` real-estate search URL and this actor follows every result page, returning each listing with **price, €/m², surface, rooms, property type, city, photos** and a **private-owner vs agency** flag. One switch narrows the results to **owner-direct (particulier)** ads, which is the core of a *pige immobilière* workflow.

Built for **estate agents doing pige, lead sourcing, market analysis, proptech and AI agents** (REST API + MCP).

### Why ParuVendu

ParuVendu is one of the few large French portals with a **genuine base of owner-direct (particulier) inventory** alongside agency ads, and it's barely covered on the scraper shelf. It complements SeLoger, PAP and Logic-Immo: each site draws different sellers and different stock, so covering all of them widens what you see for the same search.

### What you get

- ✅ The actor follows every result page on the search automatically, using `?p=` pagination so nothing gets left behind on page two.
- ✅ Each listing comes back with structured fields: price, €/m² (computed), surface, rooms, land surface, property type, city, photos.
- ✅ **Owner-direct flag:** `isPrivateSeller` is set on every ad, and a one-switch `onlyPrivateSeller` filter keeps only particuliers for pure pige.
- ✅ Filters for price, surface, rooms, property type and keywords apply across the whole search, not just the first page.
- ✅ Turn on `scrapeDetails` for optional enrichment: the full description plus energy class (DPE) pulled from each ad page.
- ✅ No login and no API key needed. It runs on Apify with the Residential proxy.

### Quick start

1. On **paruvendu.fr**, build your search (Immobilier → Vente/Location, city, budget, type). For owner-direct only, use the **`-particulier`** variant of the URL.
2. Paste the results-page URL into `searchUrls`.
3. Run. Every listing comes back structured; flip `onlyPrivateSeller` on for particuliers only.

```json
{
    "searchUrls": ["https://www.paruvendu.fr/immobilier/vente/appartement-particulier/"],
    "onlyPrivateSeller": true,
    "maxResults": 200
}
```

### Output (per listing)

```json
{
    "source": "ParuVendu",
    "id": "1292023055A1KIVHAP000",
    "url": "https://www.paruvendu.fr/immobilier/vente/appartement/1292023055A1KIVHAP000",
    "transactionType": "sale",
    "propertyType": "Appartement",
    "title": "Appartement - 4 pièce(s) - 89 m²",
    "price": 440000, "currency": "EUR", "pricePerM2": 4944,
    "rooms": 4, "surface": 89, "landSurface": null,
    "city": "Ciboure",
    "photos": ["https://img.paruvendu.fr/…"], "photoCount": 3,
    "seller": "Particulier", "isPrivateSeller": true, "sellerName": "g2ailes64",
    "energyClass": null
}
```

### Pricing

Pay per event, no subscription:

| Event | Price | When |
|---|---|---|
| Actor start | **$0.001** | Flat, once per run |
| Listing found | **$1.50 / 1,000** | Per listing returned |

Apify platform usage (compute and residential proxy) is included in the price, so there is no separate platform bill. The tiny start fee only covers a run that returns nothing at all. You can still cap spend per run with a charge limit.

### Companion actors: the French property suite

- [**Pige Immobilière**](https://apify.com/tagadanar/french-real-estate-pige) combines SeLoger, PAP and Logic-Immo, de-duplicated, with owner phones included.
- [**PAP**](https://apify.com/tagadanar/french-real-estate-pap) · [**SeLoger**](https://apify.com/tagadanar/french-real-estate-seloger) · [**Logic-Immo**](https://apify.com/tagadanar/french-real-estate-logicimmo) · [**DVF sold prices**](https://apify.com/tagadanar/french-real-estate-dvf) · [**Deal Score**](https://apify.com/tagadanar/french-real-estate-deal-score)

### FAQ

**Do I need a ParuVendu account?** No. The actor reads public search-result pages.

**Can I get the advertiser's phone number?** Not currently. ParuVendu reveals the phone only through an in-page action that isn't present in the page's HTML, so this actor returns listings without a phone. For owner phone numbers, use the **PAP** actor or the **Pige Immobilière** bundle.

**Sale and rental?** Both are covered; the transaction type is detected from the search URL (`/vente/` vs `/location/`).

**Is it reliable?** ParuVendu is read over the Residential proxy, and blocked sessions retry automatically. Selectors degrade a missing field to `null` rather than dropping the record.

**AI agents?** Yes, through the REST API and **MCP**.

***

### Something missing?

If you need an extra field, another source, or a different output, open an issue on this Actor and describe it. I read every request and small additions usually ship within days. More French real estate Actors (pige, DVF, deal score, DPE leads) are on [my profile](https://apify.com/tagadanar).

*Keywords: paruvendu scraper, paruvendu immobilier, french real estate scraper, particulier, pige immobilière, owner-direct listings, €/m², lead generation, proptech, MCP.*

# Actor input Schema

## `searchUrls` (type: `array`):

Paste one or more ParuVendu real-estate search-result URLs. Build the search on <b>paruvendu.fr</b> (Immobilier → Vente or Location, city, budget, type…) and copy the results-page URL. Use the <b>-particulier</b> variant for owner-direct only, e.g. <code>https://www.paruvendu.fr/immobilier/vente/appartement-particulier/</code>. Every result page is followed automatically.

## `onlyPrivateSeller` (type: `boolean`):

Keep only listings posted by private owners (particuliers) — the core of a pige workflow. Drops agency/pro ads. (A <code>-particulier</code> search URL already does this; this switch also filters mixed searches.)

## `minPrice` (type: `integer`):

Keep only listings at or above this price.

## `maxPrice` (type: `integer`):

Keep only listings at or below this price.

## `minSurface` (type: `integer`):

Keep only listings with at least this living surface.

## `minRooms` (type: `integer`):

Keep only listings with at least this many rooms (pièces).

## `propertyTypes` (type: `array`):

Keep only these property types. Empty = all types found.

## `keywords` (type: `array`):

Keep only listings whose title, description or city contain at least one of these words (e.g. <code>terrasse</code>, <code>jardin</code>, <code>viager</code>).

## `scrapeDetails` (type: `boolean`):

For every listing, also fetch its ad page to add the <b>full description</b> and <b>energy class (DPE)</b>. Slower and does more requests. <i>Note: ParuVendu reveals the advertiser's phone only via an in-page action, so a phone number is not extracted.</i>

## `maxResults` (type: `integer`):

Stop after this many listings across all search URLs.

## Actor input object example

```json
{
  "searchUrls": [
    "https://www.paruvendu.fr/immobilier/vente/appartement-particulier/"
  ],
  "onlyPrivateSeller": false,
  "propertyTypes": [],
  "keywords": [],
  "scrapeDetails": false,
  "maxResults": 50
}
```

# Actor output Schema

## `listings` (type: `string`):

All scraped ParuVendu listings (one item per property) in the default dataset.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchUrls": [
        "https://www.paruvendu.fr/immobilier/vente/appartement-particulier/"
    ],
    "maxResults": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("tagadanar/french-real-estate-paruvendu").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchUrls": ["https://www.paruvendu.fr/immobilier/vente/appartement-particulier/"],
    "maxResults": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("tagadanar/french-real-estate-paruvendu").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchUrls": [
    "https://www.paruvendu.fr/immobilier/vente/appartement-particulier/"
  ],
  "maxResults": 50
}' |
apify call tagadanar/french-real-estate-paruvendu --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=tagadanar/french-real-estate-paruvendu",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Vak16M6cN8nV8LYg6/builds/jnaG6U4SFXyzgGydU/openapi.json