API-First Platform

Built for Agents

Integrate AI-powered brand voice content generation into your agent, workflow, or app. Full REST API with OpenAPI spec, scoped keys, and rate limit headers.

View OpenAPI SpecRead the Docs
5-Step Quickstart

From Zero to Publishing

Get your agent posting on-brand content in minutes

1

Sign up and create an API key

Create an account, then generate a scoped API key from Settings > API Keys.

# Your API key looks like:
bb_live_abcdefghijklmnopqrstuvwxyz1234567890ab
2

List your brands

Fetch brands accessible to your API key.

curl -H "Authorization: Bearer $BRANDBEACON_API_KEY" \
  https://brandbeacon.dev/api/v1/brands
3

Get brand voice

Retrieve the AI-extracted brand voice profile for content generation.

curl -H "Authorization: Bearer $BRANDBEACON_API_KEY" \
  https://brandbeacon.dev/api/v1/brands/{brand_id}/voice
4

Generate content

Generate platform-optimized content using the brand voice.

curl -X POST -H "Authorization: Bearer $BRANDBEACON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brand_id": "BRAND_UUID",
    "platforms": ["x_twitter", "instagram"],
    "goal": "Announce our new product launch"
  }' \
  https://brandbeacon.dev/api/v1/content/generate
5

Create and schedule a post

Create a draft post, then schedule it for publishing.

# Create the post
curl -X POST -H "Authorization: Bearer $BRANDBEACON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Your generated content here",
    "platforms": ["x_twitter", "instagram"],
    "brand_id": "BRAND_UUID"
  }' \
  https://brandbeacon.dev/api/v1/posts

# Schedule it
curl -X POST -H "Authorization: Bearer $BRANDBEACON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "post_id": "POST_UUID",
    "scheduled_at": "2026-02-03T14:00:00.000Z"
  }' \
  https://brandbeacon.dev/api/v1/posts/schedule

Developer Features

Everything you need to build reliable agent integrations

OpenAPI Spec

Machine-readable API specification for code generation and tooling.

Scoped API Keys

Fine-grained access control with 6 scopes and per-brand restrictions.

Rate Limit Headers

Every response includes X-RateLimit-Remaining-Rpm and Rpd headers.

8 Platforms

Facebook, Instagram, X/Twitter, LinkedIn, Google Business, Bluesky, TikTok, Threads.

Agent Billing

Usage tracked per API key with plan-based limits and overage alerts.

Brand Voice AI

AI brand voice extraction with personality, tone, and language patterns.

Discovery Resources

Machine-readable files for agent and LLM integration

Start Building

Create an account, generate an API key, and start publishing on-brand content from your agent.

Create AccountView Plans