Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
The first Instagram website and lightweight API HTTP client
Ruby CSS JavaScript
tree: 86534959c1

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
public
views
.gitignore
Gemfile
Gemfile.lock
MIT-LICENSE
README.md
Rakefile
app.rb
config.ru
config.yml
instagram.rb
models.rb

README.md

Unofficial Instagram Ruby library

This library acts as a client for the unofficial Instagram API. It was used to create the missing Instagram web interface before their main API went public.

With it, you can:

  • fetch popular photos;
  • get user info;
  • browse photos by a user.

Caveat: you need to know user IDs; usernames can't be used. However, you can start from the popular feed and drill down from there.

Example usage

require 'instagram'

photos = Instagram::popular
photo = photos.first

photo.caption     #=> "Extreme dog closeup"
photo.likes.size  #=> 54
photo.filter_name #=> "X-Pro II"

photo.user.username      #=> "johndoe"
photo.user.full_name     #=> "John Doe"
photo.comments[1].text   #=> "That's so cute"
photo.images.last.width  #=> 612

# available sizes: 150px / 306px / 612px square
photo.image_url(612)
# => "http://distillery.s3.amazonaws.com/media/-.jpg" (612×612px image)

# fetch extended info for John
john_info = Instagram::user_info(photo.user.id)

john_info.media_count    #=> 32
john_info.follower_count #=> 160


# find more photos by John
photos_by_john = Instagram::by_user(photo.user.id)

To see which models and properties are available, see models.rb.

Something went wrong with that request. Please try again.