Skip to content
SeLoger

Search listings

One page of a seloger.com search, 30 listings, as the page shows them, the agency's phone included.

seloger/listings/search15 credits a callv2.0.0

When to use it

You need the property listings of a seloger.com search (to buy or to rent): price, previous price and its change, rooms, surfaces, energy class, photos with their room, transport nearby, and the seller (agency, agent, developer or private owner) with its phone numbers, SIREN and SIRET. Set the search up on seloger.com (place, property type, filters, sort), then pass its URL.

Try it

The options on the left write the call; the answer on the right is the contract's example. With your API key, the same call returns live data.

1Request
A seloger.com search, exactly as the browser shows it once the search is set up (place, property types, filters, sort), its page the page to start at (page=2 is the second page).
Where to go on, from next in an answer, as it is: opaque, and only for the search it was given with (otherwise invalid_cursor).
15 credits a call
Code, from the fields above
curl https://api.lobstr.io/v2/run \
  -H "Authorization: Bearer $LOBSTR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "seloger",
    "operation": "listings/search",
    "options": {
      "url": "https://www.seloger.com/classified-search?distributionTypes=Buy&estateTypes=House,Apartment&locations=AD08FR31096&order=DateDesc"
    }
  }'
2Response

An example answer, from the contract. Run it on your own input with your API key.

{
  "object": "run",
  "id": "run_qbmtozr3zhjb4cydojuwht6ysy",
  "livemode": true,
  "source": "seloger",
  "operation": "listings/search",
  "version": "2.0.0",
  "schema_url": "https://api.lobstr.io/v2/catalog/seloger/listings/search",
  "options": {
    "url": "https://www.seloger.com/classified-search?distributionTypes=Buy&estateTypes=House,Apartment&locations=AD08FR31096&order=DateDesc"
  },
  "fields": null,
  "status": "succeeded",
  "count": 1,
  "has_more": true,
  "next": {
    "source": "seloger",
    "operation": "listings/search",
    "options": {
      "url": "https://www.seloger.com/classified-search?distributionTypes=Buy&estateTypes=House,Apartment&locations=AD08FR31096&order=DateDesc",
      "cursor": "gAAAAABpNWd0x2kQ8vZr3TfYc1LmRb7uHsE9wA4jXoKqDn6yPiGt5"
    }
  },
  "cost": {
    "credits": 15
  },
  "results": [
    {
      "object": "listing",
      "id": "26EXAMPLE001",
      "position": 1,
      "url": "https://www.seloger.com/annonce/achat/ile-de-france/paris-75/paris-75000/26EXAMPLE001",
      "transaction": "buy",
      "property_type": "apartment",
      "property_subtype": null,
      "property_label": "Appartement",
      "title": "Appartement à vendre",
      "headline": "T3 lumineux de 68 m² avec balcon",
      "description": "À Paris, dans le 18ème arrondissement, ce T3 de 68 m² au 4ème étage...",
      "status": "published",
      "price": {
        "amount": 836000,
        "currency": "EUR"
      },
      "price_period": null,
      "price_note": "12 294 €/m²",
      "price_per_m2": 12294,
      "previous_price": {
        "amount": 865000,
        "currency": "EUR"
      },
      "price_change_percent": -3.35,
      "charges_included": null,
      "rooms": 3,
      "bedrooms": 2,
      "living_area": 68,
      "plot_area": null,
      "facts": [
        {
          "type": "numberOfRooms",
          "text": "3 pièces"
        },
        {
          "type": "livingSpace",
          "text": "68 m²"
        },
        {
          "type": "numberOfFloors",
          "text": "4ème étage"
        }
      ],
      "energy_class": "C",
      "building_state": "well_kept",
      "year_built": 1930,
      "is_new": true,
      "is_exclusive": false,
      "has_3d_visit": true,
      "has_brokerage_fee": false,
      "new_build": null,
      "photos": [
        {
          "url": "https://cdnihddipa.cloudimg.io/0/0/0/0/example.jpg",
          "room": "living_room"
        }
      ],
      "floor_plans": [],
      "location": {
        "city": "Paris 18ème arrondissement",
        "postal_code": "75018",
        "district": "Grandes-Carrières",
        "department": "Paris",
        "region": "Ile-de-France",
        "country": "France",
        "address_published": false,
        "place_ids": [
          {
            "id": "AD08FR31096",
            "level": "AD08"
          },
          {
            "id": "AD02FR1",
            "level": "AD02"
          }
        ],
        "transport": [
          {
            "type": "metro",
            "lines": [
              "13"
            ]
          }
        ]
      },
      "published_at": "2026-11-11T19:55:00Z",
      "updated_at": "2026-11-11T19:56:09Z",
      "seller": {
        "type": "pro",
        "kind": "agency",
        "id": "RC-0000001",
        "name": "Acme Immobilier",
        "contact_name": "Jeanne Martin",
        "phones": [
          {
            "number": "+33612345678",
            "as_written": "0612345678"
          }
        ],
        "address": "1 rue Exemple, 75018 Paris",
        "city": "Paris",
        "postal_code": "75018",
        "website": "https://www.example-agency.fr/",
        "profile_url": "https://www.seloger.com/professionnels-immobilier/example",
        "logo_url": null,
        "fees_url": null,
        "siren": "000000000",
        "siret": "00000000000000",
        "legal": [
          "Acme Immobilier",
          "Siège: 1 rue Exemple, 75018 Paris",
          "RCS: 000000000",
          "SIRET: 00000000000000"
        ]
      },
      "ids": {
        "listing_id": "26EXAMPLE001",
        "legacy_id": "200000000",
        "client_id": "RC-0000001"
      },
      "source_url": "https://www.seloger.com/classified-search?distributionTypes=Buy&estateTypes=House,Apartment&locations=AD08FR31096&order=DateDesc",
      "observed_at": "2026-11-12T09:00:00Z"
    }
  ]
}

Options

urlstringrequired
A seloger.com search, exactly as the browser shows it once the search is set up (place, property types, filters, sort), its page the page to start at (page=2 is the second page). Sort by date, newest first, with order=DateDesc. Every filter SeLoger reads is read; a parameter SeLoger does not filter on is refused, never ignored. SeLoger serves the first 9,990 results of a search (333 pages): narrow it (a price range, a smaller place) for more.
cursorstring
Where to go on, from next in an answer, as it is: opaque, and only for the search it was given with (otherwise invalid_cursor). Leave it out to start at the URL's page.

Record

Each record of results, in the envelope every call returns (Run an operation).

objectstring
The kind of record: a listing, whichever site it comes from.
idstring
SeLoger's listing id (26IBQQJTVUFB); repeated in ids.listing_id.
positioninteger
Its place among the results, across pages (30 a page): 31 is the first of page 2.
urlstring
The listing on seloger.com.
transactionstring
buy or rent, as SeLoger files the listing.
property_typestring
SeLoger's type, in its own words: apartment, house, parking, plot, building, gastronomy_hotel...
property_subtypestring
studio, multi_storey, villa, restaurant...; null when SeLoger gives none.
property_labelstring
The type as the page names it, in French: Appartement.
titlestring
The card's title: Appartement à vendre.
headlinestring
The line under it: T3 neuf de 69 m² avec extérieur de 5 m².
descriptionstring
The listing's text as the search shows it; SeLoger cuts it at about 500 characters (it ends with "...").
statusstring
SeLoger's status: published on a search page.
price.amountfloat
price.currencystring
ISO 4217
price_periodstring
month for a rent; null for a sale.
price_notestring
What the card writes under the price, as written: the price per m² (12 294 €/m²), charges comprises or hors charges for a rent, a life annuity's monthly rent (et 596 €/mois).
price_per_m2float
The price per m² the card shows, in the price's currency.
previous_price.amountfloat
previous_price.currencystring
ISO 4217
price_change_percentfloat
The change from previous_price, in percent of it: -8.55 is a drop (SeLoger's down arrow).
charges_includedboolean
A rent with its charges (cc) or without (hc); null for a sale.
roomsinteger
bedroomsinteger
living_areafloat
m².
plot_areafloat
m², a house's land.
factslist
The facts the card lists, in its order and words: the floor (4ème étage, Étage 3/5), the availability (disponible dès maintenant), the rooms and surfaces said as text.
energy_classstring
The energy performance class (DPE), A to G.
building_statestring
SeLoger's state of the building: first_time_use, mint_condition, well_kept, refurbished, need_of_renovation, to_refurbish.
year_builtinteger
The year of construction SeLoger gives (a new build's: its completion year).
is_newboolean
SeLoger's Nouveau badge: put online recently.
is_exclusiveboolean
Offered by this seller alone (the Exclusivité badge).
has_3d_visitboolean
The listing has a 3D or virtual visit.
has_brokerage_feeboolean
SeLoger's flag of an agency fee shown apart; false on every listing of the 11/11 captures.
new_build.namestring
new_build.descriptionstring
new_build.urlstring
The programme on selogerneuf.com.
photoslist
Every photo, in the listing's order.
floor_planslist
location.citystring
As SeLoger names it: Paris 18ème arrondissement.
location.postal_codestring
location.districtstring
The neighbourhood: Raspail-Montparnasse.
location.departmentstring
Rhône, Paris.
location.regionstring
location.countrystring
location.address_publishedboolean
The seller shows the street on the listing's page (a search never gives it).
location.place_idslist
SeLoger's places the listing is in, from the smallest: each id can be a search's locations=.
location.transportlist
The lines nearby the card shows, by kind.
published_atdate
When the listing was put online on SeLoger, UTC.
updated_atdate
Its last change, UTC.
seller.typestring
seller.kindstring
agency, real_estate_agent, real_estate_developer; null for a private owner.
seller.idstring
SeLoger's id of the seller: RC-1887530.
seller.namestring
The agency's or developer's name; null for a private owner.
seller.contact_namestring
The person to contact the card names (an agent, a private owner's first name).
seller.phoneslist
The seller's numbers the listing gives (an agency's; a private owner's number is not in a search).
seller.addressstring
The seller's address.
seller.citystring
seller.postal_codestring
seller.websitestring
seller.profile_urlstring
The seller's page on seloger.com.
seller.logo_urlstring
seller.fees_urlstring
An agency's scale of fees.
seller.sirenstring
The RCS number the seller gives: its SIREN.
seller.siretstring
seller.legallist
The legal lines the listing shows, as text: the company's name and capital, its seat, RCS, SIRET, its financial guarantee.
ids.listing_idstring
ids.legacy_idstring
The listing's former numeric id (SeLoger's older addresses).
ids.client_idstring
The seller's id: seller.id.
source_urlstring
The search page these values were read from, its page included.
observed_atdate
When they were read

Errors

Its own, besides those of every call (Errors). A failed call is free.

CodeStatusWhat it means
invalid_url422This URL is not a seloger.com search this operation reads.
invalid_search422SeLoger refuses this search; send it as the previous answer's next gives it, or the search's url alone.
site_challenge503SeLoger asked to prove a person is there; retry in a minute (not charged). Retryable.
site_unavailable503SeLoger did not answer in time or refused the call; retry later (not charged). Retryable.
unexpected_answer424SeLoger answered in a shape we do not read yet; we are told and fix it, and it is not charged.

Price

15 credits a call, whatever the page holds: a short last page costs a whole call. An empty page and a failed call are free. What a credit costs on each plan: Credits and pricing.

Changelog

2.0.02026-11-13
next keeps the search as it was written and goes on with cursor, opaque, as every paged operation of the API (Google's page tokens): copy next as before. search is no longer an option: the criteria SeLoger's page reads for a search by travel time or with no place travel inside the cursor. The URL's page still starts at any page.
1.2.02026-11-12
Every page as fresh as SeLoger's search, the first included, and lighter: a search URL is read as SeLoger's own page reads it, then asked of its search service (about 47 KB a page instead of 170 KB). SeLoger's page is kept up to 15 minutes by its CDN: its newest listings came late, and the last of page 1 came again on page 2. next is a URL again; search only follows a search by travel time or with no place, read from its page.
1.1.02026-11-12
A next page is lighter: next now holds search, the search as SeLoger reads its URL, and a call with it asks SeLoger's search service, as the site does from page 2 (about 47 KB instead of 170 KB). Same listings, same fields, same price; a URL alone, any page, is read as before.
1.0.02026-11-12
First version on the API v2: one page of a seloger.com search as the page shows it, 30 listings with their previous price and its change, photos with their room, transport nearby, and the seller with its phone numbers, SIREN and SIRET; a filter SeLoger does not read is refused, never ignored.