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: cap_your_api_key_here"

JavaScript / Node.js

const response = await fetch('https://api.cappersapi.com/v1/nba/teams', {
  headers: {
    'Authorization': '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': '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: 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 100 requests/minute, Pro gets 1,000 requests/minute, and Elite gets 5,000+ requests/minute. Pro and Elite also include webhooks, analytics dashboard, and priority support.