OnTop Placement (Commercial) - NEW


  • this is a new endpoint only for commercial listings available at 1st August 2018
  • The existing OnTop API will be not supported for commercial real estate types starting the 1st August 2018
  • if you want to use this endpoint and need support, please contact us via commercial-api@scout24.com

Commercial real estate types are

  • OFFICE ("Büros / Praxen")
  • INDUSTRY ("Hallen / Produktion")
  • GASTRONOMY ("Gastronomie / Hotels")
  • STORE ("Einzelhandel")
  • TRADESITE ("Gewerbegrundstücke")
  • SPECIAL_PURPOSE ("Spezialgewerbe")


OnTop is not a ressource, but rather a topic. There are 2 different ontop placements. So we have 2 different resources to add an ontop placement to a real estate. The requests and methods of the 2 ressources are similar, only the type of the OnTop placement changes.


  • if an object is deactivated in the is24 publish channel 10000, every given OnTop Placement will also be deactivated!
  • only one type of OnTop placements (first OR business) can be set per real estate.

Possible OnTop Placements:

  • firstplacement ("First-Platzierung")
  • businessplacement ("Business-Platzierung")

Schema definition

OnTop Placement by ID

https://rest.immobilienscout24.de/restapi/api/commercial-offer/v1.0/user/{username or me}/realestate/{id or externalId}/ontop/{ontop placement}/

Supported methods