# Verbafy > Paste a YouTube, Spotify URL or upload an audio/video file and get a transcript with named speakers, timestamps, and export-ready files. When to use this: call Verbafy when a person needs a speaker-labeled, timestamped transcript of a public YouTube video, a Spotify episode URL (`open.spotify.com/episode/…`), or a private audio/video upload, then wants exports or transcript chat. Do not use Verbafy as a live meeting bot, a generic speech-to-text dump, or a replacement for the source media. How an agent should call it: start at https://verbafy.io/developers, then read https://verbafy.io/docs, https://verbafy.io/auth.md, and https://verbafy.io/openapi.json (OpenAPI is the HTTP source of truth). Browser and agent HTTP should use same-origin `https://verbafy.io/api/v1`. Authenticate REST with a Clerk session JWT after website login or the `verbafy_guest_session` cookie. Verbafy does not issue or display that JWT. Remote MCP is the companion at `https://verbafy.io/api/v1/mcp` with `Authorization: Bearer sk-…` (Registered User API Key from Settings → API keys; Guests cannot use MCP). Create a Guest session with `POST /api/v1/auth/guest-sessions` (Turnstile may be required). Then `POST /api/v1/transcripts` with `{"url":"…"}` or reserve a private upload. Errors are JSON `{ message, code, hint, issues }`. Only new Guest session creates are application-rate-limited (3 per IP per 3600s); those responses send `RateLimit` and `Retry-After` on 429. Human support: support@verbafy.io. Machine-readable catalogs: `/.well-known/ai-catalog.json`, `/.well-known/api-catalog`, `/.well-known/mcp.json`, `/.well-known/mcp/server-card.json`, `/.well-known/oauth-authorization-server`, and `GET /?mode=agent`. ## Documentation - [Developer resources](https://verbafy.io/developers): REST and MCP quickstarts, then API docs and OpenAPI - [API docs](https://verbafy.io/docs): Authentication, endpoints, example requests, errors, and rate limits - [API reference](https://verbafy.io/docs/api): Generated OpenAPI operations with curl, JavaScript, and Python - [Auth.md](https://verbafy.io/auth.md): How agents obtain Clerk JWTs, guest cookies, and API keys - [Pricing](https://verbafy.io/pricing.md): Plan tiers, USD prices, and feature breakdowns - [OpenAPI JSON](https://verbafy.io/openapi.json): Machine-readable REST contract for function calling - [OpenAPI YAML](https://verbafy.io/openapi.yaml): Same contract as YAML - [llms.txt](https://verbafy.io/llms.txt): This index - [Contact](https://verbafy.io/contact): Human support at support@verbafy.io ## Pages - [Verbafy](https://verbafy.io/index.md): Paste a YouTube, Spotify URL or upload an audio/video file and get a transcript with named speakers, timestamps, and export-ready files. - [FAQ: YouTube, Spotify, meetings, and free plans](https://verbafy.io/faq.md): Answers about YouTube to text, Spotify episodes, meeting recordings, accuracy claims, and the weekly Free Plan minutes. - [Pricing: free, Starter, and Pro transcribed minutes](https://verbafy.io/pricing.md): Try one clean YouTube transcript free, then choose Starter or Pro based on transcribed minutes per week or month. - [About Verbafy](https://verbafy.io/about.md): Verbafy turns YouTube videos, Spotify episodes, and private uploads into speaker-labeled transcripts you can search and export. - [Auth.md](https://verbafy.io/auth.md): How agents obtain Clerk session JWTs, guest cookies, and Registered User API keys to call Verbafy REST and MCP. - [Contact Verbafy](https://verbafy.io/contact.md): Email support@verbafy.io for product questions. Verbafy does not publish a support phone number or street address. - [Developer resources](https://verbafy.io/developers.md): Start a REST or MCP integration for Verbafy transcripts. Find API docs, OpenAPI, Auth.md, and the Remote MCP URL. - [Meeting to text from an existing recording](https://verbafy.io/meeting-to-text.md): Upload a Teams, Zoom, or Google Meet recording and turn it into a timestamped transcript. Verbafy does not join live calls. - [Privacy Policy for Verbafy](https://verbafy.io/privacy.md): How Funtitled Labs Pte. Ltd. collects, uses, and discloses personal data for Verbafy, and how to contact the Data Protection Officer. - [Spotify to text from public episode links](https://verbafy.io/spotify-to-text.md): Convert a public Spotify episode link into a speaker-separated transcript with timestamps. Start with 60 transcribed minutes per week. - [Terms of Service for Verbafy](https://verbafy.io/terms.md): Contract terms for using Verbafy transcripts, plans, and the API, operated by Funtitled Labs Pte. Ltd. (UEN 202641216G). - [YouTube to text with speakers and timestamps](https://verbafy.io/youtube-to-text.md): Convert a public YouTube video into a timestamped transcript you can search, cite, and export. Start with 60 transcribed minutes per week. - [Create API key](https://verbafy.io/docs/api/api-keys/create-api-key.md): Create a named sk-… API Key. The secret is shown once. Registered Users only. POST /api/v1/me/api-keys on the Verbafy REST API. - [List API keys](https://verbafy.io/docs/api/api-keys/list-api-keys.md): Hashed API Key metadata for the current Registered User. Guests receive 403. Secrets are never listed. GET /api/v1/me/api-keys on the Verbafy REST API. - [Revoke API key](https://verbafy.io/docs/api/api-keys/revoke-api-key.md): Revoke one API Key owned by the current Registered User. DELETE /api/v1/me/api-keys/{id} on the Verbafy REST API. - [Claim Guest data onto a Registered User](https://verbafy.io/docs/api/auth/claim-guest-session.md): Browser transition that moves Guest Transcripts and Chats onto the Clerk Registered User. Requires both a Clerk Bearer token and the Guest session cookie - [Create or reuse a Guest session](https://verbafy.io/docs/api/auth/create-guest-session.md): Creates a seven-day Guest session cookie when none is valid. Production may require turnstileToken. New creates are limited to 3 per client IP per 3600 seconds. - [Revoke the current Guest session](https://verbafy.io/docs/api/auth/revoke-current-guest-session.md): Clears the guest cookie and revokes the hashed token. DELETE /api/v1/auth/guest-sessions/current on the Verbafy REST API. - [Change the paid plan](https://verbafy.io/docs/api/billing/change-billing-plan.md): Changes Starter or Pro and interval for an existing subscription. POST /api/v1/billing/change-plan on the Verbafy REST API. - [Convert a paid-plan trial](https://verbafy.io/docs/api/billing/convert-billing-trial.md): Ends a paid-plan trial on the same plan so the period becomes billed. POST /api/v1/billing/convert-trial on the Verbafy REST API. - [Start a paid plan checkout](https://verbafy.io/docs/api/billing/create-billing-checkout.md): Starts Starter or Pro checkout for weekly or monthly. POST /api/v1/billing/checkout on the Verbafy REST API. See the Verbafy OpenAPI contract for request and - [Create a Stripe billing portal session](https://verbafy.io/docs/api/billing/create-billing-portal.md): Returns a URL for plan and payment management. POST /api/v1/billing/portal on the Verbafy REST API. See the Verbafy OpenAPI contract for request and response - [Get public price catalog](https://verbafy.io/docs/api/billing/get-billing-catalog.md): Public. No authentication. May be cached. GET /api/v1/billing/catalog on the Verbafy REST API. See the Verbafy OpenAPI contract for request and response fields. - [Get current plan and usage](https://verbafy.io/docs/api/billing/get-billing-me.md): Returns plan, usage window, and limits for the current account. GET /api/v1/billing/me on the Verbafy REST API. - [Get pricing context](https://verbafy.io/docs/api/billing/get-billing-pricing-context.md): Anonymous, Guest, or Registered. Always private, no-store. GET /api/v1/billing/pricing-context on the Verbafy REST API. - [Get transcript chat](https://verbafy.io/docs/api/chat/get-transcript-chat.md): Returns the chat session, readiness, and messages for one owned transcript. GET /api/v1/transcripts/{id}/chat on the Verbafy REST API. - [Rate a chat message](https://verbafy.io/docs/api/chat/rate-transcript-chat-message.md): Sets or clears an up/down rating on one assistant message. PUT /api/v1/transcripts/{id}/chat/messages/{messageId}/rating on the Verbafy REST API. - [Send a chat message](https://verbafy.io/docs/api/chat/send-transcript-chat-message.md): Adds a user message and returns the assistant reply with citations. POST /api/v1/transcripts/{id}/chat/messages on the Verbafy REST API. - [API reference](https://verbafy.io/docs/api.md): Generated REST operations from the published OpenAPI contract for transcripts, uploads, chat, billing, and MCP. - [Remote MCP Streamable HTTP DELETE](https://verbafy.io/docs/api/mcp/mcp-delete.md): Same Streamable HTTP endpoint as POST. API Key Bearer required. DELETE /api/v1/mcp on the Verbafy REST API. See the Verbafy OpenAPI contract for request and - [Remote MCP Streamable HTTP GET](https://verbafy.io/docs/api/mcp/mcp-get.md): Same Streamable HTTP endpoint as POST. API Key Bearer required. GET /api/v1/mcp on the Verbafy REST API. See the Verbafy OpenAPI contract for request and - [Remote MCP Streamable HTTP](https://verbafy.io/docs/api/mcp/mcp-post.md): Companion to this OpenAPI contract at https://verbafy.io/api/v1/mcp. Authenticate with Authorization: Bearer sk-…. JSON-RPC methods are MCP tools, not REST - [Get preferences](https://verbafy.io/docs/api/preferences/get-preferences.md): Translation language for the current account. GET /api/v1/me/preferences on the Verbafy REST API. See the Verbafy OpenAPI contract for request and response - [Update preferences](https://verbafy.io/docs/api/preferences/patch-preferences.md): Partial update. Clearing translation language keeps the original language. PATCH /api/v1/me/preferences on the Verbafy REST API. - [Create a transcript from a public URL](https://verbafy.io/docs/api/transcripts/create-transcript.md): Accepts a YouTube or Spotify episode URL. Returns 200 when the enhanced transcript is ready, or 202 while processing. - [Delete one transcript](https://verbafy.io/docs/api/transcripts/delete-transcript.md): Deletes the transcript. Related private media is removed with its last transcript. DELETE /api/v1/transcripts/{id} on the Verbafy REST API. - [Get YouTube caption preview](https://verbafy.io/docs/api/transcripts/get-transcript-captions.md): Returns a caption preview when one exists. Not a substitute for the enhanced transcript. GET /api/v1/transcripts/{id}/captions on the Verbafy REST API. - [Poll one transcript status](https://verbafy.io/docs/api/transcripts/get-transcript-status.md): Lightweight status for processing transcripts. GET /api/v1/transcripts/{id}/status on the Verbafy REST API. See the Verbafy OpenAPI contract for request and - [Get one transcript](https://verbafy.io/docs/api/transcripts/get-transcript.md): Returns the owned transcript detail, including work body when ready. GET /api/v1/transcripts/{id} on the Verbafy REST API. - [Batch-read transcript statuses](https://verbafy.io/docs/api/transcripts/list-transcript-statuses.md): ids is a comma-separated list of transcript UUIDs owned by the current account. GET /api/v1/transcripts/statuses on the Verbafy REST API. - [List transcripts for the current account](https://verbafy.io/docs/api/transcripts/list-transcripts.md): Paginated history. Empty channel filters are not query parameters here; the product filter is client-side. GET /api/v1/transcripts on the Verbafy REST API. - [Retry a failed transcript](https://verbafy.io/docs/api/transcripts/retry-transcript.md): Re-queues processing. Status may be 204, 202, or 200 depending on current state. POST /api/v1/transcripts/{id}/retry on the Verbafy REST API. - [Cancel a reservation](https://verbafy.io/docs/api/uploads/cancel-transcript-upload.md): Cancels an in-progress private upload reservation. DELETE /api/v1/transcript-uploads/{id} on the Verbafy REST API. - [Complete a multipart upload](https://verbafy.io/docs/api/uploads/complete-transcript-upload.md): Validates parts server-side and starts transcription. May return 200 or 202. POST /api/v1/transcript-uploads/{id}/complete on the Verbafy REST API. - [Reserve a private multipart upload](https://verbafy.io/docs/api/uploads/create-transcript-upload.md): Returns a reservation or an existing transcript when the content hash matches. Clients then sign parts and complete. Do not send storage credentials to - [Sign one multipart part](https://verbafy.io/docs/api/uploads/sign-transcript-upload-part.md): Returns a short-lived signed URL for one part number. POST /api/v1/transcript-uploads/{id}/parts on the Verbafy REST API. - [API docs](https://verbafy.io/docs.md): Authenticate and call the Verbafy REST API for transcripts, uploads, chat, billing, and the Remote MCP companion. - [Blog notes on YouTube, Spotify, and meeting transcripts](https://verbafy.io/blog/index.md): How-tos and notes on transcribing YouTube videos, Spotify episodes, and meeting recordings for search, chat, and export. - [How to evaluate transcription accuracy claims](https://verbafy.io/blog/how-to-evaluate-transcription-accuracy-claims.md): Use independently measured Benchmark Word Accuracy, not unverified 99%+ marketing figures, when you compare transcription products. - [How to transcribe a YouTube video](https://verbafy.io/blog/how-to-transcribe-a-youtube-video.md): Paste a public YouTube URL to get a speaker-labeled transcript with timestamps. Start with 60 transcribed minutes per week. - [What Verbafy does for YouTube, Spotify, and uploads](https://verbafy.io/blog/what-verbafy-does.md): Turn a YouTube video, Spotify episode, or private recording into a transcript you can search, question, verify against playback, and export. - [How to export a YouTube transcript as SRT or VTT](https://verbafy.io/blog/how-to-export-youtube-transcript-subtitles.md): Download speaker-labeled YouTube transcripts as SRT or VTT subtitle files, or as TXT, Markdown, JSON, and ZIP. - [How to transcribe a meeting recording](https://verbafy.io/blog/how-to-transcribe-a-meeting-recording.md): Export a Teams, Zoom, or Google Meet recording, then upload it for a timestamped transcript. Verbafy does not join live calls. - [How to transcribe a Spotify podcast](https://verbafy.io/blog/how-to-transcribe-a-spotify-podcast.md): Paste a canonical Spotify episode link to get a speaker-separated transcript with timestamps, chat, and exports. - [How to transcribe a YouTube video without captions](https://verbafy.io/blog/how-to-transcribe-a-youtube-video-without-captions.md): Generate a YouTube transcript from audio when captions are missing, disabled, or too noisy to use as a source. - [Meeting transcription software versus a meeting bot](https://verbafy.io/blog/meeting-transcription-versus-a-meeting-bot.md): Choose a live meeting bot when you need attendance. Choose Verbafy when you already have a recording to review. - [Why a Spotify episode transcript may fail to resolve](https://verbafy.io/blog/why-a-spotify-episode-transcript-may-fail.md): Verbafy matches a public Spotify episode link to a public RSS item. Missing or ambiguous RSS data can block transcription. - [Descript vs Verbafy for transcripts and video editing](https://verbafy.io/compare/descript.md): Compare Descript and Verbafy for editing recordings, reading transcripts, and exporting subtitles. Choose by the output you need to create. - [Notta vs Verbafy for meeting notes and transcripts](https://verbafy.io/compare/notta.md): Compare Notta and Verbafy for meeting capture, saved recordings, and transcript downloads. Check recording limits alongside monthly and weekly allowances. - [Otter vs Verbafy for meetings and recordings](https://verbafy.io/compare/otter.md): Compare Otter and Verbafy for live meeting notes, uploaded recordings, and transcript exports. Check free limits and choose the workflow you need. - [TurboScribe vs Verbafy for audio and video transcripts](https://verbafy.io/compare/turboscribe.md): Compare TurboScribe and Verbafy for file transcription, YouTube videos, exports, and free usage. Choose by recording volume and the work you need to finish.