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.0When 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.
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" } }'
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
urlstringrequiredpage 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.cursorstringnext 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).
objectstringidstringpositionintegerurlstringtransactionstringproperty_typestringproperty_subtypestringproperty_labelstringtitlestringheadlinestringdescriptionstringstatusstringprice.amountfloatprice.currencystringprice_periodstringprice_notestringprice_per_m2floatprevious_price.amountfloatprevious_price.currencystringprice_change_percentfloatcharges_includedbooleanroomsintegerbedroomsintegerliving_areafloatplot_areafloatfactslistenergy_classstringbuilding_statestringyear_builtintegeris_newbooleanis_exclusivebooleanhas_3d_visitbooleanhas_brokerage_feebooleannew_build.namestringnew_build.descriptionstringnew_build.urlstringphotoslistfloor_planslistlocation.citystringlocation.postal_codestringlocation.districtstringlocation.departmentstringlocation.regionstringlocation.countrystringlocation.address_publishedbooleanlocation.place_idslistlocations=.location.transportlistpublished_atdateupdated_atdateseller.typestringseller.kindstringseller.idstringseller.namestringseller.contact_namestringseller.phoneslistseller.addressstringseller.citystringseller.postal_codestringseller.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_url | 422 | This URL is not a seloger.com search this operation reads. |
invalid_search | 422 | SeLoger refuses this search; send it as the previous answer's next gives it, or the search's url alone. |
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
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-13next 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-12next is a URL again; search only follows a search by travel time or with no place, read from its page.1.1.02026-11-12next 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