Signals API

Why a Signals API

Raw AI video generation is being commoditized fast. Veo 3, Sora 2, Kling 2.5, Wan 2.6, Seedance Pro — every quarter brings cheaper, higher-quality model output. The pipeline orchestration that turns a model clip into a finished branded short-form video will follow the same curve over the next 12-24 months.

What does not get cheaper: the proprietary first-party signal that tells an agent what to generate. ReelsBuilder's render pipeline produces a continuous stream of high-quality data — every successful render is a labeled example of which hook, format, duration, and brand combination won engagement. That data feeds back into the Signals API.

The Signals API is the data side of the same rail your generation calls run on. Same key, same MCP surface, same USD ledger.

Endpoints

GET /api/v1/x-hooks — proven X hookslive · free

High-performing real hooks mined from X (engagement-weighted, freshness-decayed, niche-aware). Each result carries a virality score, a relevance score for your topic, a format tag (conflict, personal_story, category_redefinition, etc.), and the source post URL for attribution.

curl -s "https://api.reelsbuilder.ai/api/v1/x-hooks?topic=copy%20trading&limit=10" \
  -H "Authorization: Bearer $REELSBUILDER_API_KEY" \
  | jq '.data.hooks[] | {hook, score, format, virality_score, freshness_score}'

MCP tool name: get_x_hooks. Free for the public beta; may move to $0.005/lookup bulk-priced after volume stabilizes (announced in advance).

GET /api/v1/trending — trend opportunitiesschema published · live route Q2 2026

Ranked trend opportunities suitable for branded short-form video. Composes Google Trends, NewsAPI, and ReelsBuilder's own engagement signal. Each result carries a virality score, a breaking-news urgency flag, a recency window, and a recommended hook/format mapping. Schema is published in /api/v1/tools today for agent discovery; the live data feed is in beta with select partners.

# Schema-only response today; live data Q2 2026
curl -s "https://api.reelsbuilder.ai/api/v1/trending?market=fintech&limit=20" \
  -H "Authorization: Bearer $REELSBUILDER_API_KEY"

GET /api/v1/brand-profile — brand DNAschema published · live route Q2 2026

The authenticated account's brand profile: industry, tone, voice recommendation, topic pool, color palette, font system, and approved video styles. Used by the generation pipeline to keep every render on-brand without per-call configuration. The standalone endpoint is published in /api/v1/tools for schema discovery; live route ships alongside the brand intelligence dataset in beta with select partners.

Future: get_brand_intelligence, get_render_performance

Two data products on the roadmap that don't have schemas published yet:

• Brand Intelligence — bulk enrichment from a URL or company name to a structured brand DNA payload (industry, tone, audience clusters, competitive positioning). Closest comparable: BuzzSumo + Brandwatch + Clearbit. Probable pricing: $0.05–$0.25 per lookup, volume tiered.
• Render Performance Index — aggregated, anonymized data on which hooks, formats, durations, and captions actually win engagement across the ReelsBuilder customer base. A Quantcast-equivalent for short-form video. Subscription-priced.

How the data composes with generation

The intended agent loop is:

// 1. Agent decides what to make
trending = await rb.getTrending({ market: "fintech", limit: 10 })
hooks    = await rb.getXHooks({ topic: trending[0].topic, limit: 5 })

// 2. Agent generates the asset using the best signal as input
job = await rb.generateVideo({
  prompt: `${hooks[0].hook}. ${trending[0].context}`,
  duration_target_sec: 15,
  aspect_ratio: "9:16",
}, idempotencyKey)

// 3. Agent polls + hands the asset to its publisher of choice
asset = await rb.waitForJob(job.job_id)
await myPublisher.post({ videoUrl: asset.videoUrl, ... })

The data calls are free reads today. The paid render at step 2 is the only USD charge. The published-to-distribution handoff at step 3 is owned by the caller — see Agent Generate API.

Competitive context

The Signals API sits in a category where ReelsBuilder competes with subscription-priced data products, not video tools:

• Exploding Topics — $39–$99/month trend subscription
• BuzzSumo — $199+/month content + brand trends
• Brand24 — $79+/month social listening
• Glimpse — $99/month emerging trends
• Tubular — $1,000+/year YouTube/TikTok analytics

ReelsBuilder's differentiator vs those: data plus a video API on the same key. Trend → hook → render is a single authenticated session, not a stitched workflow across three subscriptions.

Where to go next

• Hook Generator — synthesize hooks for any topic (paid)
• Viral Trends — the consumer-facing trend feed
• Brand DNA — extract brand profile from a URL
• Pricing — full USD-cent per-tool table