Features

• Download photos, videos from all user posts
• Download all user reels
• Download all user highlight stories
• Download all active stories of user
• Download reel, highlight, post medias by its CODE
• Delete All Instagram Posts on Your Account

[!WARNING] The above features only apply to public or private instagram profiles (you have already followed).

[!NOTE] All downloaded photos and videos will be saved in the Downloads folder (for Windows) on your computer.

Installation

npm install @minhchi1509/instagram-downloader

Usage

• This is an example:

import {
  InstagramDownloader,
  ProfileCleaner,
} from "@minhchi1509/instagram-downloader";

// Cookies of your Instagram account. You can get it by using Cookie-Editor extension on Chrome
const cookies = "YOUR_INSTAGRAM_COOKIES";
// Username of the Instagram account you want to download
const username = "minhchi1509";

const instagramDownloader = new InstagramDownloader(cookies);
const profileCleaner = new ProfileCleaner(cookies);

// Download all posts of the user
instagramDownloader.post.downloadAllUserPosts(username);

// Download all reels of the user
instagramDownloader.reel.downloadAllUserReels(username);

// Download all highlights of the user
instagramDownloader.highlight.downloadAllUserHighlightStories(username);

// Download active stories of the user
instagramDownloader.story.downloadAllUserStories(username);

// Download reel, post, highlight medias by its code
const postCode = "DC6XbjFpCF8"; // From url: https://www.instagram.com/p/DC6XbjFpCF8/
const reelCode = "DBONFumvXTH"; // From url: https://www.instagram.com/reel/DBONFumvXTH/
const highlightId = "18040128229968128"; // From url: https://www.instagram.com/stories/highlights/18040128229968128/
instagramDownloader.post.downloadPostByCode(postCode);
instagramDownloader.reel.downloadReelByCode(reelCode);
instagramDownloader.highlight.downloadHighlightStoryById(highlightId);

// Delete all posts of your account
profileCleaner.clearAllPosts();

API Documentation

Download posts, reels, highlights, stories

instagramDownloader.post.downloadAllUserPosts(
  username,
  writeStatisticFile,
  downloadMedia,
  limit
);
instagramDownloader.reel.downloadAllUserReels(
  username,
  writeStatisticFile,
  downloadMedia,
  limit
);
instagramDownloader.highlight.downloadAllUserHighlightStories(
  username,
  writeStatisticFile,
  downloadMedia
);
instagramDownloader.story.downloadAllUserStories(username);

Parameters:

• username (string, required): The username of instagram user that you want to download their media
• writeStatisticFile (boolean, optional): If true, it will output a CSV file containing information about the posts. Default value: true
• downloadMedia (boolean, optional): If true, it will download videos, photos about the posts. Default value: true
• limit (number, optional): The limit number of posts/reels you want to download in one execution and it MUST be a multiple of 12. Suitable when a user has too many posts/reels and you only want to download (example: 120 posts/reels) at a time per execution. Default value: Infinity

[!WARNING] Note that when you specify the value of limit parameter, after the batch download is complete, there will be a folder named cache_cursor/[username] and it contains files like posts.json, reels.json to save information for the next posts/reels download. Please DO NOT edit anything in these files. If you want to download posts or reels again from the beginning, delete the corresponding files.

Download post, reel, highlight by its ID/CODE

instagramDownloader.post.downloadPostByCode(postCode: string);
instagramDownloader.reel.downloadReelByCode(reelCode: string);
instagramDownloader.highlight.downloadHighlightStoryById(highlightId: string);

Get profile information

instagramDownloader.getProfileInfor(): Promise<IProfile>

Return value: return general information about a user. Include: id, username, full_name, avatar_url (HD), follower, following, is_private_account, total_posts

Delete all profile's posts

profileCleaner.clearAllPosts(limit);

Parameters:

• limit (number, optional): The limit number of your first posts you want to delete. Default value: Infinity