Wine.com Public API

This is meant to be a living document that describes how the Wine.com Public API works.

The Wine.com Public API allows client applications to access Wine.com content by making REST requests to three methods. The response will be returned in either JSON or XML format, specified by the request query.

In order to access the API, you must first sign up. Once you have signed up, you will receive a key. This key is required to make API calls. If no key is present, nothing will be returned.

Additionally, as a condition of use for this API, you must include the Wine.com name, logo and links in API input and output elements.

	<a href="http://www.wine.com/" title="Wine.com the destination for Wine and Wine Gifts"><img src="http://cache.wine.com/images/logos/80x20_winecom_logo.png" alt="Wine.com the destination for Wine and Wine Gifts" /><a>
	<a href="http://www.wine.com/" title="Wine.com the destination for Wine and Wine Gifts"><img src="http://cache.wine.com/images/logos/80x80_winecom_logo.png" alt="Wine.com the destination for Wine and Wine Gifts" /><a>
	<a href="http://www.wine.com/" title="Wine.com the destination for Wine and Wine Gifts"><img src="http://cache.wine.com/images/logos/120x40_winecom_logo.png" alt="Wine.com the destination for Wine and Wine Gifts" /><a>
	<a href="http://www.wine.com/" title="Wine.com the destination for Wine and Wine Gifts"><img src="http://cache.wine.com/images/logos/160x40_winecom_logo.png" alt="Wine.com the destination for Wine and Wine Gifts" /><a>
	<a href="http://www.wine.com/" title="Wine.com the destination for Wine and Wine Gifts"><img src="http://cache.wine.com/images/logos/300x200_winecom_logo.png" alt="Wine.com the destination for Wine and Wine Gifts" /><a>

• The Basics – The fundamentals of API requests.
• Catalog Queries – How to query the product catalog.
• Category Queries – How to narrow down your queries. Looking at product attributes and navigation.
• Reference Library Queries – Looking up reference library articles.
• API Object Dictionary
  • The Status Object
  • The Return Objects
  • Catalog Objects
  • Category Objects
  • Reference Objects