Skip to content


Subversion checkout URL

You can clone with
Download ZIP
tag: v0.1.0
Fetching contributors…

Cannot retrieve contributors at this time

46 lines (27 sloc) 1.225 kb

Instagram Ruby library

So far, the only way to browse Instagram photos was their iPhone app. Well, no more.

This library acts as a client for the unofficial Instagram API. 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.user.username      #=> "johndoe"
photo.user.full_name     #=> "John Doe"
photo.comments[1].text   #=> "That's so cute"
photo.images.last.width  #=> 612

# fetch extended info for John
john_info = Instagram::user_info(

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

# find more photos by John
photos_by_john = Instagram::by_user(


Instagram API reverse-engineered and Ruby library written by Mislav Marohnić.

Jump to Line
Something went wrong with that request. Please try again.