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

Guest: 6/5m, Signed-in: 15/2m, Premium: bypass

15+ Platforms

Native + yt-dlp + gallery-dl

Base URL

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

POST/api/v1/web/extract

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

⏱ Extract Rate Limits

• Guest: 6 requests / 5 minutes
• Logged-in non-premium: 15 requests / 2 minutes
• Premium: effectively bypasses the extract limiter

🍪 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/web/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,
    "accessMode": "authenticated",
    "publicContent": false,
    "cookieSource": "server",
    "requestId": "3f3fe71f-7f90-4f4f-b5c3-9bd88075e9e1"
  }
}

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 /api/v1/web/extract and all /api/v1/api/* routes. Pass it via Authorization: Bearer sk-dwa_xxx.

Media read routes on the web namespace (/stream, /download, /thumbnail) accept guest mode and optional API key.

🍪 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, client, or none
• Response meta.publicContent is false when cookie-backed/private data is used

DownAria