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.

Files for imgur-python, version 0.2.3
Filename, size File type Python version Upload date Hashes
Filename, size imgur_python-0.2.3-py3-none-any.whl (23.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size imgur_python-0.2.3.tar.gz (20.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page