The webservices of the import Export REST API
Howto create and publish real estate objects by REST-API
- Authenficate the user (= the ImmobilienScout24 customer) Tutorial
- Create a real estate object POST REALESTATE
- Optional: create a contact address and link it to the real estate objects POST CONTACT
- Optional: synchronize your contact addresses. Docu
- Optional: create multimedia attachments POST ATTACHMENT
- Request in which publish channel the user is allowed to publish real estate objects GET PUBLISHCHANNEL
- Publish the real estate object POST PUBLISH Important: please send the publish requests after each other and not paralell.
Steps to implementing the REST-Import-Export API
- Send us an email to firstname.lastname@example.org requesting a sandbox accesss (since the online registration hands out a productional access)
- Youll get an api access and a customer test account, both are only valid in the sandbox environment.
- Use the Playground for getting a feeling for the API and the authentification
- Enter your api access data (key and secret, which you got by email) in the playground (choose "own key" and "sandbox" and perform the oAuth authentification (left below). Therewith, you get an authentificated user, which is a prerequisite for using the import export api.
- Take the min/max XML files and use them within your first POST REALESTATE request in the playground. Try other request like GET/PUT REALESTATE or (ATTACHMENT, PUBLISH, CONTACT).
TIP: You can call the sandbox server by browser: https://www.sandbox-immobilienscout24.de -> login with your testaccount username and password and you can see the objects you've created by API.
- Start with the implentation in your software. First oAuth, then the API. There are SDKs for the import export api and which contain the oAuth implementation, see the links below.
- When you're done, register for the productional environment of the REST-API and you'll get a productive access right away, with which you'll have to the authentification for your customer(s).
Short help on 3-legged oAuth
This process is integrated in the follwing SDKs:
Your user (the realtor) needs to give your application access to his immobilienscout24 account, one time only. You'll then get a token which you save permanently and which never expires:
- Send the request token request with a callback url to your server
- Send the authorize token request, open the authorize token url, which leads to a new browser session which shows the immobilienscout24.de single-sign-on page, the user logs in and on the following page, grants access to your application
- IS24 automatically sends a request to your callback url. You get the verifier.
- With the verifier, you can generate the access token and the access token secret. You save both in your database and use it within every request. You don't need the verifier anymore.