# SeLoger.com French Real Estate Scraper (`parseforge/seloger-scraper`) Actor

Scrapes SeLoger.com property listings by city, transaction type, or direct URL. Returns each listing as a flat row with price, surface, rooms, DPE, and description.

- **URL**: https://apify.com/parseforge/seloger-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Real estate, Automation, Other
- **Stats:** 14 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $11.70 / 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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### SeLoger.com French Real Estate Scraper

**Scrape French real estate listings from SeLoger.com by city, transaction type, or direct URL, up to a million per run.** Every listing returns its price, surface area, room count, DPE rating, and full description. No API key required. Export to CSV, JSON, Excel, or XML.

SeLoger.com is France's leading property portal, but manually collecting listings for market analysis or investment tracking is slow and repetitive. This Actor reads the public search results and listing pages directly, letting you filter by city and buy or rent, or target a precise search URL. It returns structured data ready for spreadsheets or databases, without needing to register an application or manage rate limits.

| Who uses it | What they scrape SeLoger for |
|---|---|
| Real estate investors | Monitor new listings in a target city to spot undervalued properties before they are widely seen. |
| Market analysts | Track price per square meter trends across different French departments over time. |
| PropTech startups | Feed a clean, structured dataset of active listings into an internal valuation model or app. |
| Rental seekers | Get alerted to new rental listings matching specific criteria in a competitive market like Paris or Lyon. |

### What it does

This Actor collects SeLoger.com real estate listings by city, transaction type, or direct search URL, and returns each property as a flat row.

- 🏙️ **City and transaction type search:** Provide a city slug like paris-75 and choose achat or locations to scrape the main search feed.
- 🔗 **Direct URL input:** Paste any SeLoger.com search URL to replicate exact filters, sorting, and map bounds.
- 📊 **Structured output:** Every listing is flattened into a consistent row with price, surface, rooms, DPE, description, and media counts.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with SeLoger data

**📈 Track market prices by city.**

A market analyst runs the Actor weekly on lyon-69 for achat to build a price-per-square-meter index and advise clients on fair market value.

**🏠 Find investment properties early.**

An investor scrapes new rental listings in bordeaux-33 daily, filtering for low price-to-surface ratios to identify cash-flow-positive opportunities.

**🔔 Monitor a competitive rental market.**

A relocation agent scrapes locations in paris-75 every hour to alert expat clients the moment a suitable apartment appears.

**🔍 Audit a specific search URL.**

A data journalist pastes a complex SeLoger URL with multiple filters to capture all listings matching an investigation's criteria in one structured export.

### Why choose this scraper

|  | What you get |
|---|---|
| **No API registration** | Access public listing data without an API key or OAuth flow. |
| **Flexible targeting** | Scrape by city slug or paste any custom search URL from SeLoger. |
| **Scalable collection** | Fetch up to a million listings in a single run for large-scale analysis. |

### How it compares

This Actor focuses on straightforward, high-volume SeLoger.com scraping by city or URL. The competitors below also target SeLoger, with some offering additional features like multi-source collection or per-result pricing models.

| Feature | ParseForge | SeLoger Scraper 💰 From $0.9/1K France Real Estate Extractor | SeLoger Scraper ❤️ $1.5/1K (by ads URLs) ⚡ | Pige Immo FR: LBC + SeLoger + PAP + Bien'ici Multi-Source |
|---|---|---|---|---|
| Scrape by city and transaction type | Yes | Not listed | Not listed | Yes |
| Scrape from a direct search URL | Yes | Yes | Yes | Not listed |
| Extract DPE energy rating | Yes | Yes | Yes | Yes |
| Multi-source (Leboncoin, PAP, Bien'ici) | Not listed | Not listed | Not listed | Yes |
| Export to Excel format | Yes | Yes | Not listed | Not listed |

### Configure the run

Drive the Actor from a city and transaction type, or a direct SeLoger.com search URL, and set a maximum number of listings to cap the run. The Input tab lists every parameter.

A first run with the defaults:

```json
{
  "startUrl": "https://www.seloger.com/immobilier/achat/immo-paris-75/",
  "maxItems": 10,
  "city": "paris-75"
}
```

A larger pull:

```json
{
  "startUrl": "https://www.seloger.com/immobilier/achat/immo-paris-75/",
  "maxItems": 200,
  "city": "paris-75"
}
```

### Pricing

Pay-per-result: **$0.01235 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $1.23 |
| 1,000 results | $12.35 |
| 10,000 results | $123.50 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [SeLoger.com French Real Estate Scraper](https://apify.com/parseforge/seloger-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to SeLoger through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com/?tools=parseforge/seloger-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why am I getting no results?**

Check that your city slug is correctly formatted with the department code, like paris-75. Also verify that the transaction type matches the slug. If using a direct URL, ensure it is a valid SeLoger.com search page and not a single listing page.

**The Actor is returning fewer listings than expected.**

SeLoger.com may paginate results or cap the number of accessible listings. Try refining your search to be more specific, or check if the site itself shows more results for the same query in a browser.

**I pasted a URL but the Actor ignored my city setting.**

This is expected. When you provide a startUrl, the city and transactionType fields are ignored. The Actor uses the URL exactly as provided. Remove the startUrl to use the city and transaction type filters instead.

**Some listings are missing the DPE rating.**

Not all listings on SeLoger.com include a DPE energy rating. The Actor extracts the data that is present on the page. If the seller did not provide it, the field will be empty in your results.

**The run takes a long time with a high maxItems value.**

Scraping many pages politely requires delays to avoid overloading the website. A high maxItems value will naturally take longer. Reduce the number or run the Actor on a higher-memory Apify plan for more parallel processing.

### FAQ

| Question | Answer |
|---|---|
| Do I need a SeLoger.com account or API key? | No. The Actor reads publicly accessible listing pages and search results. No login, API key, or app registration is required. |
| How do I find the correct city slug? | Go to SeLoger.com, search for your city, and look at the URL. The slug is the part after the city name, for example paris-75 or lyon-69. Use that exact string in the City input field. |
| Can I scrape both sale and rental listings? | You can scrape one transaction type per run. Set the Transaction Type to achat for buying or locations for renting. To collect both, run the Actor twice with different settings. |
| What if my search URL has many filter parameters? | Paste the full URL into the startUrl field. The Actor will respect all query parameters, including price range, property type, surface area, and map coordinates. |
| How many listings can I scrape in one run? | You can set the maximum up to 1,000,000 listings. The actual number collected depends on how many results match your search on SeLoger.com. |
| What data fields does the Actor return? | The output includes the listing title, price, surface area, number of rooms and bedrooms, DPE energy rating, description text, image count, and the full URL. The exact schema is shown in the sample output on the Actor's page. |
| Can I export the results to Excel? | Yes. You can export your dataset in CSV, JSON, Excel, or XML format directly from the Apify platform. |
| Is this Actor suitable for commercial real estate? | SeLoger.com primarily lists residential properties. The Actor will collect whatever listings appear in your search results, but it is not specifically designed for commercial or business premises. |
| How often should I run the Actor to monitor new listings? | You can schedule the Actor to run as frequently as every few minutes on an Apify paid plan. For most monitoring use cases, running it once or twice a day is sufficient to catch new listings. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by SeLoger.com. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

## `startUrl` (type: `string`):

Direct SeLoger.com search URL to scrape. If provided, city and transactionType are ignored.

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

How many listings to collect per run.

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

Type of real estate transaction to search for

## `city` (type: `string`):

City slug with department code (e.g. paris-75, lyon-69, marseille-13)

## Actor input object example

```json
{
  "startUrl": "https://www.seloger.com/immobilier/achat/immo-paris-75/",
  "maxItems": 10,
  "transactionType": "achat",
  "city": "paris-75"
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# 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 = {
    "startUrl": "https://www.seloger.com/immobilier/achat/immo-paris-75/",
    "maxItems": 10,
    "city": "paris-75"
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/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 = {
    "startUrl": "https://www.seloger.com/immobilier/achat/immo-paris-75/",
    "maxItems": 10,
    "city": "paris-75",
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/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 '{
  "startUrl": "https://www.seloger.com/immobilier/achat/immo-paris-75/",
  "maxItems": 10,
  "city": "paris-75"
}' |
apify call parseforge/seloger-scraper --silent --output-dataset

```

## MCP server setup

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