Need help with instagram-user-feed?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

pgrimaud
417 Stars 75 Forks MIT License 346 Commits 5 Opened issues

Description

This is a scrapper to easily fetch any feed and interact with Instagram (like, follow, etc.) without OAuth for PHP.

Services available

!
?

Need anything else?

Contributors list

# 35,140
XML
france
sentry
nuxtjs
221 commits
# 178,087
PHP
WordPre...
instagr...
instagr...
6 commits
# 115,296
Laravel
PHP
Shell
Vue.js
4 commits
# 105,199
PHP
aws-s3
dropbox
gridfs
4 commits
# 160,668
Laravel
Kotlin
pcsc
iphone
2 commits
# 158,397
Shell
topojso...
XML
Laravel
2 commits
# 443,739
PHP
Compose...
instagr...
instagr...
2 commits
# 257,000
paypal
stripe
PHP
Laravel
1 commit
# 423,851
PHP
Laravel
varnish
instagr...
1 commit
# 22,050
whois-l...
php7
iphone
Nette
1 commit
# 498,938
PHP
guice
Shell
instagr...
1 commit
# 532,702
PHP
instagr...
instagr...
instagr...
1 commit
# 543,415
PHP
instagr...
instagr...
instagr...
1 commit

Instagram user feed PHP

Build Status Packagist Coverage Status

Minimum PHP Version Last version Total Downloads Monthly Downloads

All Contributors <!-- ALL-CONTRIBUTORS-BADGE:END -->

Information

Easily fetch any Instagram feed and more without OAuth for PHP.

If you like or use this package, please share your love by starring this repository, follow @pgrimaud or become a sponsor. 🙏💓

Features

  • Fetch profile data of user
  • Fetch medias of user
  • Fetch stories of user
  • Fetch highlights stories of user
  • Fetch detailed post of user
  • Fetch feed of followers
  • Fetch feed of followings
  • NEW : Follow or unfollow users
  • NEW : Like or unlike posts
  • NEW : Get posts of hashtag
  • NEW : Get comments of a post

This version can retrieve ANY Instagram feed using web scrapping.

⚠️ Version ^5.0 is no more maintained. ⚠️

Installation

composer require pgrimaud/instagram-user-feed

Changelog

v6.7 - 2021-01-31:

  • New feature: get post of hashtag.
  • New feature: get comments of post.
  • Add support for PHP 8.
  • Minor changes and improvements.

v6.6 - 2020-10-06:

  • New feature: like and unlike posts.
  • Retrieval #hashtags and @mentions from stories.
  • Minor changes and improvements.

v6.5 - 2020-09-14:

  • New feature: follow and unfollow users. Thanks to @David-Kurniawan)
  • Minor fixes.

v6.4 - 2020-08-30:

  • New feature: fetch followers and followings feeds. Thanks to @David-Kurniawan)
  • Minor improvements.

v6.3 -2020-07-03:

  • Add checkpoint challenge bypass using IMAP configuration.

v6.2 - 2020-06-01:

  • Improve medias crawling && cache constraints.

v6.1 - 2020-05-21:

  • New feature: Fetch stories and highlights stories.

v6.0 - 2020-05-20

  • Please upgrade from ^5.0 for cookies session stability.

Version ^6.3: Checkpoint challenge bypass

Some people may have trouble to login with this library. It happens for "old" Instagram accounts or if you're using it on some shared hosting (not all, I don't know why...).

You can now automatically bypass the checkpoint challenge. (email verification with code). You can find an example here.

Tips: you should create a dummy instagram account using a dummy e-mailbox to use this feature.

How it works?

  1. The lib will try to login
  2. Got 400 error "checkpoint_required"
  3. Trigger email verification
  4. Connect to your email inbox using IMAP credentials
  5. Wait for Instagram verification email
  6. Parse verification code from email
  7. Make a request to instagram with this code to complete verification
  8. Verification is done, then save session automatically*

Saving session with cache driver is very important here. The Instagram session is valid for... *1 YEAR**. So in theory, using a cache driver and one account will trigger only one real login to Instagram then reusing session for a long time.

Thanks to @ibnux and @eldark for help 🎉

Version ^6.0: Login

In version ^6.0, login is now mandatory, it will save cookies (session) to simulate "real" requests to Instagram.

They improve their bot detection and without real session data in the headers requests, your IP could be easily soft-ban by Instagram.

Then, you can't fetch a lot of data without login.

Tips: you just have to create or use a dummy account to use easily this package.

Usage

New in 6.0 Cache : This library implements PSR-6 for greatest interoperability.

$cachePool = new FilesystemAdapter('Instagram', 0, DIR . '/../cache');

$api = new Api($cachePool); $api->login('username', 'password'); // mandatory $profile = $api->getProfile('robertdowneyjr');

echo $profile->getUserName(); // robertdowneyjr

echo $profile->getFullName(); // Robert Downey Jr. Official

Basic usage :

login('username', 'password');

$profile = $api->getProfile('robertdowneyjr');

print_r($profile);

Instagram\Hydrator\Component\Feed Object
(
    [id] => 1518284433
    [userName] => robertdowneyjr
    [fullName] => Robert Downey Jr. Official
    [biography] => @officialfootprintcoalition @coreresponse
    [followers] => 46382057
    [following] => 50
    [profilePicture] => https://scontent-cdt1-1.cdninstagram.com/v/t51.2885-19/s320x320/72702032_542075739927421_3928117925747097600_n.jpg?_nc_ht=scontent-cdt1-1.cdninstagram.com&_nc_ohc=h2zGWoshNjUAX9ze3jb&oh=cf6441cfc3f258da3bf4cfef29686c7d&oe=5EEEC338
    [externalUrl] => http://coreresponse.org/covid19
    [private] => 
    [verified] => 1
    [mediaCount] => 453
        (
            [0] => Instagram\Model\InstagramMedia Object
                (
                    [id] => 2307655221969878423
                    [typeName] => GraphImage
                    [height] => 1350
                    [width] => 1080
                    [thumbnailSrc] => https://scontent-cdt1-1.cdninstagram.com/v/t51.2885-15/sh0.08/e35/c0.180.1440.1440a/s640x640/96225997_178111910111734_5886065436455432375_n.jpg?_nc_ht=scontent-cdt1-1.cdninstagram.com&_nc_cat=1&_nc_ohc=GqcYpSEbz8gAX_GF1Ep&oh=1b293215142d407faca46a2fd28eab71&oe=5EF0EBDF
                    [link] => https://www.instagram.com/p/CAGcDKplv2X/
                    [date] => DateTime Object
                        (
                            [date] => 2020-05-12 22:06:01.000000
                            [timezone_type] => 3
                            [timezone] => Europe/Paris
                        )

                [displaySrc] =&gt; https://scontent-cdt1-1.cdninstagram.com/v/t51.2885-15/e35/p1080x1080/96225997_178111910111734_5886065436455432375_n.jpg?_nc_ht=scontent-cdt1-1.cdninstagram.com&amp;_nc_cat=1&amp;_nc_ohc=GqcYpSEbz8gAX_GF1Ep&amp;oh=6c19ddef96fdc07d7926b05e36cb2bed&amp;oe=5EEED2CE
                [caption] =&gt; The sweetest things are worth waiting for…Susan and I are producing a @Netflix original series, Sweet Tooth, based on the comic by @Jefflemire. Can’t wait to share it with you all. 🦌 👦 @NXonNetflix @warnerbrostv #SweetTooth
                [comments] =&gt; 3308
                [likes] =&gt; 687988
                [thumbnails] =&gt; Array
                    (
                        [0] =&gt; stdClass Object
                            (
                                [src] =&gt; https://scontent-cdt1-1.cdninstagram.com/v/t51.2885-15/e35/c0.180.1440.1440a/s150x150/96225997_178111910111734_5886065436455432375_n.jpg?_nc_ht=scontent-cdt1-1.cdninstagram.com&amp;_nc_cat=1&amp;_nc_ohc=GqcYpSEbz8gAX_GF1Ep&amp;oh=24b300201afc0e0c82166c6288e0ed5b&amp;oe=5EF00196
                                [config_width] =&gt; 150
                                [config_height] =&gt; 150
                            )

                        [1] =&gt; stdClass Object
                            (
                                [src] =&gt; https://scontent-cdt1-1.cdninstagram.com/v/t51.2885-15/e35/c0.180.1440.1440a/s240x240/96225997_178111910111734_5886065436455432375_n.jpg?_nc_ht=scontent-cdt1-1.cdninstagram.com&amp;_nc_cat=1&amp;_nc_ohc=GqcYpSEbz8gAX_GF1Ep&amp;oh=203d0a3d01d77a2978739c96eb67e607&amp;oe=5EEF6DE0
                                [config_width] =&gt; 240
                                [config_height] =&gt; 240
                            )

                        [2] =&gt; stdClass Object
                            (
                                [src] =&gt; https://scontent-cdt1-1.cdninstagram.com/v/t51.2885-15/e35/c0.180.1440.1440a/s320x320/96225997_178111910111734_5886065436455432375_n.jpg?_nc_ht=scontent-cdt1-1.cdninstagram.com&amp;_nc_cat=1&amp;_nc_ohc=GqcYpSEbz8gAX_GF1Ep&amp;oh=7b9cee64460e1c9c501e59621e6ccfb2&amp;oe=5EF18BE6
                                [config_width] =&gt; 320
                                [config_height] =&gt; 320
                            )

                        [3] =&gt; stdClass Object
                            (
                                [src] =&gt; https://scontent-cdt1-1.cdninstagram.com/v/t51.2885-15/e35/c0.180.1440.1440a/s480x480/96225997_178111910111734_5886065436455432375_n.jpg?_nc_ht=scontent-cdt1-1.cdninstagram.com&amp;_nc_cat=1&amp;_nc_ohc=GqcYpSEbz8gAX_GF1Ep&amp;oh=f3d8c31eca2d3c3ab6653b3ed3ebe4f4&amp;oe=5EEFEAC0
                                [config_width] =&gt; 480
                                [config_height] =&gt; 480
                            )

                        [4] =&gt; stdClass Object
                            (
                                [src] =&gt; https://scontent-cdt1-1.cdninstagram.com/v/t51.2885-15/sh0.08/e35/c0.180.1440.1440a/s640x640/96225997_178111910111734_5886065436455432375_n.jpg?_nc_ht=scontent-cdt1-1.cdninstagram.com&amp;_nc_cat=1&amp;_nc_ohc=GqcYpSEbz8gAX_GF1Ep&amp;oh=1b293215142d407faca46a2fd28eab71&amp;oe=5EF0EBDF
                                [config_width] =&gt; 640
                                [config_height] =&gt; 640
                            )

                    )

                [location] =&gt; 
                [video] =&gt; 
                [videoViewCount] =&gt; 0
            )
    ...

[endCursor:Instagram\Model\InstagramProfile:private] =&gt; QVFEblBGclVyOEtCMmRLZkVxUUdVbmhsYXNMZmMmplNWtZRkJnRnZOSUdMM1BDRmt3ZA==

)

Paginate

If you want to use paginate on medias, just call

getMoreMedias
method.
login($credentials->getLogin(), $credentials->getPassword());

$profile = $api->getProfile('twhiddleston');

print_r($profile->getMedias()); // 12 first medias

do { $profile = $api->getMoreMedias($profile); print_r($profile->getMedias()); // 12 more medias

// avoid 429 Rate limit from Instagram
sleep(1);

} while ($profile->hasMoreMedias());

Stories

$cachePool = new FilesystemAdapter('Instagram', 0, DIR . '/../cache');

$api = new Api($cachePool); $api->login('username', 'password'); // mandatory

$profile = $api->getProfile('starwars'); // we need instagram username sleep(1); $feedStories = $api->getStories($profile->getId());

$stories = $feedStories->getStories();

print_r($stories);

Contributors

Thanks goes to these wonderful people (emoji key):


Pierre Grimaud

💻

Jan Östlund

💻

Tim Bond

💻

Dlinny

🐛

René

🐛

ikiselev1989

🐛

Pezhvak

💻

David Greminger

💻

Nana YAMANE

💻

David Kurniawan

💻

gtapps

💻

Chun-Sheng, Li

⚠️

schelmo

💻

Mojtaba

💻

Georgy Gusev

💻

Jibran Ijaz

💻

This project follows the all-contributors specification. Contributions of any kind welcome!

Feedback

You found a bug? You need a new feature? You can create an issue if needed or contact me on Twitter.

License

Licensed under the terms of the MIT License.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.