Skip to main content

API Reference

API docs by Redocly

Partner Search API (1.0.0)

Download OpenAPI specification:Download

Product search for partners

Authentication

Acquire an access token

Acquire an access token to be used for authentication in request towards the service endpoints. Make a request with your client ID and secret using the basic authorization scheme. Client credentials is the only supported grant type.

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": 3600,
  • "token_type": "Bearer"
}

Find products

Use the suggestions endpoint to find products matching a query. The response will contain a list of products matching the query with production information the offer with the current lowest price.

Query options

Product name

To search for products by name use the product query parameter to find products with a text query e.g /suggestions?product=iphone 14.

Filter by category

To find products for a specific category, use the filter[category] query parameter e.g /suggestions?filter[category]=lego. Note that the filter accepts leaf category IDs or category slugs.

Filter by price trend

To find products with a price below the average price trend the past 90 days use the filter[price_trend] query parameter e.g /suggestions?filter[price_trend]=5. The price trend and category filter can be combined to only find products within a price trend range belonging to that category The offset and limit parameters can be used 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.

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.

filter[category]
string

Filter products based on Prisjakt category slug or category leaf ID.

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.

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.

header Parameters
client-id
required
string

Client ID to use for authentication.

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 or category leaf ID.

ref
string

Referral Partner Id to add to offer urls.

gtin
string

Find products by GTIN up to 10 comma separated IDs.

header Parameters
client-id
required
string

Client ID to use for authentication.

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.

header Parameters
client-id
required
string

Client ID to use for authentication.

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": [
    ]
}