Spec's

Spec's Product API

One Spec's product with every store's price and stock in store_prices (about 200 Texas stores in one call), the online price, and details: brand, size, proof, ABV, type, origin, region, vintage, tasting notes, description and images. Pass store_id to put that store's price at the top. Prices are in cents (3260 = $32.60). Costs 5 credits per request.

POST/api/v1/specs/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

slugstring

Last part of the product URL, or the slug of a search result. Send slug or product_url.

Example: titos-texas-vodka-5

product_urlstring

Spec's product URL, https://specsonline.com/shop/<type>/<slug>/.

Example: https://specsonline.com/shop/spirits/titos-texas-vodka-5/

store_idstring

Spec's store number from /api/v1/specs/stores. Sets the top-level price and stock to that store's.

Example: 169

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Store 169 = Stone Oak, San Antonio
p = client.specs.product(slug="titos-texas-vodka-5", store_id="169")["data"]

print(p["name"], f"store ${p['price'] / 100:.2f}", f"online ${p['online']['price'] / 100:.2f}")

# Every store's price in the same response
cheapest = min(p["store_prices"], key=lambda s: s["price"])
print("cheapest store:", cheapest["store_id"], f"${cheapest['price'] / 100:.2f}")

Response

"sku": "181081",

"upc": "061994700003",

"slug": "titos-texas-vodka-5",

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

"title": "Handmade Vodka",

"brand": "Tito's",

"size": "1.75L",

"proof": "80",

"abv": "40.00%",

"type": "Texas Vodka",

"varietal": null,

"origin": "United States",

"region": "Texas (TX)",

"vintage": null,

"tasting_notes": "Clean, Cherry, Vanilla, Spice",

"description": "Tito's Handmade Vodka is an unflavored low-calorie vodka that is naturally gluten-free with zero carbs and zero sugars. Produced in Austin, Texas, Tito's is made from corn and crafted in old-fashioned pot stills inspired by the distillation methods of fine single malt scotches and high-end French cognacs. Tito's is distilled six times and each batch is taste-tested to ensure that each sip goes down smooth and has an impeccably clean finish.",

"url": "https://specsonline.com/shop/spirits/titos-texas-vodka-5/",

"store_id": "169",

"available_at_store": true,

"price": 3260,

"case_price": null,

"case_quantity": null,

"on_promo": false,

"keyclub_offer": false,

"in_stock": true,

"store_count": 195,

"rating": null,

"review_count": 0

"response_time": 29059

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Store 169 = Stone Oak, San Antonio p = client.specs.product(slug="titos-texas-vodka-5", store_id="169")["data"] print(p["name"], f"store ${p['price'] / 100:.2f}", f"online ${p['online']['price'] / 100:.2f}") # Every store's price in the same response cheapest = min(p["store_prices"], key=lambda s: s["price"]) print("cheapest store:", cheapest["store_id"], f"${cheapest['price'] / 100:.2f}")