# PAP Universal Scraper (`scrapifier/pap-universal-scraper`) Actor
🏠 Scrape PAP (pap.fr) private-seller real-estate listings by filters — rent or buy. Get price, surface, rooms, DPE/energy, photos and location, as clean structured data. Pay per result.
- **URL**: https://apify.com/scrapifier/pap-universal-scraper.md
- **Developed by:** [Scrapifier](https://apify.com/scrapifier) (community)
- **Categories:** Real estate
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $0.61 / 1,000 results
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 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/docs.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Scraper
Extract PAP (pap.fr) private-seller real-estate listings by filters — rent or buy — and export them as structured JSON, CSV or Excel. No code required.
[](https://apify.com/scrapifier/pap-universal-scraper)
### 📋 Contents
- [Overview](#-overview)
- [How to use](#-how-to-use)
- [Input](#-input)
- [Output](#-output)
- [Pricing](#-pricing)
- [Proxy and performance](#-proxy-and-performance)
- [Integrations](#-integrations)
- [Related Actors](#-related-actors)
- [FAQ](#-faq)
- [Support](#-support)
### 📖 Overview
Search PAP — France's leading **private-seller** (no agency) real-estate site — for rentals or sales by location, price, surface, rooms and bedrooms. For each listing you get the price, surface, rooms, bedrooms, DPE/energy rating, description, photos and location.
- Search with **friendly filters** — transaction, locations, property types, price, surface, rooms.
- Locations resolve **automatically** to PAP zones (cities, departments or postal codes).
- **Private-seller** listings — buy or rent directly from owners.
- Rich data — price, surface, rooms, DPE, description and all photos.
- Exports to JSON, CSV, Excel, or the Apify dataset API.
- Pay per result — no subscription.
### 🚀 How to use
1. Pick **Buy** or **Rent**, add one or more **locations** (cities, departments or postal codes), and set property types, price, surface and rooms.
2. Set **Max results** (`0` = everything).
3. Start the run.
4. Download your data from the **Storage** tab, or fetch it from the API.
### 📥 Input
| Field | Key | Type | Default | Description |
|---|---|---|---|---|
| Transaction | `transaction` | select | `buy` | Buy (sale) or rent. |
| Locations | `locations` | array | `["Bordeaux"]` | Cities, departments or postal codes. |
| Property types | `property_types` | select (multi) | flat + house | Flat, house, land, building… |
| Min / Max price | `price_min` / `price_max` | integer | — | Sale price or monthly rent, in €. |
| Min / Max surface | `surface_min` / `surface_max` | integer | — | Living surface in m². |
| Min rooms / bedrooms | `rooms_min` / `bedrooms_min` | integer | — | Minimum rooms (pièces) / bedrooms. |
| Max results | `max_results` | integer | `100` | Listings to collect. `0` = as many as possible. |
| Proxy configuration | `proxyConfiguration` | object | Residential / FR | Residential FR recommended. |
Example input
```json
{
"transaction": "buy",
"locations": ["Bordeaux"],
"property_types": ["appartement"],
"price_max": 300000,
"rooms_min": 2,
"max_results": 100
}
````
### 📤 Output
Each listing is stored as one dataset item. Export it as JSON, CSV or Excel, or read it from the API.
| Field | Description |
|---|---|
| `id` | PAP listing ID |
| `url` | Direct link to the listing |
| `transaction` | buy or rent |
| `propertyType` | appartement, maison, terrain… |
| `price` | Price in € (sale price or monthly rent) |
| `priceReduced` | Whether the price was recently reduced |
| `surfaceArea` | Living surface in m² |
| `rooms` / `bedrooms` | Number of rooms (pièces) and bedrooms |
| `energyClassification` | DPE / energy rating (A–G) |
| `city` / `postalCode` | Location |
| `description` | Listing description |
| `photos[]` / `photoCount` | Photo URLs and count |
Example output
```json
{
"id": "462200835",
"url": "https://www.pap.fr/annonces/appartement-bordeaux-33000-r462200835",
"transaction": "buy",
"propertyType": "appartement",
"price": 195000,
"priceReduced": true,
"surfaceArea": 45,
"rooms": 2,
"bedrooms": 1,
"energyClassification": "D",
"city": "Bordeaux",
"postalCode": "33000",
"photoCount": 12
}
```
### 💰 Pricing
**$0.90 per 1,000 listings.** No subscription — you pay only for the results you extract. New Apify users can try the Actor with their free monthly platform credits.
### 🛡️ Proxy and performance
- Use Apify residential proxies (country FR) for reliable runs — recommended, since pap.fr limits rapid requests.
- Start with a small **Max results** to validate your filters, then increase it.
- Add several locations in one run to cover multiple cities at once.
- The Actor paces its requests automatically to stay reliable.
### 🔌 Integrations
Run the Actor from the [Apify API](https://docs.apify.com/api/v2), the [JavaScript](https://docs.apify.com/sdk/js) or [Python](https://docs.apify.com/sdk/python) clients, or connect it to Make, Zapier, n8n, Google Sheets and Slack through Apify integrations. Each run's data is available as JSON or CSV via the dataset API.
### 🔗 Related Actors
- [Bienici Universal Scraper](https://apify.com/scrapifier/bienici-universal-scraper) — real-estate listings from Bien'ici.
- [SeLoger Universal Scraper](https://apify.com/scrapifier/seloger-universal-scraper) — real-estate listings from SeLoger.
- [Leboncoin Real Estate](https://apify.com/scrapifier/leboncoin-universal-scraper-real-estate) — Leboncoin real estate by filters.
Need another marketplace? Open an issue.
### ❓ FAQ
**What makes PAP different?**
PAP (Particulier à Particulier) lists properties sold or rented **directly by owners**, with no agency fees — a great source for private-seller deals.
**How do I target a specific area?**
Add cities, departments or postal codes in **Locations** — each is resolved automatically to its PAP zone. Add several to cover multiple areas in one run.
**How fresh is the data?**
It is collected live at runtime.
### 💬 Support
Questions or issues? Post them in the **Issues** tab and I will respond quickly. If the Actor is useful to you, a review is appreciated.
# Actor input Schema
## `transaction` (type: `string`):
Whether to scrape properties for sale or for rent.
## `locations` (type: `array`):
Cities, departments or postal codes (e.g. Bordeaux, Paris, 33000). Each is resolved automatically to its PAP zone.
## `property_types` (type: `array`):
One or more property types. Empty = flats and houses.
## `price_min` (type: `integer`):
Lowest price to include, in € (monthly rent or sale price).
## `price_max` (type: `integer`):
Highest price to include, in €.
## `surface_min` (type: `integer`):
Minimum living surface in m².
## `surface_max` (type: `integer`):
Maximum living surface in m².
## `rooms_min` (type: `integer`):
Minimum number of rooms (pièces).
## `bedrooms_min` (type: `integer`):
Minimum number of bedrooms.
## `max_results` (type: `integer`):
How many listings to collect (0 = as many as possible).
## `emit_input_status` (type: `boolean`):
Add an input\_status report to the run's OUTPUT record.
## `proxyConfiguration` (type: `object`):
Recommended — a residential proxy (country FR) keeps runs reliable, since pap.fr limits rapid requests.
## Actor input object example
```json
{
"transaction": "buy",
"locations": [
"Bordeaux"
],
"max_results": 100,
"emit_input_status": true,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "FR"
}
}
```
# Actor output Schema
## `listings` (type: `string`):
All PAP listings extracted by this run.
# 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 = {
"locations": [
"Bordeaux"
],
"max_results": 100,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "FR"
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapifier/pap-universal-scraper").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 = {
"locations": ["Bordeaux"],
"max_results": 100,
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "FR",
},
}
# Run the Actor and wait for it to finish
run = client.actor("scrapifier/pap-universal-scraper").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 '{
"locations": [
"Bordeaux"
],
"max_results": 100,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "FR"
}
}' |
apify call scrapifier/pap-universal-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapifier/pap-universal-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "PAP Universal Scraper",
"description": "🏠 Scrape PAP (pap.fr) private-seller real-estate listings by filters — rent or buy. Get price, surface, rooms, DPE/energy, photos and location, as clean structured data. Pay per result.",
"version": "0.1",
"x-build-id": "2OkM4fcoewM6odIT3"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapifier~pap-universal-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapifier-pap-universal-scraper",
"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/scrapifier~pap-universal-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapifier-pap-universal-scraper",
"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/scrapifier~pap-universal-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapifier-pap-universal-scraper",
"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",
"properties": {
"transaction": {
"title": "Transaction",
"enum": [
"buy",
"rent"
],
"type": "string",
"description": "Whether to scrape properties for sale or for rent.",
"default": "buy"
},
"locations": {
"title": "Locations",
"type": "array",
"description": "Cities, departments or postal codes (e.g. Bordeaux, Paris, 33000). Each is resolved automatically to its PAP zone.",
"items": {
"type": "string"
}
},
"property_types": {
"title": "Property types",
"type": "array",
"description": "One or more property types. Empty = flats and houses.",
"items": {
"type": "string",
"enum": [
"appartement",
"maison",
"terrain",
"immeuble",
"parking",
"local-commercial",
"boutique",
"bureau",
"chateau"
],
"enumTitles": [
"Flat / apartment",
"House",
"Land",
"Building",
"Parking / garage",
"Commercial premises",
"Shop",
"Office",
"Castle"
]
}
},
"price_min": {
"title": "Min price",
"minimum": 0,
"type": "integer",
"description": "Lowest price to include, in € (monthly rent or sale price)."
},
"price_max": {
"title": "Max price",
"minimum": 0,
"type": "integer",
"description": "Highest price to include, in €."
},
"surface_min": {
"title": "Min surface",
"minimum": 0,
"type": "integer",
"description": "Minimum living surface in m²."
},
"surface_max": {
"title": "Max surface",
"minimum": 0,
"type": "integer",
"description": "Maximum living surface in m²."
},
"rooms_min": {
"title": "Min rooms",
"minimum": 0,
"type": "integer",
"description": "Minimum number of rooms (pièces)."
},
"bedrooms_min": {
"title": "Min bedrooms",
"minimum": 0,
"type": "integer",
"description": "Minimum number of bedrooms."
},
"max_results": {
"title": "Max results",
"minimum": 0,
"type": "integer",
"description": "How many listings to collect (0 = as many as possible).",
"default": 100
},
"emit_input_status": {
"title": "Report empty searches",
"type": "boolean",
"description": "Add an input_status report to the run's OUTPUT record.",
"default": true
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Recommended — a residential proxy (country FR) keeps runs reliable, since pap.fr limits rapid requests.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "FR"
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```