Instagram user feed using API

Instagram user feed using API Main Screenshot

integrate Instagram Feed using Instagram Basic Display API

Statamic 3.0+

📸 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


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

Get started

To use the Instagram Basic Display API, you will need to register a Facebook app and configure Instagram Basic Display. Follow the getting started guide.


Require it using Composer.

composer require nineteensquared/instagram


Set the App ID and SECRET in the .env file


Set the OAuth Redirect URI in Instagram Basic Display configuration

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

Connect to Instagram

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


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

{{ ig }} {{ caption }} {{ /ig }}
{{ /instagram }}


Parameter Default Value Description
limit 12 Number of image


Variable Description
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

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


Please see CHANGELOG for more information what has changed recently.

Common error :

"error_type": "OAuthException",
"code": 400,
"error_message": "Insufficient developer role"

➡️ Add an Instagram Test User following step 3


🐛 Open an issue on github