ABC Fine Wine & Spirits Scraper

Scrape ABC Fine Wine & Spirits — Florida's oldest and largest family-owned wine, spirits, and beer retailer, with 150+ stores across Florida, Alabama, Georgia, South Carolina, and North Carolina. Search by keyword, browse the full wine/spirits/beer/ready-to-drink taxonomy, or pull specific products by URL. Get price, brand, varietal, country/region of origin, size, ABV, rating, images, and more. No login, no cookies, no paid proxy required.

What this actor does

• Three modes: search (keyword), byCategory (browse the real wine/spirits/beer/ready-to-drink/for-the-bar taxonomy, or a wine varietal), byProductUrls (fetch specific product pages)
• Filters: varietal, country of origin, region, brand, price range, in-stock only, "Sourced & Certified" only, organic only, additive-free only, new arrivals only, on sale only, minimum rating, sort order
• Optional deep enrichment: turn on fetchFullDetails to also pull ABV, sweetness, closure type, food pairings, and a description from each product's detail page
• Empty fields are omitted — every record only contains fields ABC actually returned

Output per product

• sku, title, brand
• price, msrp, currency, onSale, discountPercent
• category, categoryPath, type (e.g. Red, White, Bourbon)
• varietal (e.g. Cabernet Sauvignon, Chardonnay)
• size (bottle/can size), packSize
• country, region, subRegion
• sourcedAndCertified, organic, additiveFree, isNew, flavor
• rating, reviewCount
• popularityScore (relative popularity rank on ABC's own site — higher is more popular)
• priceRangeMin / priceRangeMax (when the product's price varies by store location)
• inStock, onlineAvailable, storeAvailabilityCount
• imageUrl, thumbnailImageUrl
• productUrl, sourceUrl
• When fetchFullDetails is on (or always for byProductUrls): description, sweetness, abv, proof, closureType, state, appellation, foodPairings[]
• recordType: "product", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / byCategory / byProductUrls
searchQuery	string	cabernet sauvignon	Free-text query (mode=search)
category	string	–	A real ABC category/sub-category or wine varietal path (mode=byCategory; optional refine on mode=search)
varietal	string	–	Restrict to a specific wine varietal
country	string	–	Restrict to a specific country of origin
region	string	–	Only products whose region/sub-region contains this text
brand	string	–	Only products whose brand contains this text
productUrls	array	–	Product URLs or bare SKUs (mode=byProductUrls)
priceMin / priceMax	int	–	Price range (USD)
inStockOnly	bool	false	Only in-stock products
sourcedCertifiedOnly	bool	false	Only ABC "Sourced & Certified" products
organicOnly	bool	false	Only organic-labeled products
additiveFreeOnly	bool	false	Only products in ABC's "Additive Free" program
newOnly	bool	false	Only products flagged as new arrivals
onSaleOnly	bool	false	Only products currently discounted below MSRP
ratingMin	int	–	Minimum customer star rating (1–5)
sortBy	string	relevance	relevance / featured / newest / mostPopular / highestRated / priceAsc / priceDesc / nameAsc / nameDesc
fetchFullDetails	bool	false	Fetch each product's detail page for ABV, sweetness, closure type, food pairings, description
maxItems	int	20	Hard cap on emitted records (1–1000)

Example: search with a price cap

{
  "mode": "search",
  "searchQuery": "chardonnay",
  "priceMax": 30,
  "inStockOnly": true,
  "maxItems": 50
}

Example: browse a category with full details

{
  "mode": "byCategory",
  "category": "Spirits>Shop By Type>Bourbon",
  "fetchFullDetails": true,
  "maxItems": 30
}

Example: fetch specific products

{
  "mode": "byProductUrls",
  "productUrls": [
    "https://www.abcfws.com/bota-box-nighthawk-bourbon-barrel-cabernet/314709",
    "314709"
  ]
}

Use cases

• Price monitoring — track pricing and discounts across wine, spirits, and beer categories over time
• Competitor research — compare a category's product range and pricing against other retailers
• Assortment tracking — monitor new arrivals and "Sourced & Certified"/organic/additive-free product listings
• Deal discovery — surface currently on-sale products within a category or search
• Regional retail research — study product availability and pricing across ABC's Southeastern US store footprint

Data source

ABC Fine Wine & Spirits' storefront uses a public Searchspring search/facets API (the same endpoint the site's own product-grid widget calls) that returns full structured product data — no auth, no cookies, no proxy needed. Product detail pages are server-rendered and used only for optional enrichment fields not present in the search index (ABV, sweetness, closure type, food pairings).

Why ABC Fine Wine & Spirits instead of TotalWine: this actor was originally built to target totalwine.com. TotalWine is protected by PerimeterX bot management at the IP-reputation layer — confirmed blocked across every zero-cost tier with live evidence from Apify's cloud infrastructure: plain httpx (with and without Apify's free AUTO proxy set to country=US), four different curl_cffi browser TLS impersonations (chrome131, chrome124, safari17_0, edge101), and a full headless-Chromium Playwright run — all returned an identical "press & hold" CAPTCHA challenge page regardless of TLS fingerprint or JS execution, indicating the block operates on IP reputation rather than fingerprinting. Since residential proxies are not used in this project, TotalWine cannot be reliably scraped at zero cost. ABC Fine Wine & Spirits is a comparable large US wine/spirits/beer retailer where both products and pricing are fully visible without login, and access is fully reliable at zero cost.

Limitations

• ABC Fine Wine & Spirits primarily serves Florida, Alabama, Georgia, South Carolina, and North Carolina; store-level availability (storeAvailabilityCount) reflects that footprint.
• ABV, sweetness, closure type, and food pairings are only available with fetchFullDetails: true (or always for byProductUrls) since they live on the product detail page, not the search index.
• varietal, country, region, subRegion, organic, additiveFree, flavor, and packSize come from the same search index attributes that back the varietal/country/region/brand/organicOnly/additiveFreeOnly input filters, but ABC's search index only returns those attributes on a subset of listings; when absent, turn on fetchFullDetails to fill in whichever of them the product's detail page carries (not every product has every attribute, e.g. spirits rarely have a wine varietal).
• priceRangeMin/priceRangeMax only appear for products whose price varies by store location; most products have a single flat price instead.
• Age-restricted alcohol products — this actor scrapes only publicly listed catalog/pricing data; it does not process orders and involves no age verification.

FAQ

Do I need a proxy or cookies? No. This actor works with no configuration beyond the input fields above, and runs on the Apify free plan.

Can I search across wine, spirits, and beer at once? Yes — leave category empty and just use searchQuery, or pick a top-level category like Wine, Spirits, or Beer to browse everything within it.

Why don't all products have a varietal or region? Not every product category (e.g. spirits, beer, bar accessories) carries a varietal or wine-region attribute — those fields are only included when ABC's catalog actually populates them for that product.

Can I get only new arrivals, on-sale items, or additive-free wines? Yes — set newOnly, onSaleOnly, or additiveFreeOnly to true, individually or combined with any other filter.

Can I filter by customer rating? Yes — set ratingMin to a value from 1 to 5 to only include products rated at least that many stars.