PHPackages                             gnahotelsolutions/laravel-instagram-feed - 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. gnahotelsolutions/laravel-instagram-feed

ActiveLibrary[API Development](/categories/api)

gnahotelsolutions/laravel-instagram-feed
========================================

Fetches the instagram feed for given authenticated profiles

3.6.0(4mo ago)0484MITPHPPHP ^8.2

Since Apr 20Pushed 4mo agoCompare

[ Source](https://github.com/gnahotelsolutions/laravel-instagram-feed)[ Packagist](https://packagist.org/packages/gnahotelsolutions/laravel-instagram-feed)[ RSS](/packages/gnahotelsolutions-laravel-instagram-feed/feed)WikiDiscussions master Synced 1mo ago

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

Laravel Instagram Feed
======================

[](#laravel-instagram-feed)

[![Build Status](https://camo.githubusercontent.com/335f353ee8d484776392ee406458e1c53b391e651d4c3a53367a08dea595f2fc/68747470733a2f2f7472617669732d63692e6f72672f44796d616e7469632f6c61726176656c2d696e7374616772616d2d666565642e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/Dymantic/laravel-instagram-feed)

Easily include your Instagram feed(s) in your project.
------------------------------------------------------

[](#easily-include-your-instagram-feeds-in-your-project)

The aim of this package is to make it as simple and user-friendly as possible to include your Instagram feed in your project, using Instagram's Basic Display API. The package stores the feed in your cache, and provides you with the ability to refresh your feeds on whatever schedule suits you.

**Note** This package requires PHP 8. If that is not your cup of tea, then you may continue to use [v2](https://github.com/Dymantic/laravel-instagram-feed/tree/v2.6.0).

### Installation

[](#installation)

```
composer require dymantic/laravel-instagram-feed

```

**Note** If you are upgrading from v2.\*, refer to the [upgrade guide](upgrade.md), as there are breaking changes. **Also Note** This version requires PHP 8 and up, so if you are still on PHP 7 and don't specify a version when you install, composer will pull in ^v2, in which case you should be reading [this page](https://github.com/Dymantic/laravel-instagram-feed/tree/v2.6.0).

Tutorial
--------

[](#tutorial)

Some parts of this whole thing can be a bit confusing, especially if you are not familiar with following the OAuth flow. I have included [a tutorial](tutorial.md) to try help make things a bit more clear. Feedback or improvements on this would be most appreciated.

### Before you start

[](#before-you-start)

To use the Instagram Basic Display API, you will need to have a Facebook app set up with the correct permissions, etc. If you don't have this yet, head over to [the Facebook developer docs](https://developers.facebook.com/docs/instagram-basic-display-api/getting-started) and follow the instructions.

### How Instagram Media is Handled

[](#how-instagram-media-is-handled)

Instagram provides three media types through this API: image, video and carousel. This package simplifies that into just a feed of images and videos. You may use the `ignore_video` config option if you don't want to include any videos. For carousel items, the first item of the carousel is used. If video is to be ignored, and the first image will be used, if it exists. Carousel items have a `children` property, which includes the actual carousel items.

##### Note on ignoring video

[](#note-on-ignoring-video)

If you chose to ignore video, your feed size may be smaller than the limit you requested. If you expect to be ignoring video posts you may want to increase how many posts you fetch (see "Getting the Feed" below).

### Setup

[](#setup)

`php artisan vendor:publish` to publish the necessary migrations and config, and `php artisan migrate` to run migrations.

### Config

[](#config)

Publishing the vendor assets as described above will give you a `config/instagram-feed.php` file. You will need to add your config before you can get started. The comments in the file explain each of the settings.

```
// config/instagram-feed.php