# PriceRunner API: Compare prices > Compares a product's prices across shops on PriceRunner in the United Kingdom, Sweden or Denmark: finds the best-matching product, lists its default new-condition national shop offers sorted by total price, and adds the three-month low when available. Unofficial. Not affiliated with or endorsed by PriceRunner. - Page: https://fous.com/methods/pricerunner.com/compare-prices - Method: `pricerunner.com/compare_prices`, version 1 - Website: pricerunner.com - Returns: product name, category, link, lowest price, currency, offer count, three-month low and date, shop offers - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `country` | string | no | | Country name or two-letter country code, for example Sweden or SE. Default "United Kingdom". | | `product` | string | yes | `"iPhone 16 128GB"` | Product name to compare, for example iPhone 16 128GB. | | `max_offers` | integer | no | | Maximum shop offers to return, for example 20. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "product": "iPhone 16 128GB" } ``` Its output: ```json { "offers": [ { "price": 462, "shop_name": "Back Market", "offer_link": "https://clk.klarna.com/uk/gotostore/v1/a63281b096226258e7083da11c6d65ea?productId=3253860562", "shop_rating": null, "total_price": 462, "stock_status": null, "shipping_cost": 0 }, { "price": 519.99, "shop_name": "Music Magpie", "offer_link": "https://clk.klarna.com/uk/gotostore/v1/329f70aca7183a6f14a57df06f5a51ba?productId=3253860562", "shop_rating": null, "total_price": 519.99, "stock_status": "In stock", "shipping_cost": 0 }, { "price": 532, "shop_name": "Back Market", "offer_link": "https://clk.klarna.com/uk/gotostore/v1/dc4affa8bdc33fb536f8a820ea3807be?productId=3253860562", "shop_rating": null, "total_price": 532, "stock_status": null, "shipping_cost": 0 } ], "category": "Mobile Phones", "currency": "GBP", "lowest_price": 462, "product_link": "https://www.pricerunner.com/pl/1-3253860562/Mobile-Phones/Apple-iPhone-16-128GB-White-Compare-Prices", "product_name": "Apple iPhone 16, 128GB White", "number_of_offers": 24, "lowest_price_last_3_months": 1, "lowest_price_last_3_months_date": "2026-09-26" } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"pricerunner.com/compare_prices","input":{"product":"iPhone 16 128GB"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Where's the cheapest place to buy Sony WH-1000XM5 headphones in the UK right now? Show me the top 10 shops. - Check PriceRunner Sweden for Samsung Galaxy S24 Ultra 256GB prices and tell me the lowest price over the last three months. - Jeg vil købe en Dyson V15 Detect i Danmark – hvilke butikker har den billigst? - Use pricerunner.com to list up to 30 UK retailers selling the PlayStation 5 Slim, sorted by total price. - Is £899 a good deal for a MacBook Air M3 13-inch? Compare shop offers in Britain and include the 3-month low. ## Input schema ```json { "type": "object", "required": [ "product" ], "properties": { "country": { "type": "string", "default": "United Kingdom", "description": "Country name or two-letter country code, for example Sweden or SE." }, "product": { "type": "string", "minLength": 1, "description": "Product name to compare, for example iPhone 16 128GB." }, "max_offers": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum shop offers to return, for example 20." } }, "additionalProperties": false } ``` ## Output schema ```json { "type": "object", "required": [ "product_name", "category", "product_link", "lowest_price", "currency", "number_of_offers", "lowest_price_last_3_months", "lowest_price_last_3_months_date", "offers" ], "properties": { "offers": { "type": "array", "items": { "type": "object", "required": [ "shop_name", "price", "shipping_cost", "total_price", "stock_status", "shop_rating", "offer_link" ], "properties": { "price": { "type": "number" }, "shop_name": { "type": "string" }, "offer_link": { "type": "string" }, "shop_rating": { "type": [ "number", "null" ] }, "total_price": { "type": [ "number", "null" ] }, "stock_status": { "type": [ "string", "null" ] }, "shipping_cost": { "type": [ "number", "null" ] } }, "additionalProperties": false } }, "category": { "type": [ "string", "null" ] }, "currency": { "type": "string" }, "lowest_price": { "type": [ "number", "null" ] }, "product_link": { "type": "string" }, "product_name": { "type": "string" }, "number_of_offers": { "type": "integer" }, "lowest_price_last_3_months": { "type": [ "number", "null" ] }, "lowest_price_last_3_months_date": { "type": [ "string", "null" ], "format": "date" } }, "additionalProperties": false } ``` ## See more - [idealo.de API: Compare prices on idealo](https://fous.com/methods/idealo.de/compare-prices.md): Finds the best-matching product on idealo for the chosen country (DE, AT, UK, FR, IT, ES) and lists its cheapest shop offers, including shipping where shown. - [Apple API: Compare Apple Store prices across countries](https://fous.com/methods/apple.com/compare-country-prices.md): Compares the Apple Store price of one product configuration across up to 15 countries, converted with the latest European Central Bank reference rates. - [Apple API: Get Apple Store product prices](https://fous.com/methods/apple.com/get-product-prices.md): Gets current Apple Store prices and the configurations on sale for a product in one country. It includes only models sold on that country's public store. - [CamelCamelCamel API: Get Amazon price history](https://fous.com/methods/camelcamelcamel.com/get-price-history.md): Gets an Amazon product's current listed price and lifetime price statistics from CamelCamelCamel (Amazon and third-party new), with dated Amazon low/high points and a comparison to the average. Takes a product name, an Amazon or CamelCamelCamel link, or an ASIN, for eight Amazon stores. - [H&M API: Get product](https://fous.com/methods/hm.com/get-product.md): Gets an H&M item's current country-specific price, sizes, colours and images by product name or product page link. Description, materials, composition, care and sustainability details are always returned as null. - [Nike API: Get product](https://fous.com/methods/nike.com/get-product.md): Gets a Nike product's details by name or product link for a chosen country. Returns its colourways, size availability, price and reviews. - [IKEA API: Search products](https://fous.com/methods/ikea.com/search-products.md): Searches IKEA products in a chosen country and returns current prices, details, photos and reviews in IKEA's result order. - [AliExpress API: Get product](https://fous.com/methods/aliexpress.com/get-product.md): Get one AliExpress product’s prices, variants, reviews, shipping to a chosen country, seller and specifications from its link or the best-selling name match. Sold counts may be rounded, and shipping options are those shown for the displayed variant.