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
tag: v0.3.2

Fetching latest commit…

Cannot retrieve the latest commit at this time

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

README.md

Instagram Ruby library

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

$ gem install instagram

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.

Credits

Instagram API documentation and Ruby library written by Mislav Marohnić.

Something went wrong with that request. Please try again.