Skip to main content
App builders like Lovable, Bolt and Replit write the code for you, but a video download or transcript that works in the preview often fails once the app runs on a server, and many videos have no captions. Your app can call Importly’s REST API instead. You don’t need the MCP server for this: the same API key works from your app’s backend.

1. Store your key as a secret

Copy your key from the API key page and save it as a secret named IMPORTLY_API_KEY:
  • If your app uses Supabase (Lovable and Bolt apps often do), add it as an Edge Function secret.
  • On Replit, add it in the Secrets tool.
Never paste the key into frontend code or a prompt that ends up in the browser. Anyone who can read it can spend your credit.

2. Ask for the feature

Paste a prompt like this into the builder, and change the first line to what your app should do:

Transcripts for video links

For downloads, use POST /import and save mediaUrl; for title, duration and thumbnail, use POST /metadata/basic. See Downloads, Transcripts and Metadata.

3. Check what it wrote

A working integration looks like this Supabase Edge Function. It starts a transcript job and returns the job ID:
supabase/functions/start-transcript/index.ts
A second function, or the same one, reads the result. A completed job has the text under result.text, and a failed one has a message:
supabase/functions/transcript-status/index.ts
The frontend calls the first function, then calls the second every few seconds until status is completed or failed. If your app has a public backend URL, you can pass a webhookUrl instead of polling. See Webhooks.
A caption transcript costs $0.003. A video without captions fails with `TRANSCRIPTION_PROVIDER_REQUIRED` and nothing is charged; send it again with `"provider": "importly"` for AI speech-to-text at $0.01 per minute. New accounts get $3.00 in free credits, no card required. See Pricing & credits.

Give the build chat Importly’s tools

Lovable and Bolt can also connect Importly’s MCP server to their chat. The builder can then fetch a transcript or a video’s details while you work, and read Importly’s integration guide before it writes the code. This only affects the chat: your published app still calls the REST API with the secret from step 1.
Open Connectors, select Add custom, and choose MCP server. Name it Importly, enter https://mcp.importly.io/mcp, leave authentication on OAuth, and click Add & authorize to sign in to Importly. If sign-in doesn’t complete, add it again with the Bearer token option and paste your API key.

Using Claude Code or Cursor instead?

Connect the MCP server and your agent can write the integration for you. See Build with your agent.