Python wrapper/SDK for Ticketmaster's Discovery API
More info: http://developer.ticketmaster.com/products-and-docs/apis/discovery-api/v2/
- Python >= 3.5.2 (anything >= 3 is probably OK)
- Requests >= 2.13.0
To install via pip:
Or, locally from the same directory as setup.py:
To pull all Hip-Hop events in Georgia between May 19th, 2017 and May 21st, 2017:
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/RapCalling 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:
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.
To search for all venues based on the string "Tabernacle":
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: CharlestonSearching for attractions works similarly to the above:
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 StadiumSearching for classifications works similarly to the above:
Output:
Segment: Film
--Genre: Drama
Segment: Arts & Theatre
--Genre: TheatreQuerying details for classifications by ID will return either a Segment, Genre, or SubGenre, whichever matches the given ID.
For example,
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: <class 'ticketpy.model.Segment'>
Name: Jazz / Type: <class 'ticketpy.model.Genre'>
Name: Bebop / Type: <class 'ticketpy.model.SubGenre'>
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent