Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/arcward/ticketpy
Python wrapper/SDK for the Ticketmaster Discovery API
https://github.com/arcward/ticketpy
api api-wrapper python python-library python3 sdk ticketmaster ticketmaster-discovery
Last synced: 4 days ago
JSON representation
Python wrapper/SDK for the Ticketmaster Discovery API
- Host: GitHub
- URL: https://github.com/arcward/ticketpy
- Owner: arcward
- License: mit
- Created: 2016-11-09T23:51:45.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2024-06-02T22:03:53.000Z (6 months ago)
- Last Synced: 2024-10-16T23:04:29.580Z (30 days ago)
- Topics: api, api-wrapper, python, python-library, python3, sdk, ticketmaster, ticketmaster-discovery
- Language: Python
- Homepage:
- Size: 1.14 MB
- Stars: 24
- Watchers: 5
- Forks: 11
- Open Issues: 1
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
ticketpy
========
**Python wrapper/SDK for Ticketmaster's Discovery API**
More info:
http://developer.ticketmaster.com/products-and-docs/apis/discovery-api/v2/
Requirements
------------
- Python >= 3.5.2 (anything >= 3 is probably OK)
- Requests >= 2.13.0
Installation
------------
To install via *pip*:
.. code-block:: bash
$ pip install ticketpy
Or, locally from the same directory as ``setup.py``:
.. code-block:: bash
$ python setup.py install
Example searches
-------------------
Events
^^^^^^
To pull all Hip-Hop events in Georgia between May 19th, 2017 and
May 21st, 2017:
.. code-block:: python
import ticketpy
tm_client = ticketpy.ApiClient('your_api_key')
pages = tm_client.events.find(
classification_name='Hip-Hop',
state_code='GA',
start_date_time='2017-05-19T20:00:00Z',
end_date_time='2017-05-21T20:00:00Z'
)
for page in pages:
for event in page:
print(event)
Output::
Event: Atlanta Funk Fest 2017 3 Day Ticket
Venue(s): 'Wolf Creek Amphitheater' at 3025 Merk Road in Atlanta GA
Start date: 2017-05-19
Start time: 19:00:00
Price ranges: 128.01-424.0
Status: onsale
Genres: R&B
Event: Atlanta Funk Fest 2017
Venue(s): 'Wolf Creek Amphitheater' at 3025 Merk Road in Atlanta GA
Start date: 2017-05-19
Start time: 19:00:00
Price ranges: 63.0-158.0
Status: onsale
Genres: R&B
Event: Atlanta Funk Fest 2017
Venue(s): 'Wolf Creek Amphitheater' at 3025 Merk Road in Atlanta GA
Start date: 2017-05-20
Start time: 17:00:00
Price ranges: 63.0-158.0
Status: onsale
Genres: Hip-Hop/Rap
Event: NF
Venue(s): 'Center Stage Theater' at 1374 W Peachtree St. NW in Atlanta GA
Start date: 2017-05-20
Start time: 20:00:00
Price ranges: 22.0-83.0
Status: onsale
Genres: Hip-Hop/Rap
Calling ``ApiClient.find()`` returns a ``ticketpy.PagedResponse``
object, which iterates through API response pages (as ``ticketpy.Page``).
By default, pages have 20 elements. If there are >20 total elements,
calling ``PagedResponse.next()`` will request the next page from the API.
You can simplify that/do away with the nested loop by using
``PagedResponse.limit()``. By default, this requests a maximum of 5 pages,
and returns the elements of each in a flat list.
Use ``PagedResponse.one()`` to return just the list from the first page.
For example, the previous example could also be written as:
.. code-block:: python
import ticketpy
tm_client = ticketpy.ApiClient('your_api_key')
pages = tm_client.events.find(
classification_name='Hip-Hop',
state_code='GA',
start_date_time='2017-05-19T20:00:00Z',
end_date_time='2017-05-21T20:00:00Z'
).limit()
for event in pages:
print(event)
The output here would be the same as there was <1 page available, however,
this can save you some wasted API calls for large result sets. If you
really want *every page*, though, use ``all()`` to request every available
page.
Venues
^^^^^^
To search for all venues based on the string "*Tabernacle*":
.. code-block:: python
import ticketpy
tm_client = ticketpy.ApiClient("your_api_key")
venues = tm_client.venues.find(keyword="Tabernacle").all()
for v in venues:
print("Name: {} / City: {}".format(v.name, v.city))
Output::
Name: Tabernacle / City: London
Name: The Tabernacle / City: Atlanta
Name: Tabernacle, Notting Hill / City: London
Name: Bethel Tabernacle / City: Penticton
Name: Revivaltime Tabernacle / City: Toronto
Name: Auckland Baptist Tabernacle / City: Auckland
Name: Pentecostal Tabernacle / City: Nashville
Name: The Tabernacle / City: Oak Bluffs
Name: Tabernacle, Shoreditch / City: London
Name: Revivaltime Tabernacle / City: Toronto
Name: Tabernacle, Notting Hill / City: London
Name: The Tabernacle / City: London
Name: Tabernacle Junction / City: Yeovil
Name: New Tabernacle 4th Baptist Church / City: Charleston
Attractions
^^^^^^^^^^^
Searching for attractions works similarly to the above:
.. code-block:: python
import ticketpy
tm_client = ticketpy.ApiClient("your_api_key")
attractions = tm_client.attractions.find(keyword="Yankees").one()
for attr in attractions:
print(attr.name)
Output::
New York Yankees
Scranton Wilkes-Barre RailRiders
Staten Island Yankees
Yankee Stadium Tours
Tampa Yankees
New York Yankees Bomber Bucks
Hands On History At Yankee Stadium
Damn Yankees
Damn Yankees
Battle Creek Yankees
New York Yankees Parking
Offsite Parking at Yankee Stadium
Quikpark at Yankee Stadium- NYCFC
New York Yankees Fan Fest
New York Yankees 3 (Do Not Use)
New York Yankees 1 (Do Not Use)
New York Yankees 2 (Do Not Use)
Behind the Scenes At Yankee Stadium
Classifications
^^^^^^^^^^^^^^^
Searching for classifications works similarly to the above:
.. code-block:: python
import ticketpy
tm_client = ticketpy.ApiClient("your_api_key")
classifications = tm_client.classifications.find(keyword="Drama").one()
for cl in classifications:
print("Segment: {}".format(cl.segment.name))
for genre in cl.segment.genres:
print("--Genre: {}".format(genre.name))
Output::
Segment: Film
--Genre: Drama
Segment: Arts & Theatre
--Genre: Theatre
Querying details for classifications by ID will return either a ``Segment``,
``Genre``, or ``SubGenre``, whichever matches the given ID.
For example,
.. code-block:: python
import ticketpy
tm_client = ticketpy.ApiClient("your_api_key")
x = tm_client.classifications.by_id('KZFzniwnSyZfZ7v7nJ')
y = tm_client.classifications.by_id('KnvZfZ7vAvE')
z = tm_client.classifications.by_id('KZazBEonSMnZfZ7vkdl')
s = "Name: {} / Type: {}"
print(s.format(x.name, type(x)))
print(s.format(y.name, type(y)))
print(s.format(z.name, type(z)))
Output::
Name: Music / Type:
Name: Jazz / Type:
Name: Bebop / Type: