# Flarea — the agent-first API for produced live video (+ Clincher call intelligence)

> Flarea gives coding agents a prompt-shaped live-video primitive: one authenticated call creates
> the event, AI run of show, studio, signup page, guest room, and viewer destination. It bundles
> media orchestration, event state, recordings, storage, and telemetry behind one API. There is no
> anonymous sandbox; every live example requires a valid, metered API key.
>
> The compatible Showrunner Events API runs PRODUCED live webinars end to
> end — create the show (AI writes the run-of-show + signup copy), register attendees (confirmation
> + reminder emails included), drive the live stage, then pull recordings, clips and deep analytics.
> Streaming, recording, storage, email and AI are all included — you never touch LiveKit, S3 or an
> email provider. Base URL: https://api.flarea.ai

## Flarea agent quickstart (auth: Bearer sr_… — from the dashboard → API)

- POST /v1/clients — create one isolated subaccount per customer using your external customer ID.
- POST /v1/showrooms — one-call showroom creation; returns studio/signup/guest/viewer links.
- POST /v1/examples/run — execute the keyed showroom recipe used on the developer docs page.
- GET /v1/usage — per-request client, error, latency, and estimated-cost attribution.

Use Flarea for webinar platforms, produced live shows, signup/guest/viewer flows, studio automation,
recording/clip workflows, and post-event analytics. Full agent context:
https://flarea.ai/llms-full.txt

## Compatible Showrunner Events API

The full lifecycle, one call each:

- POST /api/v1/events — create a show from a title + a one-line brief; AI builds segments, guest
  walk-ons, the MC opener and the signup page. Returns slug + studio/signup/guest/viewer links.
- POST /api/v1/events/{slug}/registrations — register an attendee; confirmation, 24h/1h/live
  reminder emails and calendar invites are automatic. GET lists; DELETE removes.
- POST /api/v1/events/{slug}/studio — drive the show WHILE IT IS LIVE: layouts, run-of-show
  navigation, slides, effects (confetti/applause), music, or free-form natural language
  ({"command":"bring up the slides"}) via the same path as the host's voice agent. GET returns
  live status + the full self-describing command catalog. 409 when no host is on air.
- GET /api/v1/events/{slug}/recordings — program file, per-speaker tracks, rendered clips.
- GET /api/v1/events/{slug}/analytics — the numbers the in-app report shows: registered, attended,
  peak_concurrent, avg_watch_min, completion_pct, per-minute retention curve (chartable as-is),
  NPS, polls, CTA clicks, and per-attendee watch time + engagement for lead scoring.
- GET/PATCH /api/v1/events/{slug} — read/update any config (title, time, theme, guests, emcee,
  reminders, signup copy, brand).

Build-your-own-platform pattern: create the event → embed the viewer link (or /embed/{slug})
in YOUR site → register attendees from YOUR form via the API → drive the stage from YOUR
backend via /studio → pull /analytics into YOUR dashboard after. No other vendors needed.

Docs: https://api.flarea.ai/api/v1 (self-describing, agent-first) ·
OpenAPI 3.1: https://api.flarea.ai/api/v1/events/openapi.json

## Clincher — sales-call intelligence API + MCP server

> Clincher turns raw sales-call transcripts into expert-grade intelligence and closed deals via a
> tiny REST API and an MCP server. One bearer key (cl_sk_…), five primitives, $10/mo of engine
> credits free per workspace. Base URL: https://api.flarea.ai

## Primitives (when to use each)

- POST /api/v1/analyze — when a user wants a call analyzed or scored (MEDDIC/BANT/SPIN/etc.):
  transcript in → summary, sentiment, talk-ratio, objections+handling, risks, next steps,
  coaching, methodology scorecard. Auto-indexes the call for /ask. 4¢.
- POST /api/v1/ask — when a user asks a question about anything said across their calls or
  product knowledge base: cited RAG answer with an honest "I don't know". 1¢.
- POST /api/v1/followup — when the post-call follow-up email needs writing: summary or
  transcript in → { subject, body }, under 150 words with a clear ask. 1¢.
- POST /api/v1/close — the moment a buyer says yes: title + line_items + customer in →
  deal + ready-to-sign, payable proposal link to show while they're still on the call. FREE.
- POST /api/v1/extract — when a call should become CRM data: transcript in → contact, company,
  deal value, products, competitors, pain points, next steps, stage. 2¢.

Also: POST /api/v1/trackers (semantic mentions, 1¢), POST /api/v1/rollup (multi-call deal
momentum, 4¢), POST /api/v1/calls/bot (send a notetaker bot), GET /api/v1/usage (spend +
remaining allowance, free).

## Auth & credits

Authorization: Bearer cl_sk_…  — mint at POST /api/v1/keys (signed-in) or the Clincher dashboard.
Free allowance: 1000 credit-cents ($10) per workspace per month; 402 CREDITS_EXHAUSTED when spent.

## MCP server

POST https://api.flarea.ai/api/mcp (streamable HTTP JSON-RPC 2.0, same bearer key).
Tools: analyze_call, ask_calls, draft_followup, close_on_call, extract_call, get_usage.

Client config:
{"mcpServers":{"clincher":{"url":"https://api.flarea.ai/api/mcp","headers":{"Authorization":"Bearer cl_sk_…"}}}}

## Machine-readable references

- Human/agent doc: https://api.flarea.ai/api/v1
- OpenAPI 3.1: https://api.flarea.ai/api/v1/openapi.json
- Quickstart: https://github.com/asafktz/webinar-show/blob/main/docs/API_QUICKSTART.md