PHPackages                             nineteensquared/instagram - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. nineteensquared/instagram

AbandonedArchivedStatamic-addon[API Development](/categories/api)

nineteensquared/instagram
=========================

Instagram feed for Statamic using Instagram Basic Display API

1.2.0(2y ago)92.9k4[6 issues](https://github.com/nineteen-2/statamic-instagram-basic-display-api/issues)[1 PRs](https://github.com/nineteen-2/statamic-instagram-basic-display-api/pulls)1MITPHPPHP ^7.3|^8.0

Since Sep 3Pushed 1y ago1 watchersCompare

[ Source](https://github.com/nineteen-2/statamic-instagram-basic-display-api)[ Packagist](https://packagist.org/packages/nineteensquared/instagram)[ RSS](/packages/nineteensquared-instagram/feed)WikiDiscussions master Synced 5d ago

READMEChangelog (6)Dependencies (1)Versions (12)Used By (1)

DEPRECATED
==========

[](#deprecated)

Suggestion replacement:

-
-

Display a user Instagram Feed using Instagram Basic Display API
===============================================================

[](#display-a-user-instagram-feed-using-instagram-basic-display-api)

[![Statamic 3.0+](https://camo.githubusercontent.com/93c61a311851e398f5663226aca5d307d91ef898067c6b294110a785d6c2e735/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53746174616d69632d332e302b2d4646323639453f7374796c653d666f722d7468652d6261646765266c696e6b3d68747470733a2f2f73746174616d69632e636f6d)](https://camo.githubusercontent.com/93c61a311851e398f5663226aca5d307d91ef898067c6b294110a785d6c2e735/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53746174616d69632d332e302b2d4646323639453f7374796c653d666f722d7468652d6261646765266c696e6b3d68747470733a2f2f73746174616d69632e636f6d)

📸 This addon provide a robust way to integrate Instagram Feed using **Instagram Basic Display API**

🔥 Using the API is the recommanded way to acces Instagram User Feed

⚡️ This addon also provide cache to limit API calls

📦 It is based on the [Instagram Basic Display PHP API](https://github.com/espresso-dev/instagram-basic-display-php)

Requirements
------------

[](#requirements)

- PHP 7 or higher
- cURL
- Facebook Developer Account
- Facebook App

Get started
-----------

[](#get-started)

To use the [Instagram Basic Display API](https://developers.facebook.com/docs/instagram-basic-display-api), you will need to register a Facebook app and configure Instagram Basic Display. Follow the [getting started guide](https://developers.facebook.com/docs/instagram-basic-display-api/getting-started).

Installation
------------

[](#installation)

Require it using Composer.

```
composer require nineteensquared/instagram

```

Configuration
-------------

[](#configuration)

### Set the App ID and SECRET in the .env file

[](#set-the-app-id-and-secret-in-the-env-file)

```
INSTAGRAM_APP_ID=
INSTAGRAM_APP_SECRET=

```

### Set the OAuth Redirect URI in Instagram Basic Display configuration

[](#set-the-oauth-redirect-uri-in-instagram-basic-display-configuration)

For example: `https://statamic.test/cp/nineteen-ig/auth`

### Connect to Instagram

[](#connect-to-instagram)

Log into the control panel, and go to **Tools** > **Instagram**and click on the **Login with Instagram** button.

Tag
---

[](#tag)

```
{{ instagram limit="6" as="ig" }}

        {{ ig }}

        {{ /ig }}

{{ /instagram }}

```

Parameters
----------

[](#parameters)

ParameterDefault ValueDescription`limit``12`Number of imageVariables
---------

[](#variables)

VariableDescription`caption`The Media's caption text. Not returnable for Media in albums.`id`The Media's ID.`media_type`The Media's type. Can be IMAGE, VIDEO, or CAROUSEL\_ALBUM.`media_url`The Media's URL.`permalink`The Media's permanent URL. Will be omitted if the Media contains copyrighted material, or has been flagged for a copyright violation.`thumbnail_url`The Media's thumbnail image URL. Only available on VIDEO Media.`timestamp`The Media's publish date in ISO 8601 format.`username`The Media owner's username.Overriding configuration
------------------------

[](#overriding-configuration)

`php artisan vendor:publish --tag=instagram-config`

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Common error :
--------------

[](#common-error-)

```
{
"error_type": "OAuthException",
"code": 400,
"error_message": "Insufficient developer role"
}

```

➡️ Add an Instagram Test User [following step 3](https://developers.facebook.com/docs/instagram-basic-display-api/getting-started)

Support
-------

[](#support)

🐛 Open an issue [on github](https://github.com/nineteen-2/statamic-instagram-basic-display-api/issues)

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance15

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 88% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~145 days

Recently: every ~254 days

Total

8

Last Release

1066d ago

PHP version history (2 changes)1.0.0PHP ^7.3

1.1.0PHP ^7.3|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/2e3f55a63a6259adde695c75cc14e1dec1513d98328589109cf76595aa99cad6?d=identicon)[lbeauvisage](/maintainers/lbeauvisage)

---

Top Contributors

[![lbeauvisage](https://avatars.githubusercontent.com/u/786319?v=4)](https://github.com/lbeauvisage "lbeauvisage (22 commits)")[![anditopping](https://avatars.githubusercontent.com/u/1104234?v=4)](https://github.com/anditopping "anditopping (1 commits)")[![codedge](https://avatars.githubusercontent.com/u/4409904?v=4)](https://github.com/codedge "codedge (1 commits)")[![philippkuehn](https://avatars.githubusercontent.com/u/2500670?v=4)](https://github.com/philippkuehn "philippkuehn (1 commits)")

### Embed Badge

![Health badge](/badges/nineteensquared-instagram/health.svg)

```
[![Health](https://phpackages.com/badges/nineteensquared-instagram/health.svg)](https://phpackages.com/packages/nineteensquared-instagram)
```

###  Alternatives

[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/common-protos

Google API Common Protos for PHP

173103.7M50](/packages/google-common-protos)[hubspot/api-client

Hubspot API client

23414.2M16](/packages/hubspot-api-client)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)