# Ticketmaster API: Search events > Finds upcoming Ticketmaster-listed concerts, sports, theater and other events by keyword, optionally by city, country, category and date range, with dates, venues, prices when shown and links. Partner-only listings without a Ticketmaster link are excluded; very large searches cover only the first 800 listings. Unofficial. Not affiliated with or endorsed by Ticketmaster. - Page: https://fous.com/methods/ticketmaster.com/search-events - Method: `ticketmaster.com/search_events`, version 1 - Website: ticketmaster.com - Returns: event name, local start time, venue, city, state, country, price range, currency, status, Ticketmaster link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `city` | string | no | | Event city, for example Chicago. Leave blank for anywhere. Default "". | | `query` | string | yes | `"Coldplay"` | Artist, team, show, or keyword, for example Coldplay. | | `country` | string | no | | Country name or two-letter code, for example United States or US. Default "United States". | | `category` | string | no | | Event category, for example sports. One of "all", "concerts", "sports", "arts_theater", "family". Default "all". | | `end_date` | string | no | | Last event date (YYYY-MM-DD), for example 2027-09-29. Defaults to one year from today. | | `start_date` | string | no | | First event date (YYYY-MM-DD), for example 2026-10-01. Defaults to today. | | `max_results` | integer | no | | Maximum events to return, for example 20. Default 20. | ## Output From a run on Oct 31, 2026. Its input: ```json { "query": "Coldplay" } ``` Its output: ```json { "events": [ { "city": "Anaheim", "status": "presale", "country": "United States", "event_id": "090065393930276A", "event_name": "The Kings of Queen - Queen Tribute", "venue_name": "House of Blues Anaheim", "lowest_price": null, "currency_code": null, "highest_price": null, "state_or_region": "CA", "ticketmaster_link": "https://www.ticketmaster.com/the-kings-of-queen-queen-tribute-anaheim-california-11-25-2026/event/090065393930276A", "local_start_datetime": "2026-11-25T18:00:00-08:00" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"ticketmaster.com/search_events","input":{"query":"Coldplay"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find upcoming Taylor Swift concerts in Toronto, Canada, with dates, venues and ticket price ranges - Are there any Chicago Cubs games on Ticketmaster between 2026-06-01 and 2026-06-30? List up to 15 with links. - Hamilton theater showings in Chicago this fall, September through November 2026, with prices if available - Search ticketmaster.com for Disney on Ice family shows in Houston and give me the venue, start time and status for each - What Bad Bunny tour dates are coming up anywhere in the US? Show me the next 50 events from Ticketmaster with their ticket links. ## Input schema ```json { "type": "object", "required": [ "query" ], "properties": { "city": { "type": "string", "default": "", "description": "Event city, for example Chicago. Leave blank for anywhere." }, "query": { "type": "string", "minLength": 1, "description": "Artist, team, show, or keyword, for example Coldplay." }, "country": { "type": "string", "default": "United States", "description": "Country name or two-letter code, for example United States or US." }, "category": { "enum": [ "all", "concerts", "sports", "arts_theater", "family" ], "type": "string", "default": "all", "description": "Event category, for example sports." }, "end_date": { "type": "string", "description": "Last event date (YYYY-MM-DD), for example 2027-09-29. Defaults to one year from today." }, "start_date": { "type": "string", "description": "First event date (YYYY-MM-DD), for example 2026-10-01. Defaults to today." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum events to return, for example 20." } } } ``` ## Output schema ```json { "type": "object", "required": [ "events" ], "properties": { "events": { "type": "array", "items": { "type": "object", "required": [ "event_name", "local_start_datetime", "venue_name", "city", "state_or_region", "country", "lowest_price", "highest_price", "currency_code", "status", "ticketmaster_link", "event_id" ], "properties": { "city": { "type": [ "string", "null" ] }, "status": { "enum": [ "on sale", "presale", "sold out", "cancelled", "rescheduled" ], "type": "string" }, "country": { "type": [ "string", "null" ] }, "event_id": { "type": "string" }, "event_name": { "type": "string" }, "venue_name": { "type": [ "string", "null" ] }, "lowest_price": { "type": [ "number", "null" ] }, "currency_code": { "type": [ "string", "null" ] }, "highest_price": { "type": [ "number", "null" ] }, "state_or_region": { "type": [ "string", "null" ] }, "ticketmaster_link": { "type": "string" }, "local_start_datetime": { "type": [ "string", "null" ] } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [Eventbrite API: Search events](https://fous.com/methods/eventbrite.com/search-events.md): Finds public Eventbrite events in a city or online, with optional keywords, date range, category and free-only filtering, ordered by start time. - [Songkick API: Search concerts in a city](https://fous.com/methods/songkick.com/search-concerts.md): Finds upcoming concerts in a city between two dates on Songkick. Each concert includes its artists, venue, festival name and ticket link. - [Songkick API: Get artist tour dates](https://fous.com/methods/songkick.com/get-artist-tour-dates.md): Gets an artist's upcoming concerts and tour dates on Songkick, optionally filtered by country, with ticket links and start times when listed. - [setlist.fm API: Get concert setlist](https://fous.com/methods/setlist.fm/get-concert-setlist.md): Get one artist's concert details and songs from setlist.fm by date or city. With only a city, returns the most recent matching concert there. Start times are local clock times because the pages do not supply a timezone. - [Fandango API: Get movie showtimes](https://fous.com/methods/fandango.com/get-movie-showtimes.md): Finds a movie's showtimes at nearby US theaters on Fandango, with formats, local times and ticket links. - [Meetup API: Search events](https://fous.com/methods/meetup.com/search-events.md): Finds upcoming public Meetup events by topic and city, sorted by start time. Only events that mention the topic are included; external costs and undisclosed venues may not be shown. - [Viator API: Search tours](https://fous.com/methods/viator.com/search-tours.md): Finds tours and experiences in a city on Viator, with optional keywords, date, currency and sorting. Prices are starting prices. - [Last.fm API: Get artist](https://fous.com/methods/last.fm/get-artist.md): Looks up a Last.fm artist by name and returns listening statistics, profile, top tracks and albums, similar artists, and upcoming events.