Catalog / Cellar 53 Wines and Spirits Catalog

Cellar 53 Wines and Spirits Catalog API

cellar53wine.com

Live catalog, pricing, stock, category, and store information for Cellar 53 Wines and Spirits. Values are read from Cellar 53's public City Hive JSON API at request time.

  • Shopping
  • wine
  • beer
  • spirits
  • catalog
5 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the Cellar 53 Wines and Spirits Catalog API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Product Search

Optional parameters 10

Keyword matched by Cellar 53 catalog search.

Source category/type, such as Wine or Spirits; use keyword=beer for beer discovery because the current source filter feed has no Beer type.

Source subtype, such as red, vodka, or bourbon.

Exact source varietal filter value.

Exact source region filter value.

Minimum current price.

Maximum current price.

Ask the source for products with positive stock.

Source sort value: name asc, name desc, price asc, or price desc.

One-based page number; each page requests 20 products.

View call pricing
cURL · Product search
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/6a8ff7a5-6764-474a-9630-33e957046cd7/products/search' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY"

Endpoints

Inputs and response fields for every endpoint in this API.

GETProduct detail by id/products/by-id/{product_id}

Product Detail

Input

product_idRequiredPath · string

Stable Cellar 53 product id.

Example: 609300833759156b985e6394

Response

source?string, default: cellar53wine.com
productobject
product.abv?string | number | null
product.name?string | null
product.price?number | null
product.stock?number | integer | null
product.rating?number | null
product.region?string | null
product.country?string | null
product.options?object[]
product.options[].price?number | null
product.options[].stock?number | integer | null
product.options[].vintage?string | null
product.options[].option_id?string | null
product.options[].sale_price?number | null
product.options[].bottle_size?string | null
product.options[].availability?string | null
product.options[].product_page_url?string | null
product.options[].fulfillment_options?string[]
product.vintage?string | null
product.category?string | null
product.varietal?string | null
product.image_url?string | null
product.product_id?string | null
product.sale_price?number | null
product.bottle_size?string | null
product.description?string | null
product.subcategory?string | null
product.availability?string | null
product.critic_scores?unknown | null
product.product_page_url?string | null
product.producer_or_brand?string | null
product.store_availability?object[]
product.store_availability[].price?number | null
product.store_availability[].stock?number | integer | null
product.store_availability[].address?string | null
product.store_availability[].store_id?string | null
product.store_availability[].store_name?string | null
product.store_availability[].availability?string | null
product.store_availability[].fulfillment_options?string[]

Fields marked ? are optional.

GETProduct detail by url/products/detail

Product Detail By Url

Input

product_urlRequiredQuery · string

Cellar 53 product page URL.

Example: https://cellar53wine.com/shop/product/101-north-cabernet-sauvignon/609300833759156b985e6394

Response

source?string, default: cellar53wine.com
productobject
product.abv?string | number | null
product.name?string | null
product.price?number | null
product.stock?number | integer | null
product.rating?number | null
product.region?string | null
product.country?string | null
product.options?object[]
product.options[].price?number | null
product.options[].stock?number | integer | null
product.options[].vintage?string | null
product.options[].option_id?string | null
product.options[].sale_price?number | null
product.options[].bottle_size?string | null
product.options[].availability?string | null
product.options[].product_page_url?string | null
product.options[].fulfillment_options?string[]
product.vintage?string | null
product.category?string | null
product.varietal?string | null
product.image_url?string | null
product.product_id?string | null
product.sale_price?number | null
product.bottle_size?string | null
product.description?string | null
product.subcategory?string | null
product.availability?string | null
product.critic_scores?unknown | null
product.product_page_url?string | null
product.producer_or_brand?string | null
product.store_availability?object[]
product.store_availability[].price?number | null
product.store_availability[].stock?number | integer | null
product.store_availability[].address?string | null
product.store_availability[].store_id?string | null
product.store_availability[].store_name?string | null
product.store_availability[].availability?string | null
product.store_availability[].fulfillment_options?string[]

Fields marked ? are optional.

GETCategory list/categories

Category List

Input

No input parameters.

Response

source?string, default: cellar53wine.com
categoriesobject[]
categories[].values?object[]
categories[].values[].count?integer | null
categories[].values[].value?object
categories[].values[].active?boolean | null
categories[].values[].display?string | null
categories[].values[].tooltip?string | null
categories[].display?string | null

Fields marked ? are optional.

GETStore info/store

Store Info

Input

No input parameters.

Response

source?string, default: cellar53wine.com
locationsobject[]
locations[].name?string | null
locations[].email?string | null
locations[].hours?object | null
locations[].phone?string | null
locations[].address?string | null
locations[].store_id?string | null
locations[].delivery_area?object
locations[].delivery_area.geometry?object | null
locations[].delivery_area.delivery_fee?number | null
locations[].delivery_area.minimum_order?number | null
locations[].shipping_locations?object[]
locations[].shipping_locations[].state?string | null
locations[].shipping_locations[].minimum_order?number | null
locations[].shipping_locations[].minimum_free_shipping?number | null
locations[].fulfillment_optionsstring[]

Fields marked ? are optional.

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.