Match My Deal

Use this when you need to know which product categories MatchMyDeal compares, or which category a shopping question belongs to. Returns every category with its slug, name, one-line description and number of products. If a product fits none of them, MatchMyDeal does not compare it.

list_categories

Use this when the visitor asks for deals, discounts or price drops. Returns today's products whose price dropped, measured in MatchMyDeal's own price history (not a discount claimed by a shop), biggest drop first, optionally for one category. It shows today only: do not use it to predict future prices.

get_deals

Use this before filter_products, to learn 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. Do not guess filter params or values; send filter_products only what this tool lists.

describe_filters

Use this after search, to read the full details of one product by id: prices per shop, price history and specs as text.

fetch

Use this when the visitor wants the details of one product: 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. Needs an EAN from filter_products, search_products or get_deals; never guess one.

get_product

Use this when the visitor describes what they need in one category (budget, brand, size, capacity, features) and wants matching products. Filters exactly like the filter bar on matchmydeal.nl and returns a page of products (12 per page) with prices, key specs and links, plus the shareable listing_url with the same filters. 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. When nothing matches, the answer names the filters that contradict each other and the closest product. Do not use this to look up one named model or type number; use search_products for that.

filter_products

Use this when the visitor wants two to four specific products side by side: prices per shop and a spec matrix with the same labels for every product. Needs EANs from the other tools; never guess them.

compare_products

Use this when the visitor names a product, brand, model, series or type number, in any category (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. Do not use this when the visitor describes needs rather than a product; use filter_products for that.

search_products

Use this when a research or connector workflow needs MatchMyDeal product ids: searches by words from the name, brand or model and returns ids (EANs), titles and urls. Use fetch for the details of one id.

search