Sport Sights

Getting Started

Welcome to the Sport Sights API! This guide will walk you through creating an account, generating an API key, and making your first request.

Create an Account

  1. Visit the Sport Sights Developer Portal and sign in with your GitHub account.
  2. Once signed in, you will be redirected to the dashboard where you can manage your API keys and view usage statistics.

Generate an API Key

  1. Navigate to the API Keys section from the sidebar.
  2. Click the Create Key button.
  3. Give your key a descriptive name (e.g., "My App - Development").
  4. Copy the generated key immediately — it will only be shown once.

Your API key will start with ssk_ and looks like this:

ssk_abc123def456...

Keep your API key secret. Do not share it publicly or commit it to version control.

Make Your First Request

Use your API key in the Authorization header with the Bearer scheme. Here is an example using curl to fetch a list of teams:

curl -X GET "https://api.sportsights.dev/teams" \
  -H "Authorization: Bearer ssk_your_api_key_here"

You should receive a JSON response like this:

{
  "data": [
    {
      "id": 1,
      "name": "Boston Bruins",
      "league": "NHL",
      "conference": "Eastern",
      "division": "Atlantic"
    }
  ],
  "pagination": {
    "next_cursor": "eyJpZCI6MjB9",
    "has_more": true
  }
}

Authentication

Every request to the Sport Sights API must include a valid API key. Include it in the Authorization header:

Authorization: Bearer ssk_your_api_key_here

If the key is missing or invalid, the API will return a 401 Unauthorized error.

Keys can be revoked at any time from the dashboard. Once revoked, any request using that key will be rejected immediately.

Explore the API

Now that you have your key, check out the API Reference for a complete list of available endpoints, query parameters, and response formats.