Imgur::API::Endpoint::Gallery
Access to the imgur Gallery API Endpoint. See: https://api.imgur.com/endpoints/gallery
Returns the images in the gallery. For example the main gallery is https://api.imgur.com/3/gallery/hot/viral/0.json
showViral OPTIONAL true | false - Show or hide viral images from the 'user' section. Defaults to true
section OPTIONAL hot | top | user - defaults to hot
window OPTIONAL Change the date range of the request if the section is "top", day | week | month | year | all, defaults to day
page OPTIONAL integer - the data paging number
sort OPTIONAL viral | top | time | rising (only available with user section) - defaults to viral
View images for memes subgallery
window OPTIONAL Change the date range of the request if the sort is "top", day | week | month | year | all, defaults to week
sort OPTIONAL viral | time | top - defaults to viral
View a single image in the memes gallery
image_id REQUIRED The ID for the image.
View gallery images for a subreddit
sort OPTIONAL time | top - defaults to time
subreddit REQUIRED pics - A valid subreddit name
View a single image in the subreddit
View images for a gallery tag
t_name REQUIRED The name of the tag.
View a single image in a gallery tag
View tags for a gallery item
id REQUIRED ID of the gallery item
gallery REQUIRED Gallery
Vote for a tag, 'up' or 'down' vote. Send the same value again to undo a vote.
t_name REQUIRED Name of the tag (implicitly created, if doesn't exist)
vote REQUIRED 'up' or 'down'
Update the tags for a post in the gallery
tags REQUIRED The name of the tags you wish to associate with a post. Can be passed as tags[]=funny&tags[]=cat or tags=funny,cat/td>
Search the gallery with a given query string.
sort OPTIONAL time | viral | top - defaults to time
window OPTIONAL Change the date range of the request if the sort is 'top', day | week | month | year | all, defaults to all.
Returns a random set of gallery images.
page OPTIONAL A page of random gallery images, from 0-50. Pages are regenerated every hour.
Share an Album or Image to the Gallery.
title REQUIRED The title of the image. This is required.
terms OPTIONAL If the user has not accepted our terms yet, this endpoint will return an error. To by-pass the terms in general simply set this value to 1.
topic OPTIONAL Topic name
mature OPTIONAL If the post is mature, set this value to 1.
tags[] OPTIONAL The name of the tags you wish to associate with a post. Can be passed as tags[]=funny&tags[]=cat or tags=funny,cat
Remove an image from the gallery. You must be logged in as the owner of the item to do this action.
Get additional information about an album in the gallery.
Get additional information about an image in the gallery.
Report an Image in the gallery
2 REQUIRED
4 REQUIRED
1 REQUIRED
3 REQUIRED
reason OPTIONAL An integer representing the reason for the report Value Description 1 Doesn't belong on Imgur 2 Spam 3 Abusive 4 Mature content not marked as mature 5 Pornography
5 REQUIRED
Get the vote information about an image
Vote for an image, 'up' or 'down' vote. Send 'veto' to undo a vote.
vote REQUIRED Vote
Comment on an image in the gallery.
sort OPTIONAL best | top | new - defaults to best
Information about a specific comment. This action also allows any of the additional actions provided in the Comment Endpoint.
comment REQUIRED Comment
Create a comment for an image.
comment REQUIRED The text of the comment.
Reply to a comment that has been created for an image.
commentReply REQUIRED CommentReply
comment REQUIRED The text you want to use as the reply.
List all of the IDs for the comments on an image.
The number of comments on an Image.
25 POD Errors
The following errors were encountered while parsing the POD:
'=item' outside of any '=over'
To install Imgur::API, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Imgur::API
CPAN shell
perl -MCPAN -e shell install Imgur::API
For more information on module installation, please visit the detailed CPAN module installation guide.