Download the video/audio at any URL (YouTube, TikTok, X, and 1000+ sites) to hosted storage and get back a direct download link. Importly runs yt-dlp, rotating residential proxies, and ffmpeg server-side — no local tooling needed. Async: returns a jobId immediately; poll check_import for the result. Optionally also produce a transcript in the same job with includeTranscript.

Check the status of an import_media job. Returns the media download URL (and transcript, if requested) once the job completes.

Extract full metadata for a video/audio URL (title, description, duration, uploader, formats, thumbnails, view counts) without downloading the media. Works on YouTube, TikTok, X, and 1000+ sites — no yt-dlp to run yourself. Async: poll check_metadata with the returned jobId. For just title/duration/thumbnail, prefer the faster get_basic_metadata.

Check the status of a get_metadata job. Returns the full metadata object once completed.

Fast-path metadata for a video/audio URL: title, duration, and thumbnail only. Cheaper and quicker than get_metadata — use this to identify or validate a media URL before importing or transcribing it. Async: poll check_basic_metadata with the returned jobId.

Check the status of a get_basic_metadata job. Returns title, duration, and thumbnail once completed.

Transcribe the audio of any video/audio URL (YouTube, TikTok, podcasts, and 1000+ sites) to text with timestamped segments. Importly handles the download, audio extraction, and speech-to-text server-side — no yt-dlp or ffmpeg needed. Async: returns a jobId immediately; poll check_transcription for the transcript. Costs scale with media length; set maxCostDollars to cap spend on long media.

Check the status of a transcribe_media job. Returns the transcript text and timestamped segments once completed.

Check the remaining Importly credit balance for the configured API key. Use this to diagnose failed jobs (insufficient credits) or as a pre-flight check before large imports/transcriptions.