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
- if an
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);