PAP.fr Scraper

Extract property listings from pap.fr: De Particulier à Particulier, France's largest owner-to-owner real-estate platform. Get fully-detailed listings with price, address, rooms, area, photo gallery, description, and arrondissement/department/region geography.

Why This Scraper?

• 20+ fields per listing. Price (numeric + formatted), rooms (pièces), living area, street address, postcode, city, arrondissement, department, region, full photo gallery, description, PAP reference number, and more.
• Two input modes. Pick a French city and department code from the form, or paste any pap.fr search URL you already refined in your browser.
• Rich filter set. Buy or rent, property type, minimum rooms (pièces), sort order — all passed straight to pap.fr so the results are exactly what the site would show.
• Auto pagination. Walks every result page forward to the limit you set.
• Both Buy (Vente) and Rent (Location). Apartments, houses, plots, parking, and commercial property.
• Owner-to-owner exclusive. PAP forbids agent listings — every record is a private-owner listing you won't find on the agent-heavy aggregators.

Data You Get

Field	Example
Title	Vente appartement 3 pièces 57 m² Paris 18E
Price	590 000 (numeric) + 590.000 € (formatted)
Rooms (pièces)	3
Living area	57 m²
Street address	Rue Muller, 75018 Paris
Postcode	75018
City	Paris 18e
Arrondissement	Paris 18e
Department	Paris
Region	Île-de-France
Reference	G17/2664 (PAP internal reference)
Latitude / Longitude	48.8358, 2.2899 (when fetchDetails=true)
Energy class (DPE)	A–G (when fetchDetails=true)
GHG class (GES)	A–G (when fetchDetails=true)
Active status	true live / false delisted (when fetchDetails=true)
Images	Full gallery, high-res URLs
Description	Full seller description (when fetchDetails=true)
Scraped at	ISO timestamp

How to Use

Search by Location

Enter a French city and its 2-digit department code. The scraper resolves the pap.fr geo-id automatically.

{
  "mode": "filter",
  "locations": [
    { "city": "Paris", "department": "75" }
  ],
  "listingType": "Buy",
  "propertyType": "Apartment",
  "maxPages": 10
}

Search with Filters

{
  "mode": "filter",
  "locations": [{ "city": "Lyon", "department": "69" }],
  "listingType": "Rent",
  "propertyType": "Apartment",
  "roomsMin": 3,
  "sortBy": "PriceAsc",
  "maxPages": 10
}

Multiple Cities

{
  "mode": "filter",
  "locations": [
    { "city": "Paris", "department": "75" },
    { "city": "Lyon", "department": "69" },
    { "city": "Marseille", "department": "13" },
    { "city": "Bordeaux", "department": "33" },
    { "city": "Nice", "department": "06" }
  ],
  "listingType": "Buy",
  "propertyType": "House",
  "maxPages": 5
}

Direct URLs with auto pagination

Refine a search in your browser (including price / surface filters which aren't exposed in the form here), copy the URL, paste it here. If the URL ends with -N (page number), scraping starts from page N and walks forward.

{
  "mode": "url",
  "urls": [
    "https://www.pap.fr/annonce/vente-appartements-paris-75-g439-3-pieces-tri-prix-asc"
  ],
  "maxPages": 20
}

Input Parameters

Parameter	Type	Default	Description
mode	string	filter	filter for city + department inputs, or url for direct URLs
locations	array	Paris / 75	City + 2-digit department pairs (Filter mode only)
urls	string[]	example URL	pap.fr search URLs (URL mode only); honors trailing -N as start page
listingType	string	Buy	Buy (Vente) or Rent (Location) — Filter mode only
propertyType	string	Apartment	Apartment, House, Plot, Parking, or CommercialProperty (Filter mode only)
roomsMin	number	no limit	Minimum pièces (1–5, where 5 means 5+) — Filter mode only
sortBy	string	Default	Default, PriceAsc, PriceDesc, SurfaceAsc, SurfaceDesc, DateAsc (Filter mode only)
maxPages	number	3	Max pages per search
maxListings	number	unlimited	Hard cap across the whole run
fetchDetails	boolean	false	Visit each listing's detail page for full description + street address + reference + high-res photo gallery
proxy	object	Apify RES + FR	Proxy config, French residential recommended

Output Example

{
  "id": "<listing-id>",
  "url": "<listing-url>",
  "listingType": "Buy",
  "propertyType": "Apartment",
  "title": "<listing-title>",
  "priceValue": 590000,
  "priceCurrency": "EUR",
  "priceDisplay": "590.000 €",
  "rooms": 3,
  "livingSpace": 57,
  "description": "<full seller description>",
  "streetAddress": "<street, postcode city>",
  "city": "<city>",
  "postcode": "<zip>",
  "arrondissement": "<arrondissement>",
  "department": "<department>",
  "region": "<region>",
  "latitude": 48.835767,
  "longitude": 2.289897,
  "energyClass": "D",
  "ghgClass": "D",
  "isActive": true,
  "reference": "<PAP reference>",
  "imageCount": 18,
  "images": ["<image-url-1>", "<image-url-2>"],
  "additionalProperties": {
    "Type de bien": "Appartement",
    "Ascenseur": "Oui"
  },
  "scrapedAt": "2026-04-22T10:00:00.000Z"
}

Plan requirement

This actor needs a residential proxy. Two options:

• Paid Apify plan (Starter and above). Keep the default. EU residential is preferred; FR may have issues, so the default pins IT.
• Bring your own proxy (any plan, including Free). Uncheck "Use Apify proxy" and paste your own residential URLs (Bright Data, Oxylabs, SmartProxy, IPRoyal, etc.).

If the primary proxy is unavailable, the scraper auto-falls back to a managed backup pool.

Common Department Codes

Code	Name	Biggest city
75	Paris	Paris
69	Rhône	Lyon
13	Bouches-du-Rhône	Marseille
33	Gironde	Bordeaux
06	Alpes-Maritimes	Nice
31	Haute-Garonne	Toulouse
59	Nord	Lille
44	Loire-Atlantique	Nantes
67	Bas-Rhin	Strasbourg
34	Hérault	Montpellier
35	Ille-et-Vilaine	Rennes
38	Isère	Grenoble

About

Built and maintained for reliable, cost-effective scraping of PAP.fr. Report any issues or ideas in the Apify Store listing.