Skip to main content

Installation

pip install colacloud-cli
Requires Python 3.9+.

Configuration

Set your API key via environment variable:
export COLACLOUD_API_KEY=cola_xxxx
Or configure it persistently:
cola config set-key

Commands

Search COLAs

# Quick search
cola search "bourbon"

# With filters (use 'cola colas list' for full filtering)
cola colas list --brand "Maker's Mark" --product-type "distilled spirits" --limit 20

# Filter by origin
cola colas list --origin kentucky --product-type "distilled spirits"

# Date range
cola colas list --date-from 2024-01-01 --date-to 2024-06-30

Get COLA Details

# Fetch a specific COLA by TTB ID
cola colas get 24001001000001

# Output as JSON
cola colas get 24001001000001 --json

Barcode Lookup

# Find COLAs by UPC/EAN
cola barcode 012345678901

Check Usage

# View your API usage stats
cola usage

Output Formats

# Human-readable (default)
cola search "wine" --limit 5

# JSON output for scripting
cola search "wine" --limit 5 --json

# Pipe to jq for processing
cola search "wine" --json | jq '.data[].brand_name'