Skip to main content

A Unsplash client without the need for an api key

Project description



An Unsplash client without the need for an api key. For a full documentation visit

Getting started

You can try out how this module works by importing the Unsplash class, which will help you with some user regular actions as searching for a keyword and then download a certain number of image pages of that results.

from unsplashpy import Unsplash

u = Unsplash()

search_text = input('Tell me what are you searching for: ')

num_pages = input('Pages to download [10]: ')
num_pages = 5 if num_pages == '' else int(num_pages)

image_size = input('Image size to download [regular]: ')
image_size = 'regular' if image_size == '' else image_size

u.download_last_search(num_pages=num_pages, image_size=image_size)

Some examples

Download user's photos

The bellow code will allow you to download all the user's published photos. One difference from the "Quick start" example is that this will take much more time downloading all pictures because this part doesn't make use of multithreading. We'll see another example on how to make this in a much more efficient way.

Another thing to know is that, by default, all the images downloaded will have a regular resolution.

from unsplashpy import User

username = input('Tell me a username: ')
u = User(username)

for p in

Download user's photos (multithreading way)

As said before, this is a more efficient way to download photos. It takes much less time than the above example.

from unsplashpy import User

username = input('Tell me a username: ')
u = User(username)

Download random photo

from unsplashpy import Photo

p = Photo.random()

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for unsplashpy, version 0.0.2
Filename, size File type Python version Upload date Hashes
Filename, size unsplashpy-0.0.2-py2.py3-none-any.whl (4.8 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size unsplashpy-0.0.2.tar.gz (4.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page