Tools
get_performer_analytics
Shows one performer's numbers now: rank, prices across its events, X activity, or with `view` any of them by date.
When to use it
- You want where a performer stands now: rank, average prices, listings and social activity.
- You want a performer's popularity rank, prices or X activity by date:
viewrank(orrangealone),priceorsocial. - You want the performer's dates:
vieweventsfor upcoming ones (addplayedtruefor past ones), orviewtourfor how each date's primary sale went. - You want one event's numbers: use
get_event_analytics. It replacesget_performer_rank_chart, whose name still answers: see Old names.
Inputs
view(string):now(the default): the numbers now.rank: the popularity rank by date.price: the day's mean get-in and median across its events, before fees and all-in.social: the day's X totals. Each by-date view returns one row per date overrange.events: the performer's upcoming events, soonest first, at most 50.list: a page of performers with their ranks and upcoming event counts.tour: the performer's upcoming dates with the primary seats each released, the share taken in the first 24 hours, the primary tickets left, the resale get-in against primary and the general admission floor against the cheapest reserved floor, with its 12-month track record (Max plan and above). One ofnow,rank,price,social,events,list,tour.performer_id(string or integer): The performer, by its Ticker id (pfplus ten characters), as the other tools return it.columns(array of strings): Now: the columns to return, spelled aslist_screen_columnsgives them in thepagroup, without thepa.prefix. Leave it out for every column. It does not apply to the by-date views.range(string): With a by-date view, how far back it reads. Leave it out for 28 days;allreaches back up to one year. Passed alone, it reads the popularity rank. One of7d,14d,28d,90d,all.render(boolean): With a by-date view, include a chart image ahead of the data. Setfalsefor the data only, a smaller answer.played(boolean): Withevents,truereturns the performer's dates that already took place, newest first, at most 50, each with the last get-in read before the show. Max plan and above.search(string): Find performers by part of the name, at least 2 characters, instead of naming oneperformer_id.category_id(integer): With a list, only performers in this category.subcategory_id(integer): With a list, only performers in this sub-category.event_count_min(integer): With a list, only performers with at least this many upcoming events.event_count_max(integer): With a list, only performers with at most this many upcoming events.listings_current_min(integer): With a list, only performers with at least this many listings across their events.listings_current_max(integer): With a list, only performers with at most this many listings across their events.computed_at_from(date-time): With a list, only analytics computed at or after this time.computed_at_to(date-time): With a list, only analytics computed at or before this time.sort_by(string): With a list, the sort key:name(the default), a rank,computed_at,event_countor an analytics number. A rank keeps the ranked performers; an analytics number keeps the performers that have one. One ofname,popularity_rank,lifetime_rank,computed_at,event_count,avg_median_price_current,avg_lowest_price_current,listings_current,tickets_delta_1d,tickets_delta_7d,likes_current,views_current,price_volatility_7d,price_volatility_14d.sort_order(string):ascordesc. The default isascfornameanddescfor every other key. One ofasc,desc.include_analytics(boolean): With a list, add each performer's analytics numbers underanalytics.parking(string): Parking passes sold as their own events:hide(the default) leaves them out,onlyreturns parking alone andincludereturns both. One ofhide,include,only.page(integer): With a list, the page to read, from 1.limit(integer): With a list, rows per page: 25 by default, at most 100.
Examples
How is this artist doing on the resale market right now?
{ "performer_id": "pf7k2m9q4x1z" }What is the chance this team makes the playoffs?
{
"performer_id": "pf9w4c7x2n5q",
"columns": ["playoff_prob_current", "playoff_prob_asof_date"]
}How is this artist's tour selling on the primary market?
{ "performer_id": "pf7k2m9q4x1z", "view": "tour" }What comes back
- Now: one object with the performer's columns:
popularity_rankandlifetime_rank(a higher number is better) and their changes, average prices across its events, listings, tickets and X activity. - For a sports team,
playoff_prob_currentis the chance from 0 to 1 that the team reaches its postseason. A null there means no clear market for that team, never a low chance.prediction_marketswhen a market covers the performer. x_buzzcarries recent activity on X; it is null when Ticker has no recent X reading. Acolumnspick never removes it.nullmeans Ticker has nothing for the performer.- With
viewrank: one row per date, oldest first, withsnapshot_date,popularity_rank,lifetime_rankand their places, andperformer_name. A null rank means unranked that date, not zero. A chart image comes first unlessrenderisfalse. - With
viewpriceorsocial: one row per date, oldest first. When your plan reads less far back thanrange,plan_cappedistrueandwithheldsays what was cut.
Limits and quota
- Reads only: it changes nothing.
- Each call spends one MCP request.
viewtourandplayedare on the Max plan and above.