Imagegur
 ## API Status Status for the API can be found at [status.imgur.com](http://status.imgur.com)! ## Getting Started 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. The Imgur API is a…
104 subscribers
80 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
Imagegur endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET |
AccountImages2 /3/account/me/images |
To make requests for the current account, you may use `me` as the `{{username}}` parameter. For example, `https://api.imgur.com/3/account/me/images` will request all the images… |
| POST |
GenerateAccessToken0 /oauth2/token |
Given a user's refresh token, this endpoint generates an access token. |
| GET |
AccountGalleryFavorites3 /3/account/{username}/gallery_favorites/{page}/{favoritesSort} |
Return the images the user has favorited in the gallery. #### Response Model: [Gallery Image](https://api.imgur.com/models/gallery_image) OR [Gallery… |
| GET |
AlbumCount(Un-Authed/Authed)16 /3/account/{username}/albums/count |
Return the total number of albums associated with the account. #### Response Model: [Basic](https://api.imgur.com/models/basic) |
| GET |
AccountSubmissions5 /3/account/{username}/submissions/{page} |
Return the images a user has submitted to the gallery. You can add sorting as well after paging. Sorts can be: newest (default), oldest, worst, best. #### Response Model:… |
| DELETE |
AlbumDeletion17 /3/account/{username}/album/{albumHash} |
Delete an Album with a given id. #### Response Model: [Basic](https://api.imgur.com/models/basic) |
| GET |
AccountAvailableAvatars(Un-authed/Authed)6 /3/account/{username}/available_avatars |
If unauthentiated, get list of default trophies a user can select from. The username need not exist to get the listing. If authenticated, get the list of available avatars for… |
| GET |
AccountBase1 /3/account/{username} |
Request standard user information. If you need the username for the account that is logged in, it is returned in the request for an [access token](/account/current_account).… |
| GET |
AccountAvatar(Authed)7 /3/account/{username}/avatar |
Get the current account's avatar URL and avatar name. |
| POST |
SendVerificationE-mail12 /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. #### Response Model:… |
| GET |
CommentCount21 /3/account/{username}/comments/count |
Return a count of all of the comments associated with the account. #### Response Model: [Basic](https://api.imgur.com/models/basic) |
| GET |
AlbumImages1 /3/album/{albumHash}/images |
Return all of the images in the album. #### Response Model: [Image](https://api.imgur.com/models/image) |
| GET |
Albums(Un-Authed/Authed)13 /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. #### Response Model: [Album](https://api.imgur.com/models/album)… |
| PUT |
ChangeAccountSettings9 /3/account/{username}/settings |
Updates the account settings for a given user, the user must be logged in. #### Response Model: [Basic](https://api.imgur.com/models/basic) #### Parameters | Key | Required |… |
| DELETE |
CommentDeletion2 /3/comment/{commentId} |
Delete a comment by the given id. #### Response Model: [Basic](https://api.imgur.com/models/basic) |
| GET |
Images23 /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. #### Response Model:… |
| GET |
ImageCount26 /3/account/{username}/images/count |
Returns the total number of images associated with the account. #### Response Model: [Basic](https://api.imgur.com/models/basic) |
| GET |
ImageIDs25 /3/account/{username}/images/ids/{page} |
Returns an array of Image IDs that are associated with the account. #### Response Model: [Basic](https://api.imgur.com/models/basic) |
| DELETE |
ImageDeletion27 /3/account/{username}/image/{deleteHash} |
Deletes an Image. This requires a delete hash rather than an ID. #### Response Model: [Basic](https://api.imgur.com/models/basic) |
| GET |
Image24 /3/account/{username}/image/{imageId} |
Return information about a specific image. This endpoint works the same as the [Image Endpoint](https://api.imgur.com/endpoints/image/). You can use any of the additional actions… |
| POST |
FollowTag29 /3/account/me/follow/tag/{tagName} |
Follows the {{tagName}} specified for the currently logged in user. |
| GET |
Comments18 /3/account/{username}/comments/{commentSort}/{page} |
Return the comments the user has created. #### Response Model: [Comment](https://api.imgur.com/models/comment) #### Parameters | Key | Required | Value |… |
| GET |
Image0 /3/image/{imageHash} |
Get information about an image. |
| POST |
SetAlbumImages(Un-Authed)8 /3/album/{albumDeleteHash} |
Sets the images for an album, removes all other images and only uses the images in this request. #### Response Model: [Basic](https://api.imgur.com/models/basic) #### Parameters… |
| GET |
Replies3 /3/comment/{commentId}/replies |
Get the comment with all of the replies for the comment. #### Response Model: [Comment](https://api.imgur.com/models/comment) |
| POST |
AddImagestoanAlbum(Authed)11 /3/album/{albumHash}/add |
Adds the images to an album. You must specify ids[] or deletehashes[] in order to add an image to an album. #### Response Model: [Basic](https://api.imgur.com/models/basic) ####… |
| POST |
Vote5 /3/comment/{commentId}/vote/{vote} |
Vote on a comment. The `vote` parameter can only be set as `up`, `down`, or `veto`. #### Response Model: [Basic](https://api.imgur.com/models/basic) |
| POST |
AccountDelete(me)32 /3/account/me/delete |
Delete the account of the auth'd user with delete feedback. note: password is left blank to avoid accidental account deletion, to delete account you must add account password to… |
| POST |
Report6 /3/comment/{commentId}/report |
Report a comment for being inappropriate. |
| DELETE |
CommentDeletion22 /3/account/{username}/comment/{commentId} |
Delete a comment. You are required to be logged in as the user whom created the comment. #### Response Model: [Basic](https://api.imgur.com/models/basic) |
| DELETE |
AlbumDeletion(Un-Authed)5 /3/album/{albumDeleteHash} |
Delete an album with a given deletehash. #### Response Model: [Basic](https://api.imgur.com/models/basic) |
| DELETE |
Unfollowtag31 /3/account/me/follow/tag/{tagName} |
Unfollows the {{tagName}} specified for the currently logged in user. |
| GET |
GalleryTag3 /3/gallery/t/{tagName}/{sort}/{window}/{page} |
Returns tag metadata, and posts tagged with the `tagName` provided |
| POST |
RemoveImagesfromanAlbum(Authed)13 /3/album/{albumHash}/remove_images |
Takes parameter, `ids[]`, as an array of ids and removes from the album. #### Response Model: [Basic](https://api.imgur.com/models/basic) #### Parameters | Key | Required |… |
| GET |
Gallery0 /3/gallery/{section}/{sort}/{window}/{page} |
| Key | Required | Value | |-----------|----------|---------------------------------------------------------------------------------------------------| | section | optional |… |
| POST |
RemoveImagesfromanAlbum(Un-Authed)12 /3/album/{albumDeleteHash}/remove_images |
Takes parameter, `ids[]`, as an array of ids and removes from the album. #### Response Model: [Basic](https://api.imgur.com/models/basic) #### Parameters | Key | Required |… |
| POST |
FavoriteAlbum7 /3/album/{albumHash}/favorite |
Favorite an album with a given ID. The user is required to be logged in to favorite the album. #### Response Model: [Basic](https://api.imgur.com/models/basic) |
| POST |
CommentCreation1 /3/comment |
Creates a new comment, returns the ID of the comment. #### Response Model: [Basic](https://api.imgur.com/models/basic) #### Parameters | Key | Required | Description |… |
| GET |
RandomGalleryImages9 // |
*DEPRECATED* Returns a random set of gallery images. |
| GET |
AlbumImage2 /3/album/{albumHash}/image/{imageHash} |
Get information about an image in an album, any additional actions found in [Image Endpoint](https://api.imgur.com/endpoints/image/) will also work. #### Response Model:… |
| GET |
GallerySearch8 /3/gallery/search/{sort}/{window}/{page} |
Search the gallery with a given query string. #### Parameters | Key | Required | Value | |--------|----------|---------------------------------------------------------------------… |
| POST |
SharewithCommunity(Image)10 /3/gallery/image/{imageHash} |
Share an Album or Image to the Gallery. |
| GET |
SubredditGalleries1 /3/gallery/r/{subreddit}/{sort}/{window}/{page} |
View gallery images for a subreddit | Key | Required | Value | |-----------|----------|--------------------------------------------------------------------------------------------… |
| POST |
AlbumCreation(Un-Authed/Authed)3 /3/album |
Create a new album. Optional parameter of `ids[]` is an array of image ids to add to the album. If uploading anonymous images to an anonymous album please use the optional… |
| GET |
SubredditImage2 /3/gallery/r/{subreddit}/{subredditImageId} |
View a single image in the subreddit | Key | Required | Value | |-----------|----------|-------------------------------| | subreddit | required | A valid subreddit name, ie… |
| GET |
CommentIDs20 /3/account/{username}/comments/ids/{sort}/{page} |
Return an array of all of the comment IDs. #### Response Model: [Basic](https://api.imgur.com/models/basic) #### Parameters | Key | Required | Value |… |
| GET |
Comment19 /3/account/{username}/comment/{commentId} |
Return information about a specific comment. This endpoint works the same as the [Comment Endpoint](https://api.imgur.com/endpoint/comment/). You can use any of the additional… |
| PUT |
UpdateAlbum(Un-Authed/Authed)4 /3/album/{albumHash} |
Update the information of an album. For anonymous albums, `albumHash` should be the deletehash that is returned at creation. If uploading anonymous images to an anonymous album… |
| GET |
AlbumIDs(Un-Authed/Authed)15 /3/account/{username}/albums/ids/{page} |
Return an array of all of the album IDs (hashes). #### Response Model: [Basic](https://api.imgur.com/models/basic) |
| GET |
VerifyUser'sE-mail11 /3/account/{username}/verifyemail |
Checks to see if user has verified their email address. #### Response Model: [Basic](https://api.imgur.com/models/basic) |
+ 30 more endpoints on the provider's documentation.
Imagegur pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 1000 / second |
|
| PRO | Free | — |
|
