Product API

Read our promotional product range into your own shop: articles, variants, prices and stock per warehouse. Prices are wholesale prices in SEK and exclude VAT. Stock is updated several times a day.

Authentication

Every request needs your API key. You receive it from your account manager. Send it in a header:

X-Api-Key: your-key

If your system cannot set headers, send it as a query parameter instead: ?api_key=your-key. A wrong or missing key answers 401.

Paging

Lists are paged with page (starting at 1) and limit (default 100, at most 500). Every answer states how many records exist in total:

{
  "data": [ ... ],
  "meta": { "page": 1, "limit": 100, "total": 432, "total_pages": 5 }
}

Read pages in order until you have received meta.total records.

Endpoints

GET /v1/articles

One flat row per article you can buy. A product in three colours is three rows sharing an article_no. This is the easiest list to import.

FieldMeaning
article_noThe product. Shared by all its variants.
skuThe sellable variant. Equal to article_no when the product has no variants.
product_name, description, brandProduct text.
categoryOur category path, levels separated by >.
color, size, fitVariant options. Empty when not applicable.
price, sale_pricePrice of this variant excluding VAT. sale_price is empty unless on offer.
stock_main, stock_northStock per warehouse. Empty means unknown, not zero.
stock_unitpiece or box: what the stock figures count.
pack_sizeSold in multiples of this many pieces.
eanBarcode.
imageMain picture.

GET /v1/products

The same range with variants nested inside each product under variants[], stock under variants[].stock.<warehouse> and volume prices under variants[].tiers[].

Errors

StatusMeaning
400Bad page or limit.
401Missing or wrong key.
429Too many requests. Wait the number of seconds in Retry-After.
500Our fault. Try again later.