Getting Started

Get up and running with the Cappers API in minutes. This guide will walk you through everything you need to know to start making your first requests.

Create an Account

Get Your API Key

Once you've created an account, navigate to your dashboard to find your API key. You'll need this to authenticate all your API requests.

Your API key will look like this:

cap_xxxxxxxxxxxxxxxxxxxx

Make Your First Request

Let's make a simple request to get all NBA teams. Include your API key in the Authorization header:

cURL

curl -X GET "https://api.cappersapi.com/v1/nba/teams" \
  -H "Authorization: Bearer cap_your_api_key_here"

JavaScript / Node.js

const response = await fetch('https://api.cappersapi.com/v1/nba/teams', {
  headers: {
    'Authorization': 'Bearer cap_your_api_key_here'
  }
});

const data = await response.json();
console.log(data);

Python

import requests

response = requests.get(
    'https://api.cappersapi.com/v1/nba/teams',
    headers={'Authorization': 'Bearer cap_your_api_key_here'}
)

data = response.json()
print(data)

PHP

<?php
$ch = curl_init('https://api.cappersapi.com/v1/nba/teams');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer cap_your_api_key_here'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

print_r($data);
?>

Understanding the Response

All successful API responses follow a consistent structure:

{
  "data": [...],          // Your requested data
  "meta": {              // Metadata about the request
    "total": 30,
    "page": 1,
    "limit": 100
  }
}

Base URL

All API requests should be made to:

https://api.cappersapi.com/v1

What's Included

All plans, including free, have full access to every endpoint:

All NBA Endpoints

Complete access to all endpoints regardless of your plan

Real-time Data

Live game data, scores, and play-by-play updates

Advanced Analytics

Player efficiency, four factors, shot charts, and more

Historical Data

Access past seasons and historical statistics

The only difference between plans? Rate limits. Free gets 25 requests/minute, Pro gets 500 requests/minute, and Elite gets 2,000 requests/minute. Pro and Elite also include webhooks, analytics dashboard, and priority support.