Skip to main content

Getting Started with the SeatData API

Follow these instructions to begin using the SeatData API.

Step 1: Create an API Account​

You will need a SeatData account exclusive to the API.

If you don't have any SeatData account OR you do have an account that is currently tied to a Basic, Pro, or CSV subscription, create a NEW account at: https://seatdata.io/register/

important

After creating your account, contact support@seatdata.io to request API access.

Step 2: Billing Setup​

Once you contact us, we will:

  1. Send you a link to set up billing for your account, if necessary.
  2. Provide you with an API key
Payment Method

If you prefer to use a credit card other than the one currently on file, you can adjust this using the "Manage Billing" button on the sidebar after billing is set up.

Step 3: Using the API​

important

Authentication: All requests to our server must include the header api-key with your API key as the value

API Documentation​

Full API documentation is available at: https://app.swaggerhub.com/apis-docs/seatdata/SeatDataAPI/0.4.0

Example Request (Python SDK)​

from seatdata import SeatDataClient

# Initialize client with your API key
client = SeatDataClient(api_key="your_64_char_api_key")

# Search for events
events = client.search_events(
    venue_name="Madison Square Garden",
    venue_city="New York"
)

# Get sales data for an event
sales_data = client.get_sales_data(event_id="1234567")

# Get current listings
listings = client.get_listings(event_id="1234567")

Example Request (Python)​

Below is a simple example request in Python to communicate, receive a response, JSON decode, and display the result:

import requests
import json

req = requests.get("https://seatdata.io/api/v0.3.1/salesdata/get?event_id=328852",
    headers={
        "api-key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    },
)

json_decoded = json.loads(req.content)

for i in json_decoded:
    print(i)
note

The Python requests library automatically decompresses GZIP responses.

Pricing​

API usage is billed on a tiered pricing structure. The cost per API call decreases with volume:

QuantityPrice per Unit
First 1 to 500$0.10
Next 501 to 1,000$0.08
Next 1,001 to 5,000$0.06
Next 5,001 to 10,000$0.03
Next 10,001 to 50,000$0.015
Next 50,001 to 250,000$0.0075
Next 250,001 to 1,000,000$0.006
Above 1,000,000$0.005
Billing

Your credit card will be billed every time accumulated usage reaches $500.

What Counts as a Billable API Call?​

Not all API requests result in charges. Here's what counts as a billable call:

Sales Endpoint​

  • Charged: All requests that return at least one sale
  • Not charged: Requests that return no sales data

Listings Endpoint​

  • Charged: Only when listings have been updated since your last request
  • Not charged: Requests where no listings have changed since your previous call
Cost Optimization

The Listings endpoint's intelligent caching means you're only charged for new or updated data, helping you minimize costs while staying up-to-date.

Monitoring Usage​

Usage can be viewed in the sidebar by logging into the account created for the API. Usage is updated once every 30 minutes.

Need Help?​

If you have any questions or requests, please contact us at support@seatdata.io.