Search
K

Manage classifieds

Status: Live 🟢 Market: 🇫🇷

Executive Summary

  • Goal: Display classifieds on our portals like SeLoger, SeLoger Neuf, SeLoger Construire, SeLoger Bureaux & Commerces, Belles Demeures.
  • Value Proposition: Classifieds are being publicly available.
  • Ideal for: French Real Estate agents willing to publish classifieds.

The Integration Workflow

Step 1: Providing a brand-new classified

  • Logic: Send a brand-new classified specifying the portal the customer wants to publish on. For any given portals, if quotas of customer’s contracts are not yet reached and the classified is eligible, the classified will be published accordingly.
  • Technical Link: POST Classified.

Step 2: Qualification

  • Logic: Receptions of classifieds are acknowledged with a 202 response. For error management, please refer to the dedicated section.

Step 3: Updating a classified

  • Logic: Whenever any data of a classified needs to be added, updated or removed, full classified shall be sent through PUT Classified.

Step 4: Send a stable classified update

  • Logic: Please, consider sending us a consolidated update of a classified.
    • As users may change several data, send us a unique API call that will sum up all these changes at once.
    • If nothing has changed then retain from sending us an update.
    • Whenever a classified update is strictly the same as the previous classified’s state, no update will occur on our side.

Classified types and mandatory data

Resale

  • Portal: SL
  • Required data:
    • EstateType, EstateSubType, DistributionType
    • postalCode, city, country
    • prices.buy.price.amount
    • metaData.source and its sub attributes.

Rental

  • Portal: SL
  • Required data:
    • EstateType, EstateSubType, DistributionType
    • postalCode, city, country
    • prices.rent.baseRent.amount
    • metaData.source and its sub attributes.

Luxury

  • Portal: BD
  • Required data:
    • EstateType, EstateSubType, DistributionType
    • postalCode, city, country
    • prices must comply to thresholds set according to resale / rental types and locations
      • All prices are accepted for EstateSubTypes CASTLE, MANOR_HOUSE, MANSION
      • Please contact our customer care for more information on these Thresholds
      • Please contact our customer care for more information on forbidden classifieds
    • metaData.source and its sub attributes.
    • At least one picture is required.
    • When provided, surface must be >= 20m²
    • Description minimum length of 160 characters

Bureaux & Commerces

  • Portal: BUCOM
  • Required data:
    • Only available for classifieds with EstateType TRADING
    • data.prices.rent.countrySpecific.fr.leaseRight (in French: prix de la cession)
    • Same data as resale and rental.

SeLoger Neuf

  • Portal: SLN
  • Required data:
    • Please refer to New Builds & New Homes Use cases.

SeLoger Construire

  • Portal: SLC
  • Required data:
    • Please refer to New Builds & New Homes Use cases.

Publish a classified

Publish a classified

  • Logic: At classified creation, you must request a portal to publish on. A classified must have at least one portal. An empty portal list will result in an error.

Publish a classified on multiple portals

  • Logic: A classified can be published on multiple portals, as far as our offers allow it. Any portal can be added or removed at any time through PUT Classified. While still complying to the previous rule.

Stop publication of a classified

  • Logic: Whenever a classified shall cease to appear on our portals, said classified must be deleted.
  • Technical Link: DELETE Classified.

Error Handling (The “Sad Path”)

  • Logic: Errors can be either fetch through our status API or through our webhook. Please refer to dedicated API documentation.
  • Technical Link: GET Classified Statuses and Webhooks.

Resources