Skip to content

Social Download API

Pricing

5 credits per request

Fixed cost per download, regardless of video length or file size.

Overview

The Social Download API allows you to download media content from various social media platforms and online sources. This endpoint supports platforms like YouTube, TikTok, Instagram, Facebook, and many others using advanced download technologies.

Endpoint

  • URL: POST https://revidapi.com/v1/{social}/download
  • Method: POST (GET with the same query string also works)

Supported routes

Route Platform Credit
/v1/download Detects the platform from the link 5
/v1/tiktok/download TikTok 5
/v1/douyin/download Douyin 5
/v1/instagram/download Instagram 5
/v1/facebook/download Facebook 5
/v1/tiktokshop/download TikTok Shop videos — see TikTok Shop Download 5
/v1/douyin/user/download Every video of a Douyin channel 35

There is no /v1/youtube/download route. For YouTube use /v1/youtube/video (post details with download links) from the Social media data API.

Facebook downloads are checked before you are charged: the file is fetched and verified to have picture and sound; if not, the call fails and nothing is deducted.

Request

Headers

  • x-api-key: Required. API key for authentication.

Query parameters

Parameter Type Required Description
url string (URI) ✅ URL of media content to download
format string ❌ Format: best, worst, mp4, webm, or specific ID
quality string ❌ Quality: 720p, 1080p, best, worst
extract_audio boolean ❌ Extract audio only. Default: false
audio_format string ❌ Audio format: mp3, m4a, wav. Default: mp3
id string ❌ Custom identifier

Example Request

POST https://revidapi.com/v1/tiktok/download?url=https://www.tiktok.com/@user/video/1234567890
POST https://revidapi.com/v1/douyin/download?url=https://www.douyin.com/video/7552522449193356595
curl -X POST "https://revidapi.com/v1/douyin/download?url=https://www.douyin.com/video/7552522449193356595" \
  -H "x-api-key: YOUR_API_KEY"

Success Response (via Webhook or Direct)

{
  "code": 200,
  "id": "download-request-123",
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "response": {
    "url": "https://www.tiktok.com/@user/video/1234567890",
    "title": "Video Title",
    "duration": 180,
    "thumbnail": "https://example.com/thumb.jpg",
    "uploader": "Channel Name",
    "video_url": "https://edit.revidapi.com/download-direct?url=...&expires=...",
    "download_direct": "https://edit.revidapi.com/download-direct?url=...&expires=...",
    "format": "mp4",
    "filesize": 12345678,
    "source": "revidapi.com",
    "cached": false
  },
  "message": "success"
}

Response fields:

Field Type Description
url string Original URL sent
title string Video title
duration int | null Duration (seconds)
thumbnail string | null Thumbnail URL
uploader string | null Channel/uploader name
video_url string View/download URL (download-direct link, ~15 min validity)
download_direct string | null Direct file download URL
format string Format: mp4, webm, ...
filesize int | null File size (bytes)
source string revidapi.com
cached boolean true if from cache

Error Responses

Invalid Request (400)

{
  "code": 400,
  "id": "download-request-123",
  "message": "Invalid request: 'url' is a required property"
}

Unsupported Platform (400)

{
  "code": 400,
  "id": "download-request-123",
  "message": "Unsupported platform or invalid URL"
}

Authentication Error (401)

{
  "code": 401,
  "message": "Invalid API key"
}

Usage Notes

  1. Fixed pricing: 5 credits per download request.
  2. Video link: Use video_url or download_direct to view/download (~15 min validity). Call API again to get new link when expired.
  3. Facebook/Instagram: Use specific video URL (e.g. .../videos/123456789/ or post link with video).
  4. Audio extraction: Set extract_audio: true to get audio track only.

Common Issues

  1. 502: Video private/age-restricted, invalid URL, platform blocking. Check detail in response.
  2. Private content: Cannot be downloaded.
  3. Link expired: download_direct expires after ~15 min — call API again for new link.

Best Practices

  1. Use Webhooks: Always use webhooks for better reliability, especially for large files
  2. Unique ID: Provide unique id value for tracking
  3. Quality selection: Choose appropriate quality to balance file size and download speed
  4. Error handling: Implement proper error handling for unsupported URLs or failed downloads
  5. Legal compliance: Ensure you have rights to download and use the content

API Endpoints

Endpoint Description Method
/douyin/download Download Douyin media POST
/meta/download Download Facebook/Instagram media POST
/threads/download Download Threads media POST
/tiktok/download Download TikTok media POST
/twitter/download Download Twitter media POST