- Official Eventbrite SDK for Python
- Full Documentation: http://eventbrite-sdk-python.readthedocs.org/
- API Reference: https://developer.eventbrite.com/docs/
$ pip install eventbrite
If you need to, you can also use easy_install:
$ easy_install eventbrite
The Eventbrite Python SDK makes it trivial to interact with the Eventbrite API:
>>> from eventbrite import Eventbrite
>>> eventbrite = Eventbrite('my-oauth-token')
>>> user = eventbrite.get_user() # Not passing an argument returns yourself
>>> user['id']
1234567890
>>> user['name']
Daniel Roy Greenfeld
You can also specify API endpoints manually:
>>> user = eventbrite.get('/users/me')
>>> user['id']
1234567890
>>> user['name']
Daniel Roy Greenfeld
Expansions can be included in a returned GET resource by simply adding the expand
keyword to the calling method:
>>> event = eventbrite.get_event('my-event-id')
>>> 'ticket_classes' in evbobject
False
>>> event = eventbrite.get_event('my-event-id', expand='ticket_classes')
>>> 'ticket_classes' in evbobject
True
When using Flask, you can convert incoming webhook requests into Eventbrite API objects using the webhook_to_object() method:
@app.route('/webhook', methods=['POST'])
def webhook():
# Use the API client to convert from a webhook to an API object
api_object = eventbrite.webhook_to_object(request)
# Process the API object
if api_object.type == 'User':
do_user_process(api_object)
if api_object.type == 'Event':
do_event_process(api_object)
return ""
Because this client interacts with Eventbrite's third API (a.k.a. APIv3), we are tying our release numbers against it in a modified-semantic system:
- 3.x.x where '3' matches the API version. This will not change until Eventbrite releases a new API version.
- x.0.x where '0' is increased any time there is a significant change to the API that possibly breaks backwards compatibility
- x.x.1 where '1' is increased on any release that does not break backwards compatibility (small, new features, enhancements, bugfixes)
Bug reports and pull requests are welcome on GitHub at https://github.com/eventbrite/eventbrite-sdk-python.
The library is available as Open Source under the terms of the Apache License, Version 2.0.