Total Wine

Total Wine Product API

One Total Wine product at one store: price, units in stock, aisle, bay and shelf, last restock date, ABV, size, taste profile, characteristics, breadcrumbs, images, rating and review count, plus pickup, delivery and shipping availability. Prices are in cents (2999 = $29.99). Costs 10 credits per request.

POST/api/v1/totalwine/product

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

product_idstring

Numeric id from the product URL's /p/<id>, or the id of a search result. Send product_id or product_url.

Example: 96260175

product_urlstring

Total Wine product URL ending in /p/<id>.

Example: https://www.totalwine.com/spirits/vodka/vodka/titos-handmade-vodka/p/96260175

store_idstringrequired

Total Wine store number from /api/v1/totalwine/stores.

Example: 503

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

p = client.totalwine.product(product_id="96260175", store_id="503")["data"]

print(p["name"], p["size"], f"${p['price'] / 100:.2f}")
print(p["stock"], "in stock,", p["aisle"], p["bay"], p["shelf"])
print("last restocked", p["last_received_date"])

Response

"id": "96260175",

"sku_id": "96260175-1",

"store_id": "503",

"name": "Tito's Handmade Vodka",

"brand": "Tito's",

"size": "1.75L Bottle",

"pack": "Single",

"alcohol_percentage": 40,

"url": "https://www.totalwine.com/spirits/vodka/vodka/titos-handmade-vodka/p/96260175",

"price": 2999,

"in_stock": true,

"stock": 1201,

"aisle": "Aisle 03 Left",

"bay": "Bay 26",

"shelf": "Shelf 04",

"last_received_date": "2026-06-16T11:21:49.013Z",

"rating": 4.8283,

"review_count": 3302,

"pickup": true,

"delivery": true,

"shipping": true

"response_time": 3052

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") p = client.totalwine.product(product_id="96260175", store_id="503")["data"] print(p["name"], p["size"], f"${p['price'] / 100:.2f}") print(p["stock"], "in stock,", p["aisle"], p["bay"], p["shelf"]) print("last restocked", p["last_received_date"])