# PAP Real Estate Listings — Owner-Direct Sales & Rentals (`tagadanar/french-real-estate-pap`) Actor
French property listings from PAP (Particulier à Particulier) — owner-direct sale & rental ads, no agencies. Paste a PAP search URL; get price, surface, rooms, €/m², DPE, description & photos per listing. For search, market analysis, lead sourcing & AI agents (API + MCP).
- **URL**: https://apify.com/tagadanar/french-real-estate-pap.md
- **Developed by:** [Raphaël R](https://apify.com/tagadanar) (community)
- **Categories:** Real estate, Lead generation, AI
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $1.00 / 1,000 listing founds
This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use 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
## PAP Real Estate Listings — Owner-Direct Sales & Rentals (France)
**Scrape French property ads from [PAP.fr](https://www.pap.fr) (Particulier à Particulier).** Paste a PAP search URL and get clean, structured listings — **price, surface, rooms, €/m², energy class, description and photos** — for every result page.
PAP is **owner-direct only**: no agencies, no agency fees. Every record is a private seller, which makes this ideal for **buyer/renter search, market analysis, lead sourcing, and AI agents** (works via API and MCP).
### Why this actor
- ✅ **Owner-direct leads** — PAP has no agency listings, so every result is a private individual selling or renting their own property.
- ✅ **Owner phone & full address** *(optional)* — turn on `scrapeDetails` to get each owner's **phone number** and the **exact street address** straight from the ad. Direct-to-owner contact, no agency in between.
- ✅ **Paste-a-search simplicity** — build any search on pap.fr (city, sale/rental, type, filters) and paste the URL. All result pages are followed automatically.
- ✅ **Clean, computed fields** — French prices and surfaces parsed to numbers, **€/m² computed** for sales, DPE energy class extracted.
- ✅ **Extra filtering** — narrow further by price, surface, rooms, property type or keywords, on top of what the search URL already selects.
- ✅ **Fair pricing** — pay per listing returned; the phone/address premium is only charged when contact data is actually found.
### Companion to the DVF actor
Pair this with [**French Real Estate Sales (DVF)**](https://apify.com/tagadanar/french-real-estate-dvf): DVF gives you the **actual recorded sale prices** (what properties sold for), while this actor gives you the **live asking prices** (what owners want today). Together: asking-vs-achieved price analysis for any French market.
### Input
```json
{
"searchUrls": [
"https://www.pap.fr/annonce/vente-appartements-bordeaux-33000-g43898"
],
"minPrice": 150000,
"maxPrice": 400000,
"minSurface": 40,
"minRooms": 2,
"propertyTypes": ["Appartement"],
"keywords": ["terrasse", "balcon"],
"scrapeDetails": true,
"maxResults": 500,
"maxPagesPerUrl": 20
}
````
Set `scrapeDetails: true` to also fetch each listing's page for the **owner phone**, **street address** and full description. Leave it `false` (default) for a faster, list-only run.
**How to get a search URL:** go to [pap.fr](https://www.pap.fr), run the search you want (choose city, *acheter* or *louer*, property type, and any filters), then copy the address-bar URL and paste it into `searchUrls`. You can pass several URLs at once.
### Output (one record per listing)
```json
{
"source": "PAP",
"id": "450001168",
"url": "https://www.pap.fr/annonces/appartement-aix-en-provence-r450001168",
"transactionType": "sale",
"propertyType": "Appartement",
"title": "Aix-En-Provence",
"location": "Aix-En-Provence",
"price": 389000,
"currency": "EUR",
"pricePerM2": 9262,
"rooms": 2,
"bedrooms": 1,
"surface": 42,
"landSurface": null,
"energyClass": "B",
"description": "Beau Loft avec terrasse et parking, Aix centre…",
"photos": ["https://cdn.pap.fr/photos/…-p3.jpg"],
"photoCount": 8,
"seller": "Particulier",
"phone": "06 71 26 79 76",
"streetAddress": "rue Constant Coquelin",
"postalCode": "94400",
"reference": "vente-450001168",
"sourceRef": "pap.fr (Particulier à Particulier)"
}
```
The `phone`, `streetAddress`, `postalCode` and `reference` fields are populated only when `scrapeDetails` is on; otherwise they are `null`.
### Pricing
Pay per event — no subscription:
| Event | When |
|---|---|
| Actor start | Once per run |
| Listing found | Per listing returned |
| Listing detailed | Per listing enriched with owner phone/address (only when `scrapeDetails` is on **and** contact data is found) |
### FAQ
**What's the source?** Public listings on pap.fr — France's largest owner-to-owner (particulier à particulier) real-estate site. Agencies can't list there, so results are private sellers/landlords.
**Sales and rentals?** Both. The actor detects sale vs rental from the search URL; `€/m²` is computed for sales only.
**How do I target a specific city or neighbourhood?** Build the search on pap.fr — its filters (arrondissement, budget, surface, rooms, exterior, etc.) all encode into the URL you paste.
**Why do some fields come back null?** When a listing genuinely omits a value (e.g. price on request, no DPE), the field is `null` rather than a guess.
**Does it work with AI agents?** Yes — exposed via REST API and **MCP**.
***
*Keywords: PAP, particulier à particulier, annonces immobilières, immobilier France, real estate listings, property France, prix immobilier, €/m², location appartement, vente maison, owner-direct, no agency, proptech.*
# Actor input Schema
## `searchUrls` (type: `array`):
One or more pap.fr search-result URLs. Build the search you want on pap.fr (city, sale/rental, property type, price/surface filters), then copy the page URL and paste it here. All result pages are followed automatically. Example: https://www.pap.fr/annonce/vente-appartements-bordeaux-33000-g43898
## `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 built 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 in the search.
## `keywords` (type: `array`):
Keep only listings whose description or location contains at least one of these words (e.g. terrasse, jardin, ascenseur).
## `scrapeDetails` (type: `boolean`):
Open each listing's page to also extract the owner's phone number, the full street address and the complete description. Slower and fetches one page per listing, but gives you direct owner contact for lead generation. Off = fast, list-only.
## `maxResults` (type: `integer`):
Stop after this many listings across all search URLs.
## `maxPagesPerUrl` (type: `integer`):
Safety cap on pagination depth per search URL (PAP shows ~30 listings per page).
## Actor input object example
```json
{
"searchUrls": [
"https://www.pap.fr/annonce/vente-appartements-aix-en-provence-13-g11424"
],
"propertyTypes": [],
"keywords": [],
"scrapeDetails": false,
"maxResults": 500,
"maxPagesPerUrl": 20
}
```
# Actor output Schema
## `listings` (type: `string`):
All scraped PAP 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"searchUrls": [
"https://www.pap.fr/annonce/vente-appartements-aix-en-provence-13-g11424"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("tagadanar/french-real-estate-pap").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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "searchUrls": ["https://www.pap.fr/annonce/vente-appartements-aix-en-provence-13-g11424"] }
# Run the Actor and wait for it to finish
run = client.actor("tagadanar/french-real-estate-pap").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.pap.fr/annonce/vente-appartements-aix-en-provence-13-g11424"
]
}' |
apify call tagadanar/french-real-estate-pap --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=tagadanar/french-real-estate-pap",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "PAP Real Estate Listings — Owner-Direct Sales & Rentals",
"description": "French property listings from PAP (Particulier à Particulier) — owner-direct sale & rental ads, no agencies. Paste a PAP search URL; get price, surface, rooms, €/m², DPE, description & photos per listing. For search, market analysis, lead sourcing & AI agents (API + MCP).",
"version": "0.1",
"x-build-id": "b6yxSbcPMNkdSPHPe"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/tagadanar~french-real-estate-pap/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-tagadanar-french-real-estate-pap",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/tagadanar~french-real-estate-pap/runs": {
"post": {
"operationId": "runs-sync-tagadanar-french-real-estate-pap",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/tagadanar~french-real-estate-pap/run-sync": {
"post": {
"operationId": "run-sync-tagadanar-french-real-estate-pap",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"searchUrls"
],
"properties": {
"searchUrls": {
"title": "PAP search URLs",
"type": "array",
"description": "One or more pap.fr search-result URLs. Build the search you want on pap.fr (city, sale/rental, property type, price/surface filters), then copy the page URL and paste it here. All result pages are followed automatically. Example: https://www.pap.fr/annonce/vente-appartements-bordeaux-33000-g43898",
"items": {
"type": "string"
}
},
"minPrice": {
"title": "Minimum price (€)",
"minimum": 0,
"type": "integer",
"description": "Keep only listings at or above this price."
},
"maxPrice": {
"title": "Maximum price (€)",
"minimum": 0,
"type": "integer",
"description": "Keep only listings at or below this price."
},
"minSurface": {
"title": "Minimum surface (m²)",
"minimum": 0,
"type": "integer",
"description": "Keep only listings with at least this built surface."
},
"minRooms": {
"title": "Minimum rooms",
"minimum": 0,
"type": "integer",
"description": "Keep only listings with at least this many rooms (pièces)."
},
"propertyTypes": {
"title": "Property types",
"type": "array",
"description": "Keep only these property types. Empty = all types found in the search.",
"items": {
"type": "string",
"enum": [
"Appartement",
"Maison",
"Terrain",
"Immeuble",
"Local commercial",
"Parking / Box"
],
"enumTitles": [
"Apartment",
"House",
"Land",
"Building",
"Commercial",
"Parking / Box"
]
},
"default": []
},
"keywords": {
"title": "Keywords",
"type": "array",
"description": "Keep only listings whose description or location contains at least one of these words (e.g. terrasse, jardin, ascenseur).",
"default": [],
"items": {
"type": "string"
}
},
"scrapeDetails": {
"title": "Scrape owner phone & full address (detail pages)",
"type": "boolean",
"description": "Open each listing's page to also extract the owner's phone number, the full street address and the complete description. Slower and fetches one page per listing, but gives you direct owner contact for lead generation. Off = fast, list-only.",
"default": false
},
"maxResults": {
"title": "Max listings",
"minimum": 1,
"maximum": 50000,
"type": "integer",
"description": "Stop after this many listings across all search URLs.",
"default": 500
},
"maxPagesPerUrl": {
"title": "Max pages per search URL",
"minimum": 1,
"maximum": 200,
"type": "integer",
"description": "Safety cap on pagination depth per search URL (PAP shows ~30 listings per page).",
"default": 20
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```