Instagram Image Post Downloader

Overview

This actor downloads all images from public Instagram posts. It extracts high-resolution images and metadata, handling both single-image and carousel posts. For video posts, it provides the video thumbnail as a downloadable image. Output includes direct download links hosted on Apify storage and structured engagement data.

Key Features

• Image Download: Fetches every image from single and carousel posts in the highest available resolution.
• Video Post Fallback: For video posts, retrieves the video thumbnail as an image.
• Metadata Extraction: Captures post description, likes, comments, author username, and upload date.
• Reliable Processing: Cleans input URLs and uses robust APIs to handle Instagram's structure.
• Structured Output: Returns a well-organized JSON array with media links and validation data.

How to Use

Provide a list of public Instagram post URLs via the actor's input. The actor will process each URL and return downloadable links and metadata.

Input Configuration

The input is a JSON object containing an array of post URLs under the post_urls key.

{
  "post_urls": [
    { "url": "https://www.instagram.com/p/DMxzBcrR-Jp/" },
    { "url": "https://www.instagram.com/p/CuXJXyznP-Q/" }
  ]
}

Input Fields:
* post_urls (Array): A list of objects, each containing one Instagram URL.
* url (String): The full URL of a public Instagram post.

Input/Output

Output Structure

The actor returns a JSON array. Each object in the array represents a processed post and contains the following key fields:

• original_url: The provided Instagram post URL.
• description: The full post caption/text.
• likes: Number of likes (formatted string, e.g., "35.0k").
• comments: Number of comments.
• upload_date: Post upload date.
• author_username: Post author's username.
• feedback: Status message (e.g., "Congrats, media found.").
• media: An object containing:
  • total_found: Total images found.
  • valid_urls: Number of successfully retrieved URLs.
  • urls: Array of objects, each with http_status, content_type, is_valid, and an image_download_link_N pointing to the file on Apify storage (e.g., https://api.apify.com/v2/key-value-stores/.../ig_7696698068974049882.jpg).
• request: Technical details including the cleaned_url and api_used.

Example Output

[
  {
    "original_url": "https://www.instagram.com/p/DMxzBcrR-Jp/",
    "description": "Zoom in. #ShotoniPhone by @eldography...",
    "likes": "35.0k",
    "comments": "633",
    "upload_date": "July 31, 2025",
    "author_username": "apple",
    "feedback": "Congrats, media found.",
    "media": {
      "total_found": 2,
      "valid_urls": 2,
      "urls": [
        {
          "http_status": 200,
          "content_type": "image/jpeg",
          "is_valid": true,
          "image_download_link_1": "https://api.apify.com/v2/key-value-stores/.../ig_7696698068974049882.jpg"
        }
      ]
    },
    "request": {
      "cleaned_url": "https://www.instagram.com/p/DMxzBcrR-Jp",
      "api_used": "API 1"
    }
  }
]