Developer resources
·
Use this page to automate your own transcription work. Start with a REST or MCP quickstart, then use the API docs and OpenAPI for schemas.
REST quickstart
- Open https://verbafy.io and create an account, or log in. Guest REST from the website may require a Turnstile token. Do not bypass that check.
- For browser REST, the signed-in site sends a Clerk session JWT. Verbafy does not display that token. Guests can send the
verbafy_guest_sessioncookie instead. For scripts and agents, create an API key under Settings → API keys and sendAuthorization: Bearer sk-…to Remote MCP. - Submit supported media with
POST /api/v1/transcriptsand body{"url":"https://www.youtube.com/watch?v=VIDEO_ID"}. Private files use the upload reservation flow instead. - A
200means the enhanced transcript is ready. A202means it is still processing. PollGET /api/v1/transcripts/{id}/statusuntilstatusisreadyorfailed. - Read the result with
GET /api/v1/transcripts/{id}.
Example status while processing:
{
"id": "11111111-1111-1111-1111-111111111111",
"status": "processing",
"transcriptReady": false,
"previewReady": false,
"chatReady": false,
"chatIndexStatus": "pending",
"errorMessage": null,
"readyAt": null
}If status is failed, read errorMessage, then retry when the input is valid. 401 means the credential is missing or expired. 402 means the plan does not allow the job. 429 on Guest session create includes Retry-After. Spotify episode URLs can fail when the public RSS item cannot be matched; see why a Spotify episode may fail.
Full operation pages: create a transcript. Credentials and expiry: Auth.md.
MCP quickstart
Remote MCP is Streamable HTTP at https://verbafy.io/api/v1/mcp. It wraps the REST contract. It is not a second API.
- Open https://verbafy.io and create an account, or log in. Do not use a signup path that skips the website.
- Open Settings → API keys and create a named key. The secret is shown once.
- Configure the MCP client with URL
https://verbafy.io/api/v1/mcpandAuthorization: Bearer sk-…. - Call the transcript tools, wait until processing finishes, then read the transcript. Guests cannot use MCP.
Recovery: 401 after revoke means you need a new key. 403 means the user cannot use MCP. Keep detailed schemas in the API reference.
Guides
Customer webhook subscriptions are not supported. Machine-readable catalogs for agents start at llms.txt. Human support: support@verbafy.io.