search_catalog
Search artists, teams, venues and events
Use this when the user names an artist, team, venue or event and you need the matching TicketSea records. Ranked search with prefixes, aliases and labeled one-edit corrections. Artist and venue matches are worldwide; an event radius needs a city ID or a full City, Region, Country label. Events, artists, teams and venues come with a tickets link (detail says what it is). Results are cached listings, not live inventory, and this is a search by name, not a dated list of events.
Parameterstocityfrommodesaletypelimitqueryoffsetradius
search_events
Find upcoming events
Use this when the user wants upcoming concerts, sports, theatre or other live events by performer or event name, city, country, category or dates. Returns cached provider listings in date order. Each upcoming event has its TicketSea page (url) and a tickets link: the seller's page for that exact event, else another seller's (detail says what it is), else the TicketSea page. Not live inventory, and nothing is purchased. Use nextOffset to page, and narrow the filters when scanLimited is true.
Parameterstocityfromkindlimitqueryoffsetcountry
get_event
Get event details
Use this when you have an event's slug from a search result and need that event's current details: date, local time, venue, sale state, cancellation and any published price range. Returns the newest available snapshot; older details are returned explicitly marked stale.
Parametersslugrequired
get_ticket_links
Get ticket links for an event
Use this when the user wants to buy or compare tickets for one specific event. Returns the exact-event seller links from a fresh, upcoming snapshot (links), each labeled primary or resale, official and affiliate, and the other sellers the event's TicketSea page offers (otherSellers), such as resale marketplaces, each with a description of what the link is; some are a search for the event rather than its own page. Does not check stock or reserve tickets. Canceled, past and stale events return no links.
Parametersslugrequired
prepare_event_visit
Plan a visit to an event
Use this when the user is planning a trip to one specific event and wants tickets together with a place to stay, parking or directions. One call returns the latest event details, every seller link for the event, the venue address, suggested stay dates and search links for hotels, parking, directions and things to do. Planning only; nothing is booked or saved. Stale or inactive events have no planning links.
Parametersslugrequired
get_ticket_prices
Get ticket price trends
Use this when the user asks whether tickets are getting cheaper or pricier, what it costs to get in, which events dropped or rose in price this week, or how an event's price has moved. Returns TicketSea's daily ticket price figures from TickPick's lowest listed all-in prices: the median get-in price (overall or for one category such as nfl or concerts) against a week earlier, the week's biggest drops and rises and the priciest events, each with its TicketSea page. With slug, one event's lowest price by day since TicketSea began tracking it. Mostly US events; one marketplace, one listing per day, not live inventory. Credit the figures as "TicketSea analysis of TickPick listings" with a link to the page.
Parametersslugcategory
get_service_status
Check listing freshness
Use this when a search fails or returns nothing unexpectedly and you need to know whether TicketSea's listings are current. Returns the latest snapshot time for each country. This is not a seller uptime or booking success measurement.
Takes no parameters.
