---

📸 Instagram Thumbnail & Media Scraper

A powerful and reliable actor to fetch thumbnails and media information from public Instagram videos and Reels. This actor allows you to select thumbnail quality and quickly gather all essential metadata in a structured format. Perfect for social media analysis, content aggregation, and media management.

---

🌟 Overview

The Instagram Thumbnail & Media Scraper actor provides a simple way to collect publicly available video or Reels thumbnails from Instagram URLs. With flexible quality options and structured output, you can automate thumbnail collection and store them efficiently for further use.

Key Highlights:

• Supports single or multiple Instagram video/reel URLs
• Selectable thumbnail quality (from small to 4K)
• Returns structured metadata along with thumbnail download links
• Handles fallback mechanisms for reliable downloads
• Ideal for content creators, marketers, and analysts

Quality selection thumbnail size :

• default,
• small,
• medium,
• large,
• XL,
• max,
• Full HD,
• 2K,
• 4K

---

🛠 Features

Feature	Description
Multiple URL support	Process one or more public Instagram video or Reel URLs at once
Quality selection	Choose thumbnail size from default, small, medium, large, XL, max, Full HD, 2K, or 4K
Metadata extraction	Collects video duration, upload date, original URL, and more
Reliable downloads	Optimized to ensure thumbnail download even under connection restrictions
Structured output	Clean JSON format with all relevant information for easy integration

---

📦 Input

The actor accepts a structured JSON object containing:

Properties

Field	Type	Required	Description
startUrls	Array	✅	List of public Instagram video or Reel URLs to fetch thumbnails from
thumbnailQuality	String	❌	Desired quality for thumbnails (default: default). Options: default, small, medium, large, xl, max, full_hd, 2k, 4k

Example Input:

{
    "startUrls": [
        {
            "url": "https://www.instagram.com/p/DPZNtRuDHy9/"
        },
        {
            "url": "https://www.instagram.com/reels/DQIuHgqiEFd/"
        },
        {
            "url": "https://www.instagram.com/reel/DI4WihvBwKC/?utm_source=ig_web_copy_link"
        },
        {
            "url": "https://www.instagram.com/reel/DTCyEJqEYQo/?utm_source=ig_web_copy_link&igsh=NTc4MTIwNjQ2YQ%3D%3D"
        }
    ],

    
    "thumbnailQuality": "full_hd"
}

---

Example Output:

[
  {
    "original_url": "https://www.instagram.com/p/DPZNtRuDHy9/",
    "upload_date": "20251004",
    "duration": 35.2,
    "thumbnail_url": "https://api.apify.com/v2/key-value-stores/EGyIp5ncN5UmFpvYw/records/DPZNtRuDHy9_thumbnail.jpg?signature=1fyQEu8BjL2noipf9uHRK",
    "thumbnail_data": {
      "width": 1080,
      "height": 1920,
      "quality_selected": "full_hd",
      "file_size_bytes": 165917,
      "content_type": "image/jpeg"
    }
  },
  {
    "original_url": "https://www.instagram.com/reels/DQIuHgqiEFd/",
    "upload_date": "20251023",
    "duration": 15.999,
    "thumbnail_url": "https://api.apify.com/v2/key-value-stores/EGyIp5ncN5UmFpvYw/records/DQIuHgqiEFd_thumbnail.jpg?signature=1lHidRETTkexrrcsnkM0z",
    "thumbnail_data": {
      "width": 1080,
      "height": 1917,
      "quality_selected": "full_hd",
      "file_size_bytes": 28038,
      "content_type": "image/jpeg"
    }
  },
  {
    "original_url": "https://www.instagram.com/reel/DI4WihvBwKC/?utm_source=ig_web_copy_link",
    "upload_date": "20250425",
    "duration": 20.166,
    "thumbnail_url": "https://api.apify.com/v2/key-value-stores/EGyIp5ncN5UmFpvYw/records/DI4WihvBwKC_thumbnail.jpg?signature=19vecondNEDlwSfT67ycF",
    "thumbnail_data": {
      "width": 1080,
      "height": 1350,
      "quality_selected": "full_hd",
      "file_size_bytes": 101535,
      "content_type": "image/jpeg"
    }
  },
  {
    "original_url": "https://www.instagram.com/reel/DTCyEJqEYQo/?utm_source=ig_web_copy_link&igsh=NTc4MTIwNjQ2YQ%3D%3D",
    "upload_date": "20260103",
    "duration": 27.468,
    "thumbnail_url": "https://api.apify.com/v2/key-value-stores/EGyIp5ncN5UmFpvYw/records/DTCyEJqEYQo_thumbnail.jpg?signature=3uEppz46BoARRWn94v9O",
    "thumbnail_data": {
      "width": 1080,
      "height": 1917,
      "quality_selected": "full_hd",
      "file_size_bytes": 25556,
      "content_type": "image/jpeg"
    }
  }
]

📊 Output

Each processed URL produces a structured JSON object with the following fields:

Field	Description
original_url	The original Instagram video or Reel URL
upload_date	Date the media was uploaded (YYYYMMDD)
duration	Duration of the video in seconds
thumbnail_url	Public URL of the downloaded thumbnail
thumbnail_data	Object containing details about the thumbnail:
└ width	Width of the selected thumbnail in pixels
└ height	Height of the selected thumbnail in pixels
└ quality_selected	The thumbnail quality chosen for extraction
└ file_size_bytes	Size of the downloaded thumbnail in bytes
└ content_type	MIME type of the thumbnail image

---

🎯 Benefits & Advantages

1. Time-saving automation – Download multiple Instagram thumbnails at once.
2. Quality flexibility – Choose the exact thumbnail resolution you need.
3. Structured data output – Perfect for further processing, reporting, or display in dashboards.
4. Reliability – Ensures thumbnail download even if direct access fails.
5. Scalable – Works with both single URLs and bulk URL lists.

---

📝 Best Practices

• Always ensure the URLs provided are publicly accessible; private accounts will not be processed.
• Select the thumbnail quality based on your usage: higher resolutions consume more bandwidth.
• When processing multiple URLs, ensure network stability for optimal performance.
• Rerun the actor if any URLs fail due to temporary network issues.

---

⚠️ Possible Errors & How to Avoid Them

Error	Cause	Solution
No startUrls provided	Input JSON missing startUrls	Ensure startUrls is provided with at least one URL
No thumbnails found	The URL may not be valid, private, or removed	Double-check URL accessibility and format
Failed to download thumbnail	Network issues or URL unreachable	Retry; check your connection or URL availability
Unexpected error processing URL	Temporary server or proxy issues	Retry the actor; ensure URLs are correct

---

🚀 How to Use

1. Prepare a JSON input with your desired Instagram URLs and thumbnail quality.
2. Run the actor.
3. The output will include the thumbnail URLs and metadata for each URL provided.
4. Store or process the output as needed in your projects.

Tip: You can integrate the output with dashboards, databases, or media management tools.

---

📬 Support

If you encounter issues or need guidance: 📧 Email: alphascraper69@gmail.com

---

🖼 Example Workflow

1. Input: A list of public Instagram video URLs with full_hd thumbnails.
2. Actor processes each URL and selects the best matching thumbnail.
3. Output: JSON objects with download links, metadata, and image details.
4. Use case: Automatically populate a website gallery, generate reports, or archive thumbnails.

---

🌈 Notes

• The actor ensures a clean and reliable output, suitable for automation pipelines.
• Downloaded thumbnails are publicly accessible via the generated URLs.
• Choose appropriate quality to balance image resolution vs. file size.

---