Developer API
Build with theSparkVox API
Turn recordings into LinkedIn posts programmatically.
Submit content, receive webhooks when posts are ready, and manage drafts.
Quick start, step by step.
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, programmatically.
The v1 API covers the core project workflow - long-form LinkedIn posts only.
- Submit recording URLs or transcripts and receive LinkedIn posts asynchronously
- Resolve YouTube metadata (duration, title, channel, tags)
- Import projects from connected Google Drive, Dropbox, or OneDrive via API
- List integrations, projects, and posts; delete projects when done
- Approve, edit, publish to LinkedIn, generate AI images (chart or photo pipeline, same as the app), 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.