1. Store your key as a secret
Copy your key from the API key page and save it as a secret namedIMPORTLY_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.
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
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
result.text, and a failed one has a message:
supabase/functions/transcript-status/index.ts
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.- Lovable
- Bolt
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.