Skip to main content

Getting Started with the SeatData API

Follow these instructions to begin using the SeatData API.

Step 1: Create an Account​

If you don't already have a SeatData account, create one at: https://seatdata.io/register/

Existing Users

If you already have a SeatData account (Basic, Pro, etc.), you can add API access to your existing account—no need to create a new one.

Step 2: Subscribe to API Access​

  1. Log into your SeatData account
  2. Navigate to the Pricing page
  3. Select the API plan and complete checkout

API access uses usage-based billing—you only pay for what you use.

Step 3: Generate Your API Key​

  1. After subscribing, click "API Keys" in the sidebar
  2. Click "Generate API Key"
  3. Copy your API key immediately—for security, it will only be shown once
Important

Store your API key securely. If you lose it, you'll need to regenerate a new one (which invalidates the old key).

Step 4: Using the API​

Authentication

All API requests 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/

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​

View your API usage by clicking "API Keys" in the sidebar. The usage dashboard shows:

  • Total requests for the current billing period
  • Breakdown by endpoint (Sales Data vs Listings)

Usage is updated every 15 minutes.

Managing Your API Key​

From the API Keys page, you can:

  • Regenerate your key if compromised (immediately invalidates the old key)
  • Revoke your key to disable API access

Need Help?​

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