# Leboncoin Real Estate Scraper (`saswave/leboncoin-real-estate-scraper`) Actor

$0.8 / 1000 results. Scrape real estate listings from Leboncoin, one of France’s major classified advertising platforms, and collect structured property data for market research, property analysis, investment research, and listing monitoring

- **URL**: https://apify.com/saswave/leboncoin-real-estate-scraper.md
- **Developed by:** [SASWAVE](https://apify.com/saswave) (community)
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $0.80 / 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

## Leboncoin Real Estate Scraper – Extract Property Listings, Prices & Real Estate Data

Scrape real estate listings from Leboncoin, one of France’s major classified advertising platforms, and collect structured property data for market research, property analysis, investment research, and listing monitoring.

The Leboncoin Real Estate Scraper extracts property prices, listing titles, descriptions, images, location details, property characteristics, energy ratings, and seller information when available. Use Search results to collect listing summaries or Direct results to retrieve more detailed property records.

Whether you're researching the French property market, comparing asking prices, analyzing rental and sale listings, or building a real estate dataset, this Actor helps turn Leboncoin listings into structured data.

### 🔹 Features

Real Estate Listing Scraping – Collect property advertisements from Leboncoin.

Search and Direct Modes – Retrieve listing summaries or more detailed property information, depending on the Actor's supported inputs.

Property Prices – Extract advertised prices, price per square meter, estimated notary fees, and estimated total property costs when available.

Property Characteristics – Collect living area, land area, room count, bedrooms, bathrooms, heating details, parking information, and other available attributes.

Listing Descriptions – Capture listing titles and full descriptions to support property research.

Property Images – Retrieve image URLs for listing photos.

Location Data – Extract city, postal code, department, region, country, and geographic coordinates when provided.

Energy Performance Information – Collect energy ratings, greenhouse gas emissions ratings, and estimated annual energy costs when available.

Listing Status and Dates – Retrieve listing status, first publication date, expiration date, and index date.

Seller and Agency Information – Extract available seller details, account type, badges, profile information, and activity indicators.

Additional Listing Details – Capture virtual tour URLs, old prices, availability dates, and other source-provided attributes when present.

Structured JSON Output – Collect data suitable for export, analytics, and integration with other applications.

### 🔹 Use Cases

French Real Estate Market Research

Collect property advertisements across France to investigate listing prices, property characteristics, and regional market patterns.

Property Price Comparison

Compare asking prices, living areas, land sizes, and price per square meter across listings and locations.

Real Estate Investment Research

Gather property information to help identify potential investment opportunities for further investigation.

Property Listing Monitoring

Collect listing status, publication dates, expiration dates, and advertised prices to support recurring market monitoring.

Property Data Aggregation

Build structured datasets for real estate analytics, internal research, dashboards, and property discovery applications.

Energy Performance Analysis

Analyze available energy ratings, greenhouse gas emissions ratings, and estimated energy costs across property listings.

Real Estate Agency Research

Study public listing and agency information to understand property inventory and seller activity.

Geographic Property Analysis

Use city names, postal codes, department and region details, and coordinates to organize listings by location.

### OUTPUT

Search

```json
{
  "id": 3288831667,
  "first_publication_date": "2026-10-15 15:16:50",
  "expiration_date": "2026-12-14 14:16:50",
  "index_date": "2026-10-29 14:16:51",
  "status": "active",
  "category_id": "9",
  "category_name": "Ventes immobilières",
  "subject": "Mas de caractère en Drôme Provençale",
  "body": "Cette propriété de grande qualité, ouvre sur un panorama superbe et préservé . Son emplacement privilégié garantit calme et intimité, tout en bénéficiant d'un accès rapide aux principaux axes , et à la gare de Montélimar.\n\nLe terrain offre une diversité précieuse, bosquets, arbres fruitiers, et grands arbres anciens aux essences variées .\n\nLa bâtisse en pierre de 300 m2 a été parfaitement rénovée dans le respect de son caractère d’origine, alliant confort et authenticité .\nLa configuration des espaces permet de profiter pleinement de l’ensemble de la maison, ou d’en moduler les usages selon les besoins, au fil des saisons . Les pièces de vie aux volumes généreux offrent de nombreuses possibilités . Une aile de la maison peut être utilisée comme une suite parentale, ou comme un appartement indépendant, de plein pied.\n\nA l’extérieur, le séjour est prolongé par une grande tonnelle végétalisée, constituant un vaste espace de vie ombragé . Dominant un paysage verdoyant, la piscine chauffée et ses abords forment un agréable lieu de vie dans la continuité de la maison.\nGarage, cellier, cave à vin, atelier offrent des espaces annexes particulièrement pratiques au quotidien.\n\nCommerce à 1,5 km .\nAgence s'abstenir, merci.",
  "brand": "leboncoin",
  "ad_type": "offer",
  "url": "https://www.leboncoin.fr/ad/ventes_immobilieres/3288831667",
  "price": 820000.0,
  "images": [
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/37/bc/4b/37bc4b520477b974b939871a539755212e58e81c.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/5f/26/d2/5f26d2b14e0f73a73b8e39434802c83d95f03b3a.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/b2/36/76/b23676a3fa8f1939f16358035e8cc689e0ef8a70.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/00/99/66/009966efa01313ddce8b36c63cc79c19197a0771.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/a9/c2/d1/a9c2d13b63caddb412867ab6f7f5995994b924a1.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/fd/0a/97/fd0a9701b80bcd20685e23dc8c9aff5235144329.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/68/01/eb/6801eb063f7e09353230000827d72866c200257e.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/01/44/57/01445742247ed773f9c00418d8ad9c34441216fe.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/05/a8/f7/05a8f7d13cdcc3300a44ef45135f018a22795998.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/c3/0d/c2/c30dc20bde99b258c4f4cf4da351f06f50e8756c.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/b2/3c/ec/b23cecd4b22bc8b672557a3353e32afa60269cf5.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/12/bd/af/12bdaf387fe7d1d7a2928684b99c9663e992d132.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/b0/09/60/b00960439369df6c01efc5d46293d8f5588b5ef3.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/85/c8/06/85c806cdc04796dab6543bbf28a6ed19347c94c4.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/c5/77/61/c577613c1c3b0a38d763e2062e24d2654a1f7984.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/ea/0b/65/ea0b65e8048b35c516a1464a2e2ce10b2cb005b3.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/62/1a/a7/621aa7394c0c9e315e0f2679b013e526a0294fde.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/08/4f/26/084f2670ab7e242bf7a764f3f2a829ad58bd710b.jpg?rule=ad-large"
  ],
  "has_phone": false,
  "favorites": null,
  "attributes": {
    "profile_picture_url": "https://img.leboncoin.fr/api/v1/tenants/9a6387a1-6259-4f2c-a887-7e67f23dd4cb/domains/20bda58f-d650-462e-a72a-a5a7ecf2bf88/buckets/21d2b0bc-e54c-4b64-a30b-89127b18b785/images/profile/pictures/default/9122c535-bb95-5f6f-b7aa-5d19efc56d3b?rule=pp-small",
    "type_real_estate_sale": "ancien",
    "real_estate_type": "1",
    "square": "300",
    "land_plot_surface": "3600",
    "rooms": "9",
    "bedrooms": "5",
    "nb_bathrooms": "4",
    "real_estate_type_specificities": "",
    "energy_rate": "d",
    "ges": "c",
    "specificities": "",
    "heating_mode": "electric",
    "nb_floors_house": "2",
    "orientation": "south",
    "outside_access": "",
    "nb_parkings": "5",
    "building_year": "1850",
    "available_date": "02/2027",
    "global_condition": "1",
    "price_per_square_meter": "2733",
    "estimated_notary_fees": "65600",
    "estimated_total_property_price": "885600",
    "immo_sell_type": "old",
    "is_import": "false",
    "lease_type": "sell"
  },
  "country_id": "FR",
  "region_id": "22",
  "region_name": "Rhône-Alpes",
  "department_id": "26",
  "department_name": "Drôme",
  "city_label": "La Bâtie-Rolland 26160",
  "city": "La Bâtie-Rolland",
  "zipcode": "26160",
  "lat": 44.56165,
  "lng": 4.84847
}
```

Direct

```json
{
  "id": 3192814572,
  "first_publication_date": "2026-10-21 09:03:33",
  "expiration_date": null,
  "index_date": "2026-10-21 09:03:33",
  "status": "active",
  "category_id": "9",
  "category_name": "Ventes immobilières",
  "subject": "Maison 7 pièces 194 m²",
  "body": "Maison 7 pièces 194 m²\n\nFRAISSES (42490) Maison de 194 m² en monopropriété sur une parcelle de 429 m². Mitoyenne d’un côté.  Proche des commodités du centre-ville de cette commune prisée aux portes de la Haute Loire à l’environnement mi ville mi campagne à 15 kms de SAINT ETIENNE. \n  \n  Elle se compose de 2 logements individualisés mais la liaison entre les deux a été existante et peut être recréée si besoin. Cour sur le devant et grand garage de 35 m² . Prise voiture électrique présente .\n  \n  Soit en rez de chaussée : 97 m² en accès direct à une terrasse couverte et au jardin de 220 m². 2 ou 3 chambres séjour, bureau , cuisine, belle salle d'eau de 6 m² récente , sous sol exploitable et cave. DPE F montant estimé des dépenses annuelles d’énergie pour un usage standard : entre 2820 euros et 3850 euros \n  \n  Au 1er, 97 m², 2 grandes chambres de 16 et 15 m² , double séjour, cuisine et grand cellier. DPE E montant estimé des dépenses annuelles d’énergie pour un usage standard : entre 2390 euros et 3300 euros  \n  \n  Cet ensemble immobilier permet un projet multiformes : Habitation principale avec parties indépendantes pour famille ou amis, jouissance du rez de chaussée avec jardin et garage, et un revenu locatif ou pour investissement global de 2 appartements en location. \n  \n  Jardin, superficie, grand garage, sous-sol profitable, commune de qualité, rendement possible voici les atouts de ce bien.\n  \n  Visite virtuelle sur annonce.\n  \n  Pour plus de renseignements contacter l’agent commercial EI Mr PEREZ Rémi RSAC 798810552 de SAINT ETIENNE au o6.03.86.25.22 ou [Coordonnées masquées] ou [URL masquée pour votre sécurité] \n  \n  Les informations sur les risques auxquels ce bien est exposé sont disponibles sur le site Géorisques : www.georisques.gouv.fr Les prix de vente sont frais d’agences inclus et Toutes Taxes Comprises, hors frais notariés, d’enregistrements et de publicités foncières, nos honoraires sont à la charge du vendeur (incluant : renseignements, prises de rdv, visites, suivi juridique, montage des dossiers, relations avec les notaires, rdv compromis de vente et acte authentique, état des lieux), tarif consultable sur notre site internet\n\nSurface : 194 m²\nDate de réalisation du diagnostic énergétique : 19/03/2025\n\nConsommation énergie primaire : 312 kWh/m²/an\nConsommation énergie finale : 307 kWh/m²/an\n\nMontant estimé des dépenses annuelles d'énergie pour un usage standard : entre 2 410 € et 3 280 € sur les années 2021, 2022 et 2023 (abonnements compris).",
  "brand": "leboncoin",
  "ad_type": "offer",
  "url": "https://www.leboncoin.fr/ad/ventes_immobilieres/3192814572",
  "price": 189000.0,
  "images": [
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/a7/b5/87/a7b5878726258573e4a9607a3450650ec7e7725b.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/fa/a1/eb/faa1eb80e74a7d2443dfd81cba8d676ad9cd2ac0.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/48/53/43/485343cd21882ffb21d1b68c2199de622d34f152.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/cf/fd/91/cffd91cd3f1e00a4e459edd16dba70ed2a9da150.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/39/8b/f5/398bf5a42268b70f64c1bd584e36ce820d5fd800.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/69/2b/ef/692befab159e91c2144859aa0203c8d245ef610e.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/f9/2b/51/f92b512d59cac27bb68f91457be3c7e985dc8738.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/b2/b1/d5/b2b1d5fc0ad5d5fd55352aefe6adc984dfe18136.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/21/7a/3c/217a3c5c2d9f62e1f34bde9e99d8b4daed3cbd33.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/11/1b/c1/111bc17c1c1bd3f8e97e004c3bc2336a469d8c85.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/b9/6c/ce/b96ccec4b2b10aedb2f4023fd9601f920c6c7758.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/11/61/cc/1161cc9c9ac65f9e63e9136022f2bb5d587aa315.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/58/12/93/58129392ee77e5477f8601418680e9cf32dacd86.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/0d/dc/f4/0ddcf4760f0c2370077675c03f562b80e7f7860f.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/be/cc/a6/becca60181681ba0a1a479b025fa928a43cbccb1.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/c5/f1/b0/c5f1b0932deccd405f9c2af965c4807d5c6a6d52.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/72/71/4a/72714a9329f593dbcfa4fbf16295e9bc56d1c8c9.jpg?rule=ad-large",
    "https://img.leboncoin.fr/api/v1/lbcpb1/images/f7/ad/bf/f7adbff59ee3528815bf292c8256b0ed10c74cd1.jpg?rule=ad-large"
  ],
  "has_phone": true,
  "favorites": 35,
  "attributes": {
    "activity_sector": "2",
    "external_ad_id": "apimo_6419_86997729",
    "real_estate_type": "1",
    "square": "194",
    "rooms": "7",
    "energy_rate": "e",
    "ges": "e",
    "heating_type": "individual",
    "heating_mode": "gas",
    "nb_parkings": "0",
    "fees_at_the_expanse_of": "seller",
    "pro_rates_link": "https://api.apimo.pro/document_agency/24424?secret=ebac0ab13e",
    "district_id": "42099",
    "district_visibility": "false",
    "district_type_id": "2",
    "district_resolution_type": "integration",
    "mandate_type": "simple",
    "price_per_square_meter": "974",
    "estimated_notary_fees": "15120",
    "estimated_total_property_price": "204120",
    "annual_energy_budget_min": "2410",
    "annual_energy_budget_max": "3280",
    "custom_ref": "7616",
    "immo_sell_type": "old",
    "virtual_tour": "https://view.ricoh360.com/1f8ae831-ef73-4a19-9bb9-3a74d2c8c3dd?type=compact",
    "is_import": "true",
    "lease_type": "sell",
    "old_price": "200000"
  },
  "country_id": "FR",
  "region_id": "22",
  "region_name": "Rhône-Alpes",
  "department_id": "42",
  "department_name": "Loire",
  "city_label": "Fraisses 42490",
  "city": "Fraisses",
  "zipcode": "42490",
  "lat": 45.387802,
  "lng": 4.2671194,
  "seller_infos": {
    "name": "LIBERATION 24 FIRMINY",
    "registered_at": "2016-01-01",
    "location": "Loire",
    "reply": {
      "in_minutes": 0,
      "text": ""
    },
    "presence": {
      "status": "OFFLINE",
      "presence_text": "Dernière activité il y a 8 jours",
      "last_activity": "2026-10-20T14:06:40Z",
      "enabled": true
    },
    "profile_picture": {
      "is_default": true,
      "default": true,
      "small_url": "https://img.leboncoin.fr/api/v1/tenants/9a6387a1-6259-4f2c-a887-7e67f23dd4cb/domains/20bda58f-d650-462e-a72a-a5a7ecf2bf88/buckets/21d2b0bc-e54c-4b64-a30b-89127b18b785/images/profile/pictures/default?rule=pp-small",
      "medium_url": "https://img.leboncoin.fr/api/v1/tenants/9a6387a1-6259-4f2c-a887-7e67f23dd4cb/domains/20bda58f-d650-462e-a72a-a5a7ecf2bf88/buckets/21d2b0bc-e54c-4b64-a30b-89127b18b785/images/profile/pictures/default?rule=pp-medium",
      "large_url": "https://img.leboncoin.fr/api/v1/tenants/9a6387a1-6259-4f2c-a887-7e67f23dd4cb/domains/20bda58f-d650-462e-a72a-a5a7ecf2bf88/buckets/21d2b0bc-e54c-4b64-a30b-89127b18b785/images/profile/pictures/default?rule=pp-large",
      "extra_large_url": "https://img.leboncoin.fr/api/v1/tenants/9a6387a1-6259-4f2c-a887-7e67f23dd4cb/domains/20bda58f-d650-462e-a72a-a5a7ecf2bf88/buckets/21d2b0bc-e54c-4b64-a30b-89127b18b785/images/profile/pictures/default?rule=pp-extra-large"
    },
    "badges": [
      {
        "type": "global",
        "name": "Responsiveness2"
      },
      {
        "type": "global",
        "name": "VerifiedPhoneNumber"
      }
    ],
    "total_ads": 17,
    "store_id": 15620502,
    "account_type": "pro",
    "user_id": "1123eb84-ca05-40aa-86c9-7a92fa9ff19f",
    "description": "",
    "sub_activity_sector": "RealEstateAgency"
  }
}
```

### 🛟 SUPPORT

Share your runs with the developer team and create issues on error to help us improve actor quality.

You might discover edge case we didn't test yet

We stay available anytime

# Actor input Schema

## `search_urls` (type: `array`):

Search url to extract listing from. Enter a URL that does contain category=10, category=9

## `limit_date_today` (type: `boolean`):

Select to use today date when the actor starts (without the need to provide the date manually below). Input limit_date needs to be empty to use limit_date_today

## `limit_date` (type: `string`):

Provide a max date. The scraper will return all items with a publication date newer or equal. For example if 2026-03-15 provide, all items published between today and 2026-03-15 will be returned. After that the actor will stop and not return the older items.

## `max_page` (type: `integer`):

provide max page from 1 to 100

## `directs` (type: `array`):

Direct listing url (Buy or rent)

## Actor input object example

```json
{
  "search_urls": [
    "https://www.leboncoin.fr/recherche?category=9&real_estate_type=1&sort=time&order=desc"
  ],
  "limit_date_today": false,
  "limit_date": "",
  "max_page": 1,
  "directs": []
}
```

# Actor output Schema

## `results` (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 = {
    "search_urls": [
        "https://www.leboncoin.fr/recherche?category=9&real_estate_type=1&sort=time&order=desc"
    ],
    "directs": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("saswave/leboncoin-real-estate-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 = {
    "search_urls": ["https://www.leboncoin.fr/recherche?category=9&real_estate_type=1&sort=time&order=desc"],
    "directs": [],
}

# Run the Actor and wait for it to finish
run = client.actor("saswave/leboncoin-real-estate-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 '{
  "search_urls": [
    "https://www.leboncoin.fr/recherche?category=9&real_estate_type=1&sort=time&order=desc"
  ],
  "directs": []
}' |
apify call saswave/leboncoin-real-estate-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,saswave/leboncoin-real-estate-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/LSCjMvpGeZDkt9sh7/builds/b5w4iMrb2mCmQspEe/openapi.json