Need help with InstagramDownload?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

171 Stars 79 Forks MIT License 76 Commits 7 Opened issues


Instagram image and video downloader with URL validation and cURL integration

Services available


Need anything else?

Contributors list

# 31,594
74 commits
# 19,350
2 commits

InstagramDownload - Instagram photo and Video Downloader


Instagram Photo and video download helper library.

New: Checkout TikTokOff - TikTok video online downloader (no watermarks)

Update on May 22, 2020: Due to Instagram no longer allowing anonymous users to view photos/videos, this library is currently not working. A new version 7 is in the works, but there is no ETA yet. Only IGTV videos are working now

Old and unsupported versions - Legacy 1.0 pre-composer - 2.x branch with for PHP ^7.1 - 3.x branch with for PHP ^7.2

Old and minimally supported versions - 4.x branch with for PHP ^7.3

I wrote this class mainly for my online Instagram photo, video and IGTV downloader, but I thought share this piece for your own extensions.

  • Validates Instagram URL (domain validation, URL path validation).
  • Uses OG properties to detect the image and video URL.
  • Supports Instagram photos, videos, and Instagram TV videos
  • Verbose error reporting with proper exceptions.
  • Full unit tests
  • No dependencies other than PHP curl extension (which is most likely enabled by already)


  • PHP 7.4
  • Curl

Thanks to:

  • MetaData - Meta data parsing regex and curl class.


With composer Install the library by running the following in your project.

composer require ayesh/instagram-download
Without composer Download the zip file from Github, and configure your autoload handler to autoload PSR-4
namespace from the downloaded contents

You could also manually require the file. Requires a certain amount of guilty feeling because it's 2017 and you are not using a decent autoload mechanism.

require_once 'src/InstagramDownload.php'


try {
  $client = new InstagramDownload($url);
  $url = $client->getDownloadUrl(); // Returns the download URL.
  $type = $client->getType(); // Returns "image" or "video" depending on the media type.
catch (\InvalidArgumentException $exception) {

  • \InvalidArgumentException exceptions will be thrown if there is a validation
  • error in the URL. You might want to break the code flow and report the error
  • to your form handler at this point.
  • / $error = $exception->getMessage(); } catch (\RuntimeException $exception) { /*
  • \RuntimeException exceptions will be thrown if the URL could not be
  • fetched, parsed, or a media could not be extracted from the URL.
  • / $error = $exception->getMessage(); }

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.