PAP.fr Real Estate Scraper

Scrape PAP.fr (particulier à particulier) real estate listings with full search filters. PAP.fr is France's largest private seller real estate platform — no agency fees.

Returns clean JSON with images, location, description, price per m², and 200 listings/run in under 60 seconds.

Proxies are already included — nothing to configure, works out of the box.

---

Input

Parameter	Type	Required	Default	Description
city	string	✅	—	City, arrondissement or postcode: Paris 15, 75015, Lyon 6, Marseille 8, Bordeaux
transaction	string	—	vente	vente (sale) or location (rental)
types	array	—	["maison"]	Property types (see list below)
pieces	array	—	—	Room filter. [3] = 3 rooms, [2,3,4] = 2, 3 or 4 rooms
chambresMin	integer	—	—	Minimum bedrooms
prixMin	integer	—	—	Minimum price (€)
prixMax	integer	—	—	Maximum price (€)
surfaceMin	integer	—	—	Minimum living area (m²)
surfaceMax	integer	—	—	Maximum living area (m²)
terrainMin	integer	—	—	Minimum land area (m²)
terrainMax	integer	—	—	Maximum land area (m²)
tags	array	—	—	Feature filters (see list below)
neufExclus	boolean	—	false	Exclude new construction
maxAds	integer	—	100	Maximum ads to collect (1–2000)
delay	float	—	1.5	Seconds between page requests

Property Types (types)

maison, appartement, terrain, garage-parking, immeuble, surface-a-amenager, peniche, mobil-home, viager, bureaux, local-commercial, fonds-de-commerce, local-d-activite

Tags (tags)

ascenseur, balcon-terrasse, duplex-triplex, dernier-etage, piscine, garages-parkings, acces-handicape, investissement-locatif, visite-virtuelle

Example Input

{
  "city": "Paris 15",
  "transaction": "vente",
  "types": ["appartement"],
  "pieces": [3, 4],
  "chambresMin": 2,
  "prixMax": 800000,
  "surfaceMin": 60,
  "tags": ["ascenseur", "balcon-terrasse"],
  "maxAds": 100,
  "delay": 1.5
}

---

Output

Each item represents one listing. Fields:

Field	Type	Description
id	string	PAP listing ID
url	string	Direct URL to the ad on pap.fr
badge	string	prix_en_baisse, exclusif, moins_cher, negociation or empty
price_eur	integer	Price in euros
price_per_m2	integer	Price per m² (computed: price_eur / surface_m2)
rooms	integer	Number of rooms (pièces)
bedrooms	integer	Number of bedrooms (chambres)
surface_m2	integer	Living area in m²
tags_raw	array	Raw tags from the listing (e.g. ["5 pièces", "3 chambres", "120 m²"])
location	object	city, zipcode, raw
description	string	Ad description text (excerpt)
images	object	count, thumbnail URL, urls array of all photos
rank	integer	Position in results (1 = first)

Example Output Item

{
  "id": "458401397",
  "url": "https://www.pap.fr/annonces/maison-marseille-10e-13010-r458401397",
  "badge": "prix_en_baisse",
  "price_eur": 380000,
  "price_per_m2": 2676,
  "rooms": 6,
  "bedrooms": 4,
  "surface_m2": 142,
  "tags_raw": ["6 pièces", "4 chambres", "142 m²"],
  "location": {
    "city": "Marseille 10E",
    "zipcode": "13010",
    "raw": "Marseille 10E (13010)"
  },
  "description": "Proche commerces et transports. Jolie maison d'une surface habitable de 142m2...",
  "images": {
    "count": 21,
    "thumbnail": "https://cdn.pap.fr/photos/pap/2b/2d/.../2-p2.webp",
    "urls": [
      "https://cdn.pap.fr/photos/pap/2b/2d/.../2-p2.webp",
      "https://cdn.pap.fr/photos/pap/36/c4/.../3-p2.webp"
    ]
  },
  "rank": 1
}

---

URL Format

This actor uses PAP.fr's path-encoded URL format (not query params), which matches the URLs used natively by the website when browsing with filters:

/annonce/vente-appartements-ascenseur-balcon-terrasse-paris-15e-g37782
         -3-ou-4-pieces-a-partir-de-2-chambres
         -jusqu-a-800000-euros-a-partir-de-60-m2

This ensures results are identical to what a real user would see on the site.

---

Proxy

Proxies are already included — nothing to configure.

---

Technical Notes

• Pagination: follows #pagination-next anchor href — PAP.fr uses path-based pagination, not ?page=N
• Images: all photo URLs are embedded in page HTML, no additional requests needed
• Promo filter: promotional/partner cards are automatically excluded (only real r\d+ listing URLs kept)
• Deduplication: ads are deduplicated by listing ID across pages
• Price per m²: computed and added automatically as price_per_m2

---

Supported Cities

100+ entries including all Paris, Lyon and Marseille arrondissements:

• Paris / Paris 1 … Paris 20 / 75001 … 75020
• Lyon / Lyon 1 … Lyon 9 / 69001 … 69009
• Marseille / Marseille 1, Marseille 2, Marseille 8 / 13001…
• Bordeaux, Toulouse, Nice, Nantes, Strasbourg, Montpellier
• Lille, Rennes, Grenoble, Toulon, Aix-en-Provence
• Brest, Le Havre, Dijon, Angers, Nîmes, Versailles…

---

Keywords

PAP.fr scraper, PAP immobilier, particulier à particulier, French real estate scraper, immobilier France, scrape PAP.fr, PAP appartement, PAP maison, PAP annonces, pap.fr API, real estate France API, annonces immobilières, vente appartement Paris, location maison Lyon, achat immobilier Marseille, prix immobilier France, immobilier sans agence, prix au m² Paris, scraping immobilier, property scraper France, French housing data, real estate leads France, Paris apartment listings, Lyon real estate data, Bordeaux property search, Toulouse housing, Nice immobilier, Nantes appartements, Strasbourg maison, Montpellier immobilier, Lille location, Rennes vente, Grenoble immobilier, Toulon appartement, Aix-en-Provence maison, extract real estate listings, automate PAP search, PAP.fr automation, prix en baisse immobilier, balcon terrasse Paris, ascenseur appartement, dernier étage, visite virtuelle, piscine maison, PAP API alternative, real estate data extraction, French property data, arrondissement Paris immobilier, scraper annonces, immobilier scraping Python, Apify real estate actor