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

Ayesh
138 Stars 63 Forks MIT License 73 Commits 2 Opened issues

Description

Instagram image and video downloader with URL validation and cURL integration

Services available

!
?

Need anything else?

Contributors list

# 31,421
PHP
Symfony
PHPUnit
Compose...
73 commits

InstagramDownload - Instagram photo and Video Downloader

Travis

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)

Requirements

  • PHP 7.4
  • Curl

Thanks to:

  • MetaData - Meta data parsing regex and curl class.

Installation

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

bash
composer require ayesh/instagram-download
Without composer Download the zip file from Github, and configure your autoload handler to autoload PSR-4
Ayesh\InstagramDownload
namespace from the downloaded contents
src
directory.

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'

Usage

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.