Match My Deal

List the product categories MatchMyDeal compares, with their slug, one-line description and number of products. Call this first when you do not know which category a request belongs to.

list_categories

Today's best deals: products with a real discount at the shop and a proven price drop in our own price history, highest discount first. Optionally limited to one category.

get_deals

Describe the filters of one category: every filter param with its Dutch label, how it works (any of, all of, boolean, min, max, fits, text) and the values present in today's catalogue. Call this before filter_products so you only send params and values that exist.

describe_filters

Fetch the full details of one product by id (the EAN from search): prices per shop, price history and specs as text.

fetch

Everything about one product by EAN: the price at every shop with the moment it was fetched, delivery rules per shop, our own price history (lowest ever, last 90 days), specs, the other variants of the same model and the shop links. EANs come from filter_products, search_products or get_deals.

get_product

Filter one category exactly like the filter bar on matchmydeal.nl and return a page of products (12 per page) with prices, key specs and links. The `filters` object uses the param names and values from describe_filters; lists mean "any of these" unless describe_filters says all of them must match. Returns the shareable listing_url with the same filters, and when nothing matches, which filters contradict each other.

filter_products

Compare two to four products by EAN side by side: prices per shop and a spec matrix with the same labels for every product.

compare_products

Search all categories at once by words from the product name, brand, model, series or type number (for example "iphone 17 wit", "bosch wgg246zefg", "lg oled 55 inch"). Returns model families per category with a from-price, and the category page link. Use filter_products instead when the visitor describes needs rather than a product.

search_products

Search MatchMyDeal products by words from the name, brand or model. Returns ids (EANs), titles and urls; use fetch for the details of one id.

search