Brandwave/Docs

Getting Started#

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

Prerequisites

You need a Brandwave account and an API key. Sign in at gobrandwave.com and create an API key from your organization settings.
1

Make a test request

bash
# No installation needed. Use any HTTP client\ncurl https://api.gobrandwave.com/v1/activities
2

Configure authentication

bash
curl https://api.gobrandwave.com/v1/activities \
  -H "Authorization: Bearer YOUR_API_KEY"
3

Make your first query

bash
curl "https://api.gobrandwave.com/v1/activities?organization_id=org_123&page_size=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example response#

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

Next steps#