extract-media-source

Extract playable media sources

Resolve a page URL to a direct, playable media file URL.

Pick the tool

Media	Tool	Result	Platforms
Video	microlink_video	microlink.data.video.url	YouTube, Vimeo, Twitter/X, TikTok, Instagram, Dailymotion, +hundreds
Audio	microlink_audio	microlink.data.audio.url	SoundCloud, Spotify, Mixcloud, + others

Basic call — just pass the page URL:

{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }

Read the result

Video (microlink.data.video): url, type, duration, duration_pretty, size, size_pretty, width, height.

Audio (microlink.data.audio): url, type, duration, duration_pretty, size, size_pretty.

Confirm microlink.status === "success" and that data.video / data.audio is present before using the source URL. If it's absent, the page has no detectable playable media at that URL.

Options

• meta: set false to skip page-metadata extraction and return only the media (faster, smaller). Or pass a meta object to include specific fields.
• proxy (PRO): route through a proxy for platforms that geo-block or rate-limit — e.g. { "url": "...", "proxy": "http://user:pass@host:port" }.
• force: true: bypass the cache and re-resolve the source.

Tips & gotchas

• The returned URL is a direct media link; it may be time-limited or signed by the source platform, so use it promptly rather than storing it long-term.
• Some platforms restrict access — if extraction fails on a public page, retry with a proxy (PRO plan).
• Only public URLs are supported; private/age-gated/login-walled media may not resolve.
• Respect the source platform's terms of service and copyright when reusing media.
• Free endpoint caps at 50 requests/day; set MICROLINK_API_KEY for more.