This package is not installable via Composer 1.x, please make sure you upgrade to Composer 2+. Read more about our Composer 1.x deprecation policy.

Composer compliant version of Instaphp by sesser (Randy)

1.0.0 2012-12-05 15:39 UTC

This package is not auto-updated.

Last update: 2021-09-03 23:28:31 UTC


This is a Composer compliant version of Instaphp which was coded by sesser (Randy) and can be found here.

Getting Started

Add to composer.json and install/update:

    "require": {
        "fishmarket/instaphp": "*"


require 'vendor/autoload.php';

use Instaphp\Instaphp;

// Config
$config = array(
	'client_id' => 'YOUR_CLIENT_ID'

// Get an instance of the Instaphp object
$api = Instaphp::Instance(null, $config);

// Get the response for Popular media
$response = $api->Media->Popular();

Alternatively, you could provide an access token:

$api = Instaphp::Instance('YOUR_ACCESS_TOKEN');

You can override the default configurations like above. Here are the defaults for quick reference:

public $configDefaults = array(
  'version'=> 'v1',
  'endpoint'=> '',
  'endpoint_timeout'=> '10',
  'client_id'=> null,
  'client_secret'=> null,
  'oauth_path'=> '/oauth/authorize/?client_id={client_id}&amp;response_type=code&amp;redirect_uri={redirect_uri}',
  'oauth_token_path'=> 'oauth/access_token',
  'redirect_uri'=> '',

The rest of the documentation follows the original Instaphp docs below

Instaphp v1.0 (original readme below)

This software is licensed under The MIT License. Please see the file named 'LICENSE' for futher details.


Instaphp is a small(ish) PHP library to access Instagram's API. It's main goal was to be easy to use, lightweight and have as few dependencies as possible. It's currently only compatible with PHP 5 >= 5.3 but there are very few 5.3 features being used and it's relatively trivial to convert it to versions < 5.3.

Instaphp is currently being used to power

Quickstart Guide

To get an idea of how the library works, it's best to understand the various endpoints provided by the API itself. The Instagram API currently has eight "endpoints" in which to retrieve data from their system:

  • Users
  • Relationships
  • Media
  • Comments
  • Likes
  • Tags
  • Locations
  • Geographies (This is really a subscription based endpoint and not available in Instaphp, yet)

In actuality, these eight endpoints can be summarized into four major endpoints:

  • Users
  • Media
  • Tags
  • Locations

Relationships are really an attribute of Users. Comments and Likes are both attributes of Media. Geographies are also an attribute of Media however, that particular endpoint is only available for subscriptions created for a particular location. Currently, Instaphp does not have a mechanism that supports subscriptions.

These four main "endpoints" are the basis for this library and allows a good separation for the various data you can pull from Instagram.

Example: Getting the current Popular photos

//-- Include our library
include_once 'instaphp/instaphp.php';

//-- Get an instance of the Instaphp object
$api = Instaphp\Instaphp::Instance();

//-- Get the response for Popular media
$response = $api->Media->Popular();

//-- Check if an error was returned from the API
if (empty($response->error))
	foreach ($response->data as $item)
		printf('<img src="%s" width="%d" height="%d" alt="%s">', $item->images->thumbnail->url, $item->images->thumbnail->width, $item->images->thumbnail->height, empty($item->caption->text) ? 'Untitled':$item->caption->text);

Example: Authentication

Instagram uses oAuth to authenticate its users. That means you follow a link to their site, login to their system, and grant an application access on your behalf. It's a fairly common scheme for handling authentication without passing sensitive data (e.g. your username and password) across (possibly) unsecure lines (e.g. non-https).

For Instaphp, you must have an API Key, API Secret and callback URL in order for oAuth to work. The basic flow looks like this:

  1. User clicks a link to "Login"
  2. User lands on Instagram's site and enters username/password
  3. Upon successful login, user is asked if they want to grant application access to their photos
  4. If user allows access, Instagram redirects user to callback URL of application with a code
  5. Application calls API with code to validate authentication
  6. Application is then given an access token to "sign" the calls to the API

Here's how it looks:

//-- The oAuth URL can be found in the Config object
$oAuthUrl = Instaphp\Config::Instance()->GetOAuthUri();

<!-- Here's a link -->
<a href="<?php echo $oAuthUrl ?>">Login</a>

//-- To authenticate, simply grab the code in your callback url
$code = $_GET['code'];
if (!empty($code)) {
	//-- Create an Instaphp instance
	$api = Instaphp\Instaphp::Instance();

	//-- Authenticate
	$response = $api->Users->Authenticate($code);

	//-- If no errors, grab the access_token (and cookie it, if desired)
	if (empty($response->error)) {
		$token = $response->auth->access_token;
		setcookie('instaphp', $token, strtotime('30 days'));
		//-- once you have a token, update the Instaphp instance so it passes the token for future calls
		$api = Instaphp\Instaphp::Instance($token);