Retrieve and display Flickr photos the easy way with getFlickrBy

As part of my talk on YQL for Open Hack London I’ve thought of an easy way to get Flickr photos that you are allowed to display in your products and hacks.

The wrapper API getFlickrBy works around the somewhat convoluted data returned from Flickr’s API methods and uses YQL to cut the information you want down to the bare necessities. Furthermore the API only returns photos that are licenced with Creative Commons’ “By” license to avoid you using photos you have no right to use (which is a big thing with the Flickr crowd).

The API endpoint is:

http://isithackday.com/api/getFlickrBy.php

You have several parameters to play with:

location

The location you want photos of as defined in the Yahoo Geo API

search

A word you want to search for

format

The format of the returned data, XML, HTML or JSON - preset is XML

callback

A name of a JavaScript function call to wrap the JSON data in, in case you want to use the API in a script node

amount

The amount of photos returned, max is 100 – preset is 20

size

the photo size, “s” for 75×75px, “t” for thumbnail, “m” for medium, omit to get big size

The API returns only what you need: the image title, the owner, the url of the image and the link to Flickr. If you use html as the output format it returns an HTML list of linked images. For output demos and explanations simply call the API without any parameters

Here are some examples how to use the API:

• Get 5 photos from Paris,France as JSON calling the function foo()
• Get 20 photos from Ankara as HTML
• Get 20 photos from London as XML
• Get 20 photos of bridges in munich as XML
• Get 10 photos of kittens json calling the function meow()

Tags: api, creativecommons, flickr, openhacklondon, wrapper