> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eventory.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Live ticket availability, real-time notifications, market data and watchlists for the major ticketing platforms, behind one API key.

Eventory exposes four APIs through a single gateway at `https://api.eventory.ai`.
They share one API key, one error format, and one credit balance, but they answer
different questions.

## The four APIs

<CardGroup cols={2}>
  <Card title="Real-time stream" icon="bolt" href="/stream/overview">
    A WebSocket that pushes a notification the moment an event on your watchlist
    changes: stock appears, a price drops, a new section opens. **Free** with your plan.
  </Card>

  <Card title="Watchlist" icon="list-check" href="/reference/introduction#watchlist">
    Create, read, update and delete the events you want the stream to watch. **Free**
    with your plan.
  </Card>

  <Card title="Live Availability" icon="ticket" href="/reference/introduction#live-availability">
    Ask for the current inventory of any single event on Ticketmaster, AXS, Eventim,
    StubHub, viagogo and six more platforms, right now. **5 credits** per call.
  </Card>

  <Card title="Market Data" icon="chart-line" href="/reference/introduction#market-data">
    Historical sales, price history, aggregate statistics, artist social metrics and
    full-text search over the Eventory catalog. **1 credit** per call.
  </Card>
</CardGroup>

## Which one do I need?

| I want to…                                                               | Use                          | Style              | Cost      |
| ------------------------------------------------------------------------ | ---------------------------- | ------------------ | --------- |
| Be told the instant tickets appear or prices move on events I care about | Real-time stream + Watchlist | Push (WebSocket)   | Free      |
| Check what is on sale for one event right now                            | Live Availability            | Request / response | 5 credits |
| Analyse how an event has been selling over days or weeks                 | Market Data                  | Request / response | 1 credit  |
| Find events by name, artist, venue, country, or sales volume             | Market Data (search)         | Request / response | 1 credit  |
| See how many credits I have left                                         | Account (`/usage`)           | Request / response | Free      |

The stream and the Live Availability API return the same `sections` shapes, so a
client that parses one can parse the other. See [Section types](/guides/section-types).

## What you need to know first

<Steps>
  <Step title="Get a key">
    Keys are issued with an Eventory plan. Every request carries it in the `apikey`
    header. See [Authentication](/authentication).
  </Step>

  <Step title="Know what your key can call">
    Each key is granted a set of APIs. The stream, the watchlist and `/usage` come
    with every plan; Market Data and Live Availability are enabled per account.
    See [Credits & access](/credits-and-access).
  </Step>

  <Step title="Make your first call">
    `GET /usage` is free, works with any valid key, and tells you your plan and
    remaining credits. Start there in the [Quickstart](/quickstart).
  </Step>
</Steps>