Skip to content
SeLoger

Get a listing

One seloger.com listing, whole, as its page shows it, the agency's phone included.

seloger/listings/get1 credit a callv1.0.0

When to use it

You have a seloger.com listing (its id, such as 26IBQQJTVUFB, or its address, from seloger/listings/search or the browser) and need all of it: the full description, every feature by category, the energy certificates with their values, each line of the price (fees and who pays them, a deposit, a rent's cap, a life annuity's rent), the co-ownership, the schools nearby, SeLoger's price per m² of the area, and the seller with its phones, SIREN and SIRET. A search gives 500 characters of the description and none of the rest.

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
The listing's id (26IBQQJTVUFB, the id of a seloger/listings/search record), or its address as the browser shows it (https://www.seloger.com/annonce/...), or a former address (https://www.seloger.com/annonces/... /285758851.htm).
1 credit 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/get",
    "options": {
      "listing": "26EXAMPLE001"
    }
  }'
2Response

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

{
  "object": "run",
  "id": "run_kejiexwiwdq7brks7h73sfu6qe",
  "livemode": true,
  "source": "seloger",
  "operation": "listings/get",
  "version": "1.0.0",
  "schema_url": "https://api.lobstr.io/v2/catalog/seloger/listings/get",
  "options": {
    "listing": "26EXAMPLE001"
  },
  "fields": null,
  "status": "succeeded",
  "count": 1,
  "has_more": false,
  "next": null,
  "cost": {
    "credits": 1
  },
  "results": [
    {
      "object": "listing",
      "id": "26EXAMPLE001",
      "url": "https://www.seloger.com/annonce/26EXAMPLE001",
      "transaction": "rent",
      "transaction_subtype": "classic",
      "property_type": "apartment",
      "property_label": "Appartement",
      "title": "Appartement à louer",
      "title_additions": [],
      "headline": "T3 meublé de 124 m² au cœur de Lyon",
      "description": "Spacieux appartement meublé de 124 m², deux chambres, à deux pas des quais.\nDisponible de suite.",
      "language": "fr",
      "reference": "5111",
      "price": {
        "amount": 1690,
        "currency": "EUR"
      },
      "price_period": "month",
      "price_note": "charges comprises",
      "charges_included": true,
      "price_details": [
        {
          "kind": "primary",
          "label": "Loyer charges comprises",
          "note": null,
          "value": "1 690 €/mois",
          "per_m2": "13,63 €/m²"
        },
        {
          "kind": "secondary",
          "label": "Honoraires TTC à la charge du locataire",
          "note": null,
          "value": "1 612 €",
          "per_m2": null
        },
        {
          "kind": "secondary",
          "label": "Dépôt de garantie",
          "note": null,
          "value": "3 240 €",
          "per_m2": null
        }
      ],
      "price_messages": [],
      "rooms": 3,
      "bedrooms": 2,
      "living_area": 124,
      "plot_area": null,
      "facts": [
        {
          "type": "numberOfRooms",
          "text": "3 pièces"
        },
        {
          "type": "livingSpace",
          "text": "124 m²"
        }
      ],
      "features": [
        {
          "category": "Intérieur",
          "items": [
            "Cuisine ouverte",
            "1 Salle de bain",
            "2 Chambres"
          ]
        }
      ],
      "features_by_ai": [],
      "energy_class": "D",
      "energy": {
        "details": [
          {
            "type": "heatingSystem",
            "label": "Type de chauffage",
            "value": "Chauffage individuel"
          }
        ],
        "certificates": [
          {
            "type": "fr_energy_before_2021",
            "name": "Diagnostic de performance énergétique (DPE)",
            "rating": "D",
            "values": [
              {
                "label": "Consommation (énergie primaire)",
                "value": "230 kWh/m².an"
              }
            ],
            "date": "Avant le 1er juillet 2021"
          }
        ]
      },
      "building_state": null,
      "year_built": 1946,
      "co_ownership": [],
      "is_new": true,
      "is_exclusive": false,
      "has_3d_visit": true,
      "has_brokerage_fee": false,
      "photos": [
        {
          "url": "https://mms.seloger.com/0/0/0/0/example.jpg",
          "room": "living_room",
          "caption": "Salon"
        }
      ],
      "floor_plans": [],
      "videos": [],
      "virtual_tours": [
        {
          "url": "https://my.matterport.com/show/?m=example",
          "title": "Visite virtuelle"
        }
      ],
      "location": {
        "city": "Lyon 1er arrondissement",
        "postal_code": "69001",
        "district": "Pentes de la croix-rousse",
        "department": "Rhône",
        "region": "Auvergne-Rhône-Alpes",
        "country": "France",
        "address_published": true,
        "place_ids": [
          {
            "id": "AD08FR28808",
            "level": "AD08"
          }
        ],
        "latitude": 45.77105,
        "longitude": 4.83722,
        "geometry": {
          "type": "Point",
          "coordinates": [
            4.83722,
            45.77105
          ]
        },
        "transport": [
          {
            "type": "metro",
            "lines": [
              "A",
              "C"
            ]
          }
        ],
        "schools": [
          {
            "name": "École Maternelle Publique Example",
            "sector": "public",
            "level": "primary",
            "distance": "362 m",
            "walk": "5 min",
            "bike": "3 min",
            "transit": null,
            "car": "4 min"
          }
        ]
      },
      "area_price_per_m2": {
        "average": 14,
        "low": 11,
        "high": 19,
        "accuracy": 5,
        "place": "Lyon 1er arrondissement",
        "place_id": "AD08FR28808"
      },
      "published_at": "2026-11-10T08:00:00Z",
      "updated_at": "2026-11-12T02:00:00Z",
      "seller": {
        "type": "pro",
        "kind": "agency",
        "id": "RC-0000001",
        "name": "Acme Immobilier",
        "contact_name": "Acme Lyon",
        "phones": [
          {
            "number": "+33612345678",
            "as_written": "06 12 34 56 78"
          }
        ],
        "address": "1 rue Exemple, 69001 Lyon",
        "website": null,
        "profile_url": "https://www.seloger.com/professionnels-immobilier/example",
        "logo_url": null,
        "fees_url": null,
        "siren": "000000000",
        "siret": null,
        "legal": [
          "Acme Immobilier",
          "RCS: 000000000"
        ]
      },
      "ids": {
        "listing_id": "26EXAMPLE001",
        "legacy_id": "200000000",
        "client_id": "RC-0000001"
      },
      "source_url": "https://www.seloger.com/annonce/26EXAMPLE001",
      "observed_at": "2026-11-12T15:00:00Z"
    }
  ]
}

Options

listingstringrequired
The listing's id (26IBQQJTVUFB, the id of a seloger/listings/search record), or its address as the browser shows it (https://www.seloger.com/annonce/...), or a former address (https://www.seloger.com/annonces/... /285758851.htm). A listing shown on bellesdemeures.com or selogerneuf.com is on another site.

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.
urlstring
The listing's page read.
transactionstring
buy or rent.
transaction_subtypestring
SeLoger's kind of sale or rent: resale, new_build, life_annuity, classic...
property_typestring
SeLoger's type, in its own words: apartment, house, parking...
property_labelstring
The type as the page names it, in French: Appartement.
titlestring
Appartement à vendre, Maison en viager.
title_additionslist
What the title adds: occupé (a life annuity's owner stays).
headlinestring
The seller's line above the description.
descriptionstring
The seller's text, whole, as written (line breaks kept).
languagestring
The description's language, as SeLoger says: fr.
referencestring
The seller's own reference of the listing (Référence annonce).
price.amountfloat
price.currencystring
ISO 4217
price_periodstring
month for a rent; null for a sale.
price_notestring
What the page writes under the price: 12 294 €/m², charges comprises, et 596 €/mois.
charges_includedboolean
A rent with its charges (cc) or without (hc); null for a sale.
price_detailslist
Each line of the price section, in its order and words: the price with or without fees, the fees and who pays them, a deposit, a life annuity's rent, the estimated energy bill, a rent's legal cap.
price_messageslist
What the price section says besides: Les honoraires sont à la charge du vendeur.
roomsinteger
bedroomsinteger
living_areafloat
m².
plot_areafloat
m², a house's land.
factslist
The facts the page lists at its top, in its words.
featureslist
Every feature the seller gave, by the page's categories: Informations générales, Accessibilité, Intérieur, Extérieur, Équipements, Sécurité et services.
features_by_ailist
Features SeLoger's own AI read in the listing and the page shows as such (Ascenseur), not the seller's.
energy_classstring
The energy performance class (DPE), A to G.
energy.detailslist
The energy section's facts: year of construction, state, heating, energy source.
energy.certificateslist
The energy performance (DPE) and greenhouse gas (GES) certificates, each with its rating and values.
building_statestring
SeLoger's state of the building: first_time_use, mint_condition, well_kept, refurbished, need_of_renovation, to_refurbish.
year_builtinteger
co_ownershiplist
The co-ownership the listing is in: its number of lots, annual charges, an ongoing procedure.
is_newboolean
SeLoger's Nouveau badge: put online recently.
is_exclusiveboolean
has_3d_visitboolean
has_brokerage_feeboolean
SeLoger's flag of an agency fee shown apart.
photoslist
floor_planslist
videoslist
virtual_tourslist
location.citystring
location.postal_codestring
location.districtstring
location.departmentstring
location.regionstring
As SeLoger's page data names it (its names are not all French).
location.countrystring
location.address_publishedboolean
The seller shows the street on the page.
location.latitudefloat
The property's own point, when the seller published its address; else null.
location.longitudefloat
location.place_idslist
SeLoger's places the listing is in, from the smallest: each id can be a search's locations=.
location.geometryobject
GeoJSON, as the page's map has it: a Point, the property itself, when the seller published its address (3 listings of 8 on 12/11); else a MultiPolygon, the neighbourhood or the city it is drawn in.
location.transportlist
location.schoolslist
The schools nearby the page lists, with the times to reach them it shows.
area_price_per_m2.averagefloat
area_price_per_m2.lowfloat
area_price_per_m2.highfloat
area_price_per_m2.accuracyinteger
SeLoger's confidence in it, 1 to 5.
area_price_per_m2.placestring
area_price_per_m2.place_idstring
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
seller.contact_namestring
seller.phoneslist
seller.addressstring
seller.websitestring
seller.profile_urlstring
seller.logo_urlstring
seller.fees_urlstring
seller.sirenstring
seller.siretstring
seller.legallist
ids.listing_idstring
ids.legacy_idstring
The listing's former numeric id.
ids.client_idstring
The seller's id: seller.id.
source_urlstring
The page these values were read from.
observed_atdate
When they were read

Errors

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

CodeStatusWhat it means
invalid_listing422The value is neither a seloger.com listing's id nor its address.
other_site422This listing is shown on another site than seloger.com (Belles Demeures, SeLoger Neuf). Not charged.
listing_gone404This listing is no longer online, or never was (SeLoger answers both the same way). Not charged.
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

1 credit a call. A failed call is free. What a credit costs on each plan: Credits and pricing.

Changelog

1.0.02026-11-12
First version on the API v2: one seloger.com listing, whole, by its id or address: the full description, every feature, the energy certificates, each line of the price, the co-ownership, the schools nearby, SeLoger's price per m² of the area, and the seller with its phones, SIREN and SIRET.