Catalog / Worldwide Bev Live Catalog

Worldwide Bev Live Catalog API

worldwidebev.com

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.

  • Shopping
  • wine
  • beer
  • spirits
  • liquor-store
  • live-inventory
4 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 Worldwide Bev Live 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.

Search live products

Optional parameters 11

Keyword matched against the store catalog.

Top-level source category: wine, beer, or spirits; category values are also listed by /v1/categories.

Source subtype such as red, bourbon, lager, or tequila.

Source varietal filter, when supported by the product record.

Source region filter.

Source country filter.

Minimum live price in USD.

Maximum live price in USD.

Keep products whose live option quantity is positive.

relevance, price_asc, price_desc, name_asc, or name_desc.

1-based result page.

View call pricing
cURL · Products search
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.

GETProduct detail/v1/product-detail

Get one live product

Input

product_idOptionalQuery · string | null

Stable Worldwide Bev product id.

Example: 570d623669702d1ad3964800

product_urlOptionalQuery · string | null

Worldwide Bev product page URL; the id is derived from its path.

Example: https://www.worldwidebev.com/shop/product/rustic-spirits-margarita/570d623669702d1ad3964800

Response

idstring | null
abvnumber | null
namestring | null
pricenumber | null
ratingnumber | null
regionstring | null
countrystring | null
optionsobject[]
options[].packstring | null
options[].pricenumber | null
options[].in_stockboolean | null
options[].option_idstring
options[].sale_pricenumber | null
options[].bottle_sizestring | null
options[].location_idstring | null
options[].availabilitystring
options[].location_namestring | null
options[].product_page_urlstring | null
vintagestring | null
categorystring[]
in_stockboolean | null
producerstring | null
varietalstring | null
image_urlstring | null
sale_pricenumber | null
bottle_sizestring | null
descriptionstring | null
availabilitystring
rating_countinteger | null
critic_scoresunknown | null
product_page_urlstring | null
availability_by_locationobject[]
availability_by_location[].pricenumber | null
availability_by_location[].in_stockboolean | null
availability_by_location[].sale_pricenumber | null
availability_by_location[].location_idstring | null
availability_by_location[].availabilitystring | null
availability_by_location[].location_namestring | null
GETCategories/v1/categories

List accepted source categories and filters

Input

No input parameters.

Response

groupsobject[]
groups[].namestring | null
groups[].valuesobject[]
groups[].values[].namestring | null
groups[].values[].countinteger | null
groups[].values[].valueobject
GETStore/v1/store

Get live store locations and fulfillment

Input

No input parameters.

Response

locationsobject[]
locations[].idstring | null
locations[].namestring | null
locations[].emailstring | null
locations[].hoursobject | null
locations[].phonestring | null
locations[].addressstring | null
locations[].timezonestring | null
delivery_areaobject
delivery_area.namestring | null
delivery_area.typestring | null
delivery_area.hoursobject | null
delivery_area.base_feenumber | null
delivery_area.coordinatesobject[]
delivery_area.coordinates[].0number[]
delivery_area.delivery_feenumber | null
delivery_area.order_minimumnumber | null
delivery_area.delivery_fee_typestring | null
delivery_area.max_delivery_timenumber | null
delivery_area.minimum_to_leave_storenumber | null
shipping_availableboolean | null
fulfillment_optionsobject[]
fulfillment_options[].typestring
fulfillment_options[].availableboolean | null
fulfillment_options[].delivery_areaobject
fulfillment_options[].delivery_area.namestring | null
fulfillment_options[].delivery_area.typestring | null
fulfillment_options[].delivery_area.hoursobject | null
fulfillment_options[].delivery_area.base_feenumber | null
fulfillment_options[].delivery_area.coordinatesobject[]
fulfillment_options[].delivery_area.coordinates[].0number[]
fulfillment_options[].delivery_area.delivery_feenumber | null
fulfillment_options[].delivery_area.order_minimumnumber | null
fulfillment_options[].delivery_area.delivery_fee_typestring | null
fulfillment_options[].delivery_area.max_delivery_timenumber | null
fulfillment_options[].delivery_area.minimum_to_leave_storenumber | null
fulfillment_options[].order_minimumnumber | null
delivery_order_minimumnumber | null

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.