🍷 TTB COLA — Alcohol Label Approval Scraper & New-Approval Monitor

Scrape the U.S. TTB public COLA registry — the federal record of every approved beer, wine, and spirits label — with brand, fanciful name, class/type, origin, permit, serial, and approval date. Filter by date, class, origin, or brand, and run it on a schedule to monitor NEW label approvals with Slack / email / webhook alerts.

No login, no anti-bot — it's public federal data served as server-rendered HTML. (A paid SaaS, COLA Cloud, sells exactly this "monitor new approvals" capability; this actor gives you the scheduled scraper.)

---

What does it do?

It searches the TTB Public COLA Registry (Certificate/Exemption of Label/Bottle Approval) and returns clean rows you can export to JSON, CSV, Excel, or push to your app via API — and, on a schedule, it alerts you to brand-new approvals.

• 🍾 Every approved label in your date range / filters.
• 🏷️ Brand name, fanciful name, class/type, origin, permit no., serial no., TTB ID.
• 📅 Approval (completed) date + a link to the full TTB detail page.
• 🔔 New-approval monitor — alert when a new label is approved matching your class/origin/brand.

---

What data does it extract?

For every approval: ttb_id, permit_no, serial_number, completed_date, fanciful_name, brand_name, origin_code, origin, class_code, class_type, detail_url, is_new (monitor), scraped_at.

---

Who is it for?

• ⚖️ Beverage-alcohol compliance & legal teams tracking approvals and competitors.
• 🏭 Brands & importers monitoring their own and rivals' label activity.
• 🎨 Label-design firms and 📊 market-intel analysts watching new product launches.

---

How to use it (step by step)

1. Click Try for free.
2. Set a date range (or just Lookback days for a rolling window) and any class / origin / brand filters.
3. Click Start, then open the Dataset tab to view/export.
4. (Optional) set monitorMode + a Schedule + an alert channel to get pinged on new approvals.

Quick start

{ "lookbackDays": 7 }

New-approval monitor example

{
  "lookbackDays": 2,
  "brandName": "RESERVE",
  "monitorMode": true,
  "slackWebhookUrl": "https://hooks.slack.com/services/…"
}

---

Input

Field	What it does
dateFrom / dateTo / lookbackDays	approval completed-date range
productSource, classType, origin, brandName, fancifulName	TTB search filters
maxRecords	hard cap per run (0 = all matching, up to TTB's ~1000/search cap)
monitorMode, alertOnNewApproval	recurring new-approval watcher + alerts
webhookUrl, slackWebhookUrl, emailRecipients	alert channels
proxyConfiguration	proxy settings

---

Output

Each approval is one dataset record (fields above). Export to JSON, CSV, Excel, HTML, or RSS, or fetch via the Apify API.

---

How much does it cost?

Pay-per-event — you pay for what you pull:

Event	What it covers	Suggested price
lot-scraped	each approval returned	~$0.003 / approval
monitor-run-completed	each scheduled watch run	~$0.05 / run
new-lot-detected	each newly-approved label	~$0.02 / approval
alert-delivered	each Slack/email/webhook push	~$0.005 / alert

(Final per-event prices are set on the actor's pricing page.)

---

Notes & limits

• TTB caps each search at ~1,000 results — narrow by date range / class / origin to page through everything.
• This actor returns the registry row data (brand, class, origin, dates, IDs) + a link to the TTB detail page for the full record and label image.

---

Is it legal to scrape TTB COLA data?

Yes — the COLA registry is public U.S. federal data, published by the TTB for public search, and contains label/product data (not personal data). You're still responsible for your use: review TTB's site terms and any rules on bulk use.

---

FAQ

What's a COLA? A Certificate of Label Approval — TTB's required approval before a beer/wine/spirits label can be sold across state lines.

Can I get only new approvals? Yes — monitorMode outputs/alerts only approvals new since the last run.

Do I get the label image? The actor returns the registry fields plus a detail_url to the TTB page that shows the full record and label image.

How do I export? JSON, CSV, Excel, HTML, or RSS from the Dataset tab, or via the Apify API.

---

Feedback

Want full detail-page enrichment (alcohol %, net contents, formula) or a bulk historical backfill? Open an issue on the actor.