# SeLoger Scraper (French Property) (`reventadata/seloger-scraper`) Actor

Extract SeLoger.com property listings for sale or rent: price, area, rooms, bedrooms, energy class, city and postcode, agency name with phone numbers and company registration (SIRET, RCS), photos and listing dates. Filter by location, type and price. Public pages, no login.

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

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

> **Unofficial.** This Actor is not affiliated with, authorised by, endorsed by, or in any
> way officially connected to SeLoger. "SeLoger" is a trademark of its respective owner
> and is used here only to describe what this tool reads. It reads the same public pages a
> browser does.

SeLoger Scraper reads property listings from [SeLoger.com](https://www.seloger.com), France's
real-estate portal, for sale or for rent: price, area, rooms, bedrooms, energy class, city and
postcode, the agency that published the listing with its phone numbers and public company
registration (SIRET, RCS), photos, and when the listing was created and updated.

### What data can you extract from SeLoger?

Every listing SeLoger returns for your search, with the fields the site itself publishes in
its search results. The Actor reads SeLoger's public search pages, so it
needs no browser and opens no listing pages.

Not in the search data, and therefore not in the rows: the street address, latitude and
longitude, and e-mail addresses.

### Why scrape SeLoger?

- **Sale and rent, apartments and houses**, for any French city or area SeLoger knows. Type a
  city name such as `Lyon`, or give a SeLoger place id such as `AD08FR31096` (Paris).
- **The site's own filters.** Price, rooms and surface limits and the sort order are sent to
  SeLoger, so only matching listings are fetched.
- **Agency details.** Agency name, profile page, website, address, the phone numbers the
  listing publishes, and the company lines the listing shows (legal form, head office, RCS,
  SIRET).
- **Sister portals included.** SeLoger searches also return listings of its sister portals
  (Belles Demeures, SeLoger Neuf, SeLoger Bureaux & Commerces). They stay in the results and
  carry a `portal` value so you can filter them; their `url` is on that portal's domain.
- **No duplicates.** SeLoger repeats a listing across a page boundary now and then; each id is
  returned once.

### How many results can one search return?

SeLoger serves at most 333 pages of 30 listings, 9,990 results, per search, however many
listings match (Paris apartments for sale matched 25,600 on 2026-11-08). The Actor logs a
warning when a search matches more than that. To reach the rest, split the search with the price,
rooms and surface limits or search a smaller area.

### How to scrape SeLoger

1. Enter a `location`, pick `transaction` (buy or rent) and `estateType`.
2. Optionally set price, rooms and surface limits and a sort order.
3. Run it. Results land in the dataset.

#### Input

| Field | Type | Meaning |
|---|---|---|
| `location` | string | French city or area name (`Lyon`), or a place id (`AD08FR28808`). A name is resolved with SeLoger's own place search, the first suggestion is used and logged. An unknown name stops the run with an error. |
| `transaction` | string | `buy` | `rent`. |
| `estateType` | string | `apartment` | `house`. |
| `priceMin`, `priceMax` | integer | Optional, EUR. On rent searches they limit the rent. Left out of the request when empty. |
| `roomsMin`, `roomsMax` | integer | Optional, number of rooms (pièces). |
| `spaceMin`, `spaceMax` | integer | Optional, living area in m². |
| `sortBy` | string | `relevance` | `priceAsc`. |
| `maxItems` | integer | Cap on rows. Default 1000. |
| `maxPages` | integer | Optional cap on pages, 30 listings each. |
| `proxyConfiguration` | object | Off by default. |

```json
{
    "location": "Lyon",
    "transaction": "rent",
    "estateType": "apartment",
    "priceMax": 1500,
    "sortBy": "priceAsc",
    "maxItems": 100
}
```

Rent searches return what SeLoger lists as rentals, which includes shared-flat rooms and small
storage units next to whole flats: the cheapest rows of a `priceAsc` rent search are such
listings (for example a 3 m² storage unit and rooms in shared flats). Filter on `propertySubType`,
`areaM2` or `rooms` if you only want whole flats.

#### Output

Each dataset item contains (all fields; a missing value is `null`, never 0):

| Field | Meaning |
|---|---|
| `id`, `legacyId`, `url`, `portal`, `title` | Listing identity. `portal` is `seloger`, `bellesdemeures`, `selogerneuf` or `selogerbureauxcommerces`. |
| `transaction`, `propertyType`, `propertySubType` | The site's own values, for example `BUY`, `APARTMENT`. |
| `price`, `currency`, `priceText`, `pricePeriod`, `chargesLabel`, `priceDetail`, `pricePerSquareMeter` | Numeric price, and the price text and small print as the site shows them. A price on request has `price` null. |
| `areaM2`, `plotAreaM2`, `rooms`, `bedrooms`, `floorText`, `availability`, `energyClass`, `yearBuilt` | Property facts. |
| `city`, `zipCode`, `district`, `isAddressPublished` | Location. |
| `headline`, `description` | Text; the site truncates the description in search results. |
| `publisherType`, `isPrivateOwner`, `agencyName`, `contactName`, `agencyProfileUrl`, `agencyWebsite`, `agencyAddress`, `phoneNumbers` | Who published it and how to reach them, as the listing shows them. |
| `agencyCompany`, `agencyHeadOffice`, `agencyRcs`, `agencySiret` | The agency's public company lines. |
| `isExclusive`, `isNew`, `has3DVisit`, `hasBrokerageFee`, `newBuildProgramTitle`, `newBuildProgramUrl` | The site's tags and, for new builds, the programme. |
| `imageUrls`, `floorplanUrls`, `createdAt`, `updatedAt`, `searchUrl` | Photos (agency logo excluded), floor plans, dates, the page-1 search URL. |

#### Sample output

A real row from a run on 2026-11-08 (Paris, buy, apartment), photo list shortened to one and the description cut:

```json
{
    "id": "262SHVPNZ1NL",
    "url": "https://www.seloger.com/annonce/achat/ile-de-france/paris-75/paris-75000/262SHVPNZ1NL",
    "portal": "seloger",
    "legacyId": "284812885",
    "title": "Appartement à vendre",
    "transaction": "BUY",
    "propertyType": "APARTMENT",
    "price": 415000,
    "currency": "EUR",
    "priceText": "415 000 €",
    "priceDetail": "8 830 €/m²",
    "pricePerSquareMeter": 8830,
    "areaM2": 47,
    "rooms": 2,
    "bedrooms": 1,
    "floorText": "Étage 4/6",
    "energyClass": "E",
    "yearBuilt": 1870,
    "city": "Paris 18ème arrondissement",
    "zipCode": "75018",
    "district": "Amiraux-Simplon-Poissonniers",
    "headline": "Appartement 2 pièces",
    "publisherType": "AGENCY",
    "agencyName": "CENTURY 21 - Paris 18e",
    "contactName": "Century 21 Sorim",
    "agencyProfileUrl": "https://www.seloger.com/professionnels-immobilier/TwerPBvAMcmVpxf4S2itf8",
    "phoneNumbers": ["0608656426"],
    "agencyCompany": "Société à responsabilité limitée (sans autre indication) SORIM 2000",
    "agencyHeadOffice": "43 RUE ORDENER, 75018 PARIS",
    "agencyRcs": "392496337",
    "agencySiret": "39249633700016",
    "createdAt": "2026-11-04T14:10:00Z",
    "updatedAt": "2026-11-05T02:16:40.199Z",
    "searchUrl": "https://www.seloger.com/classified-search?distributionTypes=Buy&estateTypes=Apartment&locations=AD08FR31096"
}
```

### How much does it cost?

Pay-per-event: **$0.001 per listing** saved to the dataset (**$1.00 per 1,000 listings**), plus **$0.00005** charged once when the run starts. No subscription. Each listing is saved once, so repeats are not charged.

### Privacy & compliance

This Actor reads only publicly accessible search pages and returns the public data they show:
listing facts and the business details agencies publish with their listings (name, phone,
company registration). It sends no login. It is not affiliated with
SeLoger. You are responsible for using the data in line with the site's terms and the law that
applies to you, including data-protection rules for any personal data in a row.

# Actor input Schema

## `location` (type: `string`):

A French city or area name as you would type it on seloger.com, for example "Lyon" or "Paris", or a SeLoger place id such as AD08FR31096 (Paris). A name is resolved with the site's own place search and the first suggestion is used, which is logged. An unknown name stops the run with an error.

## `transaction` (type: `string`):

Properties for sale (Achat) or for rent (Location).

## `estateType` (type: `string`):

Apartment or house. Other SeLoger categories were not tested and are not offered.

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

Optional. Lower price limit; on a rent search it limits the rent. Left out of the request when empty.

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

Optional. Upper price limit; on a rent search it limits the rent. Left out of the request when empty.

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

Optional. Fewest rooms (pièces). Left out of the request when empty.

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

Optional. Most rooms (pièces). Left out of the request when empty.

## `spaceMin` (type: `integer`):

Optional. Smallest living area in m². Left out of the request when empty.

## `spaceMax` (type: `integer`):

Optional. Largest living area in m². Left out of the request when empty.

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

The site's default order, or cheapest first.

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

Hard cap on rows pushed. The site serves at most 9,990 results per search; split bigger searches with the price, rooms or surface filters.

## `maxPages` (type: `integer`):

Optional cap on result pages (30 listings each). Without it the run walks every page the site reports for the search (at most 333), or stops at Maximum rows.

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

Optional. Left off by default; turn it on only if you see request failures.

## Actor input object example

```json
{
  "location": "Paris",
  "transaction": "buy",
  "estateType": "apartment",
  "sortBy": "relevance",
  "maxItems": 30,
  "maxPages": 1,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

Property listings: price, area, rooms, location, agency with phone and legal details, and a link to the ad.

# 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 = {
    "location": "Paris",
    "maxItems": 30,
    "maxPages": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("reventadata/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 = {
    "location": "Paris",
    "maxItems": 30,
    "maxPages": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("reventadata/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 '{
  "location": "Paris",
  "maxItems": 30,
  "maxPages": 1
}' |
apify call reventadata/seloger-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,reventadata/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/CBnNtLJLowSEFYijV/builds/qz6wrN6SPe6GwxOr5/openapi.json
