News

[Fabian Mielke@ImmobilienScout24]

Hallo Community,

in diesem Thread werden wir zukünftig Neuigkeiten, Probleme und Ankündigungen posten (äquivalent zum Immoscout REST API Twitter Account). Bitte diesen Thread abonnieren und via E-Mail informiert werden!

Gesammelt schicken wir diese Informationen ca. vierteljährlich via API Newsletter heraus - einfach für den API Newsletter anmelden oder einen API Key erstellen und automatisch den API Newsletter abonnieren.

Mit freundlichen Grüßen

Fabian

---

Hello community,

in this thread we will post news, problems and announcements (equivalent to the Immoscout REST API Twitter account). Please subscribe this thread and you will be informed via email.

We will send the collected informationen quarterly to you via API Newsletter. Just subscribe the API newsletter or create an API key and subscribe the API newsletter automatically.

Kind regards,

Fabian

[Fabian Mielke@ImmobilienScout24]

Sandbox Downtime dauerte länger als erwartet, ist aber nun vorbei. Letztendliche Downtime erstreckte sich von Freitag, 5. August 16:00 Uhr bis Montag, 8. August 10:15 Uhr.

---

Sandbox Downtime took longer than expected, but is over right now. Downtime at all from Friday, 5 august 4 pm to Monday, 8 august 10.15 am.

[Fabian Mielke@ImmobilienScout24]

Import/Export API: Neues Pflichtfeld "name" für Neubauprojekte - betrifft XSD Schema

---

Import/Export API: New mandatory field "name" for real estate projects - concerns XSD schema

[Pietro Tallarico@ImmobilienScout24]

Sandbox Downtime von Samstag 08. Oktober 08:00 Uhr bis Montag 10. Oktober 12:00 Uhr. Entschuldigt die dadurch entstandenen Umstände.

---

Sandbox Downtime from Saturday, 8th October 8am to Monday, 10th October 12pm. We apologize for any inconvenience caused.

[Fabian Mielke@ImmobilienScout24]

GeoAutoCompletion (GAC) v2 API ist live und ersetzt die veraltete Region autocomplete v1 API
Wir verabschieden uns von der Region autocomplete v1 API und sagen Hallo! zur GeoAutoCompletion (GAC) v2 API. Diese REST API ersetzt den Vorgänger nicht nur, sondern bietet noch mehr Funktionalitäten. Zum Beispiel können österreichische Geoinformationen abgerufen, die zurückgegebenen Inhalte (nur Länder, Städte, PLZs, Straßen oder Bahnhöfe) bestimmt, Geokoordinaten abfragt und die Position der Suchtreffer erhalten werden. Das PHP SDK und der Playground enthalten die Funktionalität der GAC v2 API bereits.

Für die v2 API wird eine spezielle Berechtigung benötigt. Für alle Nutzer der v1 API haben wir dieses Recht bereits eingerichtet. Wenn Sie trotzdem den Fehlercode 403 bei einer Response erhalten, füllen Sie bitte das Formular API Permission Request aus.
Ihre Applikation ist von dieser Änderung betroffen, wenn die URI /restapi/api/search/v1.0/region?q= aufgerufen wird. Eine Hilfe zur v1 -> v2 Migration finden Sie hier: https://api.immobilienscout24.de/our-apis/gis/migrate-regionautocompletionv1-to-geoautocompletionv2.html
Die Abschaltung erfolgt am 31.01.2017.

---

GeoAutoCompletion (GAC) v2 API is live and replaces the deprecated Region autocomplete v1 API
We say good bye to the Region autocomplete v1 API and welcome the GeoAutoCompletion (GAC) v2 API. This REST API does not only replace the deprecated API, but is more useful. For example you can receive geo information from Austria, decide which content should be delivered (only countries, cities, post codes, streets or train stations), you can ask for geo coordinates and get information about the position of the matched input query. The PHP SDK and the Playground were still enhanced by this functionality.

For the v2 API you will need a special permission which v1 API clients still have. If you receive a 403 response, please ask for that by filling out the API Permission Request form.
Your application is affected by this change if it calls the following uri: /restapi/api/search/v1.0/region?q=. You can find a help for the v1 -> v2 migration here: https://api.immobilienscout24.de/our-apis/gis/migrate-regionautocompletionv1-to-geoautocompletionv2.html
The cutoff will be at 31 January 2017.

[Fabian Mielke@ImmobilienScout24]

360° Links verfügbar und per Import/Export API übertragbar
360° Links werden in der Ergebnisliste und Exposé gesondert gekennzeichnet und dargestellt. Details zur Darstellung finden Sie hier: https://www.immobilienscout24.de/anbieten/lp/virtualreality.html und https://www.immobilienscout24.de/anbieten/lp/virtual-reality_anbietervergleich.html
Die Übertragung solcher 360° Links mittels API ist einfach. Sie werden via Import/Export API als übliche Attachment-URL übertragen.
Die Änderung ist bereits live. Details finden Sie hier: http://api.immobilienscout24.de/our-apis/import-export/attachments/post.html#xml-url 

---

360° links are available and can be delivered via Import/Export API
360° links will be displayed specially in result list and expose. Details for the presentation you can find here: https://www.immobilienscout24.de/anbieten/lp/virtualreality.html and https://www.immobilienscout24.de/anbieten/lp/virtual-reality_anbietervergleich.html
The transfer of such 360° links via API is easy to implement. It will be delivered as an usual attachment-URL.
The change is already live. You can find details here: http://api.immobilienscout24.de/our-apis/import-export/attachments/post.html#xml-url

[Fabian Mielke@ImmobilienScout24]

TOP Import/Export API Fehler
Wir untersuchten unsere Import/Export API und erstellten eine Liste der am häufigsten vorkommenden Fehlermeldungen. Alle gelisteten betreffen die Ressource realestate. Am zahlreichsten wird versucht, ein Objekt zu erstellen, welches es bereits gibt. Weiter befinden sich Meldungen bzgl. des Energieausweises in der TOP Liste, sowie Fehler in der Reihenfolge des Request Bodies.
Schützen Sie Ihre Software und deren Nutzer vor diesen typischen Fehlermeldungen: https://api.immobilienscout24.de/useful/top-import-export-api-errors-092016.html

---

TOP Import/Export API Errors
We made some researches in the Import/Export API and created a list which shows the most frequented error messages. Every listed error concerns the resource realestate. The error which occurs most often is the creation of a real estate with an external id which still exists within in the realtor account. Moreover there are many messages according to the energy certificate and chronology of the request body.
Protect your software and their users against that common error messages: https://api.immobilienscout24.de/useful/top-import-export-api-errors-092016.html 

[Pietro Tallarico@ImmobilienScout24]

Ablauf HTTP Support

ImmobilienScout24 wird die Nutzung der REST-API Schnittstelle ab Ende März 2018 nicht mehr über HTTP anbieten. Die bereits in unserem API-Newsletter Ende 2016 mitgeteilte Änderung dient der Optimierung zum Schutz Ihrer Daten sowie der Daten Ihrer Kunden.

 

Dies bedeutet konkret für Sie: Mit Wirkung zum 31. März 2018 werden wir ausschließlich die verschlüsselte Übertragung mittels HTTPS anbieten und damit die Datenübertragung per HTTP einstellen. Damit werden Sie unsere REST-Schnittstelle künftig ausschließlich über HTTPS benutzen können.

---

End of HTTP-Support

From end of March 2018, ImmobilienScout24 will no longer offer the use of its REST-API interface via HTTP. This change was announced in our API newsletter at the end of 2016 and is intended to improve the protection of your data and that of your customers.

 

Specifically, this means that, with effect from 31 March 2018, we will only offer encrypted transfer via HTTPS and therefore discontinue data transmission via HTTP. In future, you will therefore be able to use our REST interface via HTTPS only.

[Pietro Tallarico@ImmobilienScout24]

Downtime today

Sandbox und API Playground werden heute um 12 Uhr für ca. 1 Stunde offline sein.

Entschuldigt die Umstände.

-------

Sandbox and API Playground will be offline for approximately 1 hour starting from 12 PM.

We apologize for any inconvenience.

[Pietro Tallarico@ImmobilienScout24]

WICHTIGE INFORMATION / IMPORTANT NOTICE:

Der API Playground und unsere Sandbox wird heute aufgrund einer technischen Anpassung beeinträchtig sein. Die Beeinträchtigungen beginnen ca 10:30 und können ich über den ganzen Tag erstrecken. Die Import/Export API und andere Services können betroffen sein.

----------

Our API playground and the Sandbox environment will be impacted by an internal change today. This will start affecting the systems around 10:30 and might continue for the whole day. Expect the Import/Export API and other services to be affected. Apologies for any inconvenience.

[olaf.l...@scout24.com]

WICHTIGE INFORMATION / IMPORTANT NOTICE:

Die API wird Donnerstag 28.03.2019 von ca. 0:30 bis ca. 02:30 Uhr aufgrund von Wartungsarbeiten nicht erreichbar sein. Bitte entschuldigt die Unannehmlichkeiten

-------------------------------

Because of maintenance the API will not be reachable. This will start affecting the systems thursday morning around 0:30 and might continue until 02:30 o'clock. Apologies for any inconvenience.

[olaf.l...@scout24.com]

WICHTIGE INFORMATION / IMPORTANT NOTICE:

Our APIs will be down for maintenance on April 2nd from approximately 00:30 to 2:30 AM! Kindly, take all necessary measures on your end to maintain your system’s performance. We apologise for this inconvenience.

--------------------------------

Das API Endpoint “Export/Import” wird am 02. April von ca 00:30 bis 2:30 nicht erreichbar sein! Bitte stellen Sie sicher, dass Ihre Systeme dadurch nicht beeinträchtigt werden. Wir entschuldigen uns für diese Unannehmlichkeiten.

[Olaf Lindenau]

Our APIs will be down for maintenance on Juni 22nd from approximately 06:00 to 7:00 AM! Kindly, take all necessary measures on your end to maintain your system’s performance. We apologise for this inconvenience.

--------------------------------

Das API Endpoint “Export/Import” wird am 22. Juni von ca 06:00 bis 7:00 nicht erreichbar sein! Bitte stellen Sie sicher, dass Ihre Systeme dadurch nicht beeinträchtigt werden. Wir entschuldigen uns für diese Unannehmlichkeiten.

[Olaf Lindenau]

Dear ImmobilienScout24 API users,

We want to hear from you!

Do you want to have a say in ImmobilienScout24's new API Strategy?

Let us know your thoughts by filling out this survey- It only takes 5 minutes!

Please go to: https://indivsurvey.com/is24/1175644/pwS54u

Thanks in advance,

Your ImmobilienScout24 API Team

-------------------------------------------------------------
Liebe ImmobilienScout24 API Nutzerinnen und Nutzer,

Wir wollen von euch hören! Wie können wir unsere API Programm verbessern um Eure Zufriedenheit zu erhöhen?
Lasst es uns wissen, indem Ihr in folgende Umfrage teilnimmt: 
https://indivsurvey.com/is24/1175644/pwS54u

Es dauert nur 5 Minuten!

Danke im Voraus,

Euer ImmobilienScout24 API Team

[Olaf Lindenau]

Our APIs will be down for maintenance on November 6nd from approximately 02:30 to 3:30 AM! Kindly, take all necessary measures on your end to maintain your system’s performance. We apologise for this inconvenience.

--------------------------------

Das API Endpoint “Export/Import” wird am 06. November von ca 02:30 bis 03:30 nicht erreichbar sein! Bitte stellen Sie sicher, dass Ihre Systeme dadurch nicht beeinträchtigt werden. Wir entschuldigen uns für diese Unannehmlichkeiten.

[Olaf Lindenau]

Enexpected Downtime today

Sandbox und API Playground waren heute in der Zeit von 9:00 - 09:50 Uhr nicht zu erreichen.

Entschuldigt die Umstände.

-------

Sandbox and API Playground were offline from 09:00 - 09:50 o'clock.

[Olaf Lindenau]

Enexpected Downtime today

Aufgrund von Wartungsarbeiten sind die Sandbox und der API Playground seit 8 Uhr nicht nutzbar. 

Entschuldigt die Umstände.

-------

Because auf maintenance Sandbox and API Playground are not available since 8 o'clock.

[Olaf Lindenau]

Enexpected Downtime today

Sandbox und API Playground waren heute in der Zeit von 8:00 - 12:30 Uhr nicht zu erreichen.

Entschuldigt die Umstände.

-------

Sandbox and API Playground were offline from 08:00 - 12:30 o'clock.

[Olaf Lindenau]

Our Sandbox will be down for maintenance tomorrow morning (Tue 10.12.19). We'll keep you updated as soon as it's back up and running. We apologize if this causes any inconvenience.

----------------

Unsere Sandbox wird aufgrund von Wartungsarbeiten morgen (10.12.2019) nicht erreichbar sein. Wir werden euch informieren, sobald diese wieder erreichbar ist. Wir entschuldigen uns für entstehende Unannehmlichkeiten.

[Olaf Lindenau]

Our Sandbox has been available again since 15 o'clock.

-------------------------------

Unsere Sandbox ist seit 15 Uhr wieder erreichbar.

[Olaf Lindenau]

Maintenance is scheduled for the Export/Import Offer API on Tuesday the 17th from 7-9 AM. During that period no insertion, editing or publication of listings will be possible.
----------------------------------------
Am Dienstag 17.12.2019 finden während der Zeit von 7-9 Uhr Wartungsarbieten an der Import/Export API statt. Während dieser Zeit ist keine Inseration, Bearbeitung oder Veröffentlichung von Anzeigen möglich.

[Olaf Lindenau]

Dear Developers, Our Developer Portal will be down tomorrow! Stay tuned for what's coming up! Your ImmobilienScout24 API Team

[Olaf Lindenau]

Sehr geehrte API-Nutzerinnen & -Nutzer,Wir möchten Sie hiermit bezüglich unserer geplanten Downtime für die APIs informieren. Wir führen in der unten angegebenen Zeit wichtige Sicherheitsupdates und Wartungsarbeiten durch, um unsere Services für Sie und unsere Kunden stabiler und sicherer zu machen. Wir erwarten eine Degradierung bis hin zu kompletter Unerreichbarkeit unserer Services. Bitte stellen Sie sicher, dass die Kontinuität Ihre Services in der Zeit gewährleistet werden.Alle API Endpunkte der ImmobilienScout24 sind zu den folgenden Zeitpunkten betroffen:Sandbox Downtime: Am 18.02.2020 von 10-12 Uhr
Produktiv Downtime: Am 25.02.2020 von 7-9 Uhr Sobald wir mit den Wartungsarbeiten durch sind werden wir Ihnen dieses Mitteilen.Wir entschuldigen uns sehr für die Unannehmlichkeiten. Bei Fragen können Sie sich jederzeit bei uns unter ser...@immobilienscout24.de, Google Groups oder Twitter melden.Wir bedanken uns und verbleiben mit freundlichen GrüßenIhr ImmoScout24 API Team 
Dear ImmoScout24-API users,
 
We will be carrying out important security updates and maintenance work for our APIs and their underlying infrastructure. Service degradation and downtime is expected. We kindly ask you to take all necessary measures on your end to ensure the continuity and performance of your systems.
 
All API endpoints are affected at the following times:
 
Sandbox Downtime: 18.02.2020 from 10-12 AM 
Production Downtime: 25.02.2020 from 7-9 AM 
 
We apologize for the inconvenience, and we will let you know once we have completed all the updates.
If you have any questions, please feel free to get in touch via one of our communication channels: ser...@immobilienscout24.de, Google Groups, or Twitter.
 
Best regards,
 
Your ImmoScout24 API Team

[Olaf Lindenau]

Dear developers,

We've introduced a new field for the contact API -> secondaryEmail.

Please check our changelog (api.immobilienscout24.de/more/changelog/)
We recommend that you add it to your software, otherwise any changes made by the users on www.immobilienscout24.de will be overridden by your system.

Thank you!

Your ImmoScout API Team

[Olaf Lindenau]

Dear Developers!

We know that using OAuth 1.0 is difficult and faulty. Therefore, we’ve updated our documentation with the hope that it makes things easier for you.

You’ll find the new docs, with code examples and a GitHub repository that includes a small app to try out the authentication here : https://api.immobilienscout24.de/api-docs/authentication/introduction/

Please let us know if this is helpful for you - or not - by leaving comments here in this thread or clicking the like buttons on the docs page.

Your ImmoScout API Team

[Olaf Lindenau]

Dear Developers,

The reachability of our APIs on SANDBOX will be strongly limited because of maintenance on August 30th from approximately 1:00 to 3:00 PM! Kindly, take all necessary measures on your end to maintain your system’s performance. We apologize for this inconvenience.

Your ImmoScout API Team

[Olaf Lindenau]

Dear Developers,

For security reasons we will discontinue support for TLS version 1.0 for rest.immobilienscout24.de and auth.immobilienscout24.de.

This will happen on February 25th. From then on only TLS version 1.3 will be supported. Please make sure that your clients are updated accordingly.

Thank you!

Your API Team

[Olaf Lindenau]

Our Sandbox test environment will undergo maintenance work. The work will start tomorrow February 10th, at 10 AM. Expect performance degradation. We will inform you once we have successfully completed the work.

Thank you for your understanding.

Your API Team

[Olaf Lindenau]

Our Production environment will undergo maintenance work. The work will start on February 24, at 10 AM. Expect performance degradation.

We will inform you once we have successfully completed the work.

Thank you for your understanding.

Your API Team

[Olaf Lindenau]

Hello Community,

Postman Collections are here!

We are replacing our API Playground with Postman collections that can easily be imported into Postman and used. Postman is a great tool if you’re trying to analyze and test RESTful APIs without writing any code. Details on how you can start using Postman collections you can find here.

The API playground will be turned off on July, 17th.

[Olaf Lindenau]

Expected downtime and degradation of service, due to planned maintenance and security updates

We will be carrying out important security updates and maintenance work for our APIs and their underlying infrastructure.

Service degradation and downtime is expected. All API endpoints are affected at the following times:

Production Downtime: 15.07.2021 from 10 PM - 12 AM

We apologize for the inconvenience and kindly ask you to take all necessary measures on your end to ensure the continuity and performance of your systems.

[Olaf Lindenau]

Hello Community,

to make our services more stable and secure for you and our customers, we are performing important security updates and maintenance work Sunday, During this time, it will not be possible to publish or deactivate items. Please ensure that the continuity of your services is guaranteed during this time. All API endpoints are affected at the following time:

Sunday 26.03.2022 start 10 PM to Monday 27.03.2022 end 6 AM.

We apologize for the inconvenience and kindly ask you to take all necessary measures on your end to ensure the continuity and performance of your systems.