search_products
Search products
Returns a page of Magic Prices Italia products for a free-text query (productId, name, brand, best price in EUR, 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.
輸入參數q必填pagesizebrandmaxPriceminPricecategoryId
Returns one Magic Prices Italia product sheet: identity, best price in EUR 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.
輸入參數eanproductIdincludeSpecs
get_product_offers
Get product offers
Returns all store offers for one Magic Prices Italia product sorted by totalPrice (price plus delivery) in EUR, with store (e.g. Unieuro), availability, delivery, marketplace flag and url, plus offerCount, minPrice and maxPrice. Inputs: productId from a previous result; condition, page and size are optional.
輸入參數pagesizeconditionproductId必填
get_price_history
Get price history
Returns the best-price history of one Magic Prices Italia product in EUR: 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).
輸入參數daysproductId必填
compare_products
Compare products
Returns a side-by-side comparison of 2 to 4 Magic Prices Italia products of the same category: product summaries with best price in EUR 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.
輸入參數productIds必填
get_similar_products
Get similar products
Returns products similar to one Magic Prices Italia product (same category) as summaries with best price in EUR, offerCount, rating and url. Inputs: productId from search_products or get_product.
輸入參數productId必填
analyze_price
Analyze a product price
Returns a buying recommendation for one Magic Prices Italia product: current best price in EUR, 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.
輸入參數daysproductId必填externalPriceexternalStore
find_category
Find a category
Returns up to 10 Magic Prices Italia 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.
輸入參數query必填
get_category_products
Products of a category
Returns one page of products of a Magic Prices Italia category (price in EUR, 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.
輸入參數pagesizeslug必填sortbrandIdmaxPriceminPrice
get_brand_products
Products of a brand
Returns one page of products of a brand on Magic Prices Italia (price in EUR, 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.
輸入參數pagesizesortbrandId必填maxPriceminPricecategoryId
Returns one page of products discounted on Magic Prices Italia by at least the given percent versus their highest current price (price in EUR, highPrice, discountPercent, image, url), with the categories and brands of the deals. categoryId from find_category; brandId from a brands facet.
輸入參數pagesizebrandIddiscountmaxPriceminPricecategoryId
get_promo_codes
Coupon codes and promotions
Returns one page of coupon codes and store promotions listed on Magic Prices Italia (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.
輸入參數pagesizestorestoreId
Returns the profile of a store listed on Magic Prices Italia: 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.
輸入參數slugstoreId
get_store_deals
Highlighted offers of a store
Returns the products a store highlights on Magic Prices Italia (productId, name, price in EUR, oldPrice when known, url, image). storeId from an offer; slug or name from an offer or the user.
輸入參數sizeslugstoreId