From public URL to usable media.

Base URL https://developers.getinsaver.com/v1. JSON in, JSON out. One endpoint for every service.

Quickstart

1. Create an account and verify your email (20 free credits).
2. Create an API key in Dashboard → API keys. It is shown once; store it as GIS_KEY.
3. Send your first request:

Copycurl -X POST https://developers.getinsaver.com/v1/resolve \
  -H "Authorization: Bearer $GIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"instagram","url":"https://www.instagram.com/reel/SHORTCODE/","max_results":10}'

Copyconst response = await fetch("https://developers.getinsaver.com/v1/resolve", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.GIS_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"service":"instagram","url":"https://www.instagram.com/reel/SHORTCODE/","max_results":10})
});
const data = await response.json();
if (!response.ok) throw new Error(`${data.code}: ${data.message}`);
for (const item of data.items) console.log(item.type, item.url);

Copyimport os, requests

response = requests.post(
    "https://developers.getinsaver.com/v1/resolve",
    headers={"Authorization": f"Bearer {os.environ['GIS_KEY']}"},
    json={"service": "instagram", "url": "https://www.instagram.com/reel/SHORTCODE/", "max_results": 10},
    timeout=130,
)
data = response.json()
response.raise_for_status()
for item in data["items"]:
    print(item["type"], item["url"])

Copy<?php
$ch = curl_init("https://developers.getinsaver.com/v1/resolve");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_TIMEOUT => 130,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer " . getenv("GIS_KEY"),
    "Content-Type: application/json",
  ],
  CURLOPT_POSTFIELDS => json_encode([
    "service" => "instagram",
    "url" => "https://www.instagram.com/reel/SHORTCODE/",
    "max_results" => 10,
  ]),
]);
$data = json_decode(curl_exec($ch), true);
foreach ($data["items"] ?? [] as $item) echo $item["type"], " ", $item["url"], "\n";

Authentication

Send your key as a Bearer token on every request. Keys start with gis_live_. Revoke a leaked key in the dashboard; the others keep working.

Authorization: Bearer gis_live_••••••••••••••••

POST /v1/resolve

Response

{
  "ok": true,
  "service": "instagram",
  "source_url": "https://www.instagram.com/reel/SHORTCODE/",
  "item_count": 1,
  "items": [
    {
      "type": "video",
      "url": "https://cdn.example/media.mp4"
    }
  ],
  "metadata": {
    "title": null,
    "author": "creator",
    "caption": null
  },
  "request_id": "39a3bff5-0000-4000-8000-000000000000",
  "credits_used": 1
}

items[].type is video, image or audio. request_id matches the row in your usage log. credits_used is what this call cost.

Services

Credits

A request reserves max_results × credits per result, then settles to items returned × credits per result. If the request fails or returns nothing, the whole reservation is refunded. Your balance and every movement are visible in the dashboard.

Errors

Errors return JSON with error: true, a stable code and a readable message.

{
  "error": true,
  "code": "URL_INVALID",
  "message": "Enter a valid Instagram Posts & Reels URL."
}

Rate limits

120 requests per minute per account, shared by all of its API keys, with standard RateLimit headers. At most 2 requests can be in progress at once on the free trial and 8 once the account has bought credits; a request over that answers 429 CONCURRENCY_LIMIT with a Retry-After header and costs nothing. Requests can take up to two minutes for slow platforms, so set your client timeout to at least 130 seconds.

Media URLs

Returned URLs point at the platform's CDN or at a GetInSaver relay and are short-lived (minutes to a few hours). Download or proxy the file right after the call; do not store the URL for later.

Integration guides

• Python Instagram and TikTok Downloader API
• Node.js Social Media Downloader API
• PHP Instagram Downloader API
• n8n Instagram Downloader API
• Instaloader Alternative API
• Video Downloader API for Your Own Website