We use PostHog analytics cookies on this marketing site to understand how visitors use sparkvox.io - only if you accept. The app at app.sparkvox.io does not use marketing analytics. Cookie Policy.

Utilities

Public helpers that do not require an API key.

GET/api/url-metadata?url=<encoded_url>

URL Metadata

Public helper to resolve YouTube video metadata when creating projects with source_type: url. No authentication required.

Response 200

json
{
  "duration_seconds": 3600,
  "title": "Episode title",
  "thumbnail_url": "https://...",
  "platform": "youtube"
}

Fields may be null if the video is unavailable or YOUTUBE_API_KEY is not configured. Use duration_seconds for the required duration_seconds field on POST /api/v1/projects.