API Documentation

Simple and powerful endpoints for extracting social media media.

Note: We do not use any third-party external API services. All data is fetched directly from the original social media platforms (Facebook, Instagram, etc.) to ensure privacy and reliability.
← Back to Tools
GET POST

Facebook Downloader

/api/facebook?url={video_url}

Parameters (GET Query / POST JSON)

Name Type Required Description
cookies string No Netscape format cookies (POST only) for private content.
url string Yes The Facebook public video/reel URL.

POST Payload Example

{
  "url": "https://www.facebook.com/watch?v=...",
  "cookies": "Netscape cookies string..."
}

Success Response

{
  "data": {
    "id": "1186079316476175",
    "links": {
      "hd": "https://video.url...",
      "sd": "https://video.url..."
    },
    "thumbnail": "https://image.url...",
    "title": "Facebook Video"
  },
  "success": true,
  "source": "facebook"
}
GET POST

Instagram Downloader

/api/instagram?url={post_url}

Parameters (GET Query / POST JSON)

Name Type Required Description
cookies string No Netscape format cookies or sessionid (POST only).
url string Yes The Instagram Post/Reel URL.

POST Payload Example

{
  "url": "https://www.instagram.com/p/...",
  "cookies": "Netscape cookies string..."
}

Video Response

{
  "data": {
    "thumbnail_src": "https://image.url...",
    "video_url": "https://video.url..."
  },
  "success": true,
  "source": "instagram-api"
}

Carousel/Image Response

{
  "data": {
    "thumbnail_src": [
      "https://image1.url...",
      "https://image2.url...",
      ...
    ]
  },
  "success": true,
  "source": "instagram-api"
}
GET POST

Twitter Downloader

/api/twitter?url={tweet_url}

Parameters (GET Query / POST JSON)

Name Type Required Description
cookies string No Netscape format cookies (POST only).
url string Yes The Twitter/X post URL.

POST Payload Example

{
  "url": "https://twitter.com/user/status/...",
  "cookies": "Netscape cookies string..."
}

Success Response

{
  "success": true,
  "tweet_id": "2004932784297476285",
  "text": "Tweet caption text...",
  "author": {
    "name": "Twitter User",
    "username": "handle",
    "verified": true
  },
  "media": {
    "best_quality": "https://video.url...",
    "thumbnail": "https://image.url...",
    "variants": [
      { "quality": "720p", "url": "..." },
      ...
    ]
  },
  "stats": {
    "likes": 15452,
    "views": 4106020
  }
}
GET POST

Pinterest Downloader

/api/pinterest?url={pin_url}

Parameters (GET Query / POST JSON)

Name Type Required Description
cookies string No Netscape format cookies (POST only).
url string Yes The Pinterest Pin or pin.it short URL.

POST Payload Example

{
  "url": "https://pin.it/...",
  "cookies": "Netscape cookies string..."
}

Success Response

{
  "status": "success",
  "platform": "pinterest",
  "pin": {
    "title": "Pin Title",
    "description": "Pin description...",
    "seoViewCount": 1273
  },
  "video": {
    "thumbnail": "https://image.url...",
    "sources": {
      "mp4": { "quality": "720", "url": "..." },
      "hls": { "url": "..." }
    }
  },
  "author": {
    "displayName": "User Name",
    "username": "user",
    "profileImage": "https://image.url..."
  }
}
GET POST

Facebook Stories & Highlights

/api/facebook/stories?url={url}

Parameters

Name Type Required Description
url string Yes Profile URL (for Stories) or Highlight URL.
cookies string No Netscape format cookies (POST only) for private content.

POST Payload Example

{
  "url": "https://www.facebook.com/stories/...",
  "cookies": "Netscape cookies string..."
}
GET POST

Instagram Stories & Highlights

/api/instagram/stories?url={url}

Parameters

Name Type Required Description
url string Yes Profile URL (for Live Stories) or Highlight URL.
cookies string No Netscape format cookies (POST only) for private content.

POST Payload Example

{
  "url": "https://www.instagram.com/stories/...",
  "cookies": "Netscape cookies string..."
}

Success Response

{
  "success": true,
  "platform": "instagram_story",
  "data": [
    {
      "bucket_id": "Live Stories: user",
      "media_count": 5,
      "videos": [ ... ],
      "images": [ ... ]
    }
  ]
}
GET POST

Snapchat Downloader

/api/snapchat?url={snap_url}

Parameters (GET Query / POST JSON)

Name Type Required Description
url string Yes The Snapchat Spotlight or Story URL.

POST Payload Example

{
  "url": "https://www.snapchat.com/s/..."
}

Success Response

{
  "data": {
    "id": "videoId",
    "video_url": "https://video.url...",
    "thumbnail": "https://image.url..."
  },
  "success": true,
  "source": "snapchat"
}
GET POST

Threads Downloader

/api/threads?url={threads_url}

Parameters (GET Query / POST JSON)

Name Type Required Description
url string Yes The Threads Post URL.

POST Payload Example

{
  "url": "https://www.threads.net/@user/post/..."
}

Success Response

{
  "data": {
    "id": "postId",
    "caption": "Post caption...",
    "media": [
      {
        "type": "image",
        "url": "https://image.url...",
        "width": 1080,
        "height": 1920
      },
      ...
    ],
    "author": {
      "name": "Threads User",
      "username": "user",
      "profile_pic": "https://profile.url..."
    }
  },
  "success": true,
  "source": "threads"
}
GET POST

TikTok Downloader

/api/tiktok?url={tiktok_url}

Parameters (GET Query / POST JSON)

Name Type Required Description
url string Yes The TikTok Video URL.

POST Payload Example

{
  "url": "https://www.tiktok.com/@user/video/..."
}

Success Response

{
  "video_data": {
      "status": "success",
      "title": "Video Caption",
      "cover_data": {
          "cover": "https://p16.../img.jpg",
          "origin_cover": "https://p16.../img.jpg",
          "dynamic_cover": "https://p16.../img.webp"
      },
      "author": {
          "nickname": "User Name",
          "user_id": "12345",
          "avatar": "https://p16.../avatar.jpg"
      }
  },
  "media_files": {
      "main_links": {
          "watermarked": "/proxy/tiktok?sid=...&url=...",
          "no_watermark": "/proxy/tiktok?sid=...&url=..."
      }
  },
  "music": {
      "title": "Song Title",
      "author": "Artist",
      "audio_url": "/proxy/tiktok?sid=...&url=..."
  }
}
GET POST

Reddit Downloader

/api/reddit?url={post_url}

Parameters (GET Query / POST JSON)

Name Type Required Description
url string Yes The Reddit Post URL (video, image, or gallery).

POST Payload Example

{
  "url": "https://www.reddit.com/r/subreddit/comments/..."
}

Success Response

{
  "source": "reddit",
  "success": true,
  "data": {
    "type": "video",
    "title": "Post Title",
    "video_url": "https://v.redd.it/...",
    "thumbnail_url": "https://preview.redd.it/...",
    "images": []
  }
}
GET

Media Proxy

/proxy/image?url={media_url}
/proxy/video?url={media_url}

Parameters

Name Type Required Description
url string Yes The external URL of the image or video to proxy.

Usage

Use this endpoint to bypass CORS restrictions or download protected content (like Reddit/Twitter media) by routing it through the server.

GET POST

TeraBox Downloader

/api/terabox/info?url={terabox_url}

Parameters (GET Query / POST JSON)

Name Type Required Description
url string Yes The TeraBox File URL.

POST Payload Example

{
  "url": "https://terabox.com/s/..."
}

Success Response

{
  "data": {
    "title": "File Name.mp4",
    "size": "50.5 MB",
    "thumbnails": {
      "static": "https://thumb.url...",
      "icon": "https://thumb.url..."
    },
    "urls": {
      "download": "https://d.terabox.com/...",
      "stream": "https://d.terabox.com/..."
    },
    "original_url": "https://terabox.com/s/..."
  },
  "success": true,
  "source": "terabox-api",
  "response_time": "0.45s"
}