Skip to content

Your personal Access Token

Introduction

Your personal access token is a three-legged access token, that provides an access to your own scout data.
It is the easiest way to try out the API in your own code. If you have not yet obtained it, you can use the Postman Collection.
There you will be asked to login to your personal account then you can extract the access token and the access token secret from the interface.

Code Examples

When you have your access token, you can access is24 resources: 

1
2
3
4
5
6
7
// This is how you can use your own personal access token using SignPost library to access data from the protected resource  
OAuthConsumer consumer = new DefaultOAuthConsumer(CONSUMER_KEY, CONSUMER_SECRET);  
consumer.setTokenWithSecret(PERSONAL_ACCESS_TOKEN, PERSONAL_ACCESS_TOKEN_SECRET);  
URL url = new URL(PROTECTED_RESOURCE_ENDPOINT);  
HttpURLConnection request = (HttpURLConnection) url.openConnection();  
consumer.sign(request);  
request.connect();

1
2
3
4
5
6
7
8
9
# This is how you can use your own personal access token using requests_oauthlib library to access data from the protected resource  
from requests_oauthlib import OAuth1Session
immoscout_api = OAuth1Session('client_key',
                            client_secret='client_secret',
                            resource_owner_key='your_personal_access_token',
                            resource_owner_secret='your_personal_access_token_secret')  
url = 'https://rest.sandbox-immobilienscout24.de/restapi/api/offer/v1.0/user/me/realestate/'  
r = immoscout_api.get(url)
print(r)

Note: Even if you have your own access token, there might be some data, which you will not be able to access, because your system does not have all the required permissions.