Upscrolled Downloader (No Watermark)

A lightweight utility designed to fetch and download high-quality media from Upscrolled content without watermarks. This tool parses the Upscrolled API response to extract direct image or video links,and ensure you get the cleanest version of the content.

🚀 Features

• No Watermark: Automatically selects the raw images array or videoUrl instead of watermarked versions.
• Batch Downloading: Handles multiple images from a single post (carousel support).
• Metadata Preservation: Extracts captions, creator info, and engagement metrics (likes/comments).

🧩 Input Parameters

Field	Type	Required	Description
query	String	required	id or share url

📊 Data Mapping

The downloader interacts with the following key fields from the Upscrolled API:

Field	Description
images	Array of high-res direct image links (Watermark-free).
videoUrl	Direct link to the raw video file.
caption	The text content and hashtags associated with the post.
creator.userName	Used for organized file naming (e.g., Middle_earth_photo_1.jpg).

📝 API Response Structure

The tool is optimized for the following JSON schema:

{
   "id":"08c01106-e196-4415-8dfb-af766d73ed69",
   "caption":"“Which skill was your favorite? 👀✨\n  #skills #football \n",
   "type":"VIDEO",
   "topic":"Sports",
   "mentionedUsers":[
      {
         "name":"Francesca",
         "userName":"Francesca",
         "userId":"cb99485f-3180-457a-8555-2189c8997af4",
         "profileImg":"https://d2sscsmkqn4j9v.cloudfront.net/cb99485f-3180-457a-8555-2189c8997af4/ProfileImage_b81212c5-a39a-4964-b9f3-1e6be5e95b35.jpg",
         "isPrivate":false,
         "isVerified":false,
         "isActive":true
      }
   ],
   "taggedUsers":[
      {
         "name":"Jacqueline Owens",
         "userName":"ohhjacqui",
         "userId":"80cbdbd7-bcd2-4df6-a943-38f628cf62f3",
         "profileImg":"https://d2sscsmkqn4j9v.cloudfront.net/80cbdbd7-bcd2-4df6-a943-38f628cf62f3/ProfileImage_e0c60462-7881-49ba-b1c9-b60fc5a6f4fc.jpg",
         "isPrivate":false,
         "isVerified":true,
         "isActive":true
      }
   ],
   "images":[
      "https://image.mux.com/jT027yEvSyFaZs2yiLAU02ZeK52z0102Q00FYXMC6DswlPdA/thumbnail.jpg"
   ],
   "thumbnail":"https://image.mux.com/jT027yEvSyFaZs2yiLAU02ZeK52z0102Q00FYXMC6DswlPdA/thumbnail.jpg",
   "videoUrl":"https://stream.mux.com/jT027yEvSyFaZs2yiLAU02ZeK52z0102Q00FYXMC6DswlPdA.m3u8",
   "watermarkVideoUrl":"https://stream.mux.com/jEATDdWxaXBeZLY02YSciX15TcttofWJ7TOT00XRBKmpo/highest.mp4",
   "likes":48,
   "comments":5,
   "repost":11,
   "restory":4,
   "sensitiveContent":false,
   "externalLinks":[
      {
         "Title":"Tiktok",
         "Url":"tiktok.com/"
      },
      {
         "Title":"Insta",
         "Url":"https://www.instagram.com/"
      },
      {
         "Title":"YouTube",
         "Url":"https://youtube.com/"
      }
   ],
   "creator":{
      "name":"Premier League",
      "userName":"Premier_League",
      "userId":"72632d15-97cf-49da-90a1-dc195eb3b2b4",
      "profileImg":"https://d2sscsmkqn4j9v.cloudfront.net/72632d15-97cf-49da-90a1-dc195eb3b2b4/ProfileImage_6d9a638f-ef9d-4991-a3a7-6af642d9d243.jpg",
      "isPrivate":false,
      "isVerified":false,
      "isActive":true
   },
   "aiGenerated":false
}