Getting the API key to use Oikotie real estate API

This documentation describes on how to get the api key for your company to access your statistisc and other resources over the api.

Requirements

To be able to generate a new api key your user must be associated to a company first.

The api is not available for private users.

Instructions

1. Login to Oikotie real estate portal
2. Go to company settings API section
3. Login, and press the person icon in the top right corner
4. Press company settings (Yritysasetukset)
5. Move to the tab called "API"
6. Insert the email address of the contact person for this speficic api key and click save (Luo avain)

Note that you can have multiple api keys for your company.

Using the api key

The API key must be preasent in the request headers in field key.

Documentation

Api documentation is available at Real estate swagger spec or in the API section of this documentation portal.

Testing

You can test the api key by for example using the following curl command:

curl -H 'key: 32j4hg324k23h4...' https://asunnot.oikotie.fi/api/...

Removing old api keys

If you no longer need an api key you should expire them from the same API section in company settings, by clicking the "-" icon next the the api key.

---

Last update: March 11, 2026