Python CDL API guide

Call of Duty League APIwith Python examples.

Fetch CDL matches, standings, live state, and player stats from Python using Cito API for scripts, notebooks, dashboards, and backend services.

Start FreeView Python Docs
Built for: Discord bots · Esports dashboards · Betting tools · Fantasy apps · Broadcast overlays · Research projects
Python examplesREST JSONCDL statsBlack Ops 7 data

CDL data coverage

What CDL Data Can You Access?

Concrete Call of Duty League data categories developers can use for dashboards, bots, analytics products, fantasy apps, and match centers.

Live and upcoming Call of Duty League matches
Match results and map-by-map breakdowns
Player match stats and game-level stats
Team rosters and active CDL players
CDL standings, schedules, and tournament data
Roster moves and transfers
Historical Call of Duty League data
Black Ops 7 season coverage

30-60s

live CDL polling during match windows

500

free API calls/month to start

$25

starter paid plan, no contract

Developer endpoints

Python-ready CDL endpoints

Use requests, FastAPI jobs, notebooks, or scheduled scripts to pull Call of Duty League data into your own tools.

GET/v1/cod/matches/live

Fetch live CDL matches from Python.

GET/v1/cod/cdl/standings

Pull standings into scripts, notebooks, or dashboards.

GET/v1/cod/matches/{matchId}/player-stats?includeMaps=true

Analyze player stats and map rows in Python.

Python requests example

import os
import requests

api_key = os.environ["CITO_API_KEY"]
response = requests.get(
    "https://api.citoapi.com/api/v1/cod/matches/live",
    headers={"x-api-key": api_key},
    timeout=15,
)

response.raise_for_status()
live_matches = response.json()
print(live_matches)

Python workflows this unlocks

Run scheduled jobs that cache CDL standings and live state for your own app.

Analyze player and map stats in notebooks without manually exporting data.

Build FastAPI or Django backends that serve COD data to your frontend safely.

Use cases

Built for developers shipping COD products

Data notebooks

Pull CDL match and player data into Python for analysis and visualization.

Backend jobs

Schedule sync jobs that fetch standings, matches, and player rows into your database.

API wrappers

Build your own internal SDK around Cito endpoints for your app team.

Questions developers ask

Can I use CitoAPI with Python?

Yes. CitoAPI is a REST API, so you can use requests, httpx, aiohttp, FastAPI, Django, or any Python HTTP client.

Can Python fetch CDL player stats?

Yes. Use the match player stats endpoint and includeMaps=true when you need map-level rows.

Where should I store my API key?

Store the CitoAPI key in environment variables or a server-side secret manager, never in public frontend code.

Start building with Call of Duty data today

Get a free Cito API key, test real endpoints, and upgrade only when your product needs more volume.

Create Free API Key