PHPackages                             monoteos/instagram-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. monoteos/instagram-php

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

monoteos/instagram-php
======================

v7.0.2(6y ago)0192RPL-1.5PHPPHP &gt;=5.6CI failing

Since Nov 26Pushed 6y ago2 watchersCompare

[ Source](https://github.com/monoteos/instagram-php)[ Packagist](https://packagist.org/packages/monoteos/instagram-php)[ RSS](/packages/monoteos-instagram-php/feed)WikiDiscussions master Synced today

READMEChangelog (1)Dependencies (16)Versions (29)Used By (0)

[![logo](/examples/assets/instagram.png)](/examples/assets/instagram.png) Instagram-API [![Latest Stable Version](https://camo.githubusercontent.com/e97701ee3d33b75db2855fdf7838ff489f6589fb31f6a453c6776952833d1b73/68747470733a2f2f706f7365722e707567782e6f72672f6d677032352f696e7374616772616d2d7068702f762f737461626c65)](https://packagist.org/packages/mgp25/instagram-php) [![Total Downloads](https://camo.githubusercontent.com/f5859904b52be9cc6ae1b1772942b86e7c25bece5d5aad5735bbdc06395cd717/68747470733a2f2f706f7365722e707567782e6f72672f6d677032352f696e7374616772616d2d7068702f646f776e6c6f616473)](https://packagist.org/packages/mgp25/instagram-php) [![compatible](https://camo.githubusercontent.com/f52f20e005d9ab59bd1c916268d94d01fbbf37e90a2a43f3327e6bd2e60e2c49/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f504850253230372d436f6d70617469626c652d627269676874677265656e2e737667)](https://camo.githubusercontent.com/f52f20e005d9ab59bd1c916268d94d01fbbf37e90a2a43f3327e6bd2e60e2c49/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f504850253230372d436f6d70617469626c652d627269676874677265656e2e737667) [![License](https://camo.githubusercontent.com/d087955308f6d41b0e44b25939499c26a86eb3fc973a9531f5cadd35cf9579f0/68747470733a2f2f706f7365722e707567782e6f72672f6d677032352f696e7374616772616d2d7068702f6c6963656e7365)](https://packagist.org/packages/mgp25/instagram-php)
============================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#-instagram-api----)

This is a PHP library which emulates Instagram's Private API. This library is packed full with almost all the features from the Instagram Android App. This includes media uploads, direct messaging, stories and more.

**Read the [wiki](https://github.com/mgp25/Instagram-API/wiki)** and previous issues before opening a new one! Maybe your issue has already been answered.

**Frequently Asked Questions:** [F.A.Q.](https://github.com/mgp25/Instagram-API/wiki/FAQ)

**Do you like this project? Support it by donating**

**mgp25**

- [![Paypal](https://raw.githubusercontent.com/reek/anti-adblock-killer/gh-pages/images/paypal.png)](https://raw.githubusercontent.com/reek/anti-adblock-killer/gh-pages/images/paypal.png) Paypal: [Donate](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=5ATYY8H9MC96E)
- [![btc](https://raw.githubusercontent.com/reek/anti-adblock-killer/gh-pages/images/bitcoin.png)](https://raw.githubusercontent.com/reek/anti-adblock-killer/gh-pages/images/bitcoin.png) Bitcoin: 1DCEpC9wYXeUGXS58qSsqKzyy7HLTTXNYe

**stevejobzniak**

- [![Paypal](https://raw.githubusercontent.com/reek/anti-adblock-killer/gh-pages/images/paypal.png)](https://raw.githubusercontent.com/reek/anti-adblock-killer/gh-pages/images/paypal.png) Paypal: [Donate](https://www.paypal.me/Armindale/0usd)
- [![btc](https://raw.githubusercontent.com/reek/anti-adblock-killer/gh-pages/images/bitcoin.png)](https://raw.githubusercontent.com/reek/anti-adblock-killer/gh-pages/images/bitcoin.png) Bitcoin: 18XF1EmrkpYi4fqkR2XcHkcJxuTMYG4bcv

**jroy**

- [![Paypal](https://raw.githubusercontent.com/reek/anti-adblock-killer/gh-pages/images/paypal.png)](https://raw.githubusercontent.com/reek/anti-adblock-killer/gh-pages/images/paypal.png) Paypal: [Donate](https://www.paypal.me/JoshuaRoy1/0usd)
- [![btc](https://raw.githubusercontent.com/reek/anti-adblock-killer/gh-pages/images/bitcoin.png)](https://raw.githubusercontent.com/reek/anti-adblock-killer/gh-pages/images/bitcoin.png) Bitcoin: 32J2AqJBDY1VLq6wfZcLrTYS8fCcHHVDKD

---

Installation
------------

[](#installation)

### Dependencies

[](#dependencies)

Install/enable the required php extensions and dependencies. You can learn how to do so [here](https://github.com/mgp25/Instagram-API/wiki/Dependencies).

### Install this library

[](#install-this-library)

We use composer to distribute our code effectively and easily. If you do not already have composer installed, you can download and install it here [here](https://getcomposer.org/download/).

Once you have composer installed, you can do the following:

```
composer require mgp25/instagram-php
```

```
require __DIR__.'/../vendor/autoload.php';

$ig = new \InstagramAPI\Instagram();
```

If you want to test new and possibly unstable code that is in the master branch, and which hasn't yet been released, then you can do the following (at your own risk):

```
composer require mgp25/instagram-php dev-master
```

#### *Warning about moving data to a different server*

[](#warning-about-moving-data-to-a-different-server)

*Composer checks your system's capabilities and selects libraries based on your **current** machine (where you are running the `composer` command). So if you run Composer on machine `A` to install this library, it will check machine `A`'s capabilities and will install libraries appropriate for that machine (such as installing the PHP 7+ versions of various libraries). If you then move your whole installation to machine `B` instead, it **will not work** unless machine `B` has the **exact** same capabilities (same or higher PHP version and PHP extensions)! Therefore, you should **always** run the Composer-command on your intended target machine instead of your local machine.*

Examples
--------

[](#examples)

All examples can be found [here](https://github.com/mgp25/Instagram-API/tree/master/examples).

Code of Conduct
---------------

[](#code-of-conduct)

This project adheres to the Contributor Covenant [code of conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code. Please report any unacceptable behavior.

How do I contribute
-------------------

[](#how-do-i-contribute)

If you would like to contribute to this project, please feel free to submit a pull request.

Before you do, take a look at the [contributing guide](https://github.com/mgp25/Instagram-API/blob/master/CONTRIBUTING.md).

Why did I make this API?
------------------------

[](#why-did-i-make-this-api)

After legal measures, Facebook, WhatsApp and Instagram blocked my accounts. In order to use Instagram on my phone I needed a new phone, as they banned my UDID, so that is basically why I made this API.

### What is Instagram?

[](#what-is-instagram)

According to [the company](https://instagram.com/about/faq/):

> "Instagram is a fun and quirky way to share your life with friends through a series of pictures. Snap a photo with your mobile phone, then choose a filter to transform the image into a memory to keep around forever. We're building Instagram to allow you to experience moments in your friends' lives through pictures as they happen. We imagine a world more connected through photos."

License
=======

[](#license)

In order help ensure fairness and sharing, this library is dual-licensed. Be aware that *all* usage, unless otherwise specified, is under the **RPL-1.5**license!

- Reciprocal Public License 1.5 (RPL-1.5):

You should read the *entire* license; especially the `PREAMBLE` at the beginning. In short, the word `reciprocal` means "giving something back in return for what you are getting". It is ***not** a freeware license*. This license *requires* that you open-source *all* of your own source code for *any*project which uses this library! Creating and maintaining this library is endless hard work for us. That's why there is *one* simple requirement for you: Give *something* back to the world. Whether that's code *or* financial support for this project is entirely up to you, but *nothing else* grants you *any*right to use this library.

Furthermore, the library is *also* available *to certain entities* under a modified version of the RPL-1.5, which has been modified to allow you to use the library *without* open-sourcing your own project. The modified license (see [LICENSE\_PREMIUM](https://github.com/mgp25/Instagram-API/blob/master/LICENSE_PREMIUM)) is granted to certain entities, at *our* discretion, and for a *limited* period of time (unless otherwise agreed), pursuant to our terms. Currently, we are granting this license to all "[premium subscribers](https://github.com/mgp25/Instagram-API/issues/2655)" for the duration of their subscriptions. You can become a premium subscriber by either contributing substantial amounts of high-quality code, or by subscribing for a fee. This licensing ensures fairness and stimulates the continued growth of this library through both code contributions and the financial support it needs.

You are not required to accept this License since you have not signed it, however *nothing else* grants you permission to *use*, copy, distribute, modify, or create derivatives of either the Software (this library) or any Extensions created by a Contributor. These actions are prohibited by law if you do not accept this License. Therefore, by performing any of these actions You indicate Your acceptance of this License and Your agreement to be bound by all its terms and conditions. IF YOU DO NOT AGREE WITH ALL THE TERMS AND CONDITIONS OF THIS LICENSE DO NOT USE, MODIFY, CREATE DERIVATIVES, OR DISTRIBUTE THE SOFTWARE. IF IT IS IMPOSSIBLE FOR YOU TO COMPLY WITH ALL THE TERMS AND CONDITIONS OF THIS LICENSE THEN YOU CAN NOT USE, MODIFY, CREATE DERIVATIVES, OR DISTRIBUTE THE SOFTWARE.

Terms and conditions
====================

[](#terms-and-conditions)

- You will NOT use this API for marketing purposes (spam, botting, harassment, massive bulk messaging...).
- We do NOT give support to anyone who wants to use this API to send spam or commit other crimes.
- We reserve the right to block any user of this repository that does not meet these conditions.

Legal
-----

[](#legal)

This code is in no way affiliated with, authorized, maintained, sponsored or endorsed by Instagram or any of its affiliates or subsidiaries. This is an independent and unofficial API. Use at your own risk.

###  Health Score

32

—

LowBetter than 71% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community23

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 65% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~57 days

Recently: every ~74 days

Total

28

Last Release

2269d ago

Major Versions

v2.0 → v3.0.02017-09-04

3.1 → v4.0.02018-03-27

v4.1.0 → v5.0.02018-10-08

v5.0.0 → v6.0.02019-04-24

v6.1.0 → v7.0.02019-09-15

PHP version history (3 changes)v1.0.0PHP &gt;=5.6

v1.4PHP &gt;=5.3.0

v1.5.1PHP &gt;=5.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/d0e839cc832399ce8ed19c1d1c8ebc30f1028f6b9375083eb798a2abcd3bc3c5?d=identicon)[monoteos](/maintainers/monoteos)

---

Top Contributors

[![mgp25](https://avatars.githubusercontent.com/u/5390120?v=4)](https://github.com/mgp25 "mgp25 (897 commits)")[![valga](https://avatars.githubusercontent.com/u/23472603?v=4)](https://github.com/valga "valga (125 commits)")[![JRoy](https://avatars.githubusercontent.com/u/10731363?v=4)](https://github.com/JRoy "JRoy (121 commits)")[![Lastwisher](https://avatars.githubusercontent.com/u/10153826?v=4)](https://github.com/Lastwisher "Lastwisher (37 commits)")[![aitte2](https://avatars.githubusercontent.com/u/18485256?v=4)](https://github.com/aitte2 "aitte2 (32 commits)")[![frrakn](https://avatars.githubusercontent.com/u/8717720?v=4)](https://github.com/frrakn "frrakn (26 commits)")[![aryanbaghi](https://avatars.githubusercontent.com/u/4646461?v=4)](https://github.com/aryanbaghi "aryanbaghi (16 commits)")[![juampi92](https://avatars.githubusercontent.com/u/2080215?v=4)](https://github.com/juampi92 "juampi92 (13 commits)")[![Vasiliy-Bondarenko](https://avatars.githubusercontent.com/u/5263184?v=4)](https://github.com/Vasiliy-Bondarenko "Vasiliy-Bondarenko (10 commits)")[![vivevio](https://avatars.githubusercontent.com/u/7406182?v=4)](https://github.com/vivevio "vivevio (9 commits)")[![zuexo](https://avatars.githubusercontent.com/u/11216115?v=4)](https://github.com/zuexo "zuexo (8 commits)")[![cacadleaver](https://avatars.githubusercontent.com/u/6829309?v=4)](https://github.com/cacadleaver "cacadleaver (8 commits)")[![aliforever](https://avatars.githubusercontent.com/u/14090252?v=4)](https://github.com/aliforever "aliforever (7 commits)")[![ilyk](https://avatars.githubusercontent.com/u/797411?v=4)](https://github.com/ilyk "ilyk (5 commits)")[![ihsangulumser](https://avatars.githubusercontent.com/u/20027054?v=4)](https://github.com/ihsangulumser "ihsangulumser (5 commits)")[![ildarsaitkulov](https://avatars.githubusercontent.com/u/12912522?v=4)](https://github.com/ildarsaitkulov "ildarsaitkulov (5 commits)")[![ping](https://avatars.githubusercontent.com/u/104607?v=4)](https://github.com/ping "ping (5 commits)")[![sh2ezo](https://avatars.githubusercontent.com/u/1949160?v=4)](https://github.com/sh2ezo "sh2ezo (5 commits)")[![monoteos](https://avatars.githubusercontent.com/u/400280?v=4)](https://github.com/monoteos "monoteos (5 commits)")[![matthijsotterloo](https://avatars.githubusercontent.com/u/8299614?v=4)](https://github.com/matthijsotterloo "matthijsotterloo (4 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/monoteos-instagram-php/health.svg)

```
[![Health](https://phpackages.com/badges/monoteos-instagram-php/health.svg)](https://phpackages.com/packages/monoteos-instagram-php)
```

###  Alternatives

[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

728272.9k17](/packages/civicrm-civicrm-core)[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

4.8k4.3k](/packages/shlinkio-shlink)[rector/rector-src

Instant Upgrade and Automated Refactoring of any PHP code

134391.5k12](/packages/rector-rector-src)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
