yt-dlp API Alternative

# pip install requests
import mimetypes, os, time
import requests

API_URL = "https://developers.getinsaver.com/v1/resolve"
API_KEY = os.environ["GIS_KEY"]  # keep the key on your server, never in a browser


def resolve(service, url, max_results=10, retries=3):
    """Turn a public link into media items: [{"type": "video", "url": ...}]."""
    for attempt in range(retries + 1):
        response = requests.post(
            API_URL,
            headers={"Authorization": f"Bearer {API_KEY}"},
            json={"service": service, "url": url, "max_results": max_results},
            timeout=130,
        )
        data = response.json()
        if response.ok:
            return data
        # 429 = rate or concurrency limit, 502/504 = platform hiccup; none of them is charged
        if response.status_code in (429, 502, 504) and attempt < retries:
            time.sleep(int(response.headers.get("Retry-After", 5)))
            continue
        raise RuntimeError(f"{data['code']}: {data['message']}")


def download(item, name, folder="downloads"):
    """Media URLs expire within minutes to hours, so save the file right away."""
    os.makedirs(folder, exist_ok=True)
    with requests.get(item["url"], stream=True, timeout=120) as media:
        media.raise_for_status()
        kind = media.headers.get("Content-Type", "").split(";")[0]
        path = os.path.join(folder, name + (mimetypes.guess_extension(kind) or ".bin"))
        with open(path, "wb") as f:
            for chunk in media.iter_content(chunk_size=65536):
                f.write(chunk)
    return path


if __name__ == "__main__":
    # TikTok works the same way: resolve("tiktok", "https://www.tiktok.com/@user/video/123...")
    result = resolve("instagram", "https://www.instagram.com/reel/SHORTCODE/")
    print(f"{result['item_count']} items, {result['credits_used']} credits")
    for i, item in enumerate(result["items"]):
        print(item["type"], download(item, f"{result['request_id']}-{i}"))