Prisjakt Search API

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.

Getting started

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": "eyJhbGciOiJSUzUxMiIsInR5cCI6IkpXVCIsImtpZCI6ImM1U09QVmQyS0h6VW9mVFg2L3d6ekJYWkVqaz0ifQ.eyJpc3MiOiJodHRwczovL2FwaS1zdGFnZS5zY2hpYnN0ZWQuY29tL3ByaXNqYWt0L2F1dGgiLCJzY29wZSI6InJvbGU6c2VydmljZSIsInN1YiI6IjhkYjFjMzA4MzUzYjQ0ZTY5MTE1ODFjZDZmMGRiM2JkIiwiaWF0IjoxNjIzMDQ1ODE2LCJleHAiOjE2MjMwNDY0MTZ9.RQWSrWE0uIeiKdW11Hho0yLJBM6LVJSXxIJCvy8-CNmJ4xoncAcaizqKIpN-mIL1AYQXFFDLrB_y0iZOoHBKnwjUVRt14OUhUjVuV57ntIFMAy5Xljiv5KGWkP5w0ZDuTcs72AEGd4q1BXwrEKyoT-q_F1GYkUB28E1f0LegOLH84p0VeaJ-CHbduHWXoC4J_j1yi7G1dDJu7U2rWNG7mT876b7n5S6QuV2pC3XJqzMoX2o10Kt3Zbpl9Pk1CDxDDjApntfnjeQjmwAcJAZ0MFxQWL8UHjFnzde0EI0RQWzGDFaMqC6lurEw6tuYDiJvPdSrjMcktSuF3p3g-Vs8eg",
    "expires_in": 600,
    "token_type": "Bearer"
}

Example requests

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>'

Products

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:

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