API
Get the transcript of any video with one request, or let Claude fetch it for you mid-conversation. Included with Pro.
1. Create a key
Open your account, go to API keys, and create one. It starts with gb_ and is shown once. Revoke it any time.
2. Ask for a transcript
curl "https://api.getbrief.xyz/api/v1/transcript?url=https://youtu.be/VIDEO_ID" \
-H "Authorization: Bearer gb_YOUR_KEY"You get plain text: title, channel, link, then the transcript, ready to paste into any AI. Options:
timestamps=1adds[m:ss]at the start of each line when the platform gives timing.format=jsonreturns title, author, language, duration and the timed segments.
3. Connect it to Claude
getbrief speaks MCP, so Claude can call it as a tool. In Claude Code:
claude mcp add --transport http getbrief https://api.getbrief.xyz/api/mcp \
--header "Authorization: Bearer gb_YOUR_KEY"Then say “get the transcript of this video” and paste a link. The tool is called get_transcript.
Limits
- 30 requests a minute per key.
- 40 new videos a day. A video fetched before (by you or anyone) comes from our cache in the last 30 days: instant and not counted.
- Transcripts come from captions when they exist; otherwise the audio is transcribed.
- For your own use. Do not resell or republish transcripts of videos you do not have the rights to.