Quick Start Guide

Test the API in 30 seconds with our demo key, or sign up for free to get your own account API key.

30-Second Demo (No Signup Required)

Test the API instantly with our demo key. Copy-paste this into your terminal:

Call of Duty Live Matches:

curl -X GET "https://api.citoapi.com/api/v1/cod/matches/live" \
  -H "x-api-key: pk_demo_cito_live_a06c129e0a9ce1c39c3035bd187541c4"

Expected Response:

{
  "success": true,
  "isLive": false,
  "count": 0,
  "data": []
}

Demo key limits: 50 calls/day on this read-only COD live endpoint. If no CDL match is live, the request still succeeds and returns an empty data array. For all other products, get your own key (free tier: 500 calls/month).

Common Use Cases

"I'm building a Discord bot..."

Copy-paste for Discord.js:

// Get a Fortnite player profile
const apiKey = process.env.CITO_API_KEY;
const stats = await fetch(
  'https://api.citoapi.com/api/v1/fortnite/players/bugha',
  { headers: { 'x-api-key': apiKey } }
);
const data = await stats.json();
message.channel.send(`Profile loaded: ${data.success ? 'yes' : 'check response'}`);

"I need live tournament data..."

import os
import requests

data = requests.get(
    'https://api.citoapi.com/api/v1/fortnite/tournaments/live',
    headers={'x-api-key': os.environ['CITO_API_KEY']}
).json()

tournaments = data.get('data') or data.get('tournaments') or []
print(f"Live tournaments: {len(tournaments)}")

"I'm building a React/Next.js app..."

// app/api/live-matches/route.ts
export async function GET() {
  const response = await fetch('https://api.citoapi.com/api/v1/cod/matches/live', {
    headers: { 'x-api-key': process.env.CITO_API_KEY }
  });

  return Response.json(await response.json());
}

Get Your Account API Key (Free)

Ready to go beyond the demo? Sign up for a free account to get 500 API calls per month for testing supported endpoints.

Create Account

Get API Key

After signup, copy your API key from the dashboard. It looks like: cito_live_abc123...

Start Building

Replace the demo key with your account API key. You now have 500 calls/month!

Environment Variable Setup:

# Add to .env file
CITO_API_KEY="cito_live_your_key_here"

# Access in your code
const apiKey = process.env.CITO_API_KEY;

Use Any HTTP Client

Cito uses standard REST JSON, so you can start with the HTTP client you already use.

JavaScript/TypeScript

fetch / axios

Works in Node, Next.js routes, and workers

Python

requests / httpx

Use environment variables for API keys

Go

net/http

No generated client required

Next Steps

Live Webhooks

See how Cito pushes live match updates without constant polling.

Authentication

Learn about API key security and best practices

Rate Limits

Understand rate limits and how to handle them

Fortnite API

Explore all Fortnite endpoints and parameters

Call of Duty API

Access CDL teams, players, matches, and analytics

Apex Legends API

Explore ALGS events, match scores, players, legends, bans, and transactions

Want to try the API interactively?

Use our API Playground to test endpoints in your browser without writing any code.

Open Playground