A PHP wrapper for the Instagram API. Feedback or bug reports are appreciated.
Supports Laravel 5.3, 5.4 & 5.5
Now supports Instagram video responses.
To use the Instagram API with OAuth you have to register yourself as developer at the Instagram Developer Platform and set up an App. Take a look at the uri guidlines before registering a redirect URI.
Please note that Instagram mainly refers to »Clients« instead of »Apps«. So »Client ID« and »Client Secret« are the same as »App Key« and »App Secret«.
A good place to get started is the example App.
<?php
require '../vendor/autoload.php';
$instagram = new Andreyco\Instagram\Client(array(
'apiKey' => 'YOUR_APP_KEY',
'apiSecret' => 'YOUR_APP_SECRET',
'apiCallback' => 'YOUR_APP_CALLBACK',
'scope' => array('basic'),
));
echo "<a href='{$instagram->getLoginUrl()}'>Login with Instagram</a>";
?>
This package offers Laravel support out of the box. These steps are required to setup the package.
Installation
composer require andreyco/instagram
Add Service provider and register Facade
'providers' => array(
// ...
Andreyco\Instagram\Support\Laravel\ServiceProvider\Instagram::class,
// ...
),
'aliases' => array(
// ...
'Instagram' => Andreyco\Instagram\Support\Laravel\Facade\Instagram::class,
// ...
),
Configuration
// Pushlish configuration file.
php artisan vendor:publish --provider="Andreyco\Instagram\Support\Laravel\ServiceProvider\Instagram"
// Edit previously created `config/instagram.php` file
return [
'clientId' => '...',
'clientSecret' => '...',
'redirectUri' => '...',
'scope' => ['basic'],
]
In Laravel application, you can access library by simply using Instagram
facade, e.g.
Instagram::getLoginUrl();
For usage in pure PHP, you have to create instance of class.
$instagram = new Andreyco\Instagram\Client($config);
$instagram->getLoginUrl()
<?php
// Generate and redirect to login URL.
$url = Instagram::getLoginUrl();
// After allowing to access your profile, grab authorization *code* when redirected back to your page.
$code = $_GET['code'];
$data = Instagram::getOAuthToken($code);
// Now, you have access to authentication token and user profile
echo 'Your username is: ' . $data->user->username;
echo 'Your access token is: ' . $data->access_token;
?>
<?php
// Set user access token
Instagram::setAccessToken($accessToken);
// Get all user likes
$likes = Instagram::getUserLikes();
// Take a look at the API response
echo '<pre>';
print_r($likes);
echo '<pre>';
?>
new Instagram($config: Array|String);
array
if you want to authenticate a user and access its data:
new Instagram([
'apiKey' => 'YOUR_APP_KEY',
'apiSecret' => 'YOUR_APP_SECRET',
'apiCallback' => 'YOUR_APP_CALLBACK'
]);
string
if you only want to access public data:
new Instagram('YOUR_APP_KEY');
getLoginUrl($scope: [Array], $state: [string])
getLoginUrl(['basic', 'likes'], 'uMFYKG5u6v');
Optional scope parameters: To find out more about Scopes, please visit https://www.instagram.com/developer/authorization/
getOAuthToken($code, <true>/<false>)
true
: Return only the OAuth token
false
[default] : Returns OAuth token and profile data of the authenticated user
Set access token, for further method calls:
setAccessToken($token)
Return access token, if you want to store it for later usage:
getAccessToken()
getUser()
getUser($id)
searchUser($name, <$limit>)
getUserMedia($id, <$limit>)
getUserLikes(<$limit>)
getUserMedia(<$id>, <$limit>)
$id
isn't defined, or equals to self
it returns the media of the logged in usergetSelfFollows()
getSelfFollowedBy()
getUserRelationship($id)
modifyRelationship($action, $user)
$action
: Action command (follow / unfollow / block / unblock / approve / deny)$user
: Target user id<?php
// Follow the user with the ID 1574083
$instagram->modifyRelationship('follow', 1574083);
?>
Please note that the modifyRelationship()
method requires the relationships
scope.
getMedia($id)
searchMedia($lat, $lng, <$distance>, <$minTimestamp>, <$maxTimestamp>)
$lat
and $lng
are coordinates and have to be floats like: 48.145441892290336
,11.568603515625
$distance
Radial distance in meter (default is 1km = 1000, max. is 5km = 5000)$minTimestamp
All media returned will be taken later than this timestamp (default: 5 days ago)$maxTimestamp
All media returned will be taken earlier than this timestamp (default: now)getMediaComments($id)
addMediaComment($id, $text)
apidevelopers[at]instagram.com
for accessdeleteMediaComment($id, $commentID)
Please note that the authenticated methods require the comments
scope.
getTag($name)
getTagMedia($name)
searchTags($name)
getMediaLikes($id)
likeMedia($id)
deleteLikedMedia($id)
How to like a Media: Example usage Sample responses of the Likes Endpoints.
All <...>
parameters are optional. If the limit is undefined, all available results will be returned.
Instagram entries are marked with a type
attribute (image
or video
), that allows you to identify videos.
An example of how to embed Instagram videos by using Video.js, can be found in the /example
folder.
Please note: Instagram currently doesn't allow to filter videos.
In order to prevent that your access tokens gets stolen, Instagram recommends to sign your requests with a hash of your API secret, the called endpoint and parameters.
$instagram->setEnforceSignedRequests(true);
Each endpoint has a maximum range of results, so increasing the limit
parameter above the limit won't help (e.g. getUserMedia()
has a limit of 90).
That's the point where the "pagination" feature comes into play.
Simply pass an object into the pagination()
method and receive your next dataset:
<?php
$photos = $instagram->getTagMedia('kitten');
$result = $instagram->pagination($photos);
?>
Iteration with do-while
loop.
Registered Redirect URI | Redirect URI sent to /authorize | Valid? |
---|---|---|
http://yourcallback.com/ | http://yourcallback.com/ | yes |
http://yourcallback.com/ | http://yourcallback.com/?this=that | yes |
http://yourcallback.com/?this=that | http://yourcallback.com/ | no |
http://yourcallback.com/?this=that | http://yourcallback.com/?this=that&another=true | yes |
http://yourcallback.com/?this=that | http://yourcallback.com/?another=true&this=that | no |
http://yourcallback.com/callback | http://yourcallback.com/ | no |
http://yourcallback.com/callback | http://yourcallback.com/callback/?type=mobile | yes |
If you need further information about an endpoint, take a look at the Instagram API docs.
This example project, located in the example/
folder, helps you to get started.
The code is well documented and takes you through all required steps of the OAuth2 process.
Credit for the awesome Instagram icons goes to Ricardo de Zoete Pro.
Let me know if you have to share a code example, too.
You can find release notes here
Copyright (c) 2014 - Andrej Badin Released under the BSD License.
Instagram-PHP-API contains code taken from Christian Metz's Instagram-PHP-API, also licensed under BSD License.