semvec/pypi-packages huggingface dataset:
python-pixabay 4.2
Python 3 Pixabay's API wrapper
License: MIT
Requires Python: ~=3.5
Keywords: api development pixabay wrapper library python3

![build CI](https://github.com/momozor/python-pixabay/workflows/build%20CI/badge.svg)
[![Downloads](https://pepy.tech/badge/python-pixabay)](https://pepy.tech/project/python-pixabay)
[![Downloads](https://pepy.tech/badge/python-pixabay/month)](https://pepy.tech/project/python-pixabay/month)
[![PyPI version](https://badge.fury.io/py/python-pixabay.svg)](https://badge.fury.io/py/python-pixabay)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/python-pixabay.svg?color=1&label=Python)
<img src="http://img.shields.io/liberapay/patrons/momozor.svg?logo=liberapay">
<a href="https://liberapay.com/momozor/donate"><img alt="Donate using Liberapay" src="https://liberapay.com/assets/widgets/donate.svg"></a>
### python-pixabay
Python 3 Pixabay's API wrapper.

### Install from PyPi
`pip install python-pixabay`

### Synopsis

```python
from pixabay import Image, Video

API_KEY = 'my_pixabay_api_key'

# image operations
image = Image(API_KEY)

# default image search
image.search()

# custom image search
ims = image.search(q='cats dogs',
             lang='es',
             image_type='photo',
             orientation='horizontal',
             category='animals',
             safesearch='true',
             order='latest',
             page=2,
             per_page=3)

print(ims)

# video operations
video = Video(API_KEY)

# default video search
video.search()

# custom video search
vis = video.search(q='cats', lang='fr',
                       video_type='animation',
                       category='animals',
                       page=1,
                       per_page=4)

print(vis)
```

### Usage

I wrote a few _how to_ articles in the [project wiki](https://github.com/momozor/python-pixabay/wiki). Feel free to add more examples or scenarios to the wiki.

### Running the tests

*   Make sure you've assigned the `PIXABAY_API_KEY` environment variable with your
registered Pixabay's api key.

*   Run the following command `pytest` in the project directory.

### Maintainer and Contributors

*   This software is authored and maintained by [Momozor](https://github.com/momozor).

*   For contributors that contributed to this development of this module, see the
CONTRIBUTORS file.

### See Also
*   [python-pixabay's Documentation](https://momozor.github.io/python-pixabay/index.html)
*   [Pixabay's API Documentation](https://pixabay.com/api/docs)

### License

This module is licensed under the MIT license. See LICENSE file for more details.