get SafetyLevel for individual photo

[rodmur]

Is there a way to query an individual photo's safety level? I don't see a call for that in the Flickr API. They have flickr.photos.setSafetyLevel but no flickr.photos.getSafetyLevel. Basically I want to find all photos with a specific tag, test the safety level, and if it's not set to what I want, then set it.

[beaufour]

Hi @rodmur — you're right that there's no flickr.photos.getSafetyLevel endpoint, but the safety level is returned by flickr.photos.getInfo (and by search with extras="safety_level"), so you can read it without any new code.

With the currently released version

Load the photo (which calls getInfo under the hood) and read the safety_level attribute. Note it comes back as a string ("0", "1", "2", "3"):

photo = flickr_api.Photo(id="12345")
photo.load()
print(photo.safety_level)   # e.g. "3"

For your exact use case — find photos by tag, check the level, fix it if wrong — ask search to include the value via extras so you don't need a separate getInfo call per photo:

for p in flickr_api.Photo.search(tags="mytag", extras="safety_level"):
    if p.safety_level != "3":            # string comparison, or int(p.safety_level)
        p.setSafetyLevel(safety_level=3)

With the latest code (PR #174, now merged)

There's now a Photo.getSafetyLevel() helper, and safety_level is converted to an int automatically, so you don't have to deal with strings:

for p in flickr_api.Photo.search(tags="mytag", extras="safety_level"):
    if p.getSafetyLevel() != 3:         # returns int: 0=none, 1=safe, 2=moderate, 3=restricted
        p.setSafetyLevel(safety_level=3)

getSafetyLevel() also loads the photo for you if the value isn't already present, so flickr_api.Photo(id="12345").getSafetyLevel() works directly. The integer values match what setSafetyLevel accepts.

Hope that helps!