Metadata-Version: 2.1
Name: python-pexels
Version: 1.1
Summary: A unofficial python wrapper library for Pexels API
Author-email: Joker Hacker <jokerhacker.6521@protonmail.com>
License: GNU General Public License v3 (GPLv3)
Project-URL: Homepage, https://python-pexels.readthedocs.io/en/latest/
Project-URL: Bug Tracker, https://python-pexels.readthedocs.io/en/latest/
Project-URL: Documentation, https://python-pexels.readthedocs.io/en/latest/
Project-URL: Source Code, https://github.com/jk6521/py-pexels-api
Keywords: API Wrapper,Pexels API,PexelsAPI
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: importlib-metadata ; python_version < "3.8"

# python-pexels
A unofficial python library to support all of Pexels API features.

* Supports all of the **endpoints**, which are available in API v1.0

* Return data are **python objects**.

* User **friendly** library.

* Easy to **use**.
  
📚 **Documentation** for this library can be found below. It contains **detailed instructions** on how to use API.

📚 **Documentation for the official API can be found** [here](https://www.pexels.com/api/documentation/?language=javascript).
## Installation

You can install the library via **pip**

    pip install python-pexels

Or using **source code**, which is not recommended.

    git clone https://github.com/jk6521/py-pexels-api.git

    cd py-pexels-api

    python setup.py install

more installation guide found [here](https://python-pexels.readthedocs.io/en/latest/installation.html)

## Usage & Example
You need **API token** to access Pexels API, you can get it [here](https://www.pexels.com/api/new/)

Once library is installed using pip, create a new python file named `main.py`

```py
    #main.py
    from Pexels import Client

    client = Client(token="abcd1223")

    #search photos
    photos = client.search_photo(query="Joker")

    #you can access return data like
    print(photos.total_results)

    >>> 230
```
more examples can be found [here](https://python-pexels.readthedocs.io/en/latest/examples.html)

## Useful Links

📚 [Docs](https://python-pexels.readthedocs.io/en/latest/index.html)
🌐 [PyPi](https://pypi.org/project/python-pexels/)
💬 [Telegram](https://t.me/blackbulls_support)
