# SeLoger Scraper - Listings, Prices, DPE & Agency Phones (`scrapersdelight/seloger-scraper`) Actor

Scrape seloger.com listings for sale or rent by place, filters or search URL: price, price drops, €/m², rooms, bedrooms, floor, DPE, agency name, phones, RCS/SIRET, photos, dates. Past the 10,000-result limit, monitor mode, optional details with GPS and full text. No login.

- **URL**: https://apify.com/scrapersdelight/seloger-scraper.md
- **Developed by:** [Scrapers Delight](https://apify.com/scrapersdelight) (community)
- **Categories:** Real estate, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.72 / 1,000 listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does SeLoger Scraper do?

**SeLoger Scraper** extracts property listings from [seloger.com](https://www.seloger.com), France's best-known real-estate portal, for sale (achat) and for rent (location). Type a place, paste a SeLoger search URL or add listing links, and get one row per listing with price, price drops, €/m², rooms, area, floor, DPE energy class, agency name, phone numbers, RCS/SIRET and photos. Built for estate agents, property investors, proptech and lead-generation teams who need French housing data without copying pages by hand.

Also known as: SeLoger API, SeLoger.com scraper, SeLoger immobilier scraper, annonces immobilières scraper, French real estate scraper.

- **Search by place or by URL:** cities, arrondissements, postcodes, departments or regions ("Lyon", "Paris 15e", "13008", "Gironde"), or any SeLoger search page with its filters, sort, radius or drawn area.
- **Every SeLoger filter, applied by SeLoger:** buy or rent, property types, new build / resale / life annuity (viager), price, living area, land area, rooms, bedrooms, year built, DPE class, must-have features, furnished, private sellers only, keywords.
- **Agency contacts on the card:** agency name, named agent, phone numbers (also in international format), website, address, RCS and SIRET as separate fields.
- **Price history:** SeLoger's own previous price and percent change on reduced listings, plus a "price drops only" filter.
- **Past the 10,000-result limit:** SeLoger stops one search at 10,000 listings; SeLoger Scraper splits bigger searches into price bands automatically.
- **Listing details (optional):** GPS, district, full description, every feature, DPE kWh and CO₂, GES class, energy bill, heating, co-ownership charges, notary fees, deposit and tenant fees, rent control, SeLoger's local €/m² range, schools nearby.
- **Monitor mode:** schedule it and get only new or re-priced listings, with the price seen last time and the ids of listings that disappeared.
- **No login, no cookies, no SeLoger account.** Pay only for listings delivered; no start fee. Export as JSON, CSV or Excel, or use the API, schedules, webhooks and MCP.

### What data can you get from SeLoger?

<table>
<tr>
<td>🆔 Listing id, old numeric id, link</td>
<td>🏷️ Title, headline, description</td>
<td>💶 Price, €/m², rent with or without charges</td>
</tr>
<tr>
<td>📉 Previous price and % change (`previousPrice`)</td>
<td>🏠 Property type, new build, sale type</td>
<td>📐 Rooms, bedrooms, living area, land area</td>
</tr>
<tr>
<td>🏢 Floor and floors in the building</td>
<td>⚡ DPE energy class, year built, condition</td>
<td>📍 City, postcode, department, region, place codes</td>
</tr>
<tr>
<td>🚇 Nearby metro / tram / RER lines</td>
<td>🖼️ Photos, floor plans, 3D visit flag</td>
<td>📅 Published, updated, days online</td>
</tr>
<tr>
<td>🏢 Agency name, logo, profile, website</td>
<td>☎️ Phones (`phones`, `phonesE164`), named agent</td>
<td>🧾 RCS, SIRET, head office, fee schedule</td>
</tr>
<tr>
<td>🌐 GPS and district (details)</td>
<td>🔥 DPE kWh, CO₂, GES, energy bill, heating (details)</td>
<td>🏛️ Co-ownership lots, charges, procedures (details)</td>
</tr>
<tr>
<td>🧮 Notary fees, total project cost, mortgage estimate (details)</td>
<td>🔑 Deposit, tenant fees, rent control (details)</td>
<td>📊 SeLoger's local €/m² low / average / high (details)</td>
</tr>
</table>

Measured on the final build (2026-10-14) over 400 sale listings from four searches (Paris, Lyon, Gironde, Marseille) and 100 rentals in Toulouse: price, area, city, postcode, photos and dates on 100%; agency name on 97-100%; **phone numbers on 90-91%**; SIRET on 95-96%; DPE class on 83-86%; floor on 78-79%; a SeLoger price drop on 2-3%.

### How to scrape SeLoger with SeLoger Scraper

1. [Create a free Apify account](https://console.apify.com/sign-up) - it comes with monthly free credit, no card needed.
2. Open [SeLoger Scraper](https://apify.com/scrapersdelight/seloger-scraper) and click **Try for free**.
3. Type places into **Locations** and pick your filters, or paste a SeLoger search URL from your browser into **Search URLs**, or add listing links.
4. Set **Max listings** and click **Start**. Listings arrive in the dataset as they are read (up to 60 per request).
5. Open the **Storage** tab and **Export** as JSON, CSV or Excel - or add a schedule to run it every day.

### ⬇️ Input

| Parameter | Type | Description |
|---|---|---|
| **🔍 What to scrape** | | Use any mix; each place and each search URL is one search. |
| `locations` | List | Cities, arrondissements, postcodes, departments, regions: `Lyon`, `Paris 15e`, `13008`, `Gironde`. Resolved by SeLoger's own place search; a SeLoger place code (`AD08FR31096`) works too. Prefilled with `Paris`. |
| `searchUrls` | List | SeLoger search pages (`/classified-search?...`, `/classified-map?...`, `/recherche/...`, old `/immobilier/...` pages). Every filter, the sort and a radius or drawn area in the URL are applied. |
| `listingUrls` | List | Listing links or ids: `https://www.seloger.com/annonce/.../26I75TMMKBJK`, `26I75TMMKBJK`, or an old numeric id like `282291903`. |
| **🎯 Filters** (applied by SeLoger) | | For the places above; a search URL keeps its own filters. |
| `transactionType` | Select | `buy` (default) or `rent`. |
| `propertyTypes` | List | Apartment, House, Land, Parking, Building, Office, Shop, Storage, Restaurant / hotel, Agricultural, Other. Empty = apartments and houses. Prefilled with Apartment. |
| `projectTypes` | List | Resale, New build, Life annuity (viager). Empty = all three. |
| `priceMin` / `priceMax` | Integer | Sale price, or monthly rent. |
| `livingAreaMin` / `livingAreaMax`, `plotAreaMin` / `plotAreaMax` | Integer | Living area and land area in m². |
| `roomsMin` / `roomsMax`, `bedroomsMin` / `bedroomsMax` | Integer | Rooms (pièces) and bedrooms. |
| `yearBuiltMin` / `yearBuiltMax` | Integer | Year of construction. |
| `energyClasses` | List | DPE classes A-G to keep. |
| `features` | List | Must have: balcony / terrace, garden, parking, elevator, cellar, pool, fitted kitchen, wheelchair access, vacant, no agency fee, exclusive, houseboat. |
| `furnished` | Select | `any` (default), `furnished`, `unfurnished`. |
| `privateSellerOnly` | Boolean | Only private owners (particulier). Default: off. |
| `keywords` | List | Words the listing must mention, searched by SeLoger. |
| `sortBy` | Select | Relevance (default), newest, price, price per m², area, rooms. |
| `customCriteria` | JSON | Any other SeLoger search criterion, e.g. `{"buildState": ["Need_Of_Renovation"]}`. |
| **✂️ Refine results** | | Checked before anything is delivered or charged. |
| `excludeKeywords` | List | Drop listings whose title or description mentions a word. |
| `floorMin` / `floorMax` | Integer | Floor range (0 = ground floor). |
| `onlyWithPhone`, `onlyPriceDrops`, `only3DTour` | Boolean | Keep listings with a phone number / a SeLoger price drop / a 3D visit. Default: off. |
| `postedWithinDays` | Integer | Only listings first published in the last N days; searches then read newest first and stop at the cutoff. |
| **➕ Extra data** | | |
| `includeDetails` | Boolean | Listing details: GPS, full description, features, energy and charges (see pricing). Default: off. |
| **🔁 Monitoring** | | |
| `monitorMode` | Boolean | Only listings this monitor has not delivered before, plus re-priced ones. Default: off. |
| `monitorKey` | Text | Optional name for the monitor's memory. |
| **📦 Output** | | |
| `maxItems` | Integer | Most listings per run. Default `100` (prefill 20). |
| `maxItemsPerSearch` | Integer | Cap per place or search URL. |
| `splitLargeSearches` | Boolean | Read past 10,000 listings in price bands. Default: on. |
| `compact`, `descriptionMaxLength` | Boolean / Integer | Core fields only; cut long descriptions. |
| **⚙️ Advanced** | | |
| `proxyConfiguration` | Proxy | Optional. Leave empty: the actor picks its own route. |

#### Input JSON

```json
{
  "locations": ["Lyon", "Villeurbanne"],
  "transactionType": "buy",
  "propertyTypes": ["Apartment"],
  "priceMax": 350000,
  "roomsMin": 3,
  "energyClasses": ["A", "B", "C", "D"],
  "maxItems": 200
}
```

#### Paste the URL from your browser for anything the form does not have

Set the search up on seloger.com (place, every filter, sort, a radius or an area drawn on the map), copy the address bar and paste it into **Search URLs**. **Do:** `https://www.seloger.com/classified-search?distributionTypes=Buy&estateTypes=Apartment&locations=AD08FR31096&priceMax=500000` · **Don't:** paste a listing link there (`/annonce/...`) - listing links go in **Listing URLs or ids** (SeLoger Scraper moves them there for you if you do).

#### Type places the way SeLoger's search box understands them

`Lyon` is the city, `Lyon 3e` one arrondissement, `69003` a postcode, `Rhône` the whole department, `Auvergne-Rhône-Alpes` the region. When a name matches several places, the log shows which one was used and the alternatives.

#### Big searches: raise Max listings and leave Split large searches on

SeLoger serves at most 10,000 listings per search. Ask for more and SeLoger Scraper splits the search by price into pieces of up to 10,000 and reads each one; listings with no price cannot be reached that way and are counted in the run summary.

### ⬆️ Output

Every listing becomes one dataset item. A real row from the test run of the Paris search (trimmed):

```json
{
  "id": "26EM45VPKGLT",
  "url": "https://www.seloger.com/annonce/achat/ile-de-france/paris-75/paris-75000/26EM45VPKGLT",
  "title": "Appartement à vendre",
  "price": 290000, "pricePerM2": 18471.34,
  "previousPrice": 300000, "priceChangePercent": -3.33,
  "rooms": 1, "livingAreaM2": 15.7, "floor": 2, "totalFloors": 5,
  "city": "Paris 9ème arrondissement", "zipCode": "75009",
  "energyClass": "C", "yearBuilt": 1900,
  "sellerType": "pro", "agencyName": "BARNES PARIS 9-18e", "contactName": "Barnes Montmartre",
  "phones": ["0665467808"], "phonesE164": ["+33665467808"],
  "agencyRcs": "PARIS 894924448", "agencySiret": "89492444800018",
  "photoCount": 14, "publishedAt": "2026-09-24T11:26:00Z", "daysOnline": 19,
  "searchInput": "Paris", "searchTotal": 25461
}
```

With **Listing details** on, the same row gains the listing page's record (a Nantes sale from the test run, trimmed):

```json
{
  "latitude": 47.20939809474684, "longitude": -1.535093259789917, "district": "Ile Beaulieu",
  "energyClass": "C", "energyConsumptionKwhM2": 135, "gesClass": "A", "co2EmissionsKgM2": 4,
  "heating": "Chauffage individuel", "coOwnershipChargesPerYear": 1176,
  "notaryFees": 20000, "totalProjectCost": 270000, "monthlyMortgageEstimate": 1299,
  "marketPricePerM2": { "low": 2158, "average": 3371, "high": 4756 },
  "projectType": "RESALE", "agencyReference": "89bff1",
  "features": ["Exposition: sud, est", "Ascenseur", "Terrasse (Total 11 m²)", "Garage, Parking"]
}
```

#### Fields

Fill: **S** = 400 sale listings (Paris, Lyon, Gironde, Marseille), **R** = 100 rentals (Toulouse), **D** = 63 listings with details (33 sales, 30 rentals) - all from test runs of the final build.

| Field | Type | What it is | Fill |
|---|---|---|---|
| `id`, `legacyId`, `url` | string | SeLoger ids and link (new builds, house-and-land packages and luxury homes link to selogerneuf.com, seloger-construire.com, bellesdemeures.com) | 100% (`legacyId` 97-100%) |
| `title`, `headline`, `description` | string | Card title, headline, card text (full text with details) | 100% |
| `transactionType`, `propertyType`, `propertyTypeLabel`, `propertySubType` | string | buy / rent and the property type | 100%; sub-type 6-17% |
| `isNewBuild`, `newBuildProgram` | boolean / object | New build and its programme | S 20% |
| `price`, `priceFormatted`, `currency` | number / string | Sale price or monthly rent, EUR | 100% |
| `pricePerM2` | number | €/m² shown on sales | S 100% |
| `chargesIncluded` | boolean | Rentals: rent includes charges | R 96% |
| `previousPrice`, `priceChangePercent`, `priceTrend` | number / string | SeLoger's last price change | 2-3% (reduced listings) |
| `rooms`, `bedrooms`, `livingAreaM2`, `plotAreaM2` | number | Rooms, bedrooms, m² | rooms 99-100%, bedrooms 83-87%, area 100%, land 3-9% |
| `floor`, `totalFloors` | integer | Floor (0 = ground) and floors in the building | 78-79% / 40-62% |
| `availability`, `keyFacts` | string / list | Availability; the card's key facts | 9-15% / 100% |
| `city`, `zipCode`, `department`, `region`, `country`, `placeIds` | string / list | Place | 100% |
| `isAddressPublished` | boolean | Seller published the street address | 49-92% |
| `transportLines` | list | Nearby metro, tram, RER lines | S 24% (big cities) |
| `energyClass`, `yearBuilt`, `buildingState` | string / integer | DPE class, year built, condition | 83-86% / 29-59% / 26-53% |
| `isExclusive`, `isNew`, `has3DVisit` | boolean | Exclusive mandate, new on SeLoger, 3D visit | flags |
| `photoCount`, `images`, `floorplans` | integer / list | Photos and floor plans | 100% / floor plans 22-23% |
| `sellerType`, `publisherType` | string | pro or private; agency, developer, private | 100% |
| `agencyName`, `contactName` | string | Agency and named agent | 97-100% / 70-76% |
| `phones`, `phonesE164` | list | Phone numbers, each once, as published and as +33... | **90-91%** |
| `agencyWebsite`, `agencyProfileUrl`, `agencyAddress`, `agencyHeadOffice`, `agencyLogoUrl` | string | Agency links and address | 60-62% / 97-98% / 97-100% / 95-96% / 90-98% |
| `agencyLegalInfo`, `agencyRcs`, `agencySiret`, `agencyFeeUrl`, `agencyClientId` | list / string | Legal lines, RCS, SIRET, fee schedule, SeLoger client id | RCS 96-97%, SIRET 95-96%, fees 26-38% |
| `publishedAt`, `updatedAt`, `daysOnline` | string / integer | Dates (ISO) and days online | 100% |
| `source`, `searchInput`, `searchPosition`, `searchTotal`, `scrapedAt` | mixed | Which input produced the row; SeLoger's own total | 100% |
| `latitude`, `longitude`, `district` | number / string | GPS and district (details) | D 56% GPS (only where the listing has a map point), district 100% |
| `energyConsumptionKwhM2`, `finalEnergyKwhM2`, `co2EmissionsKgM2`, `gesClass`, `energyDiagnostic` | number / string | DPE values (details) | D 94% / 35% / 94% / 95% / 94% |
| `energyBillMinEur`, `energyBillMaxEur`, `heating`, `energySource` | number / string | Energy bill range, heating (details) | D 49% / 84% / 60% |
| `features`, `featureGroups` | list | Every feature on the listing page (details) | D 100% |
| `coOwnershipLots`, `coOwnershipChargesPerYear`, `coOwnershipProceedings` | number / string | Co-ownership (details, sales) | D sales 39% / 67% / 42% |
| `notaryFees`, `totalProjectCost`, `monthlyMortgageEstimate` | number | Sales costs (details) | D sales 100% |
| `priceExcludingFees`, `buyerAgencyFees`, `buyerAgencyFeesPercent` | number | Price before buyer-paid agency fees (details) | D sales 12% (when fees are paid by the buyer) |
| `lifeAnnuityMonthly` | number | Viager: monthly rent; `price` is then the bouquet (details) | on life-annuity listings |
| `securityDeposit`, `tenantAgencyFees`, `rentControl` | number / string | Rentals (details) | D rentals 100% / 100% / 37% |
| `marketPricePerM2` | object | SeLoger's local price (sales) or rent (rentals) per m²: low, average, high (details) | D 100% |
| `virtualTourUrls`, `schoolsNearby`, `agencyReference`, `projectType` | list / string | Tours, schools, agency reference, sale type (details) | D 70% / 89% / 100% / 100% |
| `changeType`, `previousSeenPrice`, `firstSeenAt` | string / number | Monitor mode | monitor runs |

### How can I use SeLoger data?

- 🏠 **Estate agents:** private-seller listings (particulier) every morning, competitor stock by agency and SIRET, listings that just dropped their price.
- 📈 **Investors and analysts:** asking €/m² by arrondissement, rent levels, days online and price cuts, DPE mix for rental-ban exposure (F and G).
- 🏗️ **Developers and builders:** land listings with area and price, new-build programmes and their pricing.
- 📞 **Lead-generation and proptech sales:** agencies with named agents, phone numbers, website, RCS and SIRET ready for a CRM.
- 🔔 **Buyers and relocation firms:** alerts for new listings matching exact criteria, with monitor mode and a schedule.
- 🤖 **AI agents and data teams:** a typed feed through the API or MCP, with `compact` output for short rows.

### How much does it cost to scrape SeLoger?

Pay per event, no start fee. Apify platform costs are included.

| Event | Price | When |
|---|---|---|
| Listing | $0.00072 ($0.72 per 1,000) | each listing delivered to your dataset |
| Listing details | $0.00062 | each delivered listing that carries the details, only with Listing details on |

| Run | Listings | Cost |
|---|---|---|
| Quick check (prefill) | 20 | $0.0144 |
| Typical search | 100 | $0.072 |
| Big export | 1,000 | $0.72 |
| 100 listings with details | 100 | $0.134 |

Filtered, duplicate, already-seen (monitor) and unreachable listings are never charged. You can cap the spend of any run with the **maximum cost per run** setting; SeLoger Scraper stops cleanly at it.

### Integrations, API, scheduling & MCP

- **Schedules:** run a search every hour or day and combine with **monitor mode** for new-listing and price-drop alerts.
- **Webhooks and apps:** Apify integrations with Make, Zapier, n8n, Google Sheets, Slack and email.
- **API:** start runs and read datasets from [Python](https://apify.com/scrapersdelight/seloger-scraper/api/python) or [JavaScript](https://apify.com/scrapersdelight/seloger-scraper/api/javascript) with `apify-client`.
- **MCP:** give AI assistants (Claude, Cursor, ChatGPT) live SeLoger search through the [Apify MCP server](https://apify.com/scrapersdelight/seloger-scraper/api/mcp).

### More French and property scrapers

- 🏷️ [Leboncoin Scraper](https://apify.com/scrapersdelight/leboncoin-scraper) - use it for private-seller real estate and every other leboncoin category.
- 📒 [PagesJaunes France Leads Scraper](https://apify.com/scrapersdelight/pagesjaunes-france-scraper) - use it for business phone numbers and SIRET by trade and town.
- 🏡 [Rightmove Scraper](https://apify.com/scrapersdelight/rightmove-scraper) - use it for UK property listings.
- ☀️ [Kyero Property Scraper](https://apify.com/scrapersdelight/kyero-property-scraper) - use it for Spanish and Portuguese property listings.

See every actor on [our profile](https://apify.com/scrapersdelight).

### Limits & empty runs

- **10,000 listings per search** is SeLoger's own limit; **Split large searches** (default) goes past it by price bands. Listings without a price fall outside the bands and are counted in the run summary.
- **Phones are the ones on the card:** agencies and agents show theirs on 90-91% of listings; private sellers mostly use SeLoger's contact form (phone on 11-15 of 30 private listings tested).
- **GPS comes with Listing details** and only where the listing has a map point (56% of 63 tested); otherwise SeLoger shows only the district area, so latitude and longitude stay empty rather than guessed.
- **Speed (test runs, before Apify's container start):** 20 listings in 3-5 s, 100 in 4-5 s, 1,000 in 19-27 s; Listing details add ~0.4 s per listing.
- **An empty run** means SeLoger had no listing matching the search (the run summary shows SeLoger's own total of 0) or a place could not be found (listed under `unresolvedInputs`). Nothing is charged.
- The run summary (`RUN_SUMMARY`) lists, per search, SeLoger's total, listings read and delivered, price bands, filtered and duplicate listings, and listing links that no longer exist.

### FAQ

#### How many listings can SeLoger Scraper get?

As many as your search holds. One SeLoger search serves 10,000 listings; with **Split large searches** on, SeLoger Scraper reads bigger searches in price bands. Our tests read 1,000 Marseille sale listings in 19-27 seconds.

#### Does SeLoger Scraper need a SeLoger account, login or API key?

No. It reads the same public listings a visitor sees, with no login, cookies or key.

#### Does SeLoger Scraper get the agency's phone number?

Yes, when the listing card shows it: 90-91% of listings in our tests, as published and in international format (`phonesE164`). Named agents (`contactName`), the agency website, RCS and SIRET come with the same row, no extra charge.

#### How do I get only new listings every day with SeLoger Scraper?

Turn on **Only new or re-priced listings** (monitor mode) and add a daily schedule. Each run delivers listings it has never delivered before plus listings whose price changed (`changeType`, `previousSeenPrice`), and once more with Listing details a listing an earlier run delivered without them (`changeType: "details"`); listings that disappeared are listed in the run's `OUTPUT`, free.

#### Can SeLoger Scraper scrape rentals (location) and new builds (neuf)?

Yes. Set **Buy or rent** to rent for rentals (with charges, deposit, tenant fees and rent control in the details), and pick **New build** under **Sale type** for new-build programmes; life annuities (viager) carry the monthly rent in `lifeAnnuityMonthly`.

#### How much does SeLoger Scraper cost?

$0.72 per 1,000 listings, no start fee, and $0.00062 per listing when you add Listing details. A 100-listing search costs $0.072.

#### Can I use SeLoger Scraper with the Apify API or from Python?

Yes. Start a run with `apify-client` (Python or JavaScript), pass the same JSON input, and read the dataset. See the **API** tab for ready-made code.

#### Can AI agents use SeLoger Scraper through MCP?

Yes. Add it to the Apify MCP server and an assistant can search SeLoger live; turn on **Compact rows** to keep rows short.

#### Why did my SeLoger Scraper run return no listings?

Your search matched nothing on SeLoger right now, a filter was too narrow, or a place name was not recognised - the run summary says which. Paste the same search URL into your browser to compare. Nothing is charged for an empty run.

#### Your feedback

Found a bug or need a field? Open an issue on the [Issues tab](https://apify.com/scrapersdelight/seloger-scraper/issues/open) - we read every one.

# Actor input Schema

## `locations` (type: `array`):

Cities, arrondissements, postcodes, departments or regions, resolved by SeLoger's own place search, e.g. "Lyon", "Paris 15e", "13008", "Gironde". A SeLoger place code (AD08FR31096) works too. One search per place.

## `searchUrls` (type: `array`):

SeLoger search pages with your filters applied, e.g. https://www.seloger.com/classified-search?distributionTypes=Buy\&estateTypes=Apartment\&locations=AD08FR31096 or a /recherche/... page. Every filter, the sort and a radius or drawn area in the URL are applied.

## `listingUrls` (type: `array`):

Listing pages or ids to look up, e.g. https://www.seloger.com/annonce/achat/ile-de-france/paris-75/paris-75000/26I75TMMKBJK, 26I75TMMKBJK or an old numeric id such as 282291903.

## `transactionType` (type: `string`):

Listings for sale or for rent.

## `propertyTypes` (type: `array`):

Empty = apartments and houses (SeLoger's default).

## `projectTypes` (type: `array`):

For sale searches. Empty = all three, as on SeLoger.

## `priceMin` (type: `integer`):

Sale price, or monthly rent for rentals.

## `priceMax` (type: `integer`):

Sale price, or monthly rent for rentals.

## `livingAreaMin` (type: `integer`):

Surface habitable, e.g. 40.

## `livingAreaMax` (type: `integer`):

Surface habitable, e.g. 120.

## `roomsMin` (type: `integer`):

French room count (pièces), e.g. 3 for a T3.

## `roomsMax` (type: `integer`):

French room count (pièces).

## `bedroomsMin` (type: `integer`):

Chambres.

## `bedroomsMax` (type: `integer`):

Chambres.

## `plotAreaMin` (type: `integer`):

Surface du terrain, for houses and land, e.g. 500.

## `plotAreaMax` (type: `integer`):

Surface du terrain.

## `yearBuiltMin` (type: `integer`):

Year of construction, e.g. 2015.

## `yearBuiltMax` (type: `integer`):

Year of construction, e.g. 1950.

## `energyClasses` (type: `array`):

Energy performance classes to keep, e.g. A and B.

## `features` (type: `array`):

Every one picked must be on the listing.

## `furnished` (type: `string`):

Mostly for rentals.

## `privateSellerOnly` (type: `boolean`):

Only listings posted by private owners (de particulier à particulier), no agencies.

## `keywords` (type: `array`):

Words the listing must mention, searched by SeLoger, e.g. "parking", "vue mer".

## `sortBy` (type: `string`):

Order SeLoger returns the listings in. "Newest" is SeLoger's own: by last update.

## `customCriteria` (type: `object`):

Any other SeLoger search criterion, as its search service takes it, e.g. {"buildState": \["Need_Of_Renovation"], "locationsInBuildingExcluded": \["Groundfloor"]}.

## `excludeKeywords` (type: `array`):

Drop listings whose title or description mentions any of these, e.g. "viager", "sous-sol".

## `floorMin` (type: `integer`):

0 = ground floor (RDC). Listings without a floor are dropped when set.

## `floorMax` (type: `integer`):

Listings without a floor are dropped when set.

## `onlyWithPhone` (type: `boolean`):

Keep listings whose card shows the agency's or agent's phone (agency listings mostly; private sellers use a contact form).

## `onlyPriceDrops` (type: `boolean`):

Keep listings SeLoger marks as reduced (previousPrice above the current price).

## `only3DTour` (type: `boolean`):

Keep listings tagged with a 3D visit.

## `postedWithinDays` (type: `integer`):

Keep listings first published in the last N days. Searches then read newest first and stop at the cutoff.

## `includeDetails` (type: `boolean`):

Reads each delivered listing's page record: GPS coordinates, district, full description, features list, DPE kWh and CO₂, GES class, energy bill, heating, co-ownership lots and charges, notary or tenant fees, deposit, market price per m², schools. Billed per listing that carries them.

## `monitorMode` (type: `boolean`):

Deliver only listings this monitor has not delivered before, plus known listings whose price changed (changeType, previousSeenPrice). Listings that disappeared are listed in OUTPUT, free.

## `monitorKey` (type: `string`):

Optional. Name the monitor to keep its memory when you edit the inputs; empty = one memory per set of inputs.

## `maxItems` (type: `integer`):

Most listings delivered in this run, across all searches. One SeLoger query stops at 10,000 results; bigger searches are split by price automatically.

## `maxItemsPerSearch` (type: `integer`):

Cap for each place or search URL. Empty = only the run cap.

## `splitLargeSearches` (type: `boolean`):

Read past SeLoger's 10,000-result limit by splitting the search into price bands. Off = stop at 10,000.

## `compact` (type: `boolean`):

Core fields only (id, url, price, area, rooms, floor, place, GPS, DPE, agency, phones, date): smaller rows for AI / MCP pipelines.

## `descriptionMaxLength` (type: `integer`):

Cut descriptions to this many characters. Empty = full text.

## `proxyConfiguration` (type: `object`):

Optional. Leave empty: the actor picks its own route (French residential exits, then Apify's unblocker). Set it only to use your own proxies.

## Actor input object example

```json
{
  "locations": [
    "Paris"
  ],
  "transactionType": "buy",
  "propertyTypes": [
    "Apartment"
  ],
  "furnished": "any",
  "privateSellerOnly": false,
  "sortBy": "Default",
  "onlyWithPhone": false,
  "onlyPriceDrops": false,
  "only3DTour": false,
  "includeDetails": false,
  "monitorMode": false,
  "maxItems": 20,
  "splitLargeSearches": true,
  "compact": false
}
```

# Actor output Schema

## `listings` (type: `string`):

The dataset of SeLoger listings (one item per listing).

## `summary` (type: `string`):

Per search: SeLoger's own total, listings read and delivered, price bands, criteria applied, lookups not found or unreachable, transport totals.

## `output` (type: `string`):

Delivered counts and, in monitor mode, the ids of listings that disappeared since the last run.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "locations": [
        "Paris"
    ],
    "propertyTypes": [
        "Apartment"
    ],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapersdelight/seloger-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "locations": ["Paris"],
    "propertyTypes": ["Apartment"],
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("scrapersdelight/seloger-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "locations": [
    "Paris"
  ],
  "propertyTypes": [
    "Apartment"
  ],
  "maxItems": 20
}' |
apify call scrapersdelight/seloger-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapersdelight/seloger-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/WyT3TIe1MhHpFJFAo/builds/DynAzPlKrWGqNoSwO/openapi.json
