MerchantListing

A single merchant listing for a wine from Wine-Searcher

DataMarketplaceWinePricesMerchantsVintagesCritics

Properties

Name	Type	Description
merchant_name	string	Name of the merchant/retailer
merchant_description	string	Description of the merchant
price	number	Price of the wine at this merchant
currency	string	Currency code for the price
vintage	string	Vintage year of this listing
bottle_size	string	Bottle size (e.g., 750ml, 1.5L)
offer_type	string	Type of offer
physical_address	string	Physical store address
country	string	Country of the merchant
state	string	State/region of the merchant
zip_code	string	Postal code of the merchant
latitude	number	Merchant latitude for geo lookup
longitude	number	Merchant longitude for geo lookup
link	string	URL to purchase the wine at this merchant

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/wine-searcher/refs/heads/main/json-schema/wine-searcher-merchant-listing-schema.json",
  "title": "MerchantListing",
  "description": "A single merchant listing for a wine from Wine-Searcher",
  "type": "object",
  "properties": {
    "merchant_name": {
      "type": "string",
      "description": "Name of the merchant/retailer"
    },
    "merchant_description": {
      "type": "string",
      "description": "Description of the merchant"
    },
    "price": {
      "type": "number",
      "description": "Price of the wine at this merchant"
    },
    "currency": {
      "type": "string",
      "description": "Currency code for the price"
    },
    "vintage": {
      "type": "string",
      "description": "Vintage year of this listing"
    },
    "bottle_size": {
      "type": "string",
      "description": "Bottle size (e.g., 750ml, 1.5L)"
    },
    "offer_type": {
      "type": "string",
      "description": "Type of offer",
      "enum": ["retail", "auction"]
    },
    "physical_address": {
      "type": "string",
      "description": "Physical store address"
    },
    "country": {
      "type": "string",
      "description": "Country of the merchant"
    },
    "state": {
      "type": "string",
      "description": "State/region of the merchant"
    },
    "zip_code": {
      "type": "string",
      "description": "Postal code of the merchant"
    },
    "latitude": {
      "type": "number",
      "description": "Merchant latitude for geo lookup"
    },
    "longitude": {
      "type": "number",
      "description": "Merchant longitude for geo lookup"
    },
    "link": {
      "type": "string",
      "description": "URL to purchase the wine at this merchant"
    }
  },
  "required": ["merchant_name", "price"]
}