Imgur
Imgur's API exposes the entire Imgur infrastructure via a standardized programmatic interface. Using Imgur's API, you can do just about anything you can do on imgur.com, while using your programming language of choice. If you're familiar with the APIs of Twitter, Amazon's S3, del.icio.us, or a host of other web services, you'll feel right at home.
Imgur endpoints
| Method | Endpoint | Description |
|---|---|---|
| Account | ||
| DELETE |
Account Album Deletion /3/account/{username}/album/{id} |
Delete an account album |
| GET |
Account Album Ids /3/account/{username}/albums/ids |
Get all of the ids for all of the albums associated with the account |
| GET |
Account Album Count /3/account/{username}/albums/count |
The number of albums an account contains |
| GET |
Account Albums /3/account/{username}/albums/{page} |
Get all the albums associated with the account. Must be logged in as the user to see secret and hidden albums. |
| GET |
Account Comments /3/account/{username}/comments/{sort}/{page} |
The comments that the user has made |
| GET |
Account /3/account/{username} |
Request standard user information. |
| POST |
Account Creation /3/account/{username} |
You must send recaptcha information with this request. Use this as the public captcha key: 6LeZbt4SAAAAAG2ccJykgGk_oAqjFgQ1y6daNz-H |
| DELETE |
Account Comment Deletion /3/account/{username}/comment/{id} |
Delete a comment. You are required to be logged in as the user whom created the comment. |
| DELETE |
Account Deletion /3/account/{username} |
Delete a user account, you can only access this if you're logged in as the user. |
| GET |
Account Album Information /3/account/{username}/album/{id} |
Get More information about a specific album |
| GET |
Account Image Information /3/account/{username}/image/{id} |
Return information about a specific image. This endpoint works the same as the Image Endpoint. You can use any of the additional actions that the image endpoint with this endpoint. |
| GET |
Account Images /3/account/{username}/images/{page} |
Return all of the images associated with the account. You can page through the images by setting the page, this defaults to 0. |
| GET |
Account Likes /3/account/{username}/likes |
Return an array of images that have been upvoted by the user. |
| GET |
Account Images Ids /3/account/{username}/images/ids |
Returns an array of Image IDs that are associated with the account. |
| GET |
Account Messages /3/account/{username}/notifications/messages |
Returns all messages sent to the user, formatted as a notification. Required to be logged in to view this information. |
| GET |
Account Settings /3/account/{user}/settings |
Get the account settings if you're logged in as the user |
| GET |
Account Images Count /3/account/{username}/images/count |
Returns the total number of images associated with the account. |
| POST |
Account Send Message /3/account/{username}/message |
Send a message to the user in the URL from the user that's currently logged in. Set the variables subject (the subject of the message) and body (the body of the message)… |
| GET |
Account Statistics /3/account/{username}/stats |
Return the statistics about the account. |
| GET |
Comment Count /3/account/{username}/comments/count |
Return a count of all of the comments associated with the account. |
| GET |
Comment IDs /3/account/{username}/comments/ids |
Return an array of all of the comment IDs. |
| DELETE |
Delete Account Image /3/account/{username}/image/{id} |
Delete an image that belongs to the logged in user |
| GET |
Account Gallery Favorites /3/account/{username}/gallery_favorites |
Return the images the user has favorited in the gallery. |
| GET |
Account Favorites /3/account/{username}/favorites |
Returns the users favorited images, only accessible if you're logged in as the user. |
| GET |
Account Gallery Profile /3/account/{username}/gallery_profile |
Returns the totals for the gallery profile. |
| POST |
Send Verification E-mail /3/account/{username}/verifyemail |
Sends an email to the user to verify that their email is valid to upload to gallery. Must be logged in as the user to send. |
| GET |
Account Submissions /3/account/{username}/submissions/{page} |
Return the images a user has submitted to the gallery |
| GET |
Replies /3/account/{username}/notifications/replies |
Returns all of the reply notifications for the user. Required to be logged in as that user |
| POST |
Update Account Settings /3/account/{username}/settings |
Change the account settings |
| GET |
Verify User's E-mail /3/account/{username}/verifyemail |
Checks to see if user has verified their email address |
| Comment | ||
| GET |
Comment /3/comment/{id} |
Get comment information |
| DELETE |
Comment Delete /3/comment/{id} |
Delete a comment, will be marked as deleted if there are any replies |
| POST |
Comment Vote /3/comment/{id}/vote/{vote} |
Vote for a comment, :vote is up or down |
| GET |
Comment Replies /3/comment/{id}/replies |
View the comment and the thread of replies |
| POST |
Report Comment /3/comment/{id}/report |
Report a comment for being vulgar |
| POST |
Reply Creation /3/comment/{id} |
Create a reply for the given comment. |
| Gallery | ||
| GET |
Gallery /3/gallery/{section}/{sort}/{window}/{page} |
Returns the images in the gallery. For example the main gallery is /3/gallery/hot/viral/0 |
| GET |
Gallery Image /3/gallery/image/{id} |
Get additional information about an image in the gallery |
| GET |
Gallery Comment Count /3/gallery/{id}/comments/count |
The number of comments on an item in the gallery |
| POST |
Gallery Comment Creation /3/gallery/image/{id}/comment |
Create a comment, the user must be logged in with OAuth 2 for this to work. Also, works for gallery albums if you replace 'image' with 'album' in the route |
| DELETE |
Gallery Image Comment Delete /3/gallery/image/{id}/comment/{id} |
Delete a comment from an image |
| GET |
Gallery Image Comments /3/gallery/image/{id}/comments |
The Comments of a Gallery Image |
| GET |
Gallery Item Votes /3/gallery/image/{id}/votes |
Get the vote information for an image in the gallery (also works for gallery albums by replacing 'image' with 'album' in the route) |
| GET |
Gallery Search /3/gallery/search/{sort}/{window}/{page} |
Search the gallery for a given query string |
| POST |
Gallery Comment Reply /3/gallery/image/{id}/comment/{id} |
Reply to a comment in the gallery |
| POST |
Gallery Image Vote /3/gallery/image/{id}/vote/{vote} |
Vote for an image, {vote} is up or down (also works for Gallery Albums if you replace 'album' with 'image' in the route) |
| DELETE |
Remove from Gallery /3/gallery/{id} |
This allows the user to remove their content from the gallery. |
| GET |
Subreddit Galleries /3/gallery/r/{subreddit}/{sort}/{window}/{page} |
View gallery images for a subreddit |
| GET |
Gallery Comment Ids /3/gallery/{id}/comments/ids |
List all of the comment ids in an array for a gallery item |
| POST |
Upload Image to Gallery /3/gallery/image/{id} |
This allows a user to upload an image to the gallery, you're required to be logged in for this to work. |
Imgur pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| ULTRA | $500 / month | — |
|
| MEGA | $10,000 / month | — |
|