Brandwave/Docs

Getting Started#

Go from zero to your first API call in under five minutes. This guide walks you through installing Brandwave, authenticating, and querying creator performance data.

Prerequisites

You need a Brandwave account and an access token. Sign in at gobrandwave.com and copy your access token from the dashboard.

API Keys (Planned)

Organization API keys for server-side and agent authentication are planned for a future release. For now, use access tokens from the dashboard.
1

Install the package

bash
npm install @brandwave/ts
2

Configure authentication

typescript
import { createBrandwave } from '@brandwave/ts';

const bw = createBrandwave({
  accessToken: process.env.BRANDWAVE_ACCESS_TOKEN,
});
3

Make your first query

typescript
const { items, totalCount } = await bw.activities.list({
  organizationId: 'org_123',
  pageIndex: 0,
  pageSize: 10,
});

console.log(`Found ${totalCount} activities`);
console.log(items);

Example response#

json
{
  "items": [
    {
      "id": "act_abc123",
      "channel": "instagram",
      "activity": "Sponsored Reel",
      "startAt": "2025-01-15T00:00:00Z",
      "metrics": {
        "reach": 45200,
        "engagement": 3150,
        "impressions": 62800
      }
    }
  ],
  "totalCount": 42
}

Next steps#