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"]
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/wine-searcher-merchant-listing"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.