Request an Application

First steps before starting the integration

The RE OLX API allows your clients to manage their inventory on our supported sites in real-time. If you are not confident that we have the features you need, please request a demo session through our email: [email protected].

Register as a Developer

Before you can use the OLX Group API, you need to register as a Developer. Please use this page to do that.

Required Info

Notes

Name

Name and surname or company name

Email

Email that will be used to create your account

Phone number

A phone number where we can reach you

Sites

Choose one or more:

  • Imovirtual.com
  • Otodom.pl
  • Storia.ro

Description

Describe briefly the purpose of your integration

After submitting the form, you will need to confirm the registration by clicking on the activation link sent to the email address provided.

Registering an account does not mean that you will be able to use the API, as your account must first be approved. This process may take a few days so please be patient.

Create a new application

Once your developer account is approved you can log in to your account. Open Application Manager and select the Applications tab on the left. Then click on the New Application button and fill in the form:

Required Info

Description

Required

Notes

Name

The name of your application

Mandatory

URN

It will be completed automatically. In case the URN is occupied, you can change it.

Mandatory

Logo

Logo to be displayed on the authorization page on our Sites.

Optional

Formats allowed: .png or .jpeg
Max resolution: 400x400
Min resolution: 100x100
Ratio 1:1

URL

The application's homepage URL

Mandatory

Authentication callback URL

Within the OAuth2 Authorisation Flow, we'll be redirecting the Application User to this Callback URL

Mandatory

Notification secret

A string which will be used to sign the webhook

Optional

A private key that will be used to create a HMAC SHA1 signature of the generated JSON content of the notification.

Notification callback URL

The callback URL where you will receive webhook notifications

Mandatory

This URL must be able to respond to unauthenticated POST requests with a JSON payload such as the one in the Webhooks section. Although not required, we highly recommend that this URL is served by HTTPS.
We expect to receive a 2xx code from this URL.

For more information about check the Webhooks reference section

If the form has been completed correctly, the credentials will be automatically generated when you save the form.

❗️

Never share your application secrets

The Client ID, Client Secret, Basic Base64, and API Key that you have been given are secret information. It's very important to never share them with anyone (including committing to a repository). We recommend you to store them in private environment variables.