Skip to main content

Getting Started

This API allows you to search for product suggestions given a query string e.g video game. You can also get detailed product information given a product ID.

This guide will help you get set up to use our API. The base address of the Prisjakt Partner Search API is https://api.schibsted.com/prisjakt/partner-search. The first step is to set up client credentials and make an authentication request. Next make a request towards the suggestions endpoint to get a list of products related to your query. If you need detailed product information such as product properties and offers make a request towards the products endpoint.

Authentication​

All requests to the API require authentication. To prove that the user has been granted permission, the request header sent by the application must include a valid access token. As the first step towards authentication, you will need to register your application. This will give you a unique client ID and client secret.

To authenticate set the grant type (grant_type) to client_credentials, and set your client ID (client_id) and client secret (client_secret).

curl --request POST \
  --header 'content-type: application/x-www-form-urlencoded' \
  --data grant_type=client_credentials \
  --data client_id=<replace with client ID> \
  --data client_secret=<replace with client secret> \
   https://api.schibsted.com/prisjakt/partner-search/token
{
    "access_token": "eyJhbGciOC....",
    "expires_in": 600,
    "token_type": "Bearer"
}

Attribution​

To recieve attribution for clicks you have to append your ref to the API requests e.g ref query paramter as in the examples below.

Example requests​

Product Suggestions​

curl --location --request GET 'https://api.schibsted.com/prisjakt/partner-search/suggestions?market=se&product=video game&ref=<your ref id>' \
--header 'client-id: <replace with client ID>' \
--header 'Authorization: Bearer <replace with access token>'

Product information and offers​

curl --location --request GET 'https://api.schibsted.com/prisjakt/partner-search/products/4400600?market=se&ref=<your ref id>' \
--header 'client-id: <replace with client ID>' \
--header 'Authorization: Bearer <replace with access token>'

Rate Limiting​

To make the API fast for everybody, rate limiting is applied to the Client ID.

Production: 10,000 requests in 1 hour

The returned HTTP headers of any API request show your current rate limit status:

HEADERDESCRIPTION
X-RateLimit-LimitThe maximum number of requests you're permitted to make per hour.
X-RateLimit-RemainingThe number of requests remaining in the current rate limit window.
X-RateLimit-ResetThe time in milliseconds when the current rate limit window resets.

HTTP status code 429 is used to indicate that the current rate limit has been exceeded.

Status: 429 Too Many Requests
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 600000