Cellar 53 Wines and Spirits Catalog API
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.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn 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 keySign 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.
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 search/products/search
Product Search
Input
keywordOptionalQuery · string | nullKeyword matched by Cellar 53 catalog search.
Example: cabernet
categoryOptionalQuery · string | nullSource category/type, such as Wine or Spirits; use keyword=beer for beer discovery because the current source filter feed has no Beer type.
Example: Wine
subcategoryOptionalQuery · string | nullSource subtype, such as red, vodka, or bourbon.
Example: Red
varietalOptionalQuery · string | nullExact source varietal filter value.
Example: Cabernet Sauvignon
regionOptionalQuery · string | nullExact source region filter value.
Example: Bordeaux
min_priceOptionalQuery · number, min: 0 | nullMinimum current price.
Example: 10
max_priceOptionalQuery · number, min: 0 | nullMaximum current price.
Example: 30
in_stockOptionalQuery · boolean, default: falseAsk the source for products with positive stock.
Example: true
sortOptionalQuery · string | nullSource sort value: name asc, name desc, price asc, or price desc.
Example: price asc
pageOptionalQuery · integer, min: 1, default: 1One-based page number; each page requests 20 products.
Example: 1
Response
pageintegeritemsobject[]items[].abv?string | number | nullitems[].name?string | nullitems[].price?number | nullitems[].stock?number | integer | nullitems[].rating?number | nullitems[].region?string | nullitems[].country?string | nullitems[].options?object[]items[].options[].price?number | nullitems[].options[].stock?number | integer | nullitems[].options[].vintage?string | nullitems[].options[].option_id?string | nullitems[].options[].sale_price?number | nullitems[].options[].bottle_size?string | nullitems[].options[].availability?string | nullitems[].options[].product_page_url?string | nullitems[].options[].fulfillment_options?string[]items[].vintage?string | nullitems[].category?string | nullitems[].varietal?string | nullitems[].image_url?string | nullitems[].product_id?string | nullitems[].sale_price?number | nullitems[].bottle_size?string | nullitems[].description?string | nullitems[].subcategory?string | nullitems[].availability?string | nullitems[].critic_scores?unknown | nullitems[].product_page_url?string | nullitems[].producer_or_brand?string | nullitems[].store_availability?object[]items[].store_availability[].price?number | nullitems[].store_availability[].stock?number | integer | nullitems[].store_availability[].address?string | nullitems[].store_availability[].store_id?string | nullitems[].store_availability[].store_name?string | nullitems[].store_availability[].availability?string | nullitems[].store_availability[].fulfillment_options?string[]total?integer | nullsource?string, default: cellar53wine.comhas_morebooleanpage_sizeintegerFields marked ? are optional.
GETProduct detail by id/products/by-id/{product_id}
Product Detail
Input
product_idRequiredPath · stringStable Cellar 53 product id.
Example: 609300833759156b985e6394
Response
source?string, default: cellar53wine.comproductobjectproduct.abv?string | number | nullproduct.name?string | nullproduct.price?number | nullproduct.stock?number | integer | nullproduct.rating?number | nullproduct.region?string | nullproduct.country?string | nullproduct.options?object[]product.options[].price?number | nullproduct.options[].stock?number | integer | nullproduct.options[].vintage?string | nullproduct.options[].option_id?string | nullproduct.options[].sale_price?number | nullproduct.options[].bottle_size?string | nullproduct.options[].availability?string | nullproduct.options[].product_page_url?string | nullproduct.options[].fulfillment_options?string[]product.vintage?string | nullproduct.category?string | nullproduct.varietal?string | nullproduct.image_url?string | nullproduct.product_id?string | nullproduct.sale_price?number | nullproduct.bottle_size?string | nullproduct.description?string | nullproduct.subcategory?string | nullproduct.availability?string | nullproduct.critic_scores?unknown | nullproduct.product_page_url?string | nullproduct.producer_or_brand?string | nullproduct.store_availability?object[]product.store_availability[].price?number | nullproduct.store_availability[].stock?number | integer | nullproduct.store_availability[].address?string | nullproduct.store_availability[].store_id?string | nullproduct.store_availability[].store_name?string | nullproduct.store_availability[].availability?string | nullproduct.store_availability[].fulfillment_options?string[]Fields marked ? are optional.
GETProduct detail by url/products/detail
Product Detail By Url
Input
product_urlRequiredQuery · stringCellar 53 product page URL.
Example: https://cellar53wine.com/shop/product/101-north-cabernet-sauvignon/609300833759156b985e6394
Response
source?string, default: cellar53wine.comproductobjectproduct.abv?string | number | nullproduct.name?string | nullproduct.price?number | nullproduct.stock?number | integer | nullproduct.rating?number | nullproduct.region?string | nullproduct.country?string | nullproduct.options?object[]product.options[].price?number | nullproduct.options[].stock?number | integer | nullproduct.options[].vintage?string | nullproduct.options[].option_id?string | nullproduct.options[].sale_price?number | nullproduct.options[].bottle_size?string | nullproduct.options[].availability?string | nullproduct.options[].product_page_url?string | nullproduct.options[].fulfillment_options?string[]product.vintage?string | nullproduct.category?string | nullproduct.varietal?string | nullproduct.image_url?string | nullproduct.product_id?string | nullproduct.sale_price?number | nullproduct.bottle_size?string | nullproduct.description?string | nullproduct.subcategory?string | nullproduct.availability?string | nullproduct.critic_scores?unknown | nullproduct.product_page_url?string | nullproduct.producer_or_brand?string | nullproduct.store_availability?object[]product.store_availability[].price?number | nullproduct.store_availability[].stock?number | integer | nullproduct.store_availability[].address?string | nullproduct.store_availability[].store_id?string | nullproduct.store_availability[].store_name?string | nullproduct.store_availability[].availability?string | nullproduct.store_availability[].fulfillment_options?string[]Fields marked ? are optional.
GETCategory list/categories
Category List
Input
No input parameters.
Response
source?string, default: cellar53wine.comcategoriesobject[]categories[].values?object[]categories[].values[].count?integer | nullcategories[].values[].value?objectcategories[].values[].active?boolean | nullcategories[].values[].display?string | nullcategories[].values[].tooltip?string | nullcategories[].display?string | nullFields marked ? are optional.
GETStore info/store
Store Info
Input
No input parameters.
Response
source?string, default: cellar53wine.comlocationsobject[]locations[].name?string | nulllocations[].email?string | nulllocations[].hours?object | nulllocations[].phone?string | nulllocations[].address?string | nulllocations[].store_id?string | nulllocations[].delivery_area?objectlocations[].delivery_area.geometry?object | nulllocations[].delivery_area.delivery_fee?number | nulllocations[].delivery_area.minimum_order?number | nulllocations[].shipping_locations?object[]locations[].shipping_locations[].state?string | nulllocations[].shipping_locations[].minimum_order?number | nulllocations[].shipping_locations[].minimum_free_shipping?number | nulllocations[].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.
An account is required to submit an extension. Prepare your request, then sign in to build.