Total Wine
Total Wine Store Locator API
Find Total Wine & More stores near a ZIP code or city: store number, name, address, phone, coordinates, distance in miles and delivery availability. The store_id is what Total Wine Search and Total Wine Product need for that store's prices and stock. Costs 10 credits per request.
POST/api/v1/totalwine/stores
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonquerystringrequiredZIP code, city, or "city, state".
Example: 78801
radiusintegerSearch radius in miles (1-200). Defaults to 50.
Example: 100
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
stores = client.totalwine.stores("78801", radius=100)["data"]["stores"]
for s in stores:
print(s["store_id"], s["name"], s["city"], s["distance_miles"], "mi")
# Use a store_id for that store's prices
results = client.totalwine.search("titos", store_id=stores[0]["store_id"])Response
"query": "78801",
"radius": 100,
"count": 3,
},
"response_time": 3575
}