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.0When 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.
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" } }'
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
listingstringrequiredid 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).
objectstringidstringurlstringtransactionstringtransaction_subtypestringproperty_typestringproperty_labelstringtitlestringtitle_additionslistheadlinestringdescriptionstringlanguagestringreferencestringprice.amountfloatprice.currencystringprice_periodstringprice_notestringcharges_includedbooleanprice_detailslistprice_messageslistroomsintegerbedroomsintegerliving_areafloatplot_areafloatfactslistfeatureslistfeatures_by_ailistenergy_classstringenergy.detailslistenergy.certificateslistbuilding_statestringyear_builtintegerco_ownershiplistis_newbooleanis_exclusivebooleanhas_3d_visitbooleanhas_brokerage_feebooleanphotoslistfloor_planslistvideoslistvirtual_tourslistlocation.citystringlocation.postal_codestringlocation.districtstringlocation.departmentstringlocation.regionstringlocation.countrystringlocation.address_publishedbooleanlocation.latitudefloatlocation.longitudefloatlocation.place_idslistlocations=.location.geometryobjectlocation.transportlistlocation.schoolslistarea_price_per_m2.averagefloatarea_price_per_m2.lowfloatarea_price_per_m2.highfloatarea_price_per_m2.accuracyintegerarea_price_per_m2.placestringarea_price_per_m2.place_idstringpublished_atdateupdated_atdateseller.typestringseller.kindstringseller.idstringseller.namestringseller.contact_namestringseller.phoneslistseller.addressstringseller.websitestringseller.profile_urlstringseller.logo_urlstringseller.fees_urlstringseller.sirenstringseller.siretstringseller.legallistids.listing_idstringids.legacy_idstringids.client_idstringsource_urlstringobserved_atdateErrors
Its own, besides those of every call (Errors). A failed call is free.
| Code | Status | What it means |
|---|---|---|
invalid_listing | 422 | The value is neither a seloger.com listing's id nor its address. |
other_site | 422 | This listing is shown on another site than seloger.com (Belles Demeures, SeLoger Neuf). Not charged. |
listing_gone | 404 | This listing is no longer online, or never was (SeLoger answers both the same way). Not charged. |
site_challenge | 503 | SeLoger asked to prove a person is there; retry in a minute (not charged). Retryable. |
site_unavailable | 503 | SeLoger did not answer in time or refused the call; retry later (not charged). Retryable. |
unexpected_answer | 424 | SeLoger 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