# 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). Usage plateforme inclus.

- **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:** 5 total users, 2 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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# 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,
    "maxPagesPerUrl": 20
}
```

#### The filters

They all run on the listings the search URL brings back, so you only pay for rows you actually asked for.

| Input | Type | Default | What it does |
|---|---|---|---|
| `minPrice` | integer | none | Drop listings under this price (€). |
| `maxPrice` | integer | none | Drop listings over this price (€). |
| `minSurface` | integer | none | Drop listings under this living surface (m²). |
| `minRooms` | integer | none | Drop listings with fewer rooms ("pièces", not bedrooms). |
| `propertyTypes` | array | all | Keep only these types: `Appartement`, `Maison`, `Terrain`, `Immeuble`, `Local commercial`, `Bureau`, `Parking / Box`. |
| `keywords` | array | none | Keep a listing only if one of these words appears in its title, description or city, for example `jardin`, `travaux`, `viager`. |

#### Limits, and what happens when you hit them

| Field | Default | Maximum | Why |
|---|---|---|---|
| `searchUrls` | — | 20 URLs | As many as one run can walk to depth |
| `maxResults` | 500 | 4,000 | What one run can deliver inside its time limit |
| `maxPagesPerUrl` | 20 | 20 | ~40 ads a page, so ~800 ads per URL; ParuVendu repeats content past its last real page and the actor stops there anyway |

The run also watches its own clock. If the search you asked for would outlast the run timeout, the actor stops fetching new pages while there is still time to charge and deliver everything it has collected (including listings whose ad page is still queued), and the run finishes **successfully** with a status message saying so: *"Stopped at the run time limit: N rows delivered, raise the run timeout or lower maxResults."* You keep the rows and you are told which knob to turn — instead of the run being killed mid-page with nothing to show for it.

### 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.*

# Changelog

This Actor's version history is a separate document: https://apify.com/tagadanar/french-real-estate-paruvendu/changelog.md

# Actor input Schema

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

Paste one or more ParuVendu real-estate search-result URLs (up to 20 per run — that is as many as one run can walk to depth). 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. The ceiling is what one run can actually deliver inside its time limit — asking for more than the run has time for now ends the run cleanly with a status message instead of being cut off.

## `maxPagesPerUrl` (type: `integer`):

How deep to follow each search URL's pagination. ParuVendu shows about 40 ads per page, so 20 pages is roughly 800 ads per URL — and past its last real page ParuVendu repeats content, which the actor detects and stops on anyway.

## Actor input object example

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

# 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(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tagadanar/french-real-estate-paruvendu"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

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