DownAria - Free Social Media Video Downloader

Overview API Guides FAQ ChangeLog Cookie Converter

API Reference

Unified API for extracting media from 15+ platforms.

Single Endpoint

One endpoint, auto-detect platform

Rate Limited

15/min public, 100/min with key

15+ Platforms

Native + yt-dlp + gallery-dl

Base URL

https://re-fetchtium.up.railway.app

POST/api/v1/extract

Extract media information from any supported URL. Platform is auto-detected.

🍪 Cookie Support

For private content, pass cookies in the cookie field using format: name=value; name2=value2

Request

request.json

curl -X POST https://re-fetchtium.up.railway.app/api/v1/extract \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-dwa_your_api_key" \
  -d '{"url": "https://instagram.com/p/ABC123/"}'

Parameters

Field	Type	Required	Description
`url`	string	Yes	Media URL to extract
`cookie`	string	No	Cookie string for private content Format: `sessionid=abc; csrftoken=xyz`

Response

response.json

{
  "success": true,
  "data": {
    "platform": "instagram",
    "contentType": "video",
    "title": "Video Title Here",
    "author": "Display Name",
    "authorUsername": "username",
    "description": "Post caption text...",
    "stats": {
      "views": 37344,
      "likes": 11234,
      "comments": 256
    },
    "items": [
      {
        "index": 0,
        "type": "video",
        "thumbnail": "https://...",
        "sources": [
          {
            "quality": "720p",
            "url": "https://...",
            "resolution": "1280x720",
            "mime": "video/mp4",
            "size": 10485760,
            "filename": "username_video_title_720p.mp4"
          }
        ]
      }
    ]
  },
  "meta": {
    "responseTime": 1458,
    "cookieSource": "server",
    "cookieRole": "private"
  }
}

Other Endpoints

Error Codes

Code	HTTP	Description
`INVALID_URL`	400	Invalid URL format
`UNSUPPORTED_PLATFORM`	400	Platform not supported
`PRIVATE_CONTENT`	403	Content is private, needs cookie
`LOGIN_REQUIRED`	403	Login required to access
`AGE_RESTRICTED`	403	Age-restricted content
`GEO_RESTRICTED`	403	Geo-blocked content
`DELETED_CONTENT`	404	Content has been deleted
`NO_MEDIA_FOUND`	404	No downloadable media found
`STORY_EXPIRED`	404	Story has expired
`RATE_LIMITED`	429	Too many requests
`EXTRACTION_FAILED`	500	Server error during extraction
`TIMEOUT`	504	Request timeout

🔑 Authentication

API key is required for REST API access. Pass via Authorization: Bearer sk-dwa_xxx header.

Get your API key from the Profile page or contact admin.

🍪 Cookie Behavior

• Server cookies are used automatically for API key users (private pool)
• Custom cookie can be passed in request body for private content
• Response meta.cookieSource shows: server, user, or none
• Response meta.cookieRole shows: public or private