Getting started/Quick Start Guide

Quick Start Guide

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

30-Second Demo (No Signup Required)

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

Fortnite Live Matches:

curl -X GET "https://api.citoapi.com/v1/fortnite/matches/live" \
  -H "Authorization: Bearer pk_demo_cito_live_a06c129e0a9ce1c39c3035bd187541c4"

Call of Duty Player Stats:

curl -X GET "https://api.citoapi.com/v1/cod/players/Simp" \
  -H "Authorization: Bearer pk_demo_cito_live_a06c129e0a9ce1c39c3035bd187541c4"

Expected Response (142ms):

{
  "success": true,
  "data": {
    "id": "match_12345",
    "tournament": "FNCS Grand Finals",
    "status": "live",
    "players": [...],
    "started_at": "2026-01-15T18:00:00Z"
  }
}

Demo key limits: 50 calls/day, read-only, GET requests only. For production use, get your own key (free tier: 500 calls/month).

Common Use Cases

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

Copy-paste for Discord.js:

// Get player rank
const stats = await fetch(
  'https://api.citoapi.com/v1/valorant/players/Bugha',
  { headers: { 'Authorization': 'Bearer pk_demo_cito_live_a06c129e0a9ce1c39c3035bd187541c4' } }
);
const data = await stats.json();
message.channel.send(`${data.username} is rank ${data.rank}`);

"I need live tournament data..."

import requests

data = requests.get(
    'https://api.citoapi.com/v1/fortnite/tournaments/live',
    headers={'Authorization': 'Bearer pk_demo_cito_live_a06c129e0a9ce1c39c3035bd187541c4'}
).json()

print(f"Live tournaments: {len(data['tournaments'])}")

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

// In your component
const [matches, setMatches] = useState([]);

useEffect(() => {
  fetch('https://api.citoapi.com/v1/cod/matches/live', {
    headers: { 'Authorization': 'Bearer pk_demo_cito_live_a06c129e0a9ce1c39c3035bd187541c4' }
  })
    .then(res => res.json())
    .then(data => setMatches(data.matches));
}, []);

Get Your Production Key (Free)

Sign Up Free

Ready to go beyond the demo? Sign up for a free account to get 500 API calls per month with full access to all endpoints.

1

Create Account

Sign up for free at citoapi.com/signup. No credit card required.

2

Get API Key

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

3

Start Building

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

Environment Variable Setup:

# Add to .env file
CITO_API_KEY="sk_live_your_key_here"

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

Official SDKs (Coming Soon)

For now, use direct HTTP requests with fetch, axios, or requests. Official SDKs launching soon:

JavaScript/TypeScript

npm install @citoapi/sdk

Coming Q1 2026

Python

pip install citoapi

Coming Q1 2026

Go

go get github.com/citoapi/cito-go

Coming Q2 2026

Want to try the API interactively?

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

Open Playground