Instagram

An easy-to-use and simple Instagram package.

use Vinkla\Instagram\Instagram;

// Create a new instagram instance.
$instagram = new Instagram('your-access-token');

// Fetch recent user media items.
$instagram->media();

// Fetch user information.
$instagram->self();

Installation

Instagram is decoupled from any library sending HTTP requests (like Guzzle), instead it uses an abstraction called HTTPlug which provides the http layer used to send requests to exchange rate services. This gives you the flexibility to choose what HTTP client and PSR-7 implementation you want to use.

Read more about the benefits of this and about what different HTTP clients you may use in the HTTPlug documentation. Below is an example using Guzzle 6:

$ composer require vinkla/instagram php-http/message php-http/guzzle6-adapter

Usage

First you need to generate an access token using Pixel Union's access token generator or by creating an Instagram application.

5937104658.5688ed0.675p84e21a0341gcb3b44b1a13d9de91

Then create a new Vinkla\Instagram\Instagram instance with your Instagram access token.

use Vinkla\Instagram\Instagram;

$instagram = new Instagram('5937104658.5688ed0.675p84e21a0341gcb3b44b1a13d9de91');

To fetch the user's recent media items you may use the media() method.

$instagram->media();

You may pass additional query parameters to the media() method if needed.

$instagram->media(['count' => 5]);

To fetch the user information data you may use the self() method.

$instagram->self();

To fetch media item comments you may use the comments() method.

$instagram->comments('20033001112203311302_0102938816');

Note: You can only fetch a user's recent media from the given access token.

Rate Limiting

The Instagram allows you to call their API 200 times per hour. Try to cache the responses in your application.

The Instagram API uses the same rate limiting as the Graph API (200 calls per user per hour) with one exception: the /media/comments edge limits writes to 60 writes per user per hour. Please refer to the Graph API's rate limiting documentation for more information - Facebook

Disclaimer

Instagram will deprecate their API in favor of the new Instagram Graph API in early 2020. There are currently no plans to add Graph API support to this package. If you want to keep this package alive and add support for the new API, please submit a pull request.