Verbafy

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

  1. 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.
  2. For browser REST, the signed-in site sends a Clerk session JWT. Verbafy does not display that token. Guests can send the verbafy_guest_session cookie instead. For scripts and agents, create an API key under Settings → API keys and send Authorization: Bearer sk-… to Remote MCP.
  3. Submit supported media with POST /api/v1/transcripts and body {"url":"https://www.youtube.com/watch?v=VIDEO_ID"}. Private files use the upload reservation flow instead.
  4. A 200 means the enhanced transcript is ready. A 202 means it is still processing. Poll GET /api/v1/transcripts/{id}/status until status is ready or failed.
  5. 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.

  1. Open https://verbafy.io and create an account, or log in. Do not use a signup path that skips the website.
  2. Open Settings → API keys and create a named key. The secret is shown once.
  3. Configure the MCP client with URL https://verbafy.io/api/v1/mcp and Authorization: Bearer sk-….
  4. 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.