Media extraction API for developers
Find the playable video or audio behind any URL. Microlink resolves the direct file, its dimensions, duration and type, so you can embed, transcribe or process it without scraping player markup.
The following examples show how to use the Microlink API with CLI, cURL, JavaScript, Python, Ruby, PHP & Golang, targeting 'https://vimeo.com/571394002' URL with 'video' API parameter:
CLI Microlink API example
microlink https://vimeo.com/571394002&videocURL Microlink API example
curl -G "https://api.microlink.io" \
-d "url=https://vimeo.com/571394002" \
-d "video=true"JavaScript Microlink API example
import createClient from 'microlink.io'
const microlink = createClient()
const data = await microlink.video('https://vimeo.com/571394002')Python Microlink API example
import requests
url = "https://api.microlink.io/"
querystring = {
"url": "https://vimeo.com/571394002",
"video": "true"
}
response = requests.get(url, params=querystring)
print(response.json())Ruby Microlink API example
require 'uri'
require 'net/http'
base_url = "https://api.microlink.io/"
params = {
url: "https://vimeo.com/571394002",
video: "true"
}
uri = URI(base_url)
uri.query = URI.encode_www_form(params)
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
response = http.request(request)
puts response.bodyPHP Microlink API example
<?php
$baseUrl = "https://api.microlink.io/";
$params = [
"url" => "https://vimeo.com/571394002",
"video" => "true"
];
$query = http_build_query($params);
$url = $baseUrl . '?' . $query;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => $url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET"
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #: " . $err;
} else {
echo $response;
}Golang Microlink API example
package main
import (
"fmt"
"net/http"
"net/url"
"io"
)
func main() {
baseURL := "https://api.microlink.io"
u, err := url.Parse(baseURL)
if err != nil {
panic(err)
}
q := u.Query()
q.Set("url", "https://vimeo.com/571394002")
q.Set("video", "true")
u.RawQuery = q.Encode()
req, err := http.NewRequest("GET", u.String(), nil)
if err != nil {
panic(err)
}
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(string(body))
}import createClient from 'microlink.io'
const microlink = createClient()
const data = await microlink.video('https://vimeo.com/571394002')Send the URL Get the media file back
The file, not the player.
Every platform hides its media behind a different player, a different embed shape and a different set of scripts. Microlink resolves video and audio alike into one predictable response you can render, transcribe or process.
Start free, scale when ready
Free
Pro
- Everything in Free
- Automatic proxy resolution
- Configurable TTL
- Custom HTTP headers
- Custom cache key
- Priority email support
Business & Enterprise
- Everything in Pro, plus:
- Card or invoice, PO number, net 30
- NDA, DPA & service agreement
- Vendor assessments on request
- Same named contact
- Annual billing, 10% discount
Built on open source,
trusted by developers
The Microlink media pipeline is powered by battle-tested open source libraries used by thousands of developers worldwide. Our media extraction API is built on an open source foundation: explore the code, contribute, or run it yourself.
Every player is different. The file never is.
No player markup to reverse-engineer and no provider-specific integrations to maintain. Send a URL and get a playable file back via the video and audio APIs.
Direct File URLs
The response carries a playable media URL rather than an iframe or a widget, so you can render it, stream it or queue it for processing.
Dimensions And Duration
Width, height, duration and media type arrive with the URL, so players can be laid out without a probe request or a layout shift.
Transcription Ready
You receive the media rather than the page hosting it, so audio drops straight into a speech-to-text pipeline with no scraping step.
Real Browser Detection
Players that only mount after JavaScript runs are still found, because detection happens after the page has fully settled.
Metadata In The Same Call
Request title, description, artwork and poster image alongside the media and pay for a single render instead of several.
Residential Proxy Resolution
Route hard targets through residential IPs to get past Cloudflare, DataDome and Akamai without maintaining a proxy pool yourself.
Edge Cached Responses
Configurable TTL from 1 minute to 31 days. Cache hits are free, return instantly, and never boot a browser.
Enterprise-Grade Reliability
Production-ready infrastructure with a 99.9% uptime SLA and guaranteed performance for business-critical media workflows.
Generous Free Tier
Start with a free API key: 25 requests per day with every Pro feature, no credit card, and pay-as-you-grow pricing that scales with your usage.
Direct File URLs
The response carries a playable media URL rather than an iframe or a widget, so you can render it, stream it or queue it for processing.Dimensions And Duration
Width, height, duration and media type arrive with the URL, so players can be laid out without a probe request or a layout shift.Transcription Ready
You receive the media rather than the page hosting it, so audio drops straight into a speech-to-text pipeline with no scraping step.
Real Browser Detection
Players that only mount after JavaScript runs are still found, because detection happens after the page has fully settled.Metadata In The Same Call
Request title, description, artwork and poster image alongside the media and pay for a single render instead of several.Residential Proxy Resolution
Route hard targets through residential IPs to get past Cloudflare, DataDome and Akamai without maintaining a proxy pool yourself.
Edge Cached Responses
Configurable TTL from 1 minute to 31 days. Cache hits are free, return instantly, and never boot a browser.Enterprise-Grade Reliability
Production-ready infrastructure with a 99.9% uptime SLA and guaranteed performance for business-critical media workflows.Generous Free Tier
Start with a free API key: 25 requests per day with every Pro feature, no credit card, and pay-as-you-grow pricing that scales with your usage.
Product Information
Everything you need to know about the Microlink media extraction API.