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…