PAP.fr Real Estate Scraper

Scrape property listings from PAP.fr (Particulier à Particulier) — France's leading peer-to-peer real estate platform. Extract properties for sale or rent with full details including price, area, rooms, images, and seller type.

Features

• French Real Estate Data: Access thousands of PAP.fr listings without agency fees
• Sale & Rental Support: Search both vente (sale) and location (rental) listings
• Multi-Property Types: Apartments, houses, land, commercial properties, buildings
• Rich Data Extraction: Title, price, area, rooms, bedrooms, address, images, seller type, publication date, energy class
• Seller Detection: Automatically identifies particulier (private) vs professionnel (agency) sellers
• Smart Filtering: Price range, area range filters built-in
• Anti-Detection: Random delays, user agent rotation, stealth scripts, session management
• Residential Proxy: PAP.fr now blocks plain requests with a 403 — a residential proxy is used by default to get real results
• JSON-LD Extraction: Uses structured data from detail pages for maximum reliability
• Infinite Scroll: Handles PAP's dynamic content loading
• Duplicate Prevention: Deduplicates listings across multiple search queries

Use Cases

• Property market analysis — aggregate pricing data across French cities
• Investment screening — find properties matching specific criteria
• Market monitoring — track new listings and price changes
• Competitive intelligence — analyze seller types and market composition
• Lead generation — identify private sellers vs agency listings

Input

Parameter	Type	Required	Default	Description
locations	string[]	Yes	—	French locations to search (e.g., "Paris", "Lyon 69", "Bordeaux 33001")
propertyTypes	string[]	No	["appartement", "maison"]	Property types: appartement, maison, terrain, local-commercial, immeuble
listingType	string	No	"vente"	"vente" for sale, "location" for rental
minPrice	number	No	0	Minimum price in euros (0 = no minimum)
maxPrice	number	No	0	Maximum price in euros (0 = no maximum)
minArea	number	No	0	Minimum surface area in m²
maxArea	number	No	0	Maximum surface area in m²
maxResults	number	No	20	Max results per location/type combination (1-200)
maxConcurrency	number	No	2	Concurrent browser pages (1-10)
delayMin	number	No	2000	Min delay between requests in ms
delayMax	number	No	5000	Max delay between requests in ms
debugMode	boolean	No	false	Enable verbose logging

Output

Each listing includes:

{
  "title": "Vente appartement 2 pièces 40,86 m² Arpajon (91290)",
  "price": 154900,
  "area": 40.86,
  "rooms": 2,
  "bedrooms": 1,
  "address": "Rue Marcelle Gourmelon, 91290 Arpajon",
  "location": "Arpajon",
  "postalCode": "91290",
  "department": null,
  "propertyType": "apartment",
  "listingType": "sale",
  "url": "https://www.pap.fr/annonces/appartement-arpajon-91290-r463100431",
  "images": [
    "https://cdn.pap.fr/photos/pap/c2/0e/c20ecaea1806e710aa355a5b930ce7ea/c-p1.jpg"
  ],
  "sellerType": "particulier",
  "publicationDate": "28 juin 2026",
  "description": "T2 à Arpajon, proche de toutes les commodités...",
  "energyClass": "C",
  "gesClass": null,
  "scrapedAt": "2026-07-04T12:00:00.000Z"
}

Example Runs

Sale apartments in Paris

{
  "locations": ["Paris 75"],
  "propertyTypes": ["appartement"],
  "listingType": "vente",
  "maxResults": 50
}

Rental houses in Lyon under 1500€

{
  "locations": ["Lyon 69"],
  "propertyTypes": ["maison"],
  "listingType": "location",
  "maxPrice": 1500,
  "maxResults": 30
}

Multi-city land search

{
  "locations": ["Bordeaux 33", "Toulouse 31", "Nantes 44"],
  "propertyTypes": ["terrain"],
  "listingType": "vente",
  "minArea": 200,
  "maxResults": 20
}

Technical Details

• Base URL: https://www.pap.fr
• URL Patterns:
  • Sale: /annonce/vente-{type}s-{location}-g{id}
  • Rental: /annonce/location-{type}s-{location}-g{id}
  • Detail: /annonces/{type}-{city}-{postal}-r{id}
• Data Sources: HTML parsing + JSON-LD structured data extraction
• Anti-Detection: Navigator overrides, user agent rotation, randomized delays
• Residential Proxy: used by default (proxyConfiguration input) since PAP.fr blocks plain requests with a 403

💰 Pricing

Pay-per-use, no monthly fees:

	Price
Actor start	$0.01
Per result	$0.01

💡 Example: A run returning 500 results costs $5.01 total ($0.01 start + 500 × $0.01).

Development

# Install dependencies
npm install

# Run tests
npm test

# Run locally with Apify CLI
apify call -i input.json

# Build Docker image
docker build -t pap-scraper .

Keywords

PAP, pap.fr, immobilier, particulier à particulier, French real estate, property scraper, sale, rental, apartments, houses, Playwright, Apify, scraper, France, property listing