Skip to content

Frequently asked questions

No. Send the bare key: Authorization: <key>. See Authentication.

I get 403 Forbidden on one endpoint, but others work.

Section titled “I get 403 Forbidden on one endpoint, but others work.”

Your key doesn’t have the role for that endpoint, for example History for price history or Specifications for specifications. See the roles table and ask us to add the role.

Can I call the API from my website’s JavaScript?

Section titled “Can I call the API from my website’s JavaScript?”

No. The key would be visible to every visitor. Call the API from your server and pass the data to your front end.

Why are my clicks not showing up in my reports?

Section titled “Why are my clicks not showing up in my reports?”

Check that you send users through the clickout link unchanged, with the right AffiliateId. Without AffiliateId, the first id on your key is used, which may not be the one for that website. See Affiliate ids.

I run several websites. Can I use one affiliate id?

Section titled “I run several websites. Can I use one affiliate id?”

You can, but then all clicks and sales are reported as one. Ask us for an id per website; they’re added to your existing key.

The id you sent isn’t registered on your key. Check for typos, or ask us to register it.

Many products return 404 on /Prices. Is something broken?

Section titled “Many products return 404 on /Prices. Is something broken?”

No. A 404 on GET /v1/Products/{id}/Prices means the product has no current offers in your market. A large catalog always has a share of products that are temporarily unavailable. See A 404 means “no offers right now”.

The lowest price in the product list differs from the offers I get.

Section titled “The lowest price in the product list differs from the offers I get.”

minPrice and priceAmount in GET /v1/Products include shops that are excluded for your key; the offers from /Prices don’t. See Excluded shops.

A price differs from the shop’s website.

Section titled “A price differs from the shop’s website.”

Prices come from the shop’s own product feed. Between two feed updates, or during a flash sale, the website can differ from the feed. If it happens structurally for a shop, send us the product, the shop and the time you saw it, and we’ll check the feed.

What is the difference between amount and amountBare?

Section titled “What is the difference between amount and amountBare?”

amount includes delivery cost; amountBare doesn’t. deliveryCost is the difference.

Prices are cached for 5 minutes per product. For most uses, fetching prices when you show them, or refreshing every few hours in a paced job, is enough. See Rate limits.

You sent too many requests in a short time. Back off and retry, limit concurrency and spread scheduled jobs. See Rate limits.

By shop.id. Don’t use billingCode: it is a legacy code and empty for most shops. Shop ids belong to your market, so a key for another market can have different ids for the same retailer.

Yes, in shop.website on every offer and in GET /v1/Shops. It is null for shops whose website we don’t know. Link users to the shop through the clickout link, not through website, or the click isn’t attributed to you.

I excluded a shop, but I still see it counted somewhere.

Section titled “I excluded a shop, but I still see it counted somewhere.”

Exclusions apply to the offers (/Prices, /Shops/{id}/Offers), not to the summary fields minPrice and priceAmount in product lists.

Add ?w= and/or ?h= to the image URL to get a resized copy. See Images.

A small share of images disappear when the shop removes the source. Show a placeholder, and take image URLs from a recent API response instead of storing them for a long time.

Descriptions are cut off or contain broken HTML.

Section titled “Descriptions are cut off or contain broken HTML.”

productDescription in offers is the shop’s feed text, cut off at 255 characters, sometimes in the middle of an HTML tag. Strip HTML before display. The product description comes from several sources with different formatting; sanitize it before rendering.

Where are the filters I see on Kieskeurig, such as screen size or energy label?

Section titled “Where are the filters I see on Kieskeurig, such as screen size or energy label?”

The API offers the product specifications (Specifications role), not the filter values Kieskeurig uses on its category pages. Specification names and values are in Dutch and vary per product.

No. Titles, descriptions, specifications and categories are in Dutch.