| 🆔 Stable listing ID and URL | 💶 Price (vente) or monthly rent (location) |
| 📍 Postcode and city or arrondissement | 🛣️ Street (Full details) |
| 🏠 Property type and subtype | 📐 Living area and plot area (m²) |
| 🛏️ Rooms and bedrooms | ⚡ DPE energy label (A to G) |
| 📅 Publication date (Full details) | 📷 Photo URLs |
| 📝 Full description (Full details) | 🏷️ Status |
The search pages carry price, city, rooms, bedrooms, living area, DPE label and photos. **Description, street, publication date, plot area and full-size photos** come from the listing page and are only filled with the **Full details** add-on. PAP shows no coordinates, house number, bathroom count or construction year, and the seller's phone number only after a click on the site, so `lat`, `lon`, `house_number`, `bathrooms`, `construction_year`, `agent_phone` and the other agent fields are always `null`.
#### How do I scrape PAP listings?
1. [Create a free Apify account](https://console.apify.com/sign-up) and open this Actor.
2. Enter a **Location** (for example `Lyon` or `75015`), pick **Sale or rent** and, if you like, a property type and price range. Or paste one or more **Search URLs** copied from pap.fr.
3. Set **Max listings** (the most recent come first).
4. Click **Start**, then download the listings from the **Output** tab as JSON, CSV, Excel, XML or HTML.
#### How much does it cost to scrape PAP?
You pay per listing that ends up in your dataset: **$1.10 per 1,000 listings**, no subscription. The monthly credit of Apify's Free plan ($5) covers around 4,500 listings without add-ons. Paid plans get volume discounts.
- **Add-on: Full details, $2.00 per 1,000 listings** (off by default). Opens every listing's page and adds the description, street, publication date, plot area and all photos in full size. Charged only for listings that were actually enriched. It makes one extra request per listing, so it is much slower than the search itself.
- **Add-on: Price history, $1.00 per 1,000 listings** (off by default). Adds `first_seen_at`, `previous_price`, `price_change`, `price_change_pct`, `status_changed` and `price_history`. Charged only for listings that already had history from an earlier run, so the first run is free. See the *Price history* section below.
- Failed runs and empty searches cost nothing; you can cap spending with **Maximum cost per run** in the run options.
See the **Pricing** tab for the current prices.
#### ⬇️ Input
| Field | Description |
|---|---|
| **Location** (`location`) | City, arrondissement, department or postcode (required); several separated by commas |
| **Sale or rent** (`listing_type`) | `sale` (vente) or `rent` (location) |
| **Property type** (`property_type`) | `any`, `house`, `apartment`, `land`, `commercial` (offices), `parking` |
| **Minimum / maximum price** (`min_price`, `max_price`) | In euro; for rentals per month |
| **Minimum rooms** (`min_rooms`) | Number of rooms (pièces) |
| **Minimum living area** (`min_living_area_m2`) | In m²; listings without a known area are left out |
| **Search URLs** (`start_urls`) | Search pages copied from pap.fr; they replace the filters above |
| **Max listings** (`limit`) | Stop after this many listings |
| **Full details** (`includeDetails`) | Paid add-on: description, street, publication date, all photos |
| **Price history** (`trackHistory`) | Paid add-on: compare with your previous runs |
| **History store name** (`historyStoreName`) | Where the history is kept (default `realestate-history`) |
| **Proxy** (`proxyConfiguration`) | French residential proxy, preselected (Apify Residential, country FR). PAP blocks datacenter IPs |
```json
{
"location": "Lyon",
"listing_type": "sale",
"limit": 20
}
```
PAP always searches inside a place, so **Location** is required. With **Search URLs** paste a page like `https://www.pap.fr/annonce/vente-appartements-paris-75-g439-jusqu-a-500000-euros`; filters in the URL are kept and the page number is ignored. PAP applies price and area filters with a margin of about 10%: with the form fields the Actor sends them to PAP and then keeps only the listings that match **exactly**.
#### ⬆️ Output
Listings are stored in the default dataset, most recent first. View them as a table in the **Output** tab or export JSON, CSV, Excel, XML or HTML. Fields a listing does not have are `null`; every item has the same keys.
##### A listing with the Full details add-on
```json
{
"id": "pap:463301550",
"source": "pap",
"url": "https://www.pap.fr/annonces/appartement-lyon-2e-69002-r463301550",
"title": "Vente appartement 5 pièces 108 m² Lyon 2e (69002)",
"listing_type": "sale",
"property_type": "apartment",
"property_subtype": "appartement",
"status": "available",
"price": 649000,
"price_currency": "EUR",
"price_period": null,
"price_type": "asking",
"old_price": null,
"monthly_costs": null,
"address": "bis Rue Claudius Collonge, 69002 Lyon 2e",
"street": "bis Rue Claudius Collonge",
"house_number": null,
"postcode": "69002",
"city": "Lyon 2e",
"region": null,
"country": "FR",
"lat": null,
"lon": null,
"living_area_m2": 108,
"plot_area_m2": null,
"rooms": 5,
"bedrooms": 4,
"bathrooms": null,
"energy_label": "B",
"construction_year": null,
"listed_at": "2026-11-01",
"updated_at": null,
"agent_name": null,
"agent_phone": null,
"agent_url": null,
"image_urls": [
"https://cdn.pap.fr/photos/pap/24/02/2402b6b06c7cd0304e3ab126c3e6fe87/2-p1.jpg",
"https://cdn.pap.fr/photos/pap/13/dc/13dc0c67ace1eff615f3960978798803/1-p1.jpg",
"..."
],
"description": "**Appartement familial** situé au cœur du quartier Confluence, à proximité immédiate de Perrache, des transports et des commerces.\n\nAu 6ᵉ étage avec ascenseur d ...",
"scraped_at": "2026-11-01T11:07:09Z"
}
```
##### Extra fields with the Price history add-on
```json
{
"first_seen_at": "2026-10-23T07:00:12+00:00",
"previous_price": 575000,
"price_change": -25000,
"price_change_pct": -4.35,
"status_changed": false,
"price_history": [
{ "at": "2026-10-23T07:00:12+00:00", "price": 575000, "status": "available" },
{ "at": "2026-10-30T07:00:09+00:00", "price": 550000, "status": "available" }
]
}
```
#### What can I do with PAP data?
- 📉 **Price drop alerts**: schedule a run with **Price history** and get notified when `price_change` is negative; owners often lower their price after a few weeks
- 🏘️ **Market research**: asking prices and rents per m² on the private-seller market, per arrondissement or postcode
- 🔎 **Deal finding and investment**: find owners selling without an agency (vente entre particuliers), filter by price, area and DPE label (investissement locatif)
- 🧠 **AI and analytics**: feed descriptions and attributes into valuation models or LLM pipelines
#### Tips for best results
- **PAP shows at most 25 pages per search** (about 300-375 listings). To collect more, split the search by arrondissement or postcode, by property type or by price range and run them as several searches or **Search URLs**.
- Results come in PAP's default order, most recent publication first. PAP renews ads, so a renewed listing moves to the top; the order is roughly, not strictly, by date. There is no date in the search results: switch on **Full details** if you need `listed_at`.
- PAP only searches inside one place per search; several comma-separated locations run one search each, and duplicates are removed by listing ID.
- **Minimum rooms** is applied on the results (PAP only offers exact room counts), so a strict room filter can leave few listings per page.
- For a daily feed, schedule a run with a high **Max listings** and **Price history** switched on.
- Leave **Full details** off for counting, price monitoring and market research; switch it on when you need descriptions or the street.
- Results from one run are deduplicated by listing ID. New-build programmes advertised on PAP's partner site (immoneuf.com) are not included.
#### Price history
Switch on **Price history** (`trackHistory`) and the Actor remembers every listing between runs, so you can see price drops, status changes and how long a property has been on the market.
- **Where it lives.** History is kept in a *named key-value store in your own Apify account* (default name `realestate-history`, change it with **History store name**). Named stores never expire, you own the data, and storage costs a fraction of a cent.
- **First run starts the series.** The first time a listing is seen there is nothing to compare with, so `previous_price` is `null` and you are not charged for the add-on on that listing. From the second run on, each listing gets `first_seen_at`, `previous_price`, `price_change`, `price_change_pct`, `status_changed` and `price_history` (the last 20 price/status points, one point per change).
- **Run it on a schedule.** History only grows when you run the Actor. Create a [schedule](https://docs.apify.com/platform/schedules) (daily is typical) with the same search and the same store name.
- **One store, several Actors.** Every real-estate Actor we publish uses the same default store name, so a listing keeps one history even if you scrape it with a different one of our Actors. Item IDs start with the site (`pap:...`), so sites never clash. Use a different store name per search if you want separate series.
- **Do not run two runs on the same store at the same time.** Records are updated per listing and the last writer wins, so two parallel runs can overwrite each other's newest point. Run searches that share a store one after another.
- **If you delete the store,** the Actor starts a new empty history without an error.
- **Cost:** $1.00 per 1,000 listings that already had history (see pricing above).
#### Frequently asked questions
#### Can I use PAP Listings Scraper with the Apify API?
Yes. Every run has a dataset you can read through the [Apify API](https://docs.apify.com/api/v2). Python:
```python
from apify_client import ApifyClient
client = ApifyClient("