PHPackages                             schurti/statamic-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. [Utility &amp; Helpers](/categories/utility)
4. /
5. schurti/statamic-instagram

ActiveStatamic-addon[Utility &amp; Helpers](/categories/utility)

schurti/statamic-instagram
==========================

Instagram feed for Statamic using Instagram Basic Display API

1.0.5(5y ago)08MITPHPPHP ^7.3 || ^8.0

Since Sep 3Pushed 5y agoCompare

[ Source](https://github.com/schurti/statamic-instagram-basic-display-api)[ Packagist](https://packagist.org/packages/schurti/statamic-instagram)[ RSS](/packages/schurti-statamic-instagram/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (8)Used By (0)

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** &gt; **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

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 80% 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 ~35 days

Recently: every ~44 days

Total

6

Last Release

1903d ago

PHP version history (2 changes)1.0.0PHP ^7.3

1.0.5PHP ^7.3 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/3124313e14092d6ffe95cd740df07fdab34ddaed00a0ede73a0afeaf922768f8?d=identicon)[schurti](/maintainers/schurti)

---

Top Contributors

[![lbeauvisage](https://avatars.githubusercontent.com/u/786319?v=4)](https://github.com/lbeauvisage "lbeauvisage (12 commits)")[![schurti](https://avatars.githubusercontent.com/u/1186856?v=4)](https://github.com/schurti "schurti (2 commits)")[![philippkuehn](https://avatars.githubusercontent.com/u/2500670?v=4)](https://github.com/philippkuehn "philippkuehn (1 commits)")

### Embed Badge

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

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

###  Alternatives

[apen/additional_reports

Useful information in the reports module : xclass, ajax, cliKeys, eID, general status of the system (encoding, DB, php vars...), hooks, compare local and TER extension (diff), used content type, used plugins, ExtDirect... It can really help you during migration or new existing project (to have a global reports of the system).

14157.8k](/packages/apen-additional-reports)

PHPackages © 2026

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