Verbafy
API referenceTranscripts

Create a transcript from a public URL

Accepts a YouTube or Spotify episode URL. Returns 200 when the enhanced transcript is ready, or 202 while processing.

POST /api/v1/transcripts

OpenAPI operation createTranscript. Authenticate with a Clerk session JWT (Authorization: Bearer {jwt}) or the verbafy_guest_session cookie. {jwt} is a Clerk session token after you sign in on the website. Verbafy does not issue that token and does not show it in Settings. For scripts and agents, sign in, create an API key at Settings → API keys, and call Remote MCP with Authorization: Bearer sk-…. Credential setup: Auth.md. Machine-readable contract: OpenAPI.

Request example

curl -X POST 'https://verbafy.io/api/v1/transcripts' \
  -H 'Authorization: Bearer {jwt}' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://www.youtube.com/watch?v=VIDEO_ID"}'

Responses

StatusDescription
200Transcript ready
202Transcript accepted and still processing
400Validation or domain request error
401Missing or invalid Clerk Bearer token or guest session
402Plan or usage does not include this action
502Upstream processing failed
503Dependency unavailable

Remote MCP at /api/v1/mcp is a companion wrap of this REST contract.