Skip to main content

API Reference

API docs by Redocly

Partner Search API (1.0.0)

Download OpenAPI specification:Download

License: UNLICENSED

Product search for partners

ProductsV2

Search for product information and their offers in stock.

Search for product information and their offers in stock. The API only returns offers that are available for purchase. Offers that are out of stock or not available for purchase are not included in the response.

Authorizations:
accessToken
query Parameters
market
required
string (Market)
Enum: "se" "no" "dk" "fi" "fr" "gb" "nz"

Prisjakt market as ISO 3166-1 alpha-2 country code (lowercase).

ref
required
string

Referral Partner Id to add to offer urls. Unique per partner, and is used to attribute traffic.

limit
integer <int32> [ 0 .. 250 ]

Maximum number of results to include in the response

offset
integer <int32> >= 0

Results offset index, beginning from 0

productIds
string^[0-9]+(,[0-9]+){0,19}$

A comma-delimited list of up to 20 product ids

gtins
string^[0-9]+(,[0-9]+){0,9}$

A comma-delimited list of up to 10 GTIN ids

Responses

Response samples

Content type
application/json
{
  • "links": {
    },
  • "paging": {
    },
  • "data": [
    ]
}

Get product information and its offers in stock for one specific product.

Get product information and its offers for one specific product. The API only returns offers that are available for purchase. Offers that are out of stock or not available for purchase are not included in the response.

Authorizations:
accessToken
path Parameters
productId
required
number <double>

Single product id, for example 5248850

query Parameters
market
required
string (Market)
Enum: "se" "no" "dk" "fi" "fr" "gb" "nz"

Prisjakt market as ISO 3166-1 alpha-2 country code (lowercase).

ref
required
string

Referral Partner Id to add to offer urls. Unique per partner, and is used to attribute traffic.

limit
integer <int32> [ 0 .. 250 ]

Maximum number of results to include in the response

offset
integer <int32> >= 0

Results offset index, beginning from 0

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "name": "string",
  • "brand": {
    },
  • "offers": [
    ],
  • "productPage": "string",
  • "category": {
    },
  • "rankWithinCategory": 0.1
}

Authentication

Acquire an access token

Acquire an access token to be used for authentication in requests towards the service's endpoints. Make a request with the API portal client_id and client_secret using the basic authorization scheme. This only supports grant_type=client_credentials

Authorizations:
accessToken
Request Body schema: application/x-www-form-urlencoded
required
grant_type
string
Value: "client_credentials"
client_id
string
client_secret
string

Responses

Response samples

Content type
application/json
{
  • "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
  • "expires_in": 600,
  • "token_type": "Bearer"
}

Find products

Use the suggestions endpoint to filter products with a particularly good price right now. It can also be used to find products matching a text query.

The response will contain a list of products matching the query arguments with product information, and the offer with the current lowest price.

Authorizations:
accessToken
query Parameters
market
required
string
Enum: "se" "no" "dk" "fi" "fr" "gb" "nz"

Two-letter country code for the market to perform search in.

product
string
Examples:
  • product=Samsung A51 -
  • product=iRoomba -

Product name to find suggestions for, limited to eight space separated terms.

category
string
Deprecated

Use filter[category] instead.

limit
number

The max number of results to receive. (Default 5, Up to 30)

offset
number

The amount to offset the results by.

ref
string

Referral Partner Id to add to offer urls. Unique per partner, and is used to attribute traffic.

filter[category]
string

Filter products based on Prisjakt category slug. This can be fetched in the /categories endpoint.

filter[price_trend]
number

Filter based on price trend percentage greater or equal to the given number.

filter[price_trend][gte]
number

Filter based on price trend percentage greater or equal to the given number.

filter[price_trend][lte]
number

Filter based on price trend percentage less than or equal to the given number.

header Parameters
client-id
required
string

Client ID to use for authentication. Can found and requested in Schibsted API Portal

Responses

Response samples

Content type
application/json
{}

Find categories.

The categories endpoint enables you to find Prisjakt categories corresponding to a text query.

Make a request with the q query parameter e.g. /categories?market=se&q=apple phone. The response will contain category leaf ids, slugs, names, urls to the category in the website, and logos for the categories matching the query. You can use the offset and limit query parameters to page through the results.

The category id or slug can be used on endpoints that have the filter[category] query parameter to filter by that category.

Authorizations:
accessToken
query Parameters
market
required
string
Enum: "se" "no" "dk" "fi" "fr" "gb" "nz"

Two-letter country code for the market to perform search in.

q
required
string
Examples:
  • q=mobile-phones -
  • q=tablets -

Query to find category suggestions for.

limit
number

The max number of results to receive. (Default 5, Up to 30)

offset
number

The amount to offset the results by.

ref
string

Referral Partner Id to add to offer urls. Unique per partner, and is used to attribute traffic.

header Parameters
client-id
required
string

Client ID to use for authentication. Can found and requested in Schibsted API Portal

Responses

Response samples

Content type
application/json
{}

Product Information

Provides product information and offers in stock.

You can use the products endpoint to fetch product information and offers. Fetch data by calling /products or set the GTIN query parameter to find matching products. Use the offset and limit query parameters to page through the results.

The API only returns offers that are available for purchase. Offers that are out of stock or not available for purchase are not included in the response.

Authorizations:
accessToken
query Parameters
market
required
string
Enum: "se" "no" "dk" "fi" "fr" "gb" "nz"

Two-letter country code for the market to perform search in.

limit
number

The max number products to receive. (Default 10, Up to 15)

offset
number

The amount to offset the results by.

filter[category]
string

Filter products based on Prisjakt category slug. This can be fetched in the /categories endpoint.

ref
string

Referral Partner Id to add to offer urls. Unique per partner, and is used to attribute traffic.

gtin
string

Find products by GTIN up to 10 comma separated IDs.

header Parameters
client-id
required
string

Client ID to use for authentication. Can found and requested in Schibsted API Portal

Responses

Response samples

Content type
application/json
{
  • "links": {},
  • "data": [
    ]
}

Provides product information and offers in stock for specific products.

You can use the products endpoint to fetch product information and offers with a using single or multiple product ids. Simply set the productId path parameter to the product id e.g products/5248850 or using multiple ids e.g products/5248850,5248851. Up to 20 ids can be used.

The API only returns offers that are available for purchase. Offers that are out of stock or not available for purchase are not included in the response.

Authorizations:
accessToken
path Parameters
productId
required
string

Either one or a comma-separated list of product IDs (min 1, max 20)

query Parameters
market
required
string
Enum: "se" "no" "dk" "fi" "fr" "gb" "nz"

Two-letter country code for the market to perform search in.

ref
string

Referral Partner Id to add to offer urls. Unique per partner, and is used to attribute traffic.

header Parameters
client-id
required
string

Client ID to use for authentication. Can found and requested in Schibsted API Portal

Responses

Response samples

Content type
application/json
{
  • "productId": "5248850",
  • "productName": "Samsung Galaxy A51 SM-A515F/DS Dual SIM 4GB RAM 128GB",
  • "productPage": "https://www.prisjakt.nu/produkt.php?p=5248850",
  • "category": {
    },
  • "brand": {
    },
  • "images": {},
  • "offers": [],
  • "properties": [
    ],
  • "coreProperties": [
    ]
}