PyPexels

An open source Python wrapper for the Pexels REST API. The source code is available on GitHub at https://github.com/salvoventura/pypexels.

Installation

PyPexels is available on PyPI and thus can be installed with pip on most platforms.

$ pip install pypexels

Dependencies

This library depends on Requests to make - well - requests to the Pexels API. This additional package should be automatically installed at installation time, or you can simply install it by:

$ pip install requests

Examples

This example shows how the interaction with the paging functionality of the Pexels API is greatly abstracted and simplified. The code below will iterate through all popular images, and print attributes for each photo in there.

from pypexels import PyPexels
api_key = 'YOUR_API_KEY'

# instantiate PyPexels object
py_pexels = PyPexels(api_key=api_key)

popular_photos = py_pexels.popular(per_page=30)
while popular_photos.has_next:
    for photo in popular_photos.entries:
        print(photo.id, photo.photographer, photo.url)
    # no need to specify per_page: will take from original object
    popular_photos = popular_photos.get_next_page()

Documentation

Documentation is published on ReadTheDocs.

Version

PyPexels v1.0.0rc1 (release candidate, v1)

This is the first release candidate for production ready 1.0.0 of PyPexels. Thanks to all the early adopters, there have been a number of improvements and bugfixes and now should be a good time to start the rc process.

This release introduces some good functionality, in particular:

• Support for Videos API: search, popular
• Introduction of SinglePhoto and SingleVideo * This allows instantiating a Photo or Video object using a photo_id or video_id
• Introduction of get_attribution() method on Photo and Video classes * This simplifies crediting the author
• Fix some documentation issues
• Extend Travis and Tox test coverage to include Python 3.6, 3.7 and 3.8

PyPexels v1.0.0b4 (beta, v4)

Fourth beta release introduces bugfix for Issue#7 AttributeError raised on Search.entries. REST API calls could fail silently making body an object of type None. With this fix, failing REST API calls will raise a PexelsError exception instead.

PyPexels v1.0.0b3 (beta, v3)

Third beta release introduces support for curated and random.

Note that using this library you still need to abide to Pexels Guidelines, which are explained on Pexels API page

PyPexels v1.0.0b2 (beta, v2)

Second beta release introduces Python3 support.

Note that using this library you still need to abide to Pexels Guidelines, which are explained on Pexels API page

PyPexels v1.0.0b1 (beta, v1)

First release with wrappers around the two Pexels API for search and popular.

Note that using this library you still need to abide to Pexels Guidelines, which are explained on Pexels API page

License

PyPexels is released under the MIT License.