Skip to main content

Search unsplash for photos

Project description


Unsplash-search is small python library to search for photos from the Unsplash photograph hosting website.


pip install unsplash-search


Import the UnsplashSearch module

from unsplash_search import UnsplashSearch

You must get an access key from the Unsplash Deverloper API website.

You must then instantiate the UnsplashSearch Class with your key to use the program.

unsplash = UnsplashSearch(YOUR_KEY)

Search using queries

The unsplash search method takes in a query as an argument for what kind of photos you want to get.

If successful, it will return a random image dictionary.

img ='mountains') #=> dict

The image dictionary object has two keys: The url of the image, and the author's instagram username.

So if you simply want to get a random image matching the query just do


Project details

Download files

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

Source Distribution

unsplash_search-0.2.0.tar.gz (2.3 kB view hashes)

Uploaded source

Built Distribution

unsplash_search-0.2.0-py3-none-any.whl (3.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page