Worldwide Bev Live Catalog API
Read-only live catalog data for Worldwide Wine & Spirits. Prices, inventory, categories, product details, and fulfillment information are read from the store's structured CityHive JSON endpoints on each request. Fields absent from the source are returned as null. The store currently exposes one location; the source reports shipping as null, so this API preserves that unknown value.
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 Worldwide Bev Live 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/7eb510b6-7cd9-43df-a361-15925a9276b9/v1/products/search' \
--header "Authorization: Bearer $AGENT_DATA_API_KEY"Endpoints
Inputs and response fields for every endpoint in this API.
GETProducts search/v1/products/search
Search live products
Input
keywordOptionalQuery · string | nullKeyword matched against the store catalog.
Example: Cabernet
categoryOptionalQuery · string | nullTop-level source category: wine, beer, or spirits; category values are also listed by /v1/categories.
Example: wine
subcategoryOptionalQuery · string | nullSource subtype such as red, bourbon, lager, or tequila.
Example: red
varietalOptionalQuery · string | nullSource varietal filter, when supported by the product record.
Example: Cabernet Sauvignon
regionOptionalQuery · string | nullSource region filter.
Example: Napa Valley
countryOptionalQuery · string | nullSource country filter.
Example: Italy
min_priceOptionalQuery · number, min: 0 | nullMinimum live price in USD.
Example: 10
max_priceOptionalQuery · number, min: 0 | nullMaximum live price in USD.
Example: 30
in_stock_onlyOptionalQuery · boolean, default: falseKeep products whose live option quantity is positive.
Example: true
sortOptionalQuery · string, default: relevancerelevance, price_asc, price_desc, name_asc, or name_desc.
Example: price_asc
pageOptionalQuery · integer, min: 1, default: 11-based result page.
Example: 1
Response
pageintegerhas_morebooleanproductsobject[]products[].idstring | nullproducts[].namestring | nullproducts[].pricenumber | nullproducts[].categorystring[]products[].in_stockboolean | nullproducts[].producerstring | nullproducts[].image_urlstring | nullproducts[].sale_pricenumber | nullproducts[].bottle_sizestring | nullproducts[].availabilitystringproducts[].product_page_urlstring | nullpage_sizeintegerGETProduct detail/v1/product-detail
Get one live product
Input
product_idOptionalQuery · string | nullStable Worldwide Bev product id.
Example: 570d623669702d1ad3964800
product_urlOptionalQuery · string | nullWorldwide Bev product page URL; the id is derived from its path.
Example: https://www.worldwidebev.com/shop/product/rustic-spirits-margarita/570d623669702d1ad3964800
Response
idstring | nullabvnumber | nullnamestring | nullpricenumber | nullratingnumber | nullregionstring | nullcountrystring | nulloptionsobject[]options[].packstring | nulloptions[].pricenumber | nulloptions[].in_stockboolean | nulloptions[].option_idstringoptions[].sale_pricenumber | nulloptions[].bottle_sizestring | nulloptions[].location_idstring | nulloptions[].availabilitystringoptions[].location_namestring | nulloptions[].product_page_urlstring | nullvintagestring | nullcategorystring[]in_stockboolean | nullproducerstring | nullvarietalstring | nullimage_urlstring | nullsale_pricenumber | nullbottle_sizestring | nulldescriptionstring | nullavailabilitystringrating_countinteger | nullcritic_scoresunknown | nullproduct_page_urlstring | nullavailability_by_locationobject[]availability_by_location[].pricenumber | nullavailability_by_location[].in_stockboolean | nullavailability_by_location[].sale_pricenumber | nullavailability_by_location[].location_idstring | nullavailability_by_location[].availabilitystring | nullavailability_by_location[].location_namestring | nullGETCategories/v1/categories
List accepted source categories and filters
Input
No input parameters.
Response
groupsobject[]groups[].namestring | nullgroups[].valuesobject[]groups[].values[].namestring | nullgroups[].values[].countinteger | nullgroups[].values[].valueobjectGETStore/v1/store
Get live store locations and fulfillment
Input
No input parameters.
Response
locationsobject[]locations[].idstring | nulllocations[].namestring | nulllocations[].emailstring | nulllocations[].hoursobject | nulllocations[].phonestring | nulllocations[].addressstring | nulllocations[].timezonestring | nulldelivery_areaobjectdelivery_area.namestring | nulldelivery_area.typestring | nulldelivery_area.hoursobject | nulldelivery_area.base_feenumber | nulldelivery_area.coordinatesobject[]delivery_area.coordinates[].0number[]delivery_area.delivery_feenumber | nulldelivery_area.order_minimumnumber | nulldelivery_area.delivery_fee_typestring | nulldelivery_area.max_delivery_timenumber | nulldelivery_area.minimum_to_leave_storenumber | nullshipping_availableboolean | nullfulfillment_optionsobject[]fulfillment_options[].typestringfulfillment_options[].availableboolean | nullfulfillment_options[].delivery_areaobjectfulfillment_options[].delivery_area.namestring | nullfulfillment_options[].delivery_area.typestring | nullfulfillment_options[].delivery_area.hoursobject | nullfulfillment_options[].delivery_area.base_feenumber | nullfulfillment_options[].delivery_area.coordinatesobject[]fulfillment_options[].delivery_area.coordinates[].0number[]fulfillment_options[].delivery_area.delivery_feenumber | nullfulfillment_options[].delivery_area.order_minimumnumber | nullfulfillment_options[].delivery_area.delivery_fee_typestring | nullfulfillment_options[].delivery_area.max_delivery_timenumber | nullfulfillment_options[].delivery_area.minimum_to_leave_storenumber | nullfulfillment_options[].order_minimumnumber | nulldelivery_order_minimumnumber | nullDon’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.