Home > ImgurLib

ImgurLib

ImgurLib is a project mainly written in Python, based on the MIT license.

Python library to manage the imgur.com's Authenticated API

The ImgurLib

The ImgurLib is a API wrapper arrownd the imgur.com Authenticated API service. This enables you to manage imgur.com accounts without thinking too much about the authentication. It was developed to be used with ImgurUp as some of the users wanted to use the application with their own accounts, but cince the library is extended to support almost all methods available, it is released as a separete library.

Methods

The method ImgurLib provides are as follow:

  • get_auth_url() - returns a URL for authenticating the client in imgur.com
  • authorize(self, PIN) - authorizes the user with a pin from the URL you get from get_auth_url()
  • authorize_with_token() - authorizes the user with a token you already have so you can skip the first two methods
  • account_info() - gives the information for the current account
  • upload_image(filename, title, caption) - uploads an image to imgur.com
  • get_account_images() - gives a list with images in current account
  • get_image_info(hash) - Gives full information about the image (with that hash)
  • get_image_count() - Returns the total number of images in the account
  • get_albums(count, page) - Returns the albums in the account with count and page
  • create_album(title, description, privacy) - Creates album
  • get_album_count() - Gets the number of albums in the account
  • get_credits() - How many cretis are left for the account
  • genereate_links(hash) - generates links for forums and html pages

Requires

In order to use ImgurLib you need the following libraries installed:

  • python-json
  • python-oauth2 (see https://github.com/simplegeo/python-oauth2)