SparkVoxSparkVox

Build with the
SparkVox API

Turn recordings into LinkedIn posts programmatically.
Submit content, receive webhooks when posts are ready, and manage drafts.

Get API KeyView API Docs

Quick start

Everything you need to integrate SparkVox into your workflow.

Get an API Key

Create a key in Settings → Developer. Keys start with sk_sparkvox_.

Read the docs

Authentication, endpoints, webhooks, and code examples.

Create a project

Resolve YouTube duration with GET /api/url-metadata, then POST a URL or transcript. Processing is async.

YouTube metadata (no key)

Public GET /api/url-metadata returns duration, title, channel, and tags before you create a project.

Set up webhooks

Get notified when projects are ready or fail. Verify HMAC signatures.

What you can do

The v1 API covers the core project workflow - long-form LinkedIn posts only.

  • Submit recording URLs or transcripts and receive LinkedIn posts asynchronously
  • Same Claude Sonnet pipeline as the web app - moment curation, best-of-two hook ranking, voice profile, distinctiveness checks on Awareness/Authority drafts, LinkedIn-native formatting
  • Resolve YouTube metadata (duration, title, channel, tags) via public GET /api/url-metadata before POST /projects - no API key required
  • Import projects from connected Google Drive, Dropbox, or OneDrive via API (source_type cloud: MP3/SRT on all providers; Google Docs on google-drive) or the web app Import from cloud tab (MP3, TXT, SRT; Google Docs on Drive)
  • List integrations, projects, and posts; delete projects when done
  • Approve, edit, publish to LinkedIn, generate AI images, or upload custom images via REST
  • Register webhooks for project.ready and project.failed events

See API changelog and what is not in v1.

Example request
curl -X POST https://app.sparkvox.io/api/v1/projects \
  -H "Authorization: Bearer sk_sparkvox_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My Podcast Episode",
    "source_type": "url",
    "source_url": "https://youtube.com/watch?v=...",
    "source_material": "Podcast / Interview",
    "perspective": "host",
    "platforms": ["linkedin"],
    "duration_seconds": 3600
  }'

Ready to integrate?

Create an API key in the SparkVox app and follow the documentation to submit your first project. The full API reference is below.

Get API KeyRead the full docs