Tools
get_event_sections
Shows one event's market by section: prices and tickets over time, the listings on sale, levels, one series across sections, or a map.
When to use it
- You want to know which part of the house is rising or falling in price, or to read resale vs face value section by section, as price context. For one market alone under its own section names, set
sourceto that market. - You want the listings on sale, cheapest first or section by section, with
viewlistings; or one price line across a few sections together, like a whole level, withviewaggregate. Across a performer's run or a list of events,viewfindnames the shows with listings in a section or on a level, for a ticket count and price, in one call. - You want how the house is laid out: each section's level, the sections close to it and the one opposite, with
viewlevels; or a picture of the house, each section colored by its lowest price or its tickets, withviewmap. - You want seats open this minute: use
get_event_sections_live. For a past moment or one section over hours, use it withviewatorseries.
Inputs
view(string):prices(the default): the prices and tickets of each section.listings: the listings on sale, one per row.aggregate: one series across the sections insections.levels: each section's level, the sections close to it and the section opposite.find: across a performer's upcoming events or a list of events, the events with listings in a section or on a level, with the cheapest and median price per section and market, andno_matchsaying why an event has none. It takesperformer_idorevent_ids, notevent_id.map: the event's section map as a picture, each section colored by one market's lowest price or its tickets on sale (color_by), and each drawn section's number in the data beside the picture. One ofprices,levels,listings,aggregate,find,map.event_id(string): The event, by its Ticker id. Find it withsearch_events.source(string):all(the default):vs,tm_primaryandtm_resaleside by side, one row per section. A market code reads that one market alone, under its own section names.vs,tmr,sh,sgandaqare the resale market;tm,sgpandmlb(the team's own primary market for a baseball game) are the primary market.mlbanswers current prices only, with no history. Withlistings,allreads every listing market your plan includes, andvs,sh,sg,tmrorsgpreads one. Withaggregate, one ofvs(the default),sh,sg,tmrorsgp. Withmap, the market whose sections color the map:vs(the default),tmr,sh,sg,sgp,tmoraq. It does not apply tolevels. One ofall,vs,tmr,sh,sg,sgp,tm,mlb,aq.sections(array of strings): Withpricesandlistings, only these sections, by any market's own label, like108orFL2, or bysection_key, likeFLOOR-10. Leave it out for the whole house. Withaggregate, the sections to combine, required.limit(integer): The most rows to return. Withprices, the sections when you leave outsections: 40 by default, and a value above 200 reads as 200. Withlevels: 200 by default, and a value above 1000 reads as 1000. Sections come in the order the app lists them: numbered sections by number, then named areas like the floor. Withlistings: 50 listings by default, and a value above 100 reads as 100.include_history(boolean): Withprices, setfalsefor current prices only, without history.range(string): How far back to read:3d,7d(the default),30d,90dorall, counted back from today. Withprices, the reach of each section's history; withaggregate, the span of the series. One of3d,7d,30d,90d,all.granularity(string): Withprices, the history's detail:daily(the default), one point per date, that date's last reading, orintraday, every reading the history holds, as the app charts it. One ofdaily,intraday.exclude(string): Comma separated listings to leave out:zone(Unassigned seats, where the seller holds no specific seats yet;vs) andview(Limited view, where the market says the seats see the stage or field only in part;vs,sg,sgpandsh). Leave it out to count every listing.excludedin the answer names what was left out, and a price with nothing left is null. Up to 64 characters.order(string): Withlistings:price(the default) reads the cheapest first, by the price after fees and then before;sectionwalks the listings market by market, then by section, row and price. One ofsection,price,deal_score.cursor(string): Withlistings,next_cursorfrom the page before, with the samesource,orderandsections, for the next page. Up to 400 characters.all_in_price_min_usd(number): Withlistings, only listings at or above this all-in price per ticket, in dollars. From 0 to 90071992547409.9.all_in_price_max_usd(number): Withlistings, only listings at or under this all-in price per ticket, in dollars. From 0 to 90071992547409.9.quantity(integer or array of integers): Withlistings, only listings that can sell this many tickets together, or any one of a list of up to 8 counts, like[2, 4]. A listing's stated splits decide when it has some, and its listed quantity otherwise. From 1 to 65535.row(string): Withlistings, only this row, matched without case or surrounding spaces. Up to 128 characters.parking(string): Parking passes listed inside the event:hide(the default) leaves them out,includeadds them as a parking group on the first page, at most 200, andonlylists the passes alone. On a parking event the passes are its listings at any value. One ofhide,include,only.performer_id(string or integer): Withfind, one performer's 50 soonest upcoming events, by its Ticker id (pfplus ten characters).event_idswins when you send both.event_ids(array of strings): Withfind, the events to read, at most 50, by Ticker id or a marketplace's. Up to 50 items.level(string): Withfind, only this level. A number like100or100sis the sections numbered 100 to 199, leaving out suites, boxes, lofts, the floor and pits. A word likelowerormezzanineis a level whose name holds it. An event with no such level comes back inno_matchwith the levels it has. Up to 40 characters.min_quantity(integer): Withfind, at least this many tickets together in one listing. The default is 1. From 1 to 100.max_price(number): Withfind, at or under this price per ticket, in dollars, onprice_basis.price_basis(string): Withfind,all_in(the default) for the price with fees orpre_feefor the price before fees. A listing with no price on that basis does not match, andunpriced_on_basiscounts it. One ofall_in,pre_fee.color_by(string): Withmap, what colors each section:price(the default), its lowest price, ortickets, the tickets on sale in it (ontm, the seats open). One ofprice,tickets.render(boolean): Withmap, include the map image ahead of the data. Setfalsefor the data only, a smaller answer.currency(string):usdorvenue. For an event at a Canadian or UK venue,venuegives every price in the venue's currency (Canadian dollars or pounds) at one exchange rate for the event, so the cheapest market and any order stay the same, and the answer namescurrency,venue_currency,fx_rateandfx_rate_date. Leave it out for USD. Any other event is always in USD. One ofusd,venue.
Examples
How did prices in sections 108 and 110 move this week?
{ "event_id": "ev3rp4z4zhq1", "sections": ["108", "110"] }What are the cheapest listings in section 108 right now?
{
"event_id": "ev8k2m4q7x1a",
"view": "listings",
"sections": ["108"],
"limit": 20
}How has the price of the lower level moved this month, sections 101 to 104 together?
{
"event_id": "ev5n7w2c9d4k",
"view": "aggregate",
"sections": ["101", "102", "103", "104"],
"range": "30d"
}What comes back
priceswithsourceall: one row per section, withsection,section_keyandtm_section, the primary seller's own label for it, then one block per market:vsfor the resale market with the widest section coverage,tm_primaryfor the primary market's face value andtm_resalefor the primary seller's own resale market.section_keynames the same section on every market, so the markets line up by it. Each block has the lowest, median and highest price, before fees and all-in, withavailable_ticketsandas_of, andhistoryoverrange, one point per date unlessgranularityisintraday. A block is null when the section is not offered in that market. Null never means zero.priceswith a market code:source,as_ofand one row per section withsectionandsection_key, the lowest, median, highest and average price, before fees and all-in, the face value where the market states one,available_tickets,total_listingsandhistory.sections_total,sections_returnedandtruncatedsay whetherlimitcut the list.listings: one row per listing with its market insource,sectionandsection_key,row,quantity,pricebefore fees andaip_priceall-in,face_value,captured_at(when the listing last changed),seen_at(when a read last saw it on sale) andticker_listing_id, the same on every read.listings_totalcounts them all;rows_truncatedtruemeans more follow, andnext_cursorreads them. No seller is named.aggregate:points, one per read, each with the lowest and median price and the middle half of prices (p25_pricetop75_price), before fees and all-in,total_ticketsandtotal_listings, over the listings inside the sections asked, never an average of section medians.matched_section_keysnames each asked section the event has.map: the map image first unlessrenderisfalse, cyan for the cheapest sections or the fewest tickets, yellow for the most expensive or the most tickets, and gray for a section with no number on that market. Beside it comeprice_basis(all_inorprice),colored, the count of sections with a number,min_priceandmax_priceormin_ticketsandmax_tickets, andsections, each drawn section'spriceorticketsbysection_key, cheapest or most tickets first.drawnfalsemeans the event has no map to draw, andsectionsis empty.- A market your plan does not include is left out and named in
withheld, with the plan that includes it.unavailablenames a market whose listings could not be read right now; its absence says nothing about the market.
Limits and quota
- Reads only: it changes nothing.
- Each call spends one MCP request.
- A heavy tool: an account runs two at a time, and a third waits.
- The resale prices in
vsare on every plan. Thetm_primaryandtm_resaleblocks are on the Max plan and above. Withsource, every market code butvsis on the Max plan and above, and a market your plan does not include is refused with aplan_requirederror. - Markets meet on
section_key, never on a label. When one market lists two sections under the same key, each keeps its own row. - An input the view does not take, like
cursorwithprices, is refused by name. A market that does not price by section never appears here. - At
intraday, or withaggregate, an answer too long for one result keeps the newest points and says so. Name fewer sections, or ask fordaily.