GetFromPexels is an elegant Pexels API wrapper that is available for everyone to use with the Python programming language.
Finding images
# Finding 3 images of cats
from getfrompexels import PexelsSession
session = PexelsSession(API_KEY)
query = session.search_for_photos("cat", per_page=3)
for photo in query.contents:
print(photo.pexels_url)
Finding videos
# Searching for dogs barking
from getfrompexels import PexelsSession
session = PexelsSession(API_KEY)
# Turning to page 2
query = session.search_for_videos("dog barking", page=2, per_page=3)
for video in query.contents:
print(video.pexels_url)
Saving to files
# Downloading the first image that pops up when you search "bird"
from getfrompexels import PexelsSession
session = PexelsSession(API_KEY)
# Searching for the first result for "bird"
results = session.search_for_photos("bird", per_page=1).contents
photo = results[0]
# Downloading the photo
photo.download(PATH, "large2x") # Several sizes accepted
All classes and functions contain docstrings using the reST format as code documentation.
The library requires for the requests
module to be installed.
If it isn't, running pip install requests
in the terminal should install the library.
The earliest Python version that can use this library is Python 3.11.
To request an API key, you must make a Pexels account and get one from the official Pexels website.
The official documentation for the Pexels APi is https://www.pexels.com/api/documentation/, which contains information about endpoints
and their results. GetFromPexels' main purpose is to provide anyone access to all the endpoints and provide an easy wrapper.