When you have an automated system to produce blog posts, sometimes you want to attach random pictures to it on some theme or other. For example, you might post the output of your unit tests every day and decide it would look good if each one had a different picture of a camel next to it. Flickr::Embed will look up your search terms on Flickr and return a given picture each time.

Returns a hash of information taken from Flickr. In list context, returns everything it received from Flickr, subject to exclusions. In scalar context, returns just the first one, subject to exclusions. The return type is described in THE CONTENTS OF THE HASH, below. Takes a set of named parameters, described below.

How many photos to return (if this call is in list context). You will get at most this many; if any exclusions match, or if there aren't enough photos on Flickr with the given tags, you will get fewer.

If you exclude all the pictures in the first fetch, Flickr::Embed does not yet go back and get another batch; it behaves as if there were no pictures found. By default this will only happen if you have at least 100 exclusions. This will be fixed in a later release.