search_products
Search products
Returns a page of Magic Prices UK products for a free-text query (productId, name, brand, best price in GBP, offerCount, rating, url) with brand and category facets and the price range. Covers the whole catalogue by keyword (e.g. "iPhone 15"); productId in the results is the identifier accepted by the product tools. Inputs: q from the user; brand = names from the brands facet; categoryId from the categories facet or find_category.
ParametersqrequiredpagesizebrandmaxPriceminPricecategoryId
Returns one Magic Prices UK product sheet: identity, best price in GBP with discount, plain-text summary, specs by theme (max 40 rows), editorial pros and cons, variants, the 5 cheapest offers, refurbished availability, coupons and url. Inputs: exactly one of productId or ean; includeSpecs false skips the specs.
ParameterseanproductIdincludeSpecs
get_product_offers
Get product offers
Returns all store offers for one Magic Prices UK product sorted by totalPrice (price plus delivery) in GBP, with store (e.g. Argos), availability, delivery, marketplace flag and url, plus offerCount, minPrice and maxPrice. Inputs: productId from a previous result; condition, page and size are optional.
ParameterspagesizeconditionproductIdrequired
get_price_history
Get price history
Returns the best-price history of one Magic Prices UK product in GBP: stats (min, max, avg, first, last, dataPoints, minDate, maxDate) and a {date, price} series (daily up to 90 days, weekly beyond). Inputs: productId; days 7 to 730 (default 180).
ParametersdaysproductIdrequired
compare_products
Compare products
Returns a side-by-side comparison of 2 to 4 Magic Prices UK products of the same category: product summaries with best price in GBP and spec rows by theme (the rows that differ plus the first ten shared ones). Inputs: productIds from search_products, get_similar_products or get_category_products.
ParametersproductIdsrequired
get_similar_products
Get similar products
Returns products similar to one Magic Prices UK product (same category) as summaries with best price in GBP, offerCount, rating and url. Inputs: productId from search_products or get_product.
ParametersproductIdrequired
analyze_price
Analyze a product price
Returns a buying recommendation for one Magic Prices UK product: current best price in GBP, position in the price history (near the historical low, mid range, near the high), recent trend, a verdict (buy_now, wait, neutral, unknown) with its reasons and a confidence level, plus an optional comparison with a price you saw elsewhere (externalPrice, optional externalStore). productId comes from search_products.
ParametersdaysproductIdrequiredexternalPriceexternalStore
find_category
Find a category
Returns up to 10 Magic Prices UK categories matching a name (leaves first), with slug, parent path and isLeaf. The slug of a leaf is the identifier accepted by get_category_products. Input: a category name in the site language.
Parametersqueryrequired
get_category_products
Products of a category
Returns one page of products of a Magic Prices UK category (price in GBP, price range, offers, rating, image, url), with the top brands, the price range and the total. minPrice and maxPrice restrict the page to a budget; sort accepts rating, price_asc, price_desc, created_desc. slug from find_category; brandId from a brands facet.
ParameterspagesizeslugrequiredsortbrandIdmaxPriceminPrice
get_brand_products
Products of a brand
Returns one page of products of a brand on Magic Prices UK (price in GBP, price range, offers, rating, image, url), with the brand, its main categories and the price range. brandId from a brands facet; categoryId from find_category.
ParameterspagesizesortbrandIdrequiredmaxPriceminPricecategoryId
Returns one page of products discounted on Magic Prices UK by at least the given percent versus their highest current price (price in GBP, highPrice, discountPercent, image, url), with the categories and brands of the deals. categoryId from find_category; brandId from a brands facet.
ParameterspagesizebrandIddiscountmaxPriceminPricecategoryId
get_promo_codes
Coupon codes and promotions
Returns one page of coupon codes and store promotions listed on Magic Prices UK (code, title, description, type, store, endDate), site-wide or for one store. storeId from an offer or get_store; store is a name or slug.
ParameterspagesizestorestoreId
Returns the profile of a store listed on Magic Prices UK: website, type, city, payments, deliveries, shipping cost and threshold, return policy, logo and rating. storeId from an offer; slug or name from an offer or the user.
ParametersslugstoreId
get_store_deals
Highlighted offers of a store
Returns the products a store highlights on Magic Prices UK (productId, name, price in GBP, oldPrice when known, url, image). storeId from an offer; slug or name from an offer or the user.
ParameterssizeslugstoreId