Skip to main content

A Python client for the Imgur API

Project description


A Python client for the Imgur API.

The original imgurpython project is no longer supported, so, I decided to create my own python client for the Imgur API.

Disclaimer: This is a work in progress. In this first version, I'm not gonna implement all the API calls, only the necessary ones to interact with imgur and be able to create albums, upload images and share them on the site.

For more information, check the API client documentation




$ python install

with pip

$ pip install imgur-python

How to publish something and share it with the community?

  • upload a bunch of images
  • add them to an album
  • share it
from os import path
from imgur_python import Imgur

imgur_client = Imgur({'client_id': 'cf8c57ca8......'})
image = imgur_client.image_upload(path.realpath('./image.png'), 'Untitled', 'My first image upload')
image_id = image['response']['data']['id']
album =  imgur_client.album_create([image_id], 'My first album', 'Something funny', 'public')
album_id = album['response']['data']['id']
response = imgur_client.gallery_album(album_id, 'This is going down on the sub', 0, 'funny,midly_interesting')



  • Gallery Album
  • Gallery Image
  • Album / Image Reporting
  • Album / Image Votes
  • Album / Image Voting
  • Album / Image Comments
  • Album / Image Comment
  • Album / Image Comment Creation

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

imgur_python-0.2.4.tar.gz (20.6 kB view hashes)

Uploaded source

Built Distribution

imgur_python-0.2.4-py3-none-any.whl (23.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page