Every shop's price for a product in the UK, Sweden or Denmark, with shipping and its daily price history
PriceRunner is Klarna's price comparison site for the United Kingdom (pricerunner.com, GBP), Sweden (pricerunner.se, SEK) and Denmark (pricerunner.dk, DKK).
6 active endpoints, on 2 and 3 credit tiers.
- POST/pricerunner/v1/search
- POST/pricerunner/v1/category
- POST/pricerunner/v1/product
- POST/pricerunner/v1/offers
- POST/pricerunner/v1/price_history
- POST/pricerunner/v1/reviews
What PriceRunner endpoints does ReefAPI ship?
6 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
PriceRunner API
6 of 6 endpoints, ready to run
Find products by keyword in one of three markets
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
How the PriceRunner API works
PriceRunner is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 530 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a keyword to every shop's price and the price curve
Search PriceRunner in one market, pick the products, then read their offer lists and price history.
Products with product_id, lowest price, cheapest offer, number of shops, rating and rank, plus filters with ids and counts.
Every shop: price, shipping, total, stock status, delivery days, payment methods.
The daily lowest price with the shop that had it, lowest, highest and median in the range.
Spec sheet, variants with their own ids and prices, category rank and PriceRunner's verdict on today's price.
A dated price feed per product and market: the lowest price, every competing shop with shipping and total, and the price curve behind it.
curl -X POST https://api.reefapi.com/pricerunner/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone 15","country":"uk"}'{
"ok": true,
"data": { … },
"meta": {
"api": "pricerunner",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a PriceRunner field actually contains
Fields that read differently from how they look. Every row was measured against live PriceRunner responses on 2026-10-15.
| Field | What it holds |
|---|---|
| country | uk, se or dk. Prices, shops and offers are per market and in that market's currency (GBP, SEK, DKK); the same product_id (e.g. 3409202905, an iPhone 15) exists in all three. |
| lowest_price (search row) | The lowest price PriceRunner shows on the product card. It equalled the cheapest row of offers on 12 of 12 products across the three markets, and the row's cheapest_offer_price on 672 of 672 search rows. |
| site_applied_filter | PriceRunner narrows a free-text search to the category it guesses: "headphones" matched 14,781 products in Headphones, 53,339 with auto_category=false. This field says which category and attribute it applied. |
| offers[].total_price | Price plus the shop's shipping cost, computed because PriceRunner prints no total. Shipping was published on 197 of 209 offer rows; where it is missing, total_price is null rather than guessed. |
| condition (offers) | PriceRunner does not label each offer new or used; the list is filtered by condition. The default is new, as on the site; used, refurbished or all return the other lists. condition_counts gives the counts (an iPhone 15: new 14, refurbished 33, used 13). |
| summary.lowest_national | PriceRunner's own lowest domestic price for the product. It can sit below the cheapest row of the filtered list because it also counts offers outside that stock filter (2 of 12 products). |
| price_history.points[] | One point per day: the lowest price that day, the shop and its offer id. It spans every condition, so a refurbished offer can set the day's low. |
| points[].suspect_low | PriceRunner's chart keeps days far below the normal band (an iPhone 15 at 25.30 GBP and 140 GBP from one shop, against a 478.61 GBP median). Such points are returned as published and flagged; lowest_in_range_excluding_suspect leaves them out. |
| variants[] | The other members of the product's group (colours, storage sizes), each with its own product_id and lowest price. Price history is per variant: two colours of the same phone shared 0 of 93 daily points. |
The same search and offer lists came back identical from five different network locations, so the market is set by the country you ask for, not by where the request comes from.
PriceRunner coverage, measured
Every number below was read from live PriceRunner responses on 2026-10-15, in two runs of about 100 calls each across the three markets.
United Kingdom (GBP), Sweden (SEK), Denmark (DKK). "iphone 15" matched 97 products in the UK, 377 in Sweden and 62 in Denmark; Mobile Phones held 8,644 products in the UK.
Mobile Phones 8,644 → brand Apple 881, 300 to 500 GBP 1,846 (46 of 48 rows on the page inside the range, 2 at 299.99), series Apple iPhone 17 78; price sorts ascending and descending in order on 48 of 48 rows.
The search card's lowest price equalled the cheapest offer on 12 of 12 products; total_price equals price plus shipping on every offer that publishes shipping (197 of 209).
93 daily points for 3m on the products measured; for an iPhone 15 the full history went back to 13 September 2023 (1,129 points). Each chart belongs to the product asked for: two colours of one phone shared 0 of 93 points.
24 of 24 product ids from search and category rows in the three markets came back as the same product in product and offers.
Search pages hold 48 products; offers carry no per-row condition (the list is filtered by condition); the daily chart includes offers in every condition and occasional mis-matched low prices, flagged suspect_low.
What people build with PriceRunner
The jobs this data is most often used for.
endpoints
credits per call
Track every UK, Swedish or Danish shop's price, shipping and stock for a product list.
Pull PriceRunner's daily price history to judge whether today's price is a good one.
Compare one product's price across the UK, Sweden and Denmark with the same id.
Map a category with prices, ratings, brands and popularity rank.
What PriceRunner data costs
The cheapest call here is 2 credits, so $15/mo (Pro) buys 5,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
Full pricing →- 1,000 free credits on signup, no card
- One key, all 530 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/pricerunner/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone 15","country":"uk"}'import requests
r = requests.post(
"https://api.reefapi.com/pricerunner/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "iphone 15",
"country": "uk"
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up PriceRunner.
Get a free key →Do I need a PriceRunner or Klarna account?▾
No. Everything is read logged out.
Which countries are covered?▾
The United Kingdom (pricerunner.com), Sweden (pricerunner.se) and Denmark (pricerunner.dk). Set country to uk, se or dk; prices come in GBP, SEK or DKK.
How many shops does offers return?▾
All of them in one call, up to max_offers (default 100). An iPhone 15 in the UK had 26 orderable new offers and 103 offers in every condition and stock status on 2026-10-15.
Is shipping included?▾
Every offer carries the shipping cost and total_price, price plus shipping. sort=price_with_shipping ranks by what the buyer pays.
How far back does price_history go?▾
1w, 1m, 3m (93 daily points), 1y, 2y or all. For an iPhone 15 all went back to 13 September 2023, 1,129 daily points.
Which filters are there?▾
Brand, price range and attribute filters (category), brand, category and price range (search), checked against the unfiltered count in the same run: Mobile Phones 8,644 → Apple 881, 300 to 500 GBP 1,846, series Apple iPhone 17 78. The ids come back in the filters of the same response.
Why does my search return fewer products than I expected?▾
PriceRunner narrows many queries to a category it guesses; site_applied_filter shows which. Send auto_category=false to search the whole catalogue. A filter you send yourself replaces the guess.
What reviews are available?▾
review_type=user returns reviews PriceRunner collects from retailers (an iPhone 15 had 3,679), pro returns expert tests (14), customer returns Klarna verified-buyer reviews. include_summary adds the score and the 1-5 star histogram.
What is the PriceRunner API?▾
PriceRunner API is a ReefAPI endpoint group for uk, swedish and danish price comparison: every shop's price with shipping, the daily price history, specs, variants and reviews. It returns live JSON through POST requests under /pricerunner/v1.
Is the PriceRunner API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. PriceRunner calls use the same shared credit balance as every other ReefAPI engine.
Do I need a PriceRunner login or account?▾
No login to PriceRunner is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the PriceRunner data?▾
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the PriceRunner API use?▾
PriceRunner actions currently cost 2-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call PriceRunner from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call pricerunner actions with the same key, credit pool and JSON envelope used by normal REST requests.
266 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling PriceRunner, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 529 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-15.