Video Analytics

Get video download link

Fetches an MP4 download link for a specific TikTok, Instagram, Facebook, YouTube, or Snapchat video. A file viral.app already stores is linked from its own storage, free of charge; otherwise the link is a temporary one from the platform. A TikTok photo post downloads as a ZIP of its images and sound, free when viral.app already stores it. Requires an Ultra-or-higher plan.

⚠️ Consumes extra credits: 3 credits per download, 1 credit when no file is available; stored and cached files are free.

get/videos/{platform}/{platformVideoId}/download

Request

  • Base URL: https://viral.app/api/v1
  • URL: https://viral.app/api/v1/videos/{platform}/{platformVideoId}/download
  • Auth: API key in header x-api-key

Path parameters

platform'facebook' | 'instagram' | 'tiktok' | 'youtube' | 'snapchat' required

Social media platform (facebook, instagram, tiktok, youtube, snapchat)

Example:facebook
platformVideoIdstring required

Native platform video id found in the URL of the video

Example:7123456789012345678

Response

OK

downloadUrlstring

URL

consumedExtraCreditboolean required

Example response

{
  "downloadUrl": "https://www.myproject.com"
}

Changes

No recorded changes to this operation across all 1 revision of this API.