An open API service indexing awesome lists of open source software.

https://github.com/stranger6667/pyoffers

Python client library for HasOffers API.
https://github.com/stranger6667/pyoffers

Last synced: 12 months ago
JSON representation

Python client library for HasOffers API.

Awesome Lists containing this project

README

          

PyOffers
========

|Build| |Coverage| |Version| |Python versions| |License|

Python client library for `HasOffers API `_.

Installation
============

PyOffers can be obtained with ``pip``::

$ pip install pyoffers

Usage example
=============

Initialize API client:

.. code-block:: python

>>> from pyoffers.api import HasOffersAPI
>>> hasoffers = HasOffersAPI(
endpoint='https://api.hasoffers.com/Apiv3/json',
network_token='',
network_id='',
)

Execute queries:

.. code-block:: python

>>> # Get all offers with ID greater than 100, sorted by ID and with loaded `Country` data
>>> hasoffers.offers.find_all(id__gt=100, sort='id', contain=['Country'])
[,
,
,
,
,
]
>>> # Get all clicks records for 2016-09-20
>>> hasoffers.raw_logs.clicks.find_all('20160920')
[, ...]
>>> # Get all conversions for specific offer
>>> offer = hasoffers.offers.get_by_id(100)
>>> offer.conversions.find_all()
[]

Documentation
=============

You can view documentation online at:

- https://pyoffers.readthedocs.io

Or you can look at the docs/ directory in the repository.

Python support
==============

PyOffers supports Python 3.5+.

.. |Build| image:: https://github.com/Stranger6667/pyoffers/workflows/build/badge.svg
:target: https://github.com/Stranger6667/pyoffers/actions
.. |Coverage| image:: https://codecov.io/github/Stranger6667/pyoffers/coverage.svg?branch=master
:target: https://codecov.io/github/Stranger6667/pyoffers?branch=master
.. |Version| image:: https://img.shields.io/pypi/v/pyoffers.svg
:target: https://pypi.org/project/pyoffers/
.. |Python versions| image:: https://img.shields.io/pypi/pyversions/pyoffers.svg
:target: https://pypi.org/project/pyoffers/
.. |License| image:: https://img.shields.io/pypi/l/pyoffers.svg
:target: https://opensource.org/licenses/MIT