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

ActiveStatamic-addon[Utility & 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** > **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

1902d 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)
```

PHPackages © 2026

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