Tilbudsdata.dk API
This is the documentation of the API for Tilbudsdata.dk.

The API allows technicians and developers of our customers to extract data directly from our database using the technical functions outlined below.
This page is meant as an overview of the API, but general use happens through script or code made by software developers or your company’s equivalent position.
If you’re a customer of ours, or wish to become one and use the API, please contact us at: support@effectmanager.com.

For developers:

The api is used by sending requests to the root URL, api.tilbudsdata.dk. To do this, you are assigned by us a User ID and an API key. Your API key is considered secret and must not be shared with anyone outside of the people who need to use the API directly, that is, technicians or developers writing the program that calls the API.

Using parameters in the requests on a specific sub-url you can call specific functions, which you can find below this description in list format, separated by categories. Each request must at its basis contain the following parameters:
  • _userId: Your user ID as assigned by us upon creation of your API access. This lets us know who you are and which data you have access to.
  • _expiration: An expiration time in the form of a UNIX timestamp. Must not exceed 5 minutes. This protects against replay attacks.
  • _signature: A signature of the request, constructed as instructed below using your API key. This lets us know that you are who you say you are.

and may of course contain more, depending on which function is being called. In the following example we will use the /brand/getAll/ endpoint to demonstrate how to sign your request. First we construct our base, signatureless, request parameters.
BaseParams = /brand/getAll?page={page}&_userId={userId}&_expiration={expiration}
Where {page} is a page number (required for this endpoint, not required on all requests), {userId} is your user ID as assigned by us when creating your account, and {expiration} is a unix timestamp. You then concatenate this base request with your API key, and encrypt the resulting string using SHA-256.
Signature = SHA-256(Concat(BaseParams, APIKey))
You can then add your signature as a parameter to your basic request:
FinalParams = /brand/getAll?page={page}&_userId={userId}&_expiration={expiration}&_signature={signature}
Where {signature} is your generated signature.

Your data will be returned in a JSON array of objects and the objects’ format will of course be dependent on what you have asked the API for.

Intended use

The intent is to use the functions like brand/getAll and productName/getAll to gain a list of the IDs you can filter on. This list can be saved internally or used dynamically on runtime. The IDs listed here are then used to do a filter on the /getById functions, as well as the offer/search function.

On this page, you can test our functions on a limited set of data by pressing the authorize button directly below this description, and inputting “testApi” with no quotes as both the API-key and the user ID.

If something behaves unexpectedly or you have any questions, feel free to contact us at support@effectmanager.com.

Note: All page-numbers are 0-indexed, meaning the first page is page 0, the second page is page 1, and so on.