Skip to main content

Python Wrapper for the Beeswax API

Project description

Beeswax Wrapper

The beeswax wrapper is a python API for the beeswax DSP

beeswax_wrapper is currently supported for python2 and python3.


$ pip install beeswax_wrapper


>>> from beeswax_wrapper import BeeswaxAPI, configure_endpoint

BeeswaxAPI is the main interface to the package. It allows for seamless communication with the true beeswax API. The API lazily loads a BeeswaxDAL to access the API and manage authentication state. The BeeswaxDAL is shared among all BeeswaxAPI classes.

get_beeswax_dal() returns the single BeeswaxDAL object used by the apis. Modifying the BeeswaxDAL object returned by this function affects all BeeswaxAPI classes. Updates should be made to this dal using the configure_endpoint function as follows:

>>> from beeswax_wrapper import BeeswaxAPI, configure_endpoint
>>> api = BeeswaxAPI()
>>> configure_endpoint('')
>>> api.dal.endpoint_url


The BeeswaxAPI operates with an object restful structure. The basic method calls are organised as api.<object>.<restful_method> where the restful methods are:

  • retrieve
  • list
  • create
  • update
  • delete

Some keywords that are specific to each restful endpoint are supplied but the full list of keywords is available here:


>>> from beeswax_wrapper import BeeswaxAPI
>>> api = BeeswaxAPI()

>>> # get account information for an id
>>> api.accounts.retrieve(account_id=4)

>>> # get a list of campaigns
>>> api.campaigns.list()

>>> # delete a lineitem by id
>>> api.line_items.delete(line_item_id=62)

>>> # change user
>>> api.change_user('<username>', '<password>')
>>> # cookies are preserved per class


The BeeswaxAPI is metaclassed to raise only a BeeswaxRESTException.


The beeswax_wrapper authenticates once per BeeswaxDAL instance. The authentication is for short connection durations only. In the event that a connection times out or is unavailable, the BeeswaxDAL will attempt to re-authenticate. Credentials from the DAL are queried from the os keyring.

Adding credentials

$ python beeswax_wrapper/credentials/
Beeswax Username:
Beeswax Password:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

beeswax-wrapper-1.1.9.tar.gz (13.7 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page