Wine.com Public API

This query returns the various categories and their children. These categories can then be used to retrieve products using the "filter" option.

The base URL for browsing the Wine.com categories is:

http://services.wine.com/api/beta2/service.svc/format/categorymap

The custom parameters that can be used with a category query are:

Parameter Description Example
filter Filters to apply to the product list. filter=categories(7155+124)+rating(85|100)
search The term(s) to search for.
search=mondavi
search=mondavi+merlot

Some examples:

The following query will return all root level categories for the wine finder:

/categorymap?filter=categories(490)&apikey=key

To determine all categories that can be used to narrow down a list of red wine:

/categorymap?filter=categories(490+124)&apikey=key

To determine all categories that can be used to narrow down a list of red wines that have a rating between 85 and 90 points:

/categorymap?filter=categories(490+124)+rating(85|90)&apikey=key


Powered by 3Scale
Terms and Conditions | Privacy Policy | Contact Us