OnTop Placement (Commercial) - NEW
PLEASE NOTE:
- 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.
NOTICE:
- 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}/