API: Class Photo¶

This class is used to interact with individual Photo objects typically returned by PyUnsplash as part of Photos object entries.

Methods and properties¶

Methods and properties exposed by the Photo class.

Photo.refresh()¶

Reload the full object from its REST API URI. Required if there has been an update to the object, or if you need to retrieve the full object starting from a simplified content copy coming from a list.

Parameters

Argument Type Optional/Required Notes

N/A

Returns

None

Example
import pyunsplash
pu = pyunsplash.PyUnsplash(api_key='<your Unsplash API key>')
this_user = pu.user('salvoventura', w=100, h=100)
photos = this_user.photos()    # photos is an instance of class Photos
for photo in photos.entries:
    photo.refresh()
    print photo.id, photo.link_download

Photo.id¶

Unique identifier for this user resource.

Parameters

Argument	Type	Optional/Required	Notes
N/A

Returns

string

unique resource identifier

Example

import pyunsplash
pu = pyunsplash.PyUnsplash(api_key='<your Unsplash API key>')
this_user = pu.user('salvoventura', w=100, h=100)
photos = this_user.photos()    # photos is an instance of class Photos
for photo in photos.entries:
    photo.refresh()
    print photo.id, photo.link_download

Photo.link_html¶

Link to the html representation of the resource.

Parameters

Argument Type Optional/Required Notes

N/A

Returns

string url to the html representation of the resource

Example
import pyunsplash
pu = pyunsplash.PyUnsplash(api_key='<your Unsplash API key>')
this_user = pu.user('salvoventura', w=100, h=100)
photos = this_user.photos()    # photos is an instance of class Photos
for photo in photos.entries:
    print photo.id, photo.link_html

Photo.link_download¶

Download location of this resource.

Parameters

Argument Type Optional/Required Notes

N/A

Returns

string url to the download location of the resource

Example
import pyunsplash
pu = pyunsplash.PyUnsplash(api_key='<your Unsplash API key>')
this_user = pu.user('salvoventura', w=100, h=100)
photos = this_user.photos()    # photos is an instance of class Photos
for photo in photos.entries:
    print photo.id, photo.link_download

Photo.stats¶

Retrieve a single photo’s stats.

Parameters

Argument Type Optional/Required Notes

N/A

Returns

json JSON encoded stats information about this photo

Example
import pyunsplash
pu = pyunsplash.PyUnsplash(api_key='<your Unsplash API key>')
this_user = pu.user('salvoventura', w=100, h=100)
photos = this_user.photos()    # photos is an instance of class Photos
for photo in photos.entries:
    print photo.stats