flickr-url-parser 1.1.1

Enter a Flickr URL, and find out what sort of URL it is (single photo, album, gallery, etc.)

This is a library for parsing Flickr URLs. You enter a Flickr URL, and it tells you what sort of URL it is.

Examples:

$ flickr_url_parser "https://www.flickr.com/photos/sdasmarchives/50567413447"
{"type": "single_photo", "photo_id": "50567413447"}

$ flickr_url_parser "https://www.flickr.com/photos/aljazeeraenglish/albums/72157626164453131"
{"type": "album", "user_url": "https://www.flickr.com/photos/aljazeeraenglish", "album_id": "72157626164453131"}

$ flickr_url_parser "https://www.flickr.com/people/blueminds/"
{"type": "user", "user_url": "https://www.flickr.com/photos/blueminds"}

This was extracted as a standalone bit of functionality from Flinumeratr, a toy that shows you a list of photos that can be viewed at a Flickr URL.

Usage

There are two ways to use flickr_url_parser:

1. As a command-line tool. Run flickr_url_parser, passing the Flickr URL as a single argument:

   $ flickr_url_parser "https://www.flickr.com/photos/sdasmarchives/50567413447"
   {"type": "single_photo", "photo_id": "50567413447"}
   

   The result will be printed as a JSON object.

   To see more information about the possible return values, run flickr_url_parser --help.

2. As a Python library. Import the function parse_flickr_url and pass the Flickr URL as a single argument:

   >>> from flickr_url_parser import parse_flickr_url
   
   >>> parse_flickr_url("https://www.flickr.com/photos/sdasmarchives/50567413447")
   {"type": "single_photo", "photo_id": "50567413447"}
   

   To see more information about the possible return values, use the help function:

   >>> help(parse_flickr_url)
   

Note that just because a URL can be parsed does not mean it can be resolved to a photo and/or photos. The only way to know if there are photos behind the URL is to (1) try to fetch the URL or (2) use the output from the parser to ask the Flickr API for photos.