A simple PHP wrapper for the Instagram Basic Display API. Based on the Instagram-PHP-API by Christian Metz

Composer package available.

• PHP 5.6 or higher
• cURL
• Facebook Developer Account
• Facebook App

To use the Instagram Basic Display API, you will need to register a Facebook app and configure Instagram Basic Display. Follow the getting started guide.

I strongly advice using Composer to keep updates as smooth as possible.

$ composer require espresso-dev/instagram-basic-display-php

use EspressoDev\InstagramBasicDisplay\InstagramBasicDisplay;

$instagram = new InstagramBasicDisplay([
    'appId' => 'YOUR_APP_ID',
    'appSecret' => 'YOUR_APP_SECRET',
    'redirectUri' => 'YOUR_APP_REDIRECT_URI'
]);

echo "<a href='{$instagram->getLoginUrl()}'>Login with Instagram</a>";

// Get the OAuth callback code
$code = $_GET['code'];

// Get the short lived access token (valid for 1 hour)
$token = $instagram->getOAuthToken($code, true);

// Exchange this token for a long lived token (valid for 60 days)
$token = $instagram->getLongLivedToken($token, true);

echo 'Your token is: ' . $token;

// Set user access token
$instagram->setAccessToken($token);

// Get the users profile
$profile = $instagram->getUserProfile();

echo '<pre>';
print_r($profile);
echo '<pre>';

All methods return the API data as json_decode() - so you can directly access the data.

new Instagram(<array>/<string>);

array if you want to perform oAuth:

new InstagramBasicDisplay([
    'appId' => 'YOUR_APP_ID',
    'appSecret' => 'YOUR_APP_SECRET',
    'redirectUri' => 'YOUR_APP_REDIRECT_URI'
]);

string once you have a token and just want to return read-only data:

new InstagramBasicDisplay('ACCESS_TOKEN');

getLoginUrl(<array>, <string>)

getLoginUrl(
    array(
        'user_profile', 
        'user_media'
    ),
    'state'
);

getOAuthToken($code, <true>/<false>)

true : Returns only the OAuth token
false [default] : Returns OAuth token and profile data of the authenticated user

getLongLivedToken($token, <true>/<false>)

true : Returns only the OAuth token
false [default] : Returns OAuth token and profile data of the authenticated user

refreshToken($token, <true>/<false>)

true : Returns only the OAuth token
false [default] : Returns OAuth token and expiry data of the token

• Set the access token, for further method calls: setAccessToken($token)
• Get the access token, if you want to store it for later usage: getAccessToken()

Authenticated methods

• getUserProfile()
• getUserMedia(<$id>, <$limit>)
  • if an $id isn't defined or equals 'me', it returns the media of the logged in user

Authenticated methods

• getMedia($id)
• getMediaChildren()

The getUserMedia endpoint has a maximum range of results, so increasing the limit parameter above the limit of 99 won't help.You can use pagination to return more results for this endpoint.

Pass an object into the pagination() method and receive your next dataset:

$media = $instagram->getUserMedia();

$moreMedia = $instagram->pagination($media);