Look up information about photos and collections of photos from Flickr
Project description
flickr-photos-api
This is a library for getting information about photos from the Flickr API.
It's not a general-purpose Flickr API library. Instead, it focuses on providing information about photos and photo collections. It tries to abstract away some of the details of the Flickr API -- for example, licenses are returned as complete dictionaries, rather than as the numeric license IDs returned by Flickr API methods.
Examples:
>>> from flickr_photos_api import FlickrPhotosApi
>>> api = FlickrPhotosApi(api_key="…", user_agent="…")
>>> photo = api.get_single_photo(photo_id="14898030836")
>>> photo
{'id': '14898030836', 'title': 'NASA Scientists Says', …}
>>> photo["license"]
{'id': 'cc-by-2.0', 'label': 'CC BY 2.0', 'url': 'https://creativecommons.org/licenses/by/2.0/'}
>>> photo["url"]
'https://www.flickr.com/photos/lassennps/14898030836/'
This library was created for use in Flinumeratr, Flickypedia, and other Flickr Foundation projects.
Usage
-
Install flickr-photos-api from PyPI:
$ pip install flickr-photos-api
-
Construct an instance of
FlickrPhotosApi
. You need to pass a user-agent that identifies you, and a Flickr API key.from flickr_photos_api import FlickrPhotosApi api = FlickrPhotosApi(api_key="…", user_agent="…")
-
Call methods on FlickrPhotosApi. The methods meant for public use are:
def get_single_photo(photo_id: str) -> SinglePhoto: ... def get_photos_in_album(user_url: str, album_id: str) -> PhotosInAlbum: ... def get_photos_in_gallery(gallery_id: str) -> PhotosInGallery: ... def get_public_photos_by_user(user_url: str) -> CollectionOfPhotos: ... def get_photos_in_group_pool(group_url: str) -> PhotosInGroup: ... def get_photos_with_tag(tag: str) -> CollectionOfPhotos: ...
Methods that return collections of photos also support
page
andper_page
parameters to control pagination.
Development
If you want to make changes to the library, there are instructions in CONTRIBUTING.md.
License
This project is dual-licensed as Apache-2.0 and MIT.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for flickr_photos_api-1.8.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8bd41e9c58ef80c248420476eb15be05853fda61b71ccdd202b295b66a1b38d3 |
|
MD5 | eefe73a5d5f97d7ef30b5b370497aa86 |
|
BLAKE2b-256 | 400de0d34517f9c6b4bdcb54e975dfcaae8dd48979edd09d9765c5a3f4a501e6 |