SeLoger is a French real-estate portal for homes to buy and rent. Its search pages show 30 listings at a time, so a full list of the listings in one city means paging through results and copying each price, area and agency by hand. This tutorial shows how to run SeLoger Scraper (reventadata/seloger-scraper) from a short Python script, so the listings arrive as structured rows you can sort, filter and save.

The walkthrough uses one real run: a search for apartments to buy in Paris that returned 30 listings. The rows shown below are from that run, unchanged.

Prerequisites

You need three things:

  1. Python 3.11 or newer. The Apify client for Python requires it.
  2. An Apify account and its API token. Copy the token from the Integrations page in Apify Console.
  3. The Apify client for Python, installed with the command below.

Nothing else is needed. The Actor reads public pages, so you do not log in to SeLoger, and you do not write any scraping code of your own.

pip install -U "apify-client~=3.0" 

What you'll achieve

By the end you will have a script that starts a SeLoger search, waits for it to finish, and prints one line per listing with its price, area, rooms, postcode and agency. The same script works for any French city the Actor can look up, with the filters you choose.

The input for this walkthrough is:

{ "location": "Paris", "maxItems": 30, "maxPages": 1 } 

location is a French city or area name. maxItems caps the rows, and maxPages caps the number of result pages, at 30 listings each. The Actor's other inputs (transaction, estateType, price, rooms and surface limits, and sortBy) are left out, so they take their defaults: buy, apartment, and the site's own order. The run used those defaults, and every row in it is for sale and an apartment.

Step 1: Choose the search

Set the fields in the run_input dictionary of the script (Step 2). The fields you need are:

  • location: a city name such as Paris or Lyon. The Actor looks the name up on SeLoger and uses the first match. The log names the match it used, so check that it is the place you meant.
  • transaction: buy or rent.
  • estateType: apartment or house.
  • priceMin, priceMax, roomsMin, roomsMax, spaceMin, spaceMax: optional limits. Leave them out to skip the limit. A value of 0 is a real limit, not an empty one.
  • sortBy: relevance (the site's order) or priceAsc (cheapest first).

A value outside a list (for example a transaction of sale) is refused before the run starts.

Step 2: Run it from Python

Save this as seloger_listings.py, replace the token placeholder with your own, and run it with python seloger_listings.py:

from apify_client import ApifyClient TOKEN = "<YOUR_APIFY_TOKEN>" client = ApifyClient(TOKEN) run_input = { "location": "Paris", "maxItems": 30, "maxPages": 1, } run = client.actor("reventadata/seloger-scraper").call(run_input=run_input) if run is None: raise SystemExit("The Actor run did not finish.") rows = list(client.dataset(run.default_dataset_id).iterate_items()) print(f"{len(rows)} listings") for row in rows: print(row["priceText"], row["areaM2"], row["rooms"], row["zipCode"], row["agencyName"]) 

call() starts the Actor and returns once the run has finished. The rows are then read from the run's default dataset with iterate_items(). In the run behind this post the Actor finished in 65.9 seconds and saved 30 rows.

Step 3: Read one row

Each row is one listing, with the same keys in the same order. Here is the first row of the run. Two changes are made to it for the article: imageUrls is cut to one entry, and searchUrl is left out. Every value is exactly as the run returned it.

{ "id": "26NT1GYSIXDE", "url": "https://www.bellesdemeures.com/285979427/detail.htm", "portal": "bellesdemeures", "legacyId": "285979427", "title": "Appartement à vendre", "transaction": "BUY", "propertyType": "APARTMENT", "propertySubType": null, "price": 950000, "currency": "EUR", "priceText": "950 000 €", "pricePeriod": null, "chargesLabel": null, "priceDetail": "10 722 €/m²", "pricePerSquareMeter": 10722, "areaM2": 88.6, "plotAreaM2": null, "rooms": 4, "bedrooms": 3, "floorText": "Étage 2/6", "availability": null, "energyClass": "D", "yearBuilt": null, "city": "Paris 17ème arrondissement", "zipCode": "75017", "district": "Ternes-Maillot", "isAddressPublished": true, "headline": "PMC TRAVERSANT / BALCON 8 m² / TERNES", "description": "Au pied de la promenade Pereire, dans un environnement calme et verdoyant du 17 € arrondissement, à seulement 5 minutes à pied du métro Porte-Maillot (ligne 1) et à proximité immédiate des commerces et des écoles, le Cabinet BR Immobilier vous propose ce bel appartement de 86 m². TRAVERSANT et bénéficiant de beaux VOLUMES grâce à sa HAUTEUR SOUS PLAFOND de 3,05 m, ce 4-pièces est situé au 2 € étage avec ASCENSEUR d'un immeuble ANCIEN de bonne facture, sécurisé, avec gardien et accès contrôlé pa...", "publisherType": "AGENCY", "isPrivateOwner": false, "agencyName": "BR IMMOBILIER", "contactName": "Elyes Zammit", "agencyProfileUrl": "https://www.seloger.com/professionnels-immobilier/XhQ9iPouVtsLw3Pu9VYLYL", "agencyWebsite": "http://www.br-immo.fr/", "agencyAddress": "7 avenue de l'Opéra, 75001 Paris", "phoneNumbers": [ "+33744220498" ], "agencyCompany": "SAS, société par actions simplifiée BR IMMOBILIER", "agencyHeadOffice": "7 avenue de l'Opéra, 75001 PARIS", "agencyRcs": "833370000", "agencySiret": "83337000000022", "isExclusive": true, "isNew": true, "has3DVisit": true, "hasBrokerageFee": false, "newBuildProgramTitle": null, "newBuildProgramUrl": null, "imageUrls": [ "https://cdnihddipa.cloudimg.io/5/c/a/0/5ca0a21b-a7df-424f-ba11-1f038831dc9d.jpg?ci_seal=883965e57ea0e0b68501b4dec85f1b5e4ca06c83" ], "floorplanUrls": [ "https://cdnihddipa.cloudimg.io/9/4/c/a/94cad4b2-486f-4c73-a765-c98f88ff420d.jpg?ci_seal=1ca3eb57f15d405dc31e1bd403ea3759d78db9ac", "https://cdnihddipa.cloudimg.io/e/6/2/e/e62e0bce-699d-42be-a5a2-5085eaf99f55.jpg?ci_seal=2dd9b9ae2fb85d66337143581c4816c18c8089e0", "https://cdnihddipa.cloudimg.io/8/6/8/0/8680e624-9bfc-45ec-95fe-164ffe8dc616.jpg?ci_seal=bb22173b40066a808f9c46190119f41fef75f58f" ], "createdAt": "2026-11-13T15:34:00Z", "updatedAt": "2026-11-18T08:06:12.019Z" } 

Understanding your results

Each row has the same keys. In this run:

  • Price and area. Prices run from 900,000 to 5,550,000 euros, with a median of 1,770,000. Areas run from 59.09 to 281.51 square metres, and pricePerSquareMeter from 9,887 to 38,276.
  • Rooms and energy. rooms is 4 on 12 rows, 3 on 6, 5 on 6, 6 on 3, 7 on 1, 8 on 1, and empty on 1. energyClass is D on 17 rows and E on 6.
  • Location. All 30 rows are in Paris, across 10 postcodes. Postcode 75016 has 9 rows.
  • Publisher. publisherType is AGENCY on 28 rows and REAL_ESTATE_AGENT on 2, and isPrivateOwner is false on all 30. phoneNumbers is present on 26 rows, and agencySiret on 29.

availability, chargesLabel, pricePeriod, propertySubType, plotAreaM2, newBuildProgramTitle and newBuildProgramUrl are empty on every row in this run. An empty field is null, never 0.

Pro tips and advanced usage

  • Get the cheapest listings first. Set sortBy to priceAsc, which the input describes as cheapest first.
  • Narrow the search at the site. Price, rooms and surface limits are sent with the search, so only matching listings are read.
  • Split large searches. The site serves at most 9,990 results for one search. A search that matches more needs price, rooms or surface limits to reach the rest. The run logs a warning when the match count is above that limit.
  • Check the portal field. SeLoger's sister portals can return listings too. Each row says which portal it came from, and its url is on that portal's domain. In this run all 30 rows have portal set to bellesdemeures.
  • Expect each id once. A listing that repeats across two result pages is saved once, so len(rows) counts distinct listings.
  • Cap the rows. maxItems stops the run at that many rows, so a test run stays small. Raise it once the script works.

Troubleshooting common issues

The run ends with FAILED and a message. The Actor ends FAILED when the site refuses the run or when an input is wrong. Read the message in the run's log first, then run the script again later.

A city name is not found. The run stops with an error that says the location has no match. Try the city name as you would type it on seloger.com, or use a place id, which has the form AD08FR31096 for Paris.

The run succeeds but the dataset is empty. The search matched no listings. The run is marked SUCCEEDED with a message that says so. Widen the filters and try again.

A row has missing fields. A missing value is null. Check the previous section before you treat it as an error.

For the current pricing and details of the Actor, see the Store page linked in the next section.

Next steps

Run the script on a schedule to keep a local copy of a search up to date, or write the rows to a database. Change location to another French city, switch transaction to rent, and compare the results. Experiment with the limits and the sort order until the rows match the listings you want.

For current pricing and details, see the Store page.

Try the script with your own city and tell me what you find. Drop a comment below.

About the author: reventadata builds and publishes data extraction Actors on the Apify Store.