JavaScript SDK

npm install colacloud

import { ColaCloud } from 'colacloud';

const client = new ColaCloud({ apiKey: 'cola_xxxx' });

// Search COLAs
const results = await client.colas.list({
  q: "Tito's",
  productType: 'distilled spirits',
  abvMin: 35,
  perPage: 10,
});

for (const cola of results.data) {
  console.log(`${cola.brand_name} - ${cola.product_name}`);
}

// Get a specific COLA with images and barcodes
const cola = await client.colas.get('24001001000001');
for (const image of cola.images) {
  console.log(image.image_url);
}

// Barcode lookup
const matches = await client.barcodes.lookup('012345678901');
console.log(`Found ${matches.total_colas} COLAs`);

const results = await client.colas.list({
  q: 'molson coors',
  category: 'Beer',
  derivedSubcategory: 'Beer > Ale',
  containerType: 'can',
  volumeUnit: 'fluid ounces',
  volumeMin: 12,
  volumeMax: 16,
});

for await (const cola of client.colas.iterate({ q: 'bourbon' })) {
  console.log(`${cola.ttb_id}: ${cola.brand_name}`);
}

for await (const permittee of client.permittees.iterate({ state: 'CA' })) {
  console.log(`${permittee.company_name}: ${permittee.colas} COLAs`);
}

// Search permittees
const permittees = await client.permittees.list({ state: 'NY', isActive: true });
for (const p of permittees.data) {
  console.log(`${p.company_name} (${p.permit_number})`);
}

// Get a single permittee with recent COLAs
const permittee = await client.permittees.get('NY-I-12345');
console.log(`Recent COLAs: ${permittee.recent_colas.length}`);

const usage = await client.usage.get();
console.log(`Detail views: ${usage.detail_views.used} / ${usage.detail_views.limit}`);
console.log(`List records: ${usage.list_records.used} / ${usage.list_records.limit}`);

import { ColaCloud } from 'colacloud';

const client = new ColaCloud({ apiKey: 'cola_xxxx' });

const client = new ColaCloud({ apiKey: 'cola_xxxx' });