CLI

pip install colacloud-cli

export COLACLOUD_API_KEY=cola_xxxx

cola config set-key

# 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"

# Filter by package and derived category
cola colas list --category Beer --derived-subcategory "Beer > Ale" \
  --container-type can --volume-unit "fluid ounces" --volume-min 12 --volume-max 16

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

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

# Output as JSON
cola colas get 24001001000001 --json

# Find COLAs by UPC/EAN
cola barcode 012345678901

# View your API usage stats
cola usage

# 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'