Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
The first Instagram website and lightweight API HTTP client
Ruby CSS JavaScript
tree: b2840d0330

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.