Skip to content
A 6KB JavaScript plugin for the Instagram API (without jQuery).
JavaScript
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
dist
src
.eslintrc
.gitignore
.travis.yml
LICENSE.txt
README.md
bower.json
gulpfile.js
package.json

README.md

Instafetch.js

Build Status Dependency Status

Instafetch.js is a 6KB JavaScript plugin for the Instagram API using fetch instead of jQuery.

Installation

Instafetch.js is available on CDNJS, NPM, Bower, and GitHub.

CDNJS

<script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/instafetch.js/1.5.0/instafetch.min.js"></script>

NPM

npm install --save instafetch.js
require('instafetch.js');

Bower

bower install instafetch.js
<script type="text/javascript" src="path/to/bower_components/instafetch.js/dist/instafetch.min.js"></script>

GitHub

Download the script or the minified version in the dist folder.

<script type="text/javascript" src="path/to/instafetch.min.js"></script>

Usage

The Instagram API uses the OAuth 2.0 protocol, so you're going to need an access token. The easiest way to get your access token is login to Instagram on your browser and generate one on Pixel Union.

<script type="text/javascript">
  instafetch.init({
    accessToken: 'ACCESS TOKEN',
    target: 'instafetch',
    numOfPics: 20,
    caption: false
  });
</script>

Instafetch.js will look for an element with the ID of instafetch by default. The target element can be changed when initializing the plugin.

The plugin also allows you to set the number of items to return from your feed and if you want to include the captions.

Promise Polyfill

Instafetch.js was only 3KB initially, but those 3KB didn't support any version of Internet Explorer. IE will return "Promise is undefined" and the Instagram feed will be empty. Version 1.2 included the ES6-Promise polyfill, which added an extra 7KB just for IE. Version 1.3 removed the ES6-Promise polyfill for another Promise polyfill that only added 3KB.

Changelog

1.5

  • Updated Promise polyfill
  • Fixed bug for returned images without a caption

1.4

  • Updated Fetch-JSONP
  • Switched from ES5 to ES6

1.3

1.2.2

  • Fixed installation instructions for NPM

1.2.1

  • Published different paths on NPM and Bower

1.2

1.1

  • Changed Instagram API endpoint
  • Removed user ID

1.0

  • Initial release

Issues

Please submit any issues here.

License

Instafetch.js is licensed under the MIT License.

You can’t perform that action at this time.