# Eventory API > Live ticket availability, real-time notifications, market data and watchlists for the major ticketing platforms. > ## Agent Instructions > Base URL: https://api.eventory.ai. Send your API key in the apikey header. Market Data and Live Availability calls cost credits, pings included; GET /usage is free, so use it to test a key. Costs per endpoint: https://eventory.ai/docs/credits-and-access.md - [Ticket market data and availability API](https://eventory.ai/docs/index.md): Live ticket availability, real-time notifications, market data and watchlists for the major ticketing platforms, behind one API key. - [API quickstart](https://eventory.ai/docs/quickstart.md): Verify your key, add an event to your watchlist, and pull live availability in five minutes. - [API key authentication](https://eventory.ai/docs/authentication.md): One API key, sent in the apikey header, for every API. - [API credit costs per endpoint](https://eventory.ai/docs/credits-and-access.md): What each endpoint costs, which APIs your key can call, and where to see your balance. - [API rate limits](https://eventory.ai/docs/rate-limits.md): Live Availability is limited to 30 requests per minute per account. Every other API is not rate limited. - [API error codes](https://eventory.ai/docs/errors.md): Every error code the API can return, what it actually means, and what to do. - [Real-time ticket notifications (WebSocket)](https://eventory.ai/docs/stream/overview.md): A WebSocket that pushes a notification whenever an event on your watchlist changes. - [Connect to the notifications WebSocket](https://eventory.ai/docs/stream/connecting.md): Open the WebSocket, handle the handshake errors, and reconnect safely. - [Notification message format](https://eventory.ai/docs/stream/messages.md): The notification envelope, the changes map, and the section shapes. - [Ticket section data shapes](https://eventory.ai/docs/guides/section-types.md): The two shapes of sections returned by the stream and the Live Availability API. - [Event search filter syntax](https://eventory.ai/docs/guides/search-filters.md): The filterExpression syntax for POST /eventory/data/search and the attributes you can filter on. - [Supported ticketing platforms](https://eventory.ai/docs/guides/platforms.md): The platforms Live Availability can scrape, the regions each accepts, and what to pass as event_id. - [Watchlist platform keys](https://eventory.ai/docs/guides/watchlist-platforms.md): The platform keys the watchlist validates, the retired aliases it still accepts, and the discovery monitors that watch an artist or venue instead of an event. - [Use Eventory in ChatGPT and Claude (MCP)](https://eventory.ai/docs/guides/ai-assistants.md): Connect Eventory to ChatGPT or Claude and ask about events, prices and sales in plain language. - [REST API reference](https://eventory.ai/docs/reference/introduction.md): Base URL, conventions, and a map of every HTTP endpoint. - [Search the event catalog](https://eventory.ai/docs/api-reference/market-data/search-events.md): Full-text search across the Eventory event catalog with optional filters and sort orders. See the **Search filters** guide for the `filterExpression` syntax and the filterable attributes. - [viagogo event prices and daily stats](https://eventory.ai/docs/api-reference/market-data/viagogo-event.md): Returns Viagogo event metadata, the latest aggregate summary, the full daily statistics history, and a price distribution histogram. - [Recent viagogo ticket sales](https://eventory.ai/docs/api-reference/market-data/viagogo-recent-sales.md): Returns the most recent individual Viagogo sales for an event, newest first. - [Ticketmaster event inventory and prices](https://eventory.ai/docs/api-reference/market-data/ticketmaster-event.md): Returns Ticketmaster event data (scrape runs, per-section snapshot stats, statistics history), the latest aggregate stats, and the dashboard chart payload. The three blocks are fetched in parallel. - [Vivid Seats event listings and stats](https://eventory.ai/docs/api-reference/market-data/vividseats-event.md): Returns VividSeats event metadata, the latest summary of listed inventory, a daily statistics history, and a per-section breakdown of the latest snapshot. - [Artist social metrics](https://eventory.ai/docs/api-reference/market-data/artist.md): Resolves an artist by its exact marketplace URL and returns social metrics, the latest snapshot, and a rolling window of platform snapshots. - [Add event to tracking](https://eventory.ai/docs/api-reference/market-data/add-event-to-tracking.md): Registers an event so that Eventory starts collecting market data for it. Supply exactly one source: a Viagogo pair (`event_url` + `viagogo_event_id`) or a Ticketmaster pair (`ticketmaster_event_url` + `ticketmaster_event_id`). - [Market Data API ping](https://eventory.ai/docs/api-reference/market-data/ping.md): Liveness probe for the Market Data API. - [List live availability platforms](https://eventory.ai/docs/api-reference/live-availability/list-platforms.md): Returns the twelve supported platform keys with their accepted regions, the shape of the `sections` they usually return, and an example event id. Use it to confirm the exact `platform` and `event_id` format before calling `POST /events/scrape`. Several platforms take the full event URL as `event_id`… - [Live ticket availability for an event](https://eventory.ai/docs/api-reference/live-availability/scrape-live-availability.md): Fetches the current ticket availability for a single event on one of the supported platforms (see `GET /events/platforms`). The scrape runs synchronously and can take up to 60 seconds; set your client timeout to at least 65 seconds. - [Live Availability API ping](https://eventory.ai/docs/api-reference/live-availability/ping.md): Liveness probe for the Live Availability API. - [List watchlist items](https://eventory.ai/docs/api-reference/watchlist/list-watchlist-items.md): Returns the watchlist items owned by your account, newest first. `items` is an empty array if you have none. - [Create watchlist item](https://eventory.ai/docs/api-reference/watchlist/create-watchlist-item.md): Creates a watchlist item. `website`, `event`, and `region` are required; every other field is optional and takes the server default when omitted. Sending an explicit `null` stores `NULL`, except on boolean fields and `priority`, where it is ignored. - [Get watchlist item](https://eventory.ai/docs/api-reference/watchlist/get-watchlist-item.md): Returns a single item by id. - [Update watchlist item](https://eventory.ai/docs/api-reference/watchlist/update-watchlist-item.md): Partial update. Send only the fields you want to change; omitted fields are left untouched. To clear a nullable field, send it explicitly as `null`; `null` on a boolean field or on `priority` is ignored. - [Delete watchlist item](https://eventory.ai/docs/api-reference/watchlist/delete-watchlist-item.md): Deletes an item permanently. The stream stops delivering notifications for it within 60 seconds. - [Watchlist API health check](https://eventory.ai/docs/api-reference/watchlist/health.md): Liveness probe for the Watchlist API. Authentication is required like any other call, and a key without watchlist access gets `403`. - [Credit usage and plan](https://eventory.ai/docs/api-reference/account/usage.md): Returns your plan, billing period, and credit usage, fetched live from billing on every call. `credits.used` can trail your most recent requests by a minute or so. Any valid key may call this endpoint, whatever routes it is granted, so it is also the safest way to test a key. ## OpenAPI Specs - [openapi](/docs/openapi.yaml) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.