API Reference#

The Brandwave REST API gives you programmatic access to all creator marketing data. Use standard HTTP requests from any language, platform, or tool.

Base URL#

text

https://api.gobrandwave.com/v1

Request format#

All requests must include an Authorization header with your API key. Request bodies should be JSON-encoded with the Content-Type: application/json header.

bash

curl https://api.gobrandwave.com/v1/activities \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response format#

All responses return JSON. List endpoints return paginated results with items and totalCount fields.

json

{
  "items": [...],
  "totalCount": 42
}

HTTP status codes#

Name	Type	Required	Description
200	`OK`	—	Request succeeded.
201	`Created`	—	Resource created successfully.
400	`Bad Request`	—	Invalid request parameters.
401	`Unauthorized`	—	Missing or invalid API key.
404	`Not Found`	—	Resource does not exist.
429	`Too Many Requests`	—	Rate limit exceeded. Retry after the specified delay.
500	`Server Error`	—	Internal server error. Contact support if persistent.

Next steps#

Authentication

Set up API keys and authenticate your requests.

TypeScript SDK

Use our typed SDK instead of raw HTTP requests.