Instagram Realtime

This module allows you to integrate real-time Instagram content with your Drupal site. This module was developed for the Alaska Salmon Project by ThinkShout.

To use this tool, you must create an Instagram "Client" through Instagram's Developer UI. After installing and enabling the module, you can then add your credentials Instagram Client credentials to the site at admin/config/services/instagram.

Once you have done that, go to the Instagram Push Subscriptions tab (admin/config/services/instagram/subscriptions) to create a subscription. Note that you must allow the Instagram service to communicate with your site for this function to work: if you are developing behind a firewall, you'll need to setup a tunneling service (like ngrok). Click "Add Subscription" and specify what type of filter you want to create. For tags, exclude the "#".

Once you add your subscription, you should see it appear in the subscription list. If it doesn't work, double-check that your site is accessible from the web.

Instagram will now notify you any time media matching your filter is added to Instagram. This module will then retrieve this media for you and make the media available to you via a hook. Implement hook_instagram_process_new($media) to get ahold of your media. It will be formatted as described here.