Developer Platform
A full REST API, an MCP server for AI agents, real-time webhooks, and typed SDKs for TypeScript and Python โ everything you need to embed AI-generated audio briefings into your app, workflow, or agent.
20 endpoints for profiles, sources, briefings, schedules, and webhooks. Full OpenAPI 3.1 spec.
View API reference โ10 tools for AI agents over JSON-RPC 2.0. Drop into Claude Desktop, Continue, or any MCP client.
MCP quickstart โBearer API keys with fine-grained scopes. HMAC-signed webhooks. Full audit log.
Auth guide โTyped client for Node.js and Cloudflare Workers. Covers all 20 endpoints.
TypeScript SDK โSync + async client with Pydantic models. Works with FastAPI, Django, scripts.
Python SDK โ4 ready-to-run projects: personal assistant, business agent, website embed, Discord bot.
See use cases โSign in at listenbrief.com, then go to Settings โ API Keys to generate your first key.
POST https://listenbrief.com/api/v1/me/keys
Authorization: Bearer <session_token>
{"name":"My App","scopes":["read","write"]}
Register an RSS feed or website to pull content from.
curl -X POST https://listenbrief.com/api/v1/sources \
-H "Authorization: Bearer lb_api_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"rss","url":"https://techcrunch.com/feed/","name":"TechCrunch","profile_id":"prof_..."}'
Trigger an on-demand AI briefing and poll for the audio URL.
curl -X POST https://listenbrief.com/api/v1/briefings \
-H "Authorization: Bearer lb_api_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"profile_id":"prof_..."}'
Follow the full quickstart to go from zero to a generated AI audio briefing in under five minutes.
Get started โ