Because GIFs make life fun! Use Giphy API from your Ruby programs and command line. Check out Giphy Labs for inspiration.

Add this line to your application's Gemfile:

gem 'giphy'

And then execute:

$ bundle

Or install it yourself as:

$ gem install giphy

Set the API version and api_key:

Giphy::Configuration.configure do |config|
  config.version = THE_API_VERSION
  config.api_key = YOUR_API_KEY
end

Important: Giphy API is currently in public beta. Unless version and api_key are set to specific values the default values for the beta period will be used. Check Giphy's API for updates.

That's it, you're ready to have fun!

Giphy.recent(tag: 'cats', limit: 5)

Giphy.translate('geek')

Giphy.search('funny cat', {limit: 50, offset: 25})

Write

Giphy.flag('m5QHf0caAwgMw')

Read

Giphy.flagged

Write

Giphy.favorite('12HoHdqnDxz5NS')

Read

Giphy.favorites('absurdnoise', {limit: 50, offset: 25})

Giphy.screensaver('surprise')

Giphy.random

For getting random gifs with a specific tag:

Giphy.random('american psycho')

Giphy.artists

Giphy.gif_by_artist('89a', {limit: 5, offset: 10})

Giphy.gif_by_id('feqkVgjJpYtjy', '12HoHdqnDxz5NS', '7rzbxdu0ZEXLy')

There is a small command line tool that let's you search for GIFs from the command line and opens it on your browser. Just for fun.

$ giphy 'dance'

This library aims to support and is tested against the following Ruby implementations:

• Ruby 1.9
• Ruby 2.0
• Ruby 2.1

1. Fork it
2. Create your feature branch: git checkout -b my-new-feature
3. Run tests: rake
4. Commit your changes: git commit -am 'Add some feature'
5. Push to the branch: git push origin my-new-feature
6. Create new Pull Request

See LICENSE for details.